#589 ability to prevent default outcome behaviour

- ability to prevent default outcome behaviour (i.e. custom validation)
- new ‘executeOutcome’ event for DocumentList
- unit tests
- readme updates

ng2-components/ng2-activiti-form/src/components/activiti-form.component.spec.ts

@@ -19,7 +19,7 @@ import { it, describe, expect } from '@angular/core/testing';
 import { Observable } from 'rxjs/Rx';
 import { SimpleChange } from '@angular/core';
 import { ActivitiForm } from './activiti-form.component';
-import { FormModel, FormOutcomeModel, FormFieldModel } from './widgets/index';
+import { FormModel, FormOutcomeModel, FormFieldModel, FormOutcomeEvent } from './widgets/index';
 import { FormService } from './../services/form.service';
 import { WidgetVisibilityService } from './../services/widget-visibility.service';
 import { ContainerWidget } from './widgets/container/container.widget';
@@ -582,4 +582,56 @@ describe('ActivitiForm', () => {
         expect(formComponent.checkVisibility).toHaveBeenCalledWith(fakeField);
     });
 
+    it('should prevent default outcome execution', () => {
+
+        let outcome = new FormOutcomeModel(new FormModel(), {
+            id: ActivitiForm.CUSTOM_OUTCOME_ID,
+            name: 'Custom'
+        });
+
+        formComponent.form = new FormModel();
+        formComponent.executeOutcome.subscribe((event: FormOutcomeEvent) => {
+            expect(event.outcome).toBe(outcome);
+            event.preventDefault();
+            expect(event.defaultPrevented).toBeTruthy();
+        });
+
+        let result = formComponent.onOutcomeClicked(outcome);
+        expect(result).toBeFalsy();
+    });
+
+    it('should not prevent default outcome execution', () => {
+        let outcome = new FormOutcomeModel(new FormModel(), {
+            id: ActivitiForm.CUSTOM_OUTCOME_ID,
+            name: 'Custom'
+        });
+
+        formComponent.form = new FormModel();
+        formComponent.executeOutcome.subscribe((event: FormOutcomeEvent) => {
+            expect(event.outcome).toBe(outcome);
+            expect(event.defaultPrevented).toBeFalsy();
+        });
+
+        spyOn(formComponent, 'completeTaskForm').and.callThrough();
+
+        let result = formComponent.onOutcomeClicked(outcome);
+        expect(result).toBeTruthy();
+
+        expect(formComponent.completeTaskForm).toHaveBeenCalledWith(outcome.name);
+    });
+
+    it('should check visibility only if field with form provided', () => {
+
+        formComponent.checkVisibility(null);
+        expect(visibilityService.updateVisibilityForForm).not.toHaveBeenCalled();
+
+        let field = new FormFieldModel(null);
+        formComponent.checkVisibility(field);
+        expect(visibilityService.updateVisibilityForForm).not.toHaveBeenCalled();
+
+        field = new FormFieldModel(new FormModel());
+        formComponent.checkVisibility(field);
+        expect(visibilityService.updateVisibilityForForm).toHaveBeenCalledWith(field.form);
+    });
+
 });