Presentation from Alfresco Summit 2013

1. Testing Alfresco extensions
(no, it’s not about jUnit)
07/11/2013
Alexey Ermakov / ITD Systems
#SummitNow

2. 2
What’s the target?
•
•
•
•
REST APIs tests
UI tests
complex behavioral scenarios
easy-to-write tests
#SummitNow
#SummitNow

3. 3
Why?
There’s Alfresco SDK and jUnit that already
allow you to run tests with repository
embedded to your Java code.
#SummitNow
#SummitNow

4. 4
Because we can!
#SummitNow
#SummitNow

5. 5
What’s inside?
• Python as the main tests language
• Proboscis as a core testing framework
• Selenium as a web browser emulator
#SummitNow
#SummitNow

6. 6
But where is your framework?
Repository tests:
• Python wrappers for REST calls
• Out-of-the-box implementation for few
standard REST APIs
#SummitNow
#SummitNow

7. 7
Example
from pyalfresco import alfresco
from proboscis.asserts import assert_equal
alf = alfresco.Alfresco()
assert_equal(
alf.get_person('admin').firstName,
'Administrator‘)
#SummitNow
#SummitNow

8. 8
Example
def get_task(self, id):
return WrapperObject(
self,
**self.repo_get_json(
'api/task-instances/%s' % id
)
)
#SummitNow
#SummitNow

9. 9
OK, what’s about UI tests?
UI tests:
• Predefined classes and decorators to run
tests only for specific browsers
#SummitNow
#SummitNow

10. 10
OK, what’s about UI tests?
UI tests:
• Predefined classes and decorators to run
tests only for specific browsers
• Predefined APIs to interact with Alfresco
Share forms system
#SummitNow
#SummitNow

11. 11
Example
from pyalfresco.tests import *
@for_browsers(['ie', 'firefox'])
class DashletTest(AlfrescoShareTest):
pass
#SummitNow
#SummitNow

12. 12
Dashlet to test
#SummitNow
#SummitNow

13. 13
Workflow start form
#SummitNow
#SummitNow

14. 14
Testing dashlet
class WorkflowShortcutsDashlet(AlfrescoShareObject):
def locate(self):
self.el = self.driver.find_element_by_css_selector(
'.dashlet.workflow-shortcuts‘
)
#SummitNow
#SummitNow

15. 15
Testing dashlet
@test
def locate_dashlet(self):
self.perform_share_log_in('admin', 'admin')
self.driver.get(URL + '/page/user/admin/dashboard')
self.dashlet = WorkflowShortcutsDashlet(
parent=None, driver=self.driver
)
self.dashlet.locate()
#SummitNow
#SummitNow

16. 16
Testing dashlet
@test(depends_on=[locate_dashlet])
def launch_workflows(self):
for w in self.dashlet.get_workflows().keys():
self.dashlet.launch_workflow(w)
#SummitNow
#SummitNow

17. 17
Testing form
<appearance>
<field id="bpm:workflowDescription" />
<field id="bpm:assignee">
<control template="/orgchart-picker.ftl" />
</field>
</appearance>
#SummitNow
#SummitNow

18. 18
Testing form
f = AlfrescoShareWorkflowForm(
workflow_id='activiti$wf', parent=self, fields=[
{
'name': 'bpm:workflowDescription',
'control': AlfrescoShareFormTextFieldControl
},
...
])
#SummitNow
#SummitNow

19. 19
Testing form
tffc = f.get_field_control('bpm:workflowDescription')
tffc.set_text('DESCRIPTION')
ocfc = f.get_field_control('bpm:assignee')
ocfc.show_picker()
ocfc.search('admin')
ocfc.add_person('Administrator')
ocfc.close_picker()
f.submit()
#SummitNow
#SummitNow

20. 20
Hm, what about complex tests?
1.
2.
3.
4.
5.
Create UI test
Verify results with REST bindings
Perform REST APIs tests
…
PROFIT!!
#SummitNow
#SummitNow

21. 21
Roadmap
• More wrappers for REST APIs
• More predefined form controls
• Improvements to framework code
#SummitNow
#SummitNow

22. 22
Stay in touch
Follow us: @itdsystems
Join the project: http://git.io/qzeE1Q
#SummitNow
#SummitNow