在AEM中开发项目

首先，在/apps/<your-app-folder>下创建一个名为projects的文件夹。 在该名为templates的文件夹下创建另一个文件夹。

/apps/aem-guides/projects-tasks/
                    + projects (nt:folder)
                             + templates (nt:folder)

为了简化操作，我们将从现有的“简单项目”模板开始自定义模板。

1. 将节点​ /libs/cq/core/content/projects/templates/default ​复制并粘贴到步骤1中创建的​ templates ​文件夹下。

/apps/aem-guides/projects-tasks/
             + templates (nt:folder)
                  + default (cq:Template)

您现在应具有类似于​ /apps/aem-guides/projects-tasks/projects/templates/authoring-project ​的路径。

1. 编辑author-project节点的​ jcr：title ​和​ jcr：description ​属性以自定义标题和描述值。

   1. 将​ 向导 ​属性保留为指向默认的项目属性。

/apps/aem-guides/projects-tasks/projects/
         + templates (nt:folder)
              + authoring-project (cq:Template)
                   - jcr:title = "Authoring Project"
                   - jcr:description = "A project to manage approval and publish process for AEM Sites or Assets"
                   - wizard = "/libs/cq/core/content/projects/wizard/steps/defaultproject.html"

对于此项目模板，我们希望使用“任务”。

1. 在名为​ tasks ​的authoring-project/gadgets下添加新的​ nt：unstructured ​节点。
2. 将String属性添加到​ cardWeight = "100"、jcr：title="Tasks"和​ sling：resourceType="cq/gui/components/projects/admin/pod/taskpod"的任务节点。

现在，在创建新项目时，默认情况下将显示任务拼贴。

../projects/templates/authoring-project
    + gadgets (nt:unstructured)
         + team (nt:unstructured)
         + asset (nt:unstructured)
         + work (nt:unstructured)
         + experiences (nt:unstructured)
         + projectinfo (nt:unstructured)
         ..
         + tasks (nt:unstructured)
              - cardWeight = "100"
              - jcr:title = "Tasks"
              - sling:resourceType = "cq/gui/components/projects/admin/pod/taskpod"

我们将向项目模板添加自定义审批者角色。

1. 在项目模板(authoring-project)节点下添加一个新的​ nt：unstructured ​节点，标记为​ 角色。

2. 将另一个标记为批准者的​ nt：unstructured ​节点添加为角色节点的子节点。

3. 添加字符串属性​ jcr：title = "审批者"，roleclass ="所有者"，roleid="审批者"。

   1. 审批者节点的名称以及jcr：title和roleid可以是任何字符串值（只要roleid是唯一的）。
   2. roleclass ​根据三个OOTB角色控制应用于该角色的权限： 所有者、编辑者 ​和​ 观察者。
   3. 一般来说，如果自定义角色更像是管理角色，则角色可以是​ 所有者； ​如果自定义角色更像是摄影师或Designer之类的创作角色，则​ 编辑者 ​角色就足够了。 所有者 ​和​ 编辑者 ​之间的主要区别在于，项目所有者可以更新项目属性并将新用户添加到项目中。

../projects/templates/authoring-project
    + gadgets (nt:unstructured)
    + roles (nt:unstructured)
        + approvers (nt:unstructured)
             - jcr:title = "Approvers"
             - roleclass = "owner"
             - roleid = "approver"

通过复制简单项目模板，您将配置四个OOTB工作流。 工作流/模型下的每个节点都指向该工作流的特定工作流和开始对话框向导。 在本教程的后面部分，我们将为此项目创建一个自定义工作流。 现在，请删除工作流/模型下的节点：

../projects/templates/authoring-project
    + gadgets (nt:unstructured)
    + roles (nt:unstructured)
    + workflows (nt:unstructured)
         + models (nt:unstructured)
            - (remove ootb models)

为了便于内容作者识别项目模板，您可以添加自定义缩略图。 建议的大小为319x319像素。

1. 在CRXDE Lite中，将文件创建为名为​ thumbnail.png ​的小工具、角色和工作流节点的同级。
2. 保存，然后导航到jcr:content节点并双击jcr:data属性（避免单击“查看”）。
   1. 这将提示您编辑jcr:data文件对话框，您可以上传自定义缩略图。

../projects/templates/authoring-project
    + gadgets (nt:unstructured)
    + roles (nt:unstructured)
    + workflows (nt:unstructured)
    + thumbnail.png (nt:file)

您应该看到自定义模板作为创建项目的选项之一。

选择自定义模板后，单击“下一步”，并注意在填充项目成员时，您可以将其添加为审批者角色。

