Krutik Jayswal

Evaluators are used for control visibility of share document library action.For creating custom action in alfresco share you can follow below link.It has most of the things covered.

http://www.krutikjayswal.com/2016/08/custom-action-in-share-documentlibrary.html

Evaluators are nothing but a spring bean which is used for evaluating the visibility of custom action in alfresco share.In alfresco there are already few predefined evaluators are there.Those are generic and can me used in multiple scenarios.On below link all those evaluators are very well explained.

http://docs.alfresco.com/5.1/concepts/doclib-predefined-evaluators-reference.html

Even if all those evaluators are there, there can be a business requirement of creating a custom evaluator.In custom evaluators there are few things using which you can do evaluation like properties of node.

Lets take one example of custom evaluator.
In my previous blog we have created action called "open-form" and have added it on document-browse,document-details,folder-browse and folder-details section.

   onActionFormDialog
   action
   script
   create
   {node.nodeRef}
   message.execute-script.success
   message.execute-script.failure

Now for adding evaluator you have to create bean in slingshot application context file.That bean will reference a java class which extends a class called org.alfresco.web.evaluator.BaseEvaluator.Lets take a loon on that java file.

SampleEvaluator.Java

import org.alfresco.web.evaluator.BaseEvaluator;
import org.json.simple.JSONObject;

public class SampleEvaluator extends BaseEvaluator{

 @Override
 public boolean evaluate(JSONObject jsonObject) {
  boolean result=false;
  
  //Evaluate
  
  
  return result;
 }
 

}

In the method public boolean evaluate(JSONObject jsonObject), You can evaluate the node and set the value of result variable accordingly.Properties you can get from node are in jsonObject argument of method.Apart from this if you need anything else you can call alfresco webservice also.

{
 "node": {
  "isLink": false,
  "nodeRef": "workspace:\/\/SpacesStore\/43dd6777-b40f-4c49-9533-cd5a180fe4d4",
  "permissions": {
   "inherited": true,
   "roles": ["ALLOWED;GROUP_EVERYONE;Contributor;INHERITED"],
   "user": {
    "Delete": true,
    "Write": true,
    "CancelCheckOut": false,
    "ChangePermissions": true,
    "CreateChildren": true,
    "Unlock": false
   }
  },
  "isLocked": false,
  "aspects": ["cm:titled", "cm:auditable", "sys:referenceable", "sys:localized"],
  "isContainer": true,
  "type": "cm:folder",
  "properties": {
   "cm:title": "",
   "cm:creator": {
    "firstName": "Administrator",
    "lastName": "",
    "displayName": "Administrator",
    "userName": "admin"
   },
   "cm:modifier": {
    "firstName": "Administrator",
    "lastName": "",
    "displayName": "Administrator",
    "userName": "admin"
   },
   "cm:created": {
    "iso8601": "2016-08-27T12:56:35.349Z",
    "value": "Sat Aug 27 18:26:35 IST 2016"
   },
   "cm:name": "Inv",
   "sys:store-protocol": null,
   "sys:node-dbid": null,
   "sys:store-identifier": null,
   "sys:locale": null,
   "cm:modified": {
    "iso8601": "2016-08-27T12:56:35.349Z",
    "value": "Sat Aug 27 18:26:35 IST 2016"
   },
   "cm:description": "",
   "sys:node-uuid": null
  }
 },
 "webdavUrl": "\/webdav\/Shared\/Inv",
 "parent": {
  "isLink": false,
  "nodeRef": "workspace:\/\/SpacesStore\/3372c9eb-8ea2-4b1f-a19c-386158313f8f",
  "permissions": {
   "inherited": false,
   "roles": ["ALLOWED;GROUP_EVERYONE;Contributor;DIRECT"],
   "user": {
    "Delete": true,
    "Write": true,
    "CancelCheckOut": false,
    "ChangePermissions": true,
    "CreateChildren": true,
    "Unlock": false
   }
  },
  "isLocked": false,
  "aspects": ["cm:titled", "cm:auditable", "sys:referenceable", "sys:localized", "app:uifacets"],
  "isContainer": true,
  "type": "cm:folder",
  "properties": {
   "cm:title": "Shared Folder",
   "cm:creator": {
    "firstName": "System",
    "lastName": "User",
    "displayName": "System User",
    "userName": "System"
   },
   "cm:modifier": {
    "firstName": "Administrator",
    "lastName": "",
    "displayName": "Administrator",
    "userName": "admin"
   },
   "cm:created": {
    "iso8601": "2016-08-23T11:50:00.399Z",
    "value": "Tue Aug 23 17:20:00 IST 2016"
   },
   "sys:store-protocol": null,
   "sys:store-identifier": null,
   "cm:description": "Folder to store shared stuff ",
   "sys:node-uuid": null,
   "cm:name": "Shared",
   "sys:node-dbid": null,
   "sys:locale": null,
   "cm:modified": {
    "iso8601": "2016-08-27T12:56:35.402Z",
    "value": "Sat Aug 27 18:26:35 IST 2016"
   },
   "app:icon": "space-icon-default"
  }
 },
 "fileName": "Inv",
 "nodeRef": "workspace:\/\/SpacesStore\/43dd6777-b40f-4c49-9533-cd5a180fe4d4",
 "displayName": "Inv",
 "location": {
  "path": "\/Shared",
  "parent": {},
  "file": "Inv",
  "repositoryId": "6c2cf525-c6bf-4e63-8f8e-71d15bf1a588",
  "repoPath": "\/Shared"
 },
 "version": "1.0",
 "likes": {
  "isLiked": false,
  "totalLikes": 0
 }
}

