動態選取以AEM Forms為中心的工作流程步驟的使用者或群組

了解如何在執行階段為AEM Forms工作流程選取使用者或群組。

在大型組織中，需要動態選取流程的使用者。例如，根據座席與客戶的接近程度選擇要為客戶服務的現場座席。在這種情況下，動態選擇代理。

指派任務和Acrobat Sign步驟 Forms OSGi工作流程提供動態選取使用者的選項。您可以使用ECMAScript或OSGi套件組合，以動態方式為「指派任務」步驟選擇受託人，或為「簽署檔案」步驟選擇簽署人。

使用ECMAScript動態選擇用戶或組

ECMAScript是一種指令碼語言。用於用戶端指令碼和伺服器應用程式。執行下列步驟以使用ECMAScript動態選取使用者或群組：

開啟CRXDE Lite。 URL為 https://[server]:[port]/crx/de/index.jsp
在下列路徑建立副檔名為.ecma的檔案。如果路徑（節點結構）不存在，請建立它：
- （分配任務步驟的路徑） /apps/fd/dashboard/scripts/participantChooser
- （簽名步驟的路徑） /apps/fd/workflow/scripts/adobesign
將具有動態選取使用者邏輯的ECMAScript新增至.ecma檔案。按一下 全部儲存.

如需範例指令碼，請參閱動態選取使用者或群組的ECMAScript範例.
新增指令碼的顯示名稱。此名稱會顯示在工作流程步驟中。要指定名稱：
1. 展開指令碼節點，按一下右鍵 jcr:content 節點，然後按一下 Mixins.
2. 新增 mix:title 在「編輯Mixin」對話方塊中，按一下「」屬性確定.
3. 將下列屬性新增至指令碼的jcr:content節點：
  
  名稱類型值
  
  jcr:title 字串指定指令碼的名稱。例如，選擇最接近的欄位代理。此名稱顯示在「分配任務」和「簽署文檔」步驟中。
4. 按一下 全部儲存. 指令碼可供AEM Workflow的元件中選取。

名稱	類型	值
jcr:title	字串	指定指令碼的名稱。例如，選擇最接近的欄位代理。此名稱顯示在「分配任務」和「簽署文檔」步驟中。

動態選擇用戶或組的ECMAScript示例

以下示例ECMAScript動態選擇「分配任務」步驟的受託人。在此指令碼中，會根據裝載的路徑選取使用者。使用此指令碼之前，請確定指令碼中提及的所有使用者都存在於AEM中。如果指令碼中提及的使用者不存在於AEM中，則相關程式可能會失敗。

function getParticipant() {

var workflowData = graniteWorkItem.getWorkflowData();

if (workflowData.getPayloadType() == "JCR_PATH") {

var path = workflowData.getPayload().toString();
     if (path.indexOf("/content/geometrixx/en") == 0) {
    return "user1";
    }
   else {
              return "user2";
            }
}
}

以下範例ECMAScript會動態選取Acrobat Sign步驟的受託人。使用以下指令碼之前，請確保指令碼中提及的用戶資訊（電子郵件地址和電話號碼）正確。如果指令碼中提及的使用者資訊不正確，則相關程式可能會失敗。

注意

使用ECMAScript for Acrobat Sign時，指令碼必須位於crx-repository（位於/apps/fd/workflow/scripts/adobesign/），且應具有名為getAdobeSignRecipients的函式，才能傳回使用者清單。

function getAdobeSignRecipients() {

    var recipientSetInfos = new Packages.java.util.ArrayList();

    var recipientInfoSet = new com.adobe.aem.adobesign.recipient.RecipientSetInfo();
    var recipientInfoList = new Packages.java.util.ArrayList();
    var recipientInfo = new com.adobe.aem.adobesign.recipient.RecipientInfo();

    var email;
    var recipientAuthenticationMethod = com.adobe.aem.adobesign.recipient.RecipientAuthenticationMethod.PHONE;
    //var recipientAuthenticationMethod = com.adobe.aem.adobesign.recipient.RecipientAuthenticationMethod.NONE;
    var securityOptions = null;

    var phoneNumber = "123456789";
    var countryCode = "+1";
    var recipientPhoneInfo = new Array();
    recipientPhoneInfo.push(new com.adobe.aem.adobesign.recipient.RecipientPhoneInfo(phoneNumber, countryCode));

     securityOptions = new com.adobe.aem.adobesign.recipient.RecipientSecurityOption(recipientAuthenticationMethod, recipientPhoneInfo , null);

    email = "example@example.com";

    recipientInfo.setEmail(email);
    recipientInfo.setSecurityOptions(securityOptions);

    recipientInfoList.add(recipientInfo);
    recipientInfoSet.setMemberInfos(recipientInfoList);
    recipientSetInfos.add(recipientInfoSet);

    return recipientSetInfos;

}

使用Java介面動態選擇用戶或組

