topic Re: Added Categories and Execute script in workflow in Alfresco Archive

Added Categories and Execute script in workflow

irene08 — Fri, 28 Sep 2012 09:06:07 GMT

Hi!Good Day! I've done my own javascript and I will execute this in workflow and I also added some category name in categories.xml. Here with is the code that I've done and below this script is the category name I've added. Please help. Thank you.—————————————————————————————————————————————————————

Re: Added Categories and Execute script in workflow

afaust — Sat, 29 Sep 2012 18:20:36 GMT

Hello,

the following statement in your script does not make any sense to me:

cm:generalclassifiable=”Approval”;

If you want to add a tag to a document, you need to obtain the document reference first and then call addTag() to add a single tag. But cm:generalclassifiable is not a tag, just a common category, in which case you would need to update the cm:categories property of the document.

Some sample code (NOT directly applicable to your context, just a demonstration - also NOT tested, writtend ad-hoc):


// some code

// get the first document from the workflow package
var document = bpm_package.childFileFolders(true, false)[0];
var oldCategories = document.properties["cm:categories"];
var categoryToAdd = null;

var categories = classification.getRootCategories("cm:generalclassifiable");
var remainingNames = ["Document Review Status", "Approval"];
while(categoryToAdd == null && categories && remainingNames.length > 0){
   var idx = 0, max = categories.length, innerCategories = categories;
   // reset categories to prevent further iterations if we don't find a match
   categories = null;

   for(;idx < max; idx++){
      var category = categories[idx];
      if(category.name.equals(remainingNames[0])){
          if(remainingNames.length == 1){
             categoryToAdd = category;
          }else{
             categories = category.getSubCategories();
             remainingNames.shift();
             break;
          }
      }
   }
}

if(categoryToAdd != null){
   var newCategories = oldCategories != null ? oldCategories : [];
   newCategories.push(categoryToAdd);
   document.properties["cm:categories"] = newCategories;
   document.save();
}

// some more code
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Regards
Axel

Re: Added Categories and Execute script in workflow

irene08 — Mon, 01 Oct 2012 02:14:46 GMT

Hi!

I really appreciate your reply and effort. I just want to clarify that tag and category are different. I created my own category for me to use it as a tag.

Steps:
1. If author/creator uploads the file—->Draft(automatically)
…Author/Creator will set workflow for reviewers…
2. If updated the file and one of the reviewers approve it—->Reviewed(automatically)
3. If all reviewers approve the file and required percent is equal to actual percent—>Approval(should be automatically)
…Author/Creator will set another workflow for approvers…
4. If all approvers approve the file—>Approved(should be automatically)
5. Author/Creator will MANUALLY tag the file as Published.

I can set the the 'Draft' and 'Reviewed' automatically tag in the file thru user interface of alfresco share in MANAGE RULE. But I don't know why
I can't set the 'Approval' and 'Approved' category in manage rule so I decided to execute own script for this but my script doesn't work. I hope this helps and make sense. Thank you really.

Again, Thank you.
Irene

Re: Added Categories and Execute script in workflow

afaust — Mon, 01 Oct 2012 08:58:57 GMT

Hello,

tags are "enhanced categories", i.e. Alfresco provides special interfaces / methods that simplify dealing with tags. Technically, they are of the same nature.

Rules are only for content changes and don't react to workflow events if those events don't actually change anything (approval state in workflow is managed separately from content). This is why you need a script in your workflow.

Regards
Axel

Re: Added Categories and Execute script in workflow

irene08 — Tue, 02 Oct 2012 02:38:15 GMT

Hello,

tags are "enhanced categories", i.e. Alfresco provides special interfaces / methods that simplify dealing with tags. Technically, they are of the same nature.

Rules are only for content changes and don't react to workflow events if those events don't actually change anything (approval state in workflow is managed separately from content). This is why you need a script in your workflow.

Regards
Axel

Thank you. I appreciate your help.
Irene

Re: Added Categories and Execute script in workflow

rubiecasana — Tue, 09 Oct 2012 16:51:07 GMT

Hi Axel,

I'm working on the same problem. tried adding this code in the parallelreview_group_processdefinition.xml. Restarted Alfresco, however I think it's not executed.

Have I missed any step for this to take effect?

var nodeId = document.id;
var theDocument = search.findNode("workspace://SpacesStore/" + nodeId);
var summary = theDocument.properties["cm:summary"];
theDocument.properties["cm:summary"] = "Approved";
theDocument.save();
‍‍‍‍‍‍

Hello,

the following statement in your script does not make any sense to me:

cm:generalclassifiable=”Approval”;


// some code

// get the first document from the workflow package
var document = bpm_package.childFileFolders(true, false)[0];
var oldCategories = document.properties["cm:categories"];
var categoryToAdd = null;

var categories = classification.getRootCategories("cm:generalclassifiable");
var remainingNames = ["Document Review Status", "Approval"];
while(categoryToAdd == null && categories && remainingNames.length > 0){
   var idx = 0, max = categories.length, innerCategories = categories;
   // reset categories to prevent further iterations if we don't find a match
   categories = null;

   for(;idx < max; idx++){
      var category = categories[idx];
      if(category.name.equals(remainingNames[0])){
          if(remainingNames.length == 1){
             categoryToAdd = category;
          }else{
             categories = category.getSubCategories();
             remainingNames.shift();
             break;
          }
      }
   }
}

if(categoryToAdd != null){
   var newCategories = oldCategories != null ? oldCategories : [];
   newCategories.push(categoryToAdd);
   document.properties["cm:categories"] = newCategories;
   document.save();
}

// some more code
‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍

Regards
Axel

Re: Added Categories and Execute script in workflow

afaust — Wed, 10 Oct 2012 10:42:22 GMT

Hello,

the code looks alright. Have you redeployed your updated process definition and started a new workflow? Only then will a change in a process definition actually lead to a result.

Regards
Axel

Re: Added Categories and Execute script in workflow

irene08 — Fri, 12 Oct 2012 03:26:32 GMT

Hello,

the code looks alright. Have you redeployed your updated process definition and started a new workflow? Only then will a change in a process definition actually lead to a result.

Regards
Axel

Hi!

What do you mean by redeployed process definition? Is that the bpmn20.xml? It's different from processdefinition.xml. Right?

Thank you,
Irene

Re: Added Categories and Execute script in workflow

afaust — Fri, 12 Oct 2012 08:42:19 GMT

Hello,

processdefinition.xml (JBPM, can actually be named anything - need not be named processdefinition.xml at all) is equivalent to .bpmn20.xml (Activiti) and if any changes are made to either file, these changes only take effect if the respective file is redeployed (not just put into the correct directory on the server).

Regards
Axel