单击“创建”以根据自定义模板完成项目创建。 您会注意到“项目功能板”上的“任务拼贴”以及在小工具下配置的其他拼贴会自动显示。

从AEM“开始”菜单中，导航到“工具” — >“工作流” — >“模型”。 单击右上角的“创建”以创建工作流模型。

为新模型指定标题“内容审批工作流”和URL名称“content-approval-workflow”。

有关创建工作流的详细信息，请阅读此处。

作为最佳实践，自定义工作流应分组到/etc/workflow/models下方的各自文件夹中。 在CRXDE Lite中，在名为​ "aem-guides" ​的/etc/workflow/models下创建一个​ "nt：folder"。 添加子文件夹可确保自定义工作流在升级或Service Pack安装期间不会意外覆盖。

*请注意，切勿将文件夹或自定义工作流放置在ootb子文件夹（如/etc/workflow/models/dam或/etc/workflow/models/projects）下，因为升级或Service Pack也可能会覆盖整个子文件夹。

中的位置

工作流模型在6.3中的位置

NOTE

如果使用AEM 6.4+，则Workflow的位置已更改。 查看此处，了解更多详细信息。

如果使用AEM 6.4+，将在/conf/global/settings/workflow/models下创建工作流模型。 对/conf目录重复上述步骤，添加名为aem-guides的子文件夹，并将content-approval-workflow移到其下方。

工作流模型在6.4+中的位置

AEM 6.3中引入了向给定工作流添加工作流暂存的功能。 这些暂存将显示在“工作流信息”选项卡的“收件箱”中，供用户使用。 它将向用户显示工作流中的当前阶段以及工作流之前和之后的阶段。

要配置阶段，请从Sidekick中打开“页面属性”对话框。 第四个选项卡标记为“暂存”。 添加以下值以配置此工作流的三个阶段：

1. 编辑内容
2. 审批
3. 发布

从“页面属性”对话框中配置工作流暂存。

从AEM收件箱中看到的工作流进度条。

（可选）您可以将​ 图像 ​上传到页面属性，该属性在用户选择时用作工作流缩略图。 图像尺寸应为319x319像素。 当用户选择工作流时，也会显示向页面属性添加​ Description。

“创建项目任务”工作流进程旨在创建作为工作流步骤的任务。 只有在完成任务后，工作流才会前进。 “创建项目任务”步骤的一个强大方面是，它可以读取工作流元数据值，并使用这些值动态创建任务。

首先删除默认创建的参与者步骤。 从“组件”菜单中的Sidekick中展开​ “项目” ​子标题，并将​ “创建项目任务” ​拖放到模型上。

双击“创建项目任务”步骤以打开工作流对话框。 配置以下属性：

此选项卡在所有工作流流程步骤中都是通用的，我们将设置标题和描述（最终用户看不到这两个标题）。 我们将设置的重要属性是从下拉菜单中将“工作流暂存”设置为​ “编辑内容”。

Common Tab
-----------------
    Title = "Start Task Creation"
    Description = "This the first task in the Workflow"
    Workflow Stage = "Edit Content"

“创建项目任务”工作流进程旨在创建作为工作流步骤的任务。 “任务”选项卡允许我们设置任务的所有值。 在本例中，我们希望被分派人具有动态性，因此我们将保留为空。 其余属性值：

Task Tab
-----------------
    Name* = "Edit Content"
    Task Priority = "Medium"
    Description = "Edit the content and finalize for approval. Once finished submit for approval."
    Due In - Days = "2"

“路由”选项卡是一个可选的对话框，可为完成任务的用户指定可用的操作。 这些操作只是字符串值，且会保存到工作流的元数据中。 可以通过脚本读取这些值，和/或稍后在工作流中执行流程步骤以动态“路由”工作流。 根据我们将要执行的工作流目标，向此选项卡中添加三个操作：

Routing Tab
-----------------
    Actions =
        "Normal Approval"
        "Rush Approval"
        "Bypass Approval"

通过此选项卡，我们可以配置创建前任务脚本，在其中我们可以在创建任务之前以编程方式决定任务的各种值。 我们可以选择将脚本指向外部文件，或者直接在对话框中嵌入简短脚本。 在我们的示例中，我们将预创建任务脚本指向外部文件。 在步骤5中，我们将创建该脚本。

Advanced Settings Tab
-----------------
   Pre-Create Task Script = "/apps/aem-guides/projects/scripts/start-task-config.ecma"

在上一步中，我们引用了一个预创建任务脚本。 我们现在将创建该脚本，其中将根据工作流元数据值"代理人"的值设置任务的代理人。 工作流启动时设置了​ “代理人” ​值。 我们还将读取工作流元数据，以通过读取工作流元数据的“taskPriority” ​值以及用于在第一个任务到期时动态设置的​ “taskDueDate” ​来动态选择任务的优先级。