您可以使用 RecipientInfoSpecifier Java介面，動態選擇用於Acrobat Sign的用戶或組並分配任務步驟。您可以建立使用的OSGi套件組合 RecipientInfoSpecifier Java介面並部署至AEM Forms伺服器。它可讓選項在AEM Workflow的「指派任務」和Acrobat Sign元件中供選取。

您需要 AEM Forms用戶端SDK 罐子花崗岩檔案來編譯下列程式碼範例。將這些jar檔案作為外部依賴項添加到OSGi捆綁項目。您可以使用任何Java IDE來建立OSGi套件組合。下列程式提供使用Eclipse建立OSGi套件組合的步驟：

開啟Eclipse IDE。導覽至檔案> 新增專案.
在選取精靈畫面上，選取 馬文專案，然後按一下 下一個.
在New Maven專案中，保留預設值，然後按一下 下一個. 選取原型並按一下 下一個. 例如， maven-archetype-quickstart。指定 群組Id, 工件ID, 版本，和套件，然後按一下完成. 專案隨即建立。

開啟pom.xml檔案以進行編輯，並以下列項目取代檔案的所有內容：

<project xmlns="https://maven.apache.org/POM/4.0.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>getAgent</groupId>
    <artifactId>assignToAgent</artifactId>
    <version>1.0</version>
    <packaging>bundle</packaging><!-- packaging type bundle is must -->

    <name>assignToAgent</name>
    <url>https://maven.apache.org</url>
    <repositories>
        <repository>
            <id>adobe</id>
            <name>Adobe Public Repository</name>
            <url>https://repo.adobe.com/nexus/content/groups/public/</url>
            <layout>default</layout>
        </repository>
    </repositories>
    <pluginRepositories>
        <pluginRepository>
            <id>adobe</id>
            <name>Adobe Public Repository</name>
            <url>https://repo.adobe.com/nexus/content/groups/public/</url>
            <layout>default</layout>
        </pluginRepository>
    </pluginRepositories>

    <dependencies>
        <dependency>
            <groupId>com.adobe.aemfd</groupId>
            <artifactId>aemfd-client-sdk</artifactId>
            <version>5.1.100</version>
        </dependency>
        <dependency>
            <groupId>com.adobe.granite</groupId>
            <artifactId>com.adobe.granite.workflow.api</artifactId>
            <version>1.0.0</version>
        </dependency>

        <dependency>
            <groupId>org.osgi</groupId>
            <artifactId>org.osgi.core</artifactId>
            <version>4.2.0</version>
            <scope>provided</scope>
        </dependency>

        <dependency>
            <groupId>org.apache.felix</groupId>
            <artifactId>org.apache.felix.scr.annotations</artifactId>
            <version>1.7.0</version>

        </dependency>

        <dependency>
            <groupId>org.apache.sling</groupId>
            <artifactId>org.apache.sling.api</artifactId>
            <version>2.2.0</version>

        </dependency>

    </dependencies>

    <!-- ====================================================================== -->
    <!-- B U I L D D E F I N I T I O N -->
    <!-- ====================================================================== -->
    <build>
        <plugins>

            <plugin>
                <groupId>org.apache.felix</groupId>
                <artifactId>maven-bundle-plugin</artifactId>
                <extensions>true</extensions>
                <configuration>
                    <instructions>
                        <Bundle-SymbolicName>com.aem.assigntoAgent-bundle</Bundle-SymbolicName>
                    </instructions>
                </configuration>
            </plugin>

            <plugin>
                <groupId>org.apache.felix</groupId>
                <artifactId>maven-scr-plugin</artifactId>
                <version>1.9.0</version>
                <executions>
                    <execution>
                        <id>generate-scr-descriptor</id>
                        <goals>
                            <goal>scr</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

</project>

新增使用的原始碼 RecipientInfoSpecifier Java介面，動態選擇「分配」任務步驟的用戶或組。如需程式碼範例，請參閱使用Java介面動態選擇使用者或群組的範例.
開啟命令提示字元，並導覽至包含OSGi套件專案的目錄。使用以下命令建立OSGi捆綁包：

mvn clean install
將套件組合上傳至AEM Forms伺服器。您可以使用AEM Package Manager將套件組合匯入AEM Forms伺服器。

匯入套件組合後，可在Acrobat Sign和「指派任務」步驟中使用選擇Java介面以動態選取使用者或群組的選項。

動態選擇使用者或群組的Java程式碼範例

下列范常式式碼會動態選擇Acrobat Sign步驟的受託人。您在OSGi套件中使用程式碼。使用下列程式碼之前，請確定程式碼中提及的使用者資訊（電子郵件地址和電話號碼）正確無誤。如果程式碼中提及的使用者資訊不正確，相關程式可能會失敗。