In slingshot application context file you have to create bean like below.

Basic information on alfresco certification are available on below link.

https://university.alfresco.com/ACE













Few tips while preparing for alfresco certification.

If you have friends who are working in alfresco, tell him to prepare list of questions and try to solve those like you are giving exam. Luckily I have few.

As i said in the earlier para, do some practicals on which you are having doubt and don't waste your time on simple things.Read it and leave it if you know that.

Few people might have concern on aikau as its the latest ui framework in alfresco, but believe me it is not the one which you should concentrate.For aikau it will be enough if you are completing tutorials on following link.

https://github.com/Alfresco/Aikau/tree/master/tutorial/chapters

The other reason for not concentrating on it is , there are very less questions coming from aikau part.

Regarding how does it feel of being certified, well for me its like getting gold medal in olympics.

There are multiple types of action available in alfresco share which you can add in document library.Few examples are already available in internet for adding custom action in alfresco share.The most common exmaple is adding an action called send-as-email in document library.That exmaple is added in documentation of alfresco share as well.Take a look on below link for same.

http://docs.alfresco.com/5.0/tasks/dev-extensions-share-tutorials-add-action-doclib.html

There are multiple business cases in which you need to implement custom action in alfresco.This blog will give you description about what kind of things you can achieve in custom action of alfresco share.

Below is screenshot of document details page on which custom actions are highlighted.




There are few components which can be customized or used in alfresco for implementation of custom action in alfresco share.Those are as below.

Evaluator
Using evaluator we can control the visibility/access of action for users.There are multiple parameters by which we can control the visibility. Evaluation of node can be done on aspects, properties state of node or the type of node.

Type of action
There are multiple type of action you can create in share.All of them are as below.

javascript
With the use of this type of action you can call java script function.Lets take an example.Take a look on below code.

   onActionFormDialog
   action
   script
   create
   {node.nodeRef}
   message.execute-script.success
   message.execute-script.failure

If you take look on each param which is passed in function, than you will realize that all of those params are related to form.The parameter named function is used for identification for which function function is called. Rest of all params are used inside that function.There are some predifined javascript function which you can use.Please take a look on actions.js file in alfresco share for all function.If you are using this function, you have to create action-executor with the same id of action.

page

Redirection to internal application(Withinn pages of alfresco share)

link
Redirection to external web application, for example redirection to http://www.google.com
Any of above action can be visible on any/all of the below section.

1. Folder Details
2. Folder Browse
3. Document Details
4. Document Browse
5. Folder Link Browse
6. Folder Link Details
7. Document Link Browse
8. Document Link Details

Below is sample code for adding action on desired location.

 

 
  
   onActionFormDialog
        
   action
        
   script
        
   create
        
   {node.nodeRef}
        
   message.execute-script.success
        
   message.execute-script.failure

  
 
 
  
   
  
  
   
  
  
   
  
  
   
  
 

In above index attribute is index of action in the list of action.