出于组织目的，我们在应用程序文件夹下创建了一个文件夹，用于保存所有与项目相关的脚本： /apps/aem-guides/projects-tasks/projects/scripts。 在此文件夹下创建名为​ "start-task-config.ecma" ​的文件。 *注意：请确保start-task-config.ecma文件的路径与步骤4中“高级设置”选项卡中设置的路径相匹配。

添加以下内容作为文件的内容：

// start-task-config.ecma
// Populate the task using values stored as workflow metadata originally posted by the start workflow wizard

// set the assignee based on start workflow wizard
var assignee = workflowData.getMetaDataMap().get("assignee", Packages.java.lang.String);
task.setCurrentAssignee(assignee);

//Set the due date for the initial task based on start workflow wizard
var dueDate = workflowData.getMetaDataMap().get("taskDueDate", Packages.java.util.Date);
if (dueDate != null) {
    task.setProperty("taskDueDate", dueDate);
}

//Set the priority based on start workflow wizard
var taskPriority = workflowData.getMetaDataMap().get("taskPriority", "Medium");
task.setProperty("taskPriority", taskPriority);

导航回内容审批工作流。 将​ OR拆分 ​组件(可在“工作流”Sidekick下找到)拖放到​ 开始Task ​步骤下。 在“常用”对话框中，选择“3个分支”的单选按钮。 OR拆分将读取工作流元数据值​ "lastTaskAction" ​以确定工作流的路由。 "lastTaskAction" ​属性设置为步骤4中配置的路由选项卡中的值之一。 对于每个“分支”选项卡，使用以下值填写​ 脚本 ​文本区域：

function check() {
var lastAction = workflowData.getMetaDataMap().get("lastTaskAction","");

if(lastAction == "Normal Approval") {
    return true;
}

return false;
}

function check() {
var lastAction = workflowData.getMetaDataMap().get("lastTaskAction","");

if(lastAction == "Rush Approval") {
    return true;
}

return false;
}

function check() {
var lastAction = workflowData.getMetaDataMap().get("lastTaskAction","");

if(lastAction == "Bypass Approval") {
    return true;
}

return false;
}

*请注意，我们正在执行直接字符串匹配以确定路由，因此分支脚本中设置的值必须与步骤4中设置的路由值相匹配。

将另一个"创建项目任务"步骤拖放到模型的最左侧（分支1）的OR拆分下方。 使用下列属性填写对话框：

Common Tab
-----------------
    Title = "Approval Task Creation"
    Description = "Create a an approval task for Project Approvers. Priority is Medium."
    Workflow Stage = "Approval"

Task Tab
------------
    Name* = "Approve Content for Publish"
    Task Priority = "Medium"
    Description = "Approve this content for publication."
    Days = "5"

Routing Tab - Actions
----------------------------
    "Approve and Publish"
    "Send Back for Revision"

由于这是常规审批路由，因此任务的优先级将设置为Medium。 此外，我们给批准者组五天时间来完成任务。 “任务”选项卡上的“被分派人”留空，因为我们将在“高级设置”选项卡中动态分配此项。 完成此任务时，我们为批准者组提供两种可能的途径：如果批准内容且内容可以发布，则传递​ “批准”和Publish“”；如果存在原始编辑器需要更正的问题，则传递​ “返回以进行修订”。 批准者可以添加注释，如果工作流返回给他/她，原始编辑者将看到这些注释。

将另一个"创建项目任务"步骤拖放到模型的OR拆分下的中间分支（分支2）中。 使用下列属性填写对话框：

Common Tab
-----------------
    Title = "Rush Approval Task Creation"
    Description = "Create a an approval task for Project Approvers. Priority is High."
    Workflow Stage = "Approval"

Task Tab
------------
    Name* = "Rush Approve Content for Publish"
    Task Priority = "High"
    Description = "Rush approve this content for publication."
    Days = "1"

Routing Tab - Actions
----------------------------
    "Approve and Publish"
    "Send Back for Revision"

由于这是紧急批准路由，因此任务的优先级将设置为“高”。 此外，我们只给批准者组一天时间来完成任务。 “任务”选项卡上的“被分派人”留空，因为我们将在“高级设置”选项卡中动态分配此项。