/*************************************************************************

 *
 * ADOBE CONFIDENTIAL
 * __________________
 *
 * Copyright 2016 Adobe Systems Incorporated
 * All Rights Reserved.
 *
 * NOTICE:  All information contained herein is, and remains
 * the property of Adobe Systems Incorporated and its suppliers,
 * if any.  The intellectual and technical concepts contained
 * herein are proprietary to Adobe Systems Incorporated and its
 * suppliers and are protected by trade secret or copyright law.
 * Dissemination of this information or reproduction of this material
 * is strictly forbidden unless prior written permission is obtained
 * from Adobe Systems Incorporated.
 **************************************************************************/

package com.aem.impl;

import java.util.ArrayList;
import java.util.List;

import com.adobe.aem.adobesign.recipient.RecipientAuthenticationMethod;
import com.adobe.aem.adobesign.recipient.RecipientInfo;
import com.adobe.aem.adobesign.recipient.RecipientPhoneInfo;
import com.adobe.aem.adobesign.recipient.RecipientSecurityOption;
import com.adobe.aem.adobesign.recipient.RecipientSetInfo;
import com.adobe.fd.workflow.adobesign.api.RecipientInfoSpecifier;
import com.adobe.granite.workflow.WorkflowException;
import com.adobe.granite.workflow.WorkflowSession;
import com.adobe.granite.workflow.exec.WorkItem;
import com.adobe.granite.workflow.metadata.MetaDataMap;
import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Service;

/**
 * <code>DummyRecipientInfoSpecifier implementation. A sample code to write implementation of RecipientInfoSpecifier to choose recipients/code>...
 */
@Service

@Component(metatype = false)
public class DummyRecipientChoser implements RecipientInfoSpecifier {
    public List<RecipientSetInfo> getAdobeSignRecipients(WorkItem workItem, WorkflowSession workflowSession, MetaDataMap args) throws WorkflowException {

        List<RecipientSetInfo> recipientSetInfos = new ArrayList<RecipientSetInfo>();

                //First Recipient

                RecipientSetInfo recipientInfoSet1 = new RecipientSetInfo();
                List<RecipientInfo> recipientInfoList = new ArrayList<RecipientInfo>();
                RecipientInfo recipientInfo1 = new RecipientInfo();//Member to first recipient

                String email;

                RecipientAuthenticationMethod recipientAuthenticationMethod = RecipientAuthenticationMethod.WEB_IDENTITY;
                RecipientSecurityOption securityOptions = null;

                String phoneNumber = "123456789";
                String countryCode = "+1";
                RecipientPhoneInfo[] recipientPhoneInfo = new RecipientPhoneInfo[1];  //if multiple phone numbers, size>1
                recipientPhoneInfo[0] = new RecipientPhoneInfo(phoneNumber, countryCode);
                securityOptions = new RecipientSecurityOption(recipientAuthenticationMethod, recipientPhoneInfo , null);

                email = "example@example.com";

                recipientInfo1.setEmail(email);
                recipientInfo1.setSecurityOptions(securityOptions);

                recipientInfoList.add(recipientInfo1);  //Add member

                recipientInfoSet1.setMemberInfos(recipientInfoList);

                //Second Recipient

                RecipientSetInfo recipientInfoSet2 = new RecipientSetInfo();
                List<RecipientInfo> recipientInfoList2 = new ArrayList<RecipientInfo>();

                recipientAuthenticationMethod = RecipientAuthenticationMethod.PHONE;
                securityOptions = null;

                phoneNumber = "987654321";//"0123456789";

                countryCode = "+1";
                RecipientPhoneInfo[] recipientPhoneInfo_1 = new RecipientPhoneInfo[1];
                recipientPhoneInfo_1[0] = new RecipientPhoneInfo(phoneNumber, countryCode);
                securityOptions = new RecipientSecurityOption(recipientAuthenticationMethod, recipientPhoneInfo_1 , null);

                email = "example2@example.com";//"dummymail2@domain.com";

                RecipientInfo recipientInfo2  = new RecipientInfo();
                recipientInfo2.setEmail(email);
                recipientInfo2.setSecurityOptions(securityOptions);

                recipientInfoList2.add(recipientInfo2);  //Add member

                recipientInfoSet2.setMemberInfos(recipientInfoList2);

                //*********************************

                recipientSetInfos.add(recipientInfoSet1);
                recipientSetInfos.add(recipientInfoSet2);

        return recipientSetInfos;

    }

}

Business.Adobe.com 資源

Ecommerce Integrations Targeted Content Asset Collections Managed Cloud Dynamic Media Headless Cms

動態選取以AEM Forms為中心的工作流程步驟的使用者或群組

使用ECMAScript動態選擇用戶或組

動態選擇用戶或組的ECMAScript示例

使用Java介面動態選擇用戶或組

動態選擇使用者或群組的Java程式碼範例

Business.Adobe.com 資源

本頁內容

檢視下一個:

學習

說明文件

社群

技術支援

資源

Adobe 帳戶

Adobe