Difference between revisions of "Automation"

Revision as of 10:47, 3 December 2012

Refer to Enable automation section to know how enable automation. By default automation is not enabled.

Refer to Extend_automation to extend automation validators and actions.

Preliminar concepts

Rule is composed by validators and actions.
Validators are one or more conditions on a rule that are evaluated depending the elements which fired the automation event ( document, folder, etc... )
Actions are some operations with element which fired the automation event ( document, folder, etc... )
Rule is executed when all validators in a rule return true.
When Actions are executed (all validators in rule are true ) all actions defined in the rule are executed in the element which fired the automation event ( folder, document, etc... )

Add new rule

Click icon and will be shown the add rule form:

Order field indicates execution preference among the other rules.
Name field is some name to identify the rule.
Event field indicates on which type of events is evaluted the rule.
At field has two possible values post or pre. post indicates execution before element is created at OpenKM, pre indicates execution when element is yet created. With example will be more clear, with post we can change the path where a document will be created, with pre the document is yet created but we can move to other path.
Exclusive field enabled stop the evaluation is rule is executed. Automation can have several rules, one or more can be evaluated and executed at same time ( in order defined by field Order ), but if a rule with exclusive field enabled is executed then automation stops here ( it's similar concept than firewall rules ).
Active indicates if rule is enabled or disabled.

Click send button and the rule will be added.

Edit a rule

Click icon and will be shown the edit rule form:

Changes values if needed and then click send button to update the rule.

Delete a rule

Click icon and will be shown the delete rule form:

Click send button and the rule will be deleted.

Edit actions and validators

Click icon will be shown a screen like this:

Click icon and add some validator:

Click send button and the validator will be added.

Click icon and add some action:

Click send button and the action will be added.

With edit icon and delete icon you can edit or delete validators and actions.

Validators description

Element can be document, folder, etc...

ContainsFolder

Return True if element path has some folder child.
Example
- Folder child name = test
- Element folder with path /okm:root/folder1 has a folder called /okm:root/folder1/test then return true
- Element folder with path /okm:root/folder1 has not a folder called /okm:root/folder1/test then return false

HasKeyword

Return True if element has some keyword

HasPropertyGroup

Return True if element has some property group

HasPropertyGroupValue

Return True if element has some property group value

NameContains

Return True if path element contains some string value
Example
- Value = test
- Element folder with path /okm:root/folder1/test/temporary contains test, then return true
- Element folder with path /okm:root/folder1/temporary not contains test, then return false

PathContains

Return True if path starts with some value
- Path starts with = /okm:root/folder1
- Element folder with path /okm:root/folder1/test/temporaryreturn true
- Element folder with path /okm:root/test/temporary returns false

PathContainsFolderName

Return True if path contains some value
- Folder name with = folder1
- Element folder with path /okm:root/folder1/test/temporaryreturn true
- Element folder with path /okm:root/test/temporary/folder1return true
- Element folder with path /okm:root/test/temporary returns false

Actions description

Element can be document, folder, etc...

AddCategory

Add some category to the element

AddCategoryToWizard

After uploading document will be shown the wizard ( user action needed ) to add categories.

AddDigitalSignatureToWizard

After uploading document will be shown the wizard ( user action needed ) to sign document.

AddKeyword

Add some keyword to the element.

addKeywordToWizard

After uploading document will be shown the wizard ( user action needed ) to to add keywords.

AddPropertyGroupToWizard

After uploading document will be shown the wizard ( user action needed ) to to add property groups.

AddWorkflowToWizard

After uploading document will be shown the wizard ( user action needed ) to to execute workflows.

ExecuteScripting

Execute a script related with the element.

GrantRole

Add some role grant to the element.

GrantUser

Add some user grant to the element.

RevokeAllRoles

Remove all roles grants to the element.

RevokeAllUsers

Remove all user grants to the element.

RevokeCategory

Remove a category to the element.

RevokeKeyword

Remove a keyword to the element.

RevokeRole

Remove a role grant to the element.

RevokeUser

Remove a user grant to the element.

SetTextExtracted

Add text content to be indexed as document content.

SendMail

Send mail to users. Can be used the same variables than Notification_and_subscription_messages. The default subject used is notification subject.

@@ Line 13: / Line 13: @@
 == Add new rule ==
-Click [[File:new.png]] icon and will be shown the add rule form:
+Click [[File:add.png]] icon and will be shown the add rule form:
 [[File:Okm_admin_075.png|center]]
@@ Line 46: / Line 46: @@
 [[File:Okm_admin_078.png|center]]
-Click [[File:new.png]] icon and add some validator:
+Click [[File:add.png]] icon and add some validator:
 [[File:Okm_admin_079.png|center]]
@@ Line 54: / Line 54: @@
 [[File:Okm_admin_080.png|center]]
-Click [[File:new.png]] icon and add some action:
+Click [[File:add.png]] icon and add some action:
 [[File:Okm_admin_081.png|center]]