我们可以重复使用与步骤7中相同的脚本片段来填充{高级设置{选项卡 ​上的​ 脚本 ​文本区域。 复制并粘贴以下代码：

var projectApproverGrp = workflowData.getMetaDataMap().get("project.group.approvers","administrators");

task.setCurrentAssignee(projectApproverGrp);

将a​ 无操作 ​组件拖放到最右侧分支（分支3）中。 无操作组件不执行任何操作，它将会立即进行高级操作，表示原始编辑者希望绕过批准步骤。 从技术上讲，我们可以离开此分支而不执行任何工作流步骤，但作为最佳实践，我们将添加“不操作”步骤。 这使其他开发人员清楚了解分支3的用途。

双击工作流步骤并配置标题和描述：

Common Tab
-----------------
    Title = "Bypass Approval"
    Description = "Placeholder step to indicate that the original editor decided to bypass the approver group."

在配置OR拆分中的所有三个分支后，工作流模型应该如下所示。

由于“审批者”组可以选择将工作流发送回原始编辑器以进行进一步修订，因此我们将依赖​ 转至 ​步骤来读取上次执行的操作并将工作流路由到开头，或者让它继续。

将“跳转步骤”组件(可在“工作流”下的Sidekick中找到)拖放到重新联接处的OR拆分下。 双击并在对话框中配置以下属性：

Common Tab
----------------
    Title = "Goto Step"
    Description = "Based on the Approver groups action route the workflow to the beginning or continue and publish the payload."

Process Tab
---------------
    The step to go to. = "Start Task Creation"

我们将配置的最后一个部分是作为“转至”流程步骤一部分的脚本。 脚本值可以通过对话框嵌入，也可以配置为指向外部文件。 Goto脚本必须包含​ 函数check()，如果工作流应转到指定的步骤，则返回true。 返回false会导致工作流继续运行。

如果审批者组选择​ “Send Back for Revision” ​操作（在步骤7和步骤8中配置），则我们希望将工作流返回到​ “Start Task Creation” ​步骤。

在“流程”选项卡上，将以下代码片段添加到“脚本”文本区域：

function check() {
var lastAction = workflowData.getMetaDataMap().get("lastTaskAction","");

if(lastAction == "Send Back for Revision") {
    return true;
}

return false;
}

为了发布有效负载，我们将使用ootb 激活页面/资产 ​流程步骤。 此流程步骤几乎不需要进行配置，并且会将工作流的负载添加到复制队列以进行激活。 我们将在“转至”步骤下添加步骤，以这种方式，只有在审批者组已审批要发布的内容或原始编辑者选择“略过审批”路由时，才能访问此步骤。

将​ 激活页面/资产 ​流程步骤(可在WCM工作流下的Sidekick中找到)拖放到模型中的跳转步骤下。

添加“转至”步骤和“激活页面/资产”步骤后工作流模型的外观。

如果“审批者”组将内容发送回以进行修订，我们想让原始编辑器知道。 我们可以通过动态更改“任务”创建属性来实现这一点。 我们将关闭​ “Send Back for Revision” ​的lastActionTaked属性值。 如果存在该值，我们将修改标题和描述，以指示此任务是将内容发送回以进行修订的结果。 我们还将优先级更新为​ “高”，以便它是编辑器处理的第一个项目。 最后，我们将任务到期日设置为从发送回工作流以进行修订起的一天。

将开始start-task-config.ecma脚本（在步骤5中创建）替换为以下内容：

// start-task-config.ecma
// Populate the task using values stored as workflow metadata originally posted by the start workflow wizard

// set the assignee based on start workflow wizard
var assignee = workflowData.getMetaDataMap().get("assignee", Packages.java.lang.String);
task.setCurrentAssignee(assignee);

//Set the due date for the initial task based on start workflow wizard
var dueDate = workflowData.getMetaDataMap().get("taskDueDate", Packages.java.util.Date);
if (dueDate != null) {
    task.setProperty("taskDueDate", dueDate);
}

//Set the priority based on start workflow wizard
var taskPriority = workflowData.getMetaDataMap().get("taskPriority", "Medium");
task.setProperty("taskPriority", taskPriority);

var lastAction = workflowData.getMetaDataMap().get("lastTaskAction","");

//change the title and priority if the approver group sent back the content
if(lastAction == "Send Back for Revision") {
  var taskName = "Review and Revise Content";

  //since the content was rejected we will set the priority to High for the revison task
  task.setProperty("taskPriority", "High");

  //set the Task name (displayed as the task title in the Inbox)
  task.setProperty("name", taskName);
  task.setProperty("nameHierarchy", taskName);

  //set the due date of this task 1 day from current date
  var calDueDate = Packages.java.util.Calendar.getInstance();
  calDueDate.add(Packages.java.util.Calendar.DATE, 1);
  task.setProperty("taskDueDate", calDueDate.getTime());

}