以程式管理端點 programmatically-managing-endpoints

使用Java API新增EJB端點 adding-an-ejb-endpoint-using-the-java-api

使用Java API新增EJB端點：

包含專案檔案。

在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-livecycle-client.jar。 (
建立EndpointRegistry使用者端物件。
- 建立包含連線屬性的ServiceClientFactory物件。
- 使用它的建構函式並傳遞ServiceClientFactory物件來建立EndpointRegistryClient物件。
設定EJB端點屬性。
- 使用物件的建構函式建立CreateEndpointInfo物件。
- 叫用CreateEndpointInfo物件的setConnectorId方法並傳遞字串值EJB，以指定聯結器識別碼值。
- 透過叫用CreateEndpointInfo物件的setDescription方法並傳遞描述端點的字串值來指定端點的描述。
- 透過叫用CreateEndpointInfo物件的setName方法並傳遞指定名稱的字串值來指定端點的名稱。
- 透過叫用CreateEndpointInfo物件的setServiceId方法並傳遞指定服務名稱的字串值，來指定端點所屬的服務。
- 指定叫用CreateEndpointInfo物件的setOperationName方法所叫用的作業，並傳遞指定作業名稱的字串值。對於SOAP和EJB端點，請指定萬用字元( *)，這表示所有作業。
建立EJB端點。

透過叫用EndpointRegistryClient物件的createEndpoint方法並傳遞CreateEndpointInfo物件來建立端點。此方法會傳回代表新EJB端點的Endpoint物件。
啟用端點。

啟用端點，方法是叫用EndpointRegistryClient物件的enable方法並傳遞createEndpoint方法傳回的Endpoint物件。

另請參閱

快速入門：使用Java API新增EJB端點

新增SOAP端點 adding-soap-endpoints

您可以使用AEM Forms Java API，以程式設計方式將SOAP端點新增至服務。透過新增SOAP端點，您可以讓使用者端應用程式使用SOAP模式叫用服務。也就是說，在設定呼叫AEM Forms所需的連線屬性時，您可以選取SOAP模式。

NOTE

您無法使用網站服務新增SOAP端點。

NOTE

通常SOAP端點會依預設新增至服務。不過，SOAP端點可以新增至以程式設計方式部署的流程，或是SOAP端點移除後而必須重新新增的流程。

步驟摘要 summary_of_steps-1

若要將SOAP端點新增至服務，請執行下列工作：

包含專案檔案。
建立EndpointRegistryClient物件。
設定SOAP端點屬性。
建立SOAP端點。
啟用端點。

包含專案檔

在您的開發專案中包含必要的檔案。如果您使用Java建立使用者端應用程式，請包含必要的JAR檔案。如果您使用Web服務，請務必包含Proxy檔案。

必須將下列JAR檔案新增至專案的類別路徑：

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (如果將AEM Forms部署在JBoss Application Server上，則為必要)
jbossall-client.jar (如果AEM Forms部署在JBoss Application Server上，則為必要)

建立SOAP端點需要這些JAR檔案。不過，如果您使用SOAP端點來叫用服務，則需要額外的JAR檔案。如需AEM Forms JAR檔案的相關資訊，請參閱包含AEM Forms Java程式庫檔案。

建立EndpointRegistry使用者端物件

若要以程式設計方式將SOAP端點新增至服務，您必須建立EndpointRegistryClient物件。

設定SOAP端點屬性

若要將SOAP端點新增至服務，請指定下列值：

聯結器識別碼值：指定要建立的端點型別。若要建立SOAP端點，請指定SOAP。
描述：指定端點描述。
名稱：指定端點名稱。
服務識別碼值：指定端點所屬的服務。
作業名稱：指定使用端點叫用的作業名稱。建立SOAP端點時，請指定萬用字元( *)。不過，如果您要指定特定作業，而不是叫用所有服務作業，請指定作業的名稱，而不是使用萬用字元( *)。

建立SOAP端點

設定SOAP端點屬性後，即可建立SOAP端點。

啟用端點

建立端點後，您必須啟用它。端點啟用時，可用來叫用服務。啟用端點後，即可在管理主控台中檢視端點。

另請參閱

使用Java API新增SOAP端點

使用Java API新增SOAP端點 add-a-soap-endpoint-using-the-java-api

使用Java API新增SOAP端點至服務：

包含專案檔案。

在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-livecycle-client.jar。
建立EndpointRegistry使用者端物件。
- 建立包含連線屬性的ServiceClientFactory物件。
- 使用它的建構函式並傳遞ServiceClientFactory物件來建立EndpointRegistryClient物件。
設定SOAP端點屬性。
- 使用物件的建構函式建立CreateEndpointInfo物件。
- 叫用CreateEndpointInfo物件的setConnectorId方法並傳遞字串值SOAP，以指定聯結器識別碼值。
- 透過叫用CreateEndpointInfo物件的setDescription方法並傳遞描述端點的字串值來指定端點的描述。
- 透過叫用CreateEndpointInfo物件的setName方法並傳遞指定名稱的字串值來指定端點的名稱。
- 透過叫用CreateEndpointInfo物件的setServiceId方法並傳遞指定服務名稱的字串值，來指定端點所屬的服務。
- 指定叫用CreateEndpointInfo物件的setOperationName方法，並傳遞指定作業名稱的字串值，以叫用的作業。對於SOAP和EJB端點，請指定萬用字元( *)，這表示所有作業。
建立SOAP端點。

透過叫用EndpointRegistryClient物件的createEndpoint方法並傳遞CreateEndpointInfo物件來建立端點。此方法會傳回代表新SOAP端點的Endpoint物件。
啟用端點。

透過叫用EndpointRegistryClient物件的enable方法啟用端點，並傳遞createEndpoint方法傳回的Endpoint物件。

另請參閱

快速入門：使用Java API新增SOAP端點

新增Watched資料夾端點 adding-watched-folder-endpoints

您可以使用AEM Forms Java API，以程式設計方式將Watched資料夾端點新增至服務。透過新增Watched資料夾端點，您可以讓使用者將檔案(例如PDF檔案)放在資料夾中。將檔案放在資料夾中時，會叫用已設定的服務並操作檔案。服務執行指定的作業後，會將修改的檔案儲存在指定的輸出資料夾中。觀察資料夾已設定為以固定速率間隔或以cron排程掃描，例如每個星期一、星期三和星期五中午。

為了以程式設計方式將Watched資料夾端點新增至服務，請考慮下列名為 EncryptDocument 的短期程式。 (請參閱瞭解AEM Forms程式。)

aw_aw_encryptdocumentprocess

此程式接受不安全的PDF檔案作為輸入值，然後將不安全的PDF檔案傳遞給加密服務的EncryptPDFUsingPassword作業。 PDF檔案使用密碼加密，而密碼加密的PDF檔案是此程式的輸出值。輸入值的名稱(不安全的PDF檔案)是InDoc，資料型別是com.adobe.idp.Document。輸出值(密碼加密的PDF檔案)的名稱為SecuredDoc，資料型別為com.adobe.idp.Document。

NOTE

您無法使用Web服務新增Watched資料夾端點。

步驟摘要 summary_of_steps-2

若要將Watched資料夾端點新增至服務，請執行下列工作：

包含專案檔案。
建立EndpointRegistryClient物件。
設定Watched資料夾端點屬性。
指定設定值。
定義輸入引數值。
定義輸出引數值。
建立Watched資料夾端點。
啟用端點。

包含專案檔

在您的開發專案中包含必要的檔案。如果您使用Java建立使用者端應用程式，請包含必要的JAR檔案。如果您使用Web服務，請務必包含Proxy檔案。

必須將下列JAR檔案新增至專案的類別路徑：

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (如果將AEM Forms部署在JBoss Application Server上，則為必要)
jbossall-client.jar (如果AEM Forms部署在JBoss Application Server上，則為必要)

如需關於這些JAR檔案位置的資訊，請參閱包含AEM Forms Java程式庫檔案。

建立EndpointRegistry使用者端物件

若要以程式設計方式新增「監看資料夾」端點，您必須建立EndpointRegistryClient物件。

設定Watched資料夾端點屬性

若要為服務建立Watched資料夾端點，請指定下列值：

聯結器識別碼：指定已建立的端點型別。若要建立Watched資料夾端點，請指定WatchedFolder。
描述：指定端點的描述。
名稱：指定端點的名稱。
服務識別碼：指定端點所屬的服務。例如，若要將Watched資料夾端點新增至此區段中引進的處理（使用Workbench啟動時處理會變成服務），請指定EncryptDocument。
作業名稱：指定使用端點叫用的作業名稱。一般而言，針對源自於Workbench中建立之處理序的服務，建立Watched資料夾端點時，作業名稱為invoke。

指定組態值

以程式設計方式將Watched資料夾端點新增至服務時，請指定Watched資料夾端點的設定值。如果使用管理主控台新增Watched資料夾端點，則由管理員指定這些設定值。

下列清單指定以程式設計方式將Watched資料夾端點新增至服務時所設定的設定值：

url：指定watched資料夾位置。在叢集環境中，此值必須指向可從叢集中的每台電腦存取的共用網路資料夾。
非同步：將呼叫型別識別為非同步或同步。暫時和同步處理程式只能同步叫用。預設值為true。建議使用非同步。
cronExpression： Quartz用來排程輪詢輸入目錄。
purgeDuration：這是必要屬性。當結果資料夾中的檔案和資料夾早於此值時，就會清除這些檔案和資料夾。此值以天為單位測量。此屬性有助於確保結果資料夾不會填滿。值為–1天表示絕不刪除結果資料夾。預設值為 -1。
repeatInterval：掃描Watched資料夾以進行輸入的間隔（秒）。除非啟用節流功能，否則此值應超過處理平均作業的時間；否則，系統可能會變得超載。預設值為 5。
repeatCount： Watched資料夾掃描資料夾或目錄的次數。值–1表示無限掃描。預設值為 -1。
throttleOn：限制可在任何指定時間處理的Watched資料夾工作數目。最大作業數由batchSize值決定。
userName：從Watched資料夾叫用目標服務時使用的使用者名稱。此值為必填。預設值為SuperAdmin。
domainName：使用者的網域。此值為必填。預設值為DefaultDom。
batchSize：每次掃描要擷取的檔案或資料夾數目。使用此值可防止系統過載；一次掃描太多檔案可能會導致當機。預設值為 2。
waitTime：建立資料夾或檔案後，掃描資料夾或檔案前的等待時間（以毫秒為單位）。例如，如果等待時間為36,000,000毫秒（一小時），且檔案是在一分鐘前建立的，則系統會在59分鐘或更長時間後擷取此檔案。此屬性對於確保檔案或資料夾完全複製到輸入資料夾非常有用。例如，如果您有大型檔案要處理，且檔案下載需要10分鐘，請將等待時間設為10&amp；ast；60&amp；ast；1000毫秒。此設定可防止watched資料夾在等待十分鐘後掃描檔案。預設值為 0。
excludeFilePattern： watched資料夾用來判斷要掃描和擷取哪些檔案和資料夾的模式。任何具有此模式的檔案或資料夾都不會掃描以進行處理。當輸入是包含多個檔案的資料夾時，此設定非常有用。資料夾的內容可以複製到一個資料夾中，該資料夾的名稱將由watched資料夾擷取。此步驟可防止watched資料夾在資料夾完全複製到輸入資料夾之前擷取資料夾進行處理。例如，如果excludeFilePattern值為data*，則不會擷取符合data*的所有檔案和資料夾。這包括名為data1、data2等等的檔案和資料夾。此外，模式可附加萬用字元模式，以指定檔案模式。 Watched資料夾會修改規則運算式，以支援*.*和*.pdf等萬用字元模式。規則運算式不支援這些萬用字元模式。
includeFilePattern： watched資料夾用來判斷要掃描和擷取哪些資料夾和檔案的模式。例如，如果此值為*，則會擷取符合input*的所有檔案和資料夾。這包括名為input1、input2等等的檔案和資料夾。預設值為*。此值表示所有檔案和資料夾。此外，模式可附加萬用字元模式，以指定檔案模式。 Watched資料夾會修改規則運算式，以支援*.*和*.pdf等萬用字元模式。規則運算式不支援這些萬用字元模式。此值為必填。
resultFolderName：儲儲存存結果的資料夾。此位置可以是絕對或相對目錄路徑。如果結果未出現在此資料夾中，請檢查失敗資料夾。唯讀檔案不會處理，且會儲存在失敗資料夾中。預設值為result/%Y/%M/%D/。這是watched資料夾內的結果資料夾。
preserveFolderName：在成功掃描和擷取之後，儲存檔案的位置。此位置可以是絕對、相對或Null目錄路徑。預設值為 preserve/%Y/%M/%D/。
failureFolderName：儲存失敗檔案的資料夾。此位置永遠是相對於watched資料夾。唯讀檔案不會處理，且會儲存在失敗資料夾中。預設值為 failure/%Y/%M/%D/。
preserveOnFailure：如果服務執行作業失敗，則保留輸入檔案。預設值為true。
overwriteDuplicateFilename：設定為true時，會覆寫結果資料夾和保留資料夾中的檔案。設定為false時，名稱會使用具有數值索引尾碼的檔案和資料夾。預設值為false。

定義輸入引數值

建立Watched資料夾端點時，您必須定義輸入引數值。也就是說，您必須說明傳遞至watched資料夾所叫用之作業的輸入值。例如，請考量本主題中介紹的程式。它有一個名為InDoc的輸入值，其資料型別為com.adobe.idp.Document。當為此處理序建立Watched資料夾端點時（在處理序啟動後，它會變成服務），您必須定義輸入引數值。

若要定義Watched資料夾端點所需的輸入引數值，請指定下列值：

輸入引數名稱：輸入引數的名稱。在Workbench中為處理指定輸入值的名稱。如果輸入值屬於服務作業（不是在Workbench中建立的處理序的服務），則在component.xml檔案中指定輸入名稱。例如，此區段中引進之處理序的輸入引數名稱是InDoc。

對應型別：用來設定呼叫服務作業所需的輸入值。對應型別有兩種：

Literal： Watched資料夾端點使用在顯示的欄位中輸入的值。支援所有基本Java型別。例如，如果API使用字串、long、int和Boolean等輸入，則字串會轉換為正確型別並叫用服務。
Variable：輸入的值是watched資料夾用來挑選輸入的檔案模式。例如，如果您為對應型別選取「變數」，且輸入檔案必須是PDF檔案，則可以指定*.pdf作為對應值。

對應值：指定對應型別的值。例如，如果您選取Variable對應型別，則可以指定*.pdf做為檔案模式。

資料型別：指定輸入值的資料型別。例如，此區段中引進之程式之輸入值的資料型別為com.adobe.idp.Document。

定義輸出引數值

建立Watched資料夾端點時，您必須定義輸出引數值。也就是說，您必須說明由Watched資料夾端點叫用的服務所傳回的輸出值。例如，請考量本主題中介紹的程式。它有一個名為SecuredDoc的輸出值，其資料型別為com.adobe.idp.Document。當為此處理序建立Watched資料夾端點時（在處理序啟動後，它會變成服務），您必須定義輸出引數值。

若要定義Watched資料夾端點所需的輸出引數值，請指定下列值：

輸出引數名稱：輸出引數的名稱。在Workbench中指定處理輸出值的名稱。如果輸出值屬於服務作業（不是在Workbench中建立的處理作業）時，會在component.xml檔案中指定輸出名稱。例如，此區段中引進之處理序的輸出引數名稱是SecuredDoc。

對應型別：用來設定服務和操作的輸出。下列選項可供使用：

如果服務傳回單一物件（單一檔案），則模式為%F.pdf，而來源目的地為sourcefilename.pdf。例如，本節介紹的程式會傳回單一檔案。因此，對應型別可以定義為%F.pdf （ %F表示使用指定的檔案名稱）。模式%E指定輸入檔案的副檔名。
如果服務傳回清單，則模式為Result\%F\，來源目的地為Result\sourcefilename\source1 （輸出1）和Result\sourcefilename\source2 （輸出2）。
如果服務傳回對應，則模式為Result\%F\，來源目的地為Result\sourcefilename\file1和Result\sourcefilename\file2。如果對應有多個物件，則模式為Result\%F.pdf，而來源目的地為Result\sourcefilename1.pdf （輸出1）、Result\sourcefilenam2.pdf （輸出2）等等。

資料型別：指定傳回值的資料型別。例如，此區段中引進之處理序的傳回值資料型別為com.adobe.idp.Document。

建立Watched資料夾端點

在您設定端點的屬性、組態值以及定義輸入和輸出引數值之後，您必須建立Watched資料夾端點。

啟用端點

建立Watched資料夾端點之後，您必須啟用它。端點啟用時，可用來叫用服務。啟用端點後，即可在管理主控台中檢視它。

另請參閱

使用Java API新增Watched資料夾端點

使用Java API新增Watched資料夾端點 add-a-watched-folder-endpoint-using-the-java-api

使用AEM Forms Java API新增Watched資料夾端點：

包含專案檔案。

在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-livecycle-client.jar。
建立EndpointRegistry使用者端物件。
- 建立包含連線屬性的ServiceClientFactory物件。
- 使用它的建構函式並傳遞ServiceClientFactory物件來建立EndpointRegistryClient物件。
設定Watched資料夾端點屬性。
- 使用物件的建構函式建立CreateEndpointInfo物件。
- 叫用CreateEndpointInfo物件的setConnectorId方法並傳遞字串值WatchedFolder，以指定聯結器識別碼值。
- 透過叫用CreateEndpointInfo物件的setDescription方法並傳遞描述端點的字串值來指定端點的描述。
- 透過叫用CreateEndpointInfo物件的setName方法並傳遞指定名稱的字串值來指定端點的名稱。
- 透過叫用CreateEndpointInfo物件的setServiceId方法並傳遞指定服務名稱的字串值，來指定端點所屬的服務。
- 指定叫用CreateEndpointInfo物件的setOperationName方法，並傳遞指定作業名稱的字串值，以叫用的作業。通常，在為源自於Workbench中建立的程式之服務建立Watched資料夾端點時，會叫用操作的名稱。

指定設定值。

對於要為Watched資料夾端點設定的每個設定值，您必須叫用CreateEndpointInfo物件的setConfigParameterAsText方法。例如，若要設定url組態值，請叫用CreateEndpointInfo物件的setConfigParameterAsText方法，並傳遞下列字串值：

字串值，指定組態值的名稱。設定url組態值時，請指定url。
字串值，指定設定值的值。設定url設定值時，請指定watched資料夾位置。

note note
NOTE
若要檢視為EncryptDocument服務設定的所有設定值，請參閱位於QuickStart：使用Java API新增Watched資料夾端點的Java程式碼範例。

定義輸入引數值。

透過叫用CreateEndpointInfo物件的setInputParameterMapping方法定義輸入引數值，並傳遞下列值：

字串值，指定輸入引數的名稱。例如，EncryptDocument服務的輸入引數名稱是InDoc。
字串值，指定輸入引數的資料型別。例如，InDoc輸入引數的資料型別是com.adobe.idp.Document。
字串值，指定對應型別。例如，您可以指定variable。
字串值，指定對應型別值。例如，您可以指定&amp；ast；.pdf作為檔案模式。

note note
NOTE
叫用每個要定義的輸入引數值的`setInputParameterMapping`方法。由於EncryptDocument程式只有一個輸入引數，因此您需要叫用此方法一次。

定義輸出引數值。

透過叫用CreateEndpointInfo物件的setOutputParameterMapping方法定義輸出引數值，並傳遞下列值：
- 字串值，指定輸出引數的名稱。例如，EncryptDocument服務的輸出引數名稱是SecuredDoc。
- 字串值，指定輸出引數的資料型別。例如，SecuredDoc輸出引數的資料型別為com.adobe.idp.Document。
- 字串值，指定對應型別。例如，您可以指定%F.pdf。
建立Watched資料夾端點。

透過叫用EndpointRegistryClient物件的createEndpoint方法並傳遞CreateEndpointInfo物件來建立端點。此方法會傳回代表Watched資料夾端點的Endpoint物件。
啟用端點。

啟用端點，方法是叫用EndpointRegistryClient物件的enable方法，並傳遞createEndpoint方法傳回的Endpoint物件。

另請參閱

快速入門：使用Java API新增Watched資料夾端點

Watched資料夾組態值常數檔案 watched-folder-configuration-values-constant-file

QuickStart：使用Java API新增Watched資料夾端點，使用必須是Java專案一部分的常數檔案來編譯快速入門。此常數檔案代表新增Watched資料夾端點時必須設定的組態值。下列Java程式碼代表常數檔案。

 /**
     * This class contains constants that can be used when setting Watched Folder
     * configuration values
     */

 public final class WatchedFolderEndpointConfigConstants {

         public static final String PROPERTY_FILEPROVIDER_URL = "url";
         public static final String PROPERTY_PROPERTY_ASYNCHRONOUS = "asynchronous";
         public static final String PROPERTY_CRON_EXPRESSION = "cronExpression";
         public static final String PROPERTY_PURGE_DURATION = "purgeDuration";
         public static final String PROPERTY_REPEAT_INTERVAL = "repeatInterval";
         public static final String PROPERTY_REPEAT_COUNT = "repeatCount";
         public static final String PROPERTY_THROTTLE = "throttleOn";
         public static final String PROPERTY_USERNAMER = "userName";
         public static final String PROPERTY_DOMAINNAME = "domainName";
         public static final String PROPERTY_FILEPROVIDER_BATCH_SIZE = "batchSize";
         public static final String PROPERTY_FILEPROVIDER_WAIT_TIME = "waitTime";
         public static final String PROPERTY_EXCLUDE_FILE_PATTERN = "excludeFilePattern";
         public static final String PROPERTY_INCLUDE_FILE_PATTERN = "excludeFilePattern";
         public static final String PROPERTY_FILEPROVIDER_RESULT_FOLDER_NAME =  "resultFolderName";
         public static final String PROPERTY_FILEPROVIDER_PRESERVE_FOLDER_NAME = "preserveFolderName";
         public static final String PROPERTY_FILEPROVIDER_FAILURE_FOLDER_NAME = "failureFolderName";
         public static final String PROPERTY_FILEPROVIDER_PRESERVE_ON_FAILURE = "preserveOnFailure";
         public static final String PROPERTY_FILEPROVIDER_OVERWRITE_DUPLICATE_FILENAME = "overwriteDuplicateFilename";
        }

新增電子郵件端點 adding-email-endpoints

您可以使用AEM Forms Java API，以程式設計方式將電子郵件端點新增至服務。透過新增電子郵件端點，您可以讓使用者將包含一或多個檔案附件的電子郵件訊息傳送至指定的電子郵件帳戶。然後會叫用設定服務操作並操作檔案。服務執行指定的作業後，會傳送電子郵件訊息給寄件者，其中包含已修改的檔案作為檔案附件。

為了以程式設計方式將電子郵件端點新增至服務，請考慮下列名為 MyApplication\EncryptDocument 的短期處理序。如需有關短期處理程式的資訊，請參閱瞭解AEM Forms處理程式。

ae_ae_encryptdocumentprocess

此程式接受不安全的PDF檔案作為輸入值，然後將不安全的PDF檔案傳遞給加密服務的EncryptPDFUsingPassword作業。此程式會使用密碼加密PDF檔案，並傳回密碼加密的PDF檔案作為輸出值。輸入值的名稱(不安全的PDF檔案)是InDoc，資料型別是com.adobe.idp.Document。輸出值(密碼加密的PDF檔案)的名稱為SecuredDoc，資料型別為com.adobe.idp.Document。

NOTE

您無法使用網站服務來新增電子郵件端點。

步驟摘要 summary_of_steps-3

若要將電子郵件端點新增至服務，請執行下列工作：

包含專案檔案。
建立EndpointRegistryClient物件。
設定電子郵件端點屬性。
指定設定值。
定義輸入引數值。
定義輸出引數值。
建立電子郵件端點。
啟用端點。

包含專案檔

在您的開發專案中包含必要的檔案。如果您使用Java建立使用者端應用程式，請包含必要的JAR檔案。如果您使用Web服務，請務必包含Proxy檔案。

必須將下列JAR檔案新增至專案的類別路徑：

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (如果將AEM Forms部署在JBoss Application Server上，則為必要)
jbossall-client.jar (如果AEM Forms部署在JBoss Application Server上，則為必要)

如需關於這些JAR檔案位置的資訊，請參閱包含AEM Forms Java程式庫檔案。

建立EndpointRegistry使用者端物件

您必須先建立EndpointRegistryClient物件，才能以程式設計方式新增電子郵件端點。

設定電子郵件端點屬性

若要建立服務的電子郵件端點，請指定下列值：

聯結器識別碼值：指定已建立的端點型別。若要建立電子郵件端點，請指定Email。
描述：指定端點的描述。
名稱：指定端點的名稱。
服務識別碼值：指定端點所屬的服務。例如，若要將電子郵件端點新增至本節中介紹的程式（使用Workbench啟動時程式會變成服務），請指定EncryptDocument。
作業名稱：指定使用端點叫用的作業名稱。一般而言，針對源自於Workbench中建立之處理序的服務建立電子郵件端點時，作業名稱為invoke。

指定組態值

以程式設計方式將電子郵件端點新增至服務時，指定電子郵件端點的設定值。如果使用管理主控台新增電子郵件端點，則管理員會指定這些設定值。

NOTE

受監控的電子郵件帳戶是僅用於電子郵件端點的特殊帳戶。此帳戶不是一般使用者的電子郵件帳戶。一般使用者的電子郵件帳戶不可設定為電子郵件提供者使用的帳戶，因為電子郵件提供者在完成郵件處理之後，會從收件匣中刪除電子郵件訊息。

以程式設計方式將電子郵件端點新增至服務時，會設定下列設定值：

cronExpression：如果電子郵件必須使用cron運算式排程，則為cron運算式。
repeatCount：電子郵件端點掃描資料夾或目錄的次數。值–1表示無限掃描。預設值為 -1。
repeatInterval：接收者用來檢查內送郵件的掃描速率（秒）。預設值為 10。
startDelay：排程器啟動後等待掃描的時間。預設時間為0。
batchSize：接收者每次掃描所處理的電子郵件訊息數目，以獲得最佳效能。值–1表示所有電子郵件。預設值為 2。
userName：從電子郵件叫用目標服務時使用的使用者名稱。預設值為 SuperAdmin。
domainName：必要的設定值。預設值為 DefaultDom。
domainPattern：指定提供者接受的傳入電子郵件的網域模式。例如，如果使用adobe.com，則只會處理來自adobe.com的電子郵件，而會忽略來自其他網域的電子郵件。
filePattern：指定提供者接受的傳入檔案附件模式。這包括具有特定副檔名(&amp；ast；.dat、&amp；ast；.xml)的檔案、具有特定名稱（資料）的檔案，以及具有名稱與副檔名複合運算式的檔案(&amp；ast；)。[d][aA]'連線埠')。預設值為 *。
recipientSuccessfulJob：傳送訊息以指示成功工作的電子郵件地址。依預設，成功的工作訊息一律會傳送給寄件者。如果您輸入sender，電子郵件結果會傳送給寄件者。最多可支援100個收件者。使用電子郵件地址指定其他收件者，每個收件者之間以逗號分隔。若要關閉此選項，請將此值留空。某些情況下，您可能想要觸發程式，而不想收到結果的電子郵件通知。預設值為 sender。
recipientFailedJob：傳送訊息以指出工作失敗的電子郵件地址。依預設，失敗的工作訊息一律會傳送給寄件者。如果您輸入sender，電子郵件結果會傳送給寄件者。最多可支援100個收件者。使用電子郵件地址指定其他收件者，每個收件者之間以逗號分隔。若要關閉此選項，請將此值留空。預設值為 sender。
收件匣主機：要掃描的電子郵件提供者的收件匣主機名稱或IP位址。
收件匣連線埠：電子郵件伺服器使用的連線埠。 POP3的預設值為110，IMAP的預設值為143。如果啟用SSL，POP3的預設值為995，IMAP的預設值為993。
inboxProtocol：電子郵件端點用來掃描收件匣的電子郵件通訊協定。選項為IMAP或POP3。收件匣主機郵件伺服器必須支援這些通訊協定。
inboxTimeOut：電子郵件提供者等候收件匣回應的逾時秒數。預設值為 60。
inboxUser：登入電子郵件帳戶所需的使用者名稱。視電子郵件伺服器和設定而定，這可能只是電子郵件的使用者名稱部分，也可能是完整的電子郵件地址。
收件匣密碼：收件匣使用者的密碼。
inboxSSLEnabled：設定此值，以強制電子郵件提供者在傳送結果或錯誤的通知訊息時使用SSL。請確定IMAP或POP3主機支援SSL。
smtpHost：電子郵件提供者傳送結果和錯誤訊息的目標郵件伺服器的主機名稱。
smtpPort： SMTP連線埠的預設值為25。
smtpUser：電子郵件提供者傳送結果和錯誤的電子郵件通知時要使用的使用者帳戶。
smtpPassword： SMTP帳戶的密碼。有些郵件伺服器不需要SMTP密碼。
charSet：電子郵件提供者使用的字元集。預設值為 UTF-8。
smtpSSLEnabled：設定此值，以強制電子郵件提供者在傳送結果或錯誤的通知訊息時使用SSL。請確定SMTP主機支援SSL。
failedJobFolder：指定當SMTP郵件伺服器無法運作時，要儲存結果的目錄。
非同步：設定為同步時，會處理所有輸入檔案並傳回單一回應。設為非同步時，系統會針對每個已處理的輸入檔案傳送回應。例如，會針對本主題中介紹的流程建立電子郵件端點，並傳送電子郵件訊息至端點的收件匣，其中包含多個不安全的PDF檔案。當所有PDF檔案都使用密碼加密時，如果端點設定為同步，則會傳送單一回應電子郵件訊息並附加所有安全PDF檔案。如果端點設定為非同步，則會為每個安全PDF檔案傳送個別的回應電子郵件訊息。每封電子郵件都包含單一PDF檔案作為附件。預設值為非同步。

定義輸入引數值

建立電子郵件端點時，您必須定義輸入引數值。也就是說，您必須說明傳遞至電子郵件端點所叫用之作業的輸入值。例如，請考量本主題中介紹的程式。它有一個名為InDoc的輸入值，其資料型別為com.adobe.idp.Document。為此流程建立電子郵件端點時（流程啟動後，就會變成服務），您必須定義輸入引數值。

若要定義電子郵件端點所需的輸入引數值，請指定下列值：

輸入引數名稱：輸入引數的名稱。在Workbench中為處理指定輸入值的名稱。如果輸入值屬於服務操作(不是在Workbench中建立之程式的Forms服務)，則輸入名稱會在component.xml檔案中指定。例如，此區段中引進之處理序的輸入引數名稱是InDoc。

對應型別：用來設定呼叫服務作業所需的輸入值。兩種對應型別如下：

Literal：電子郵件端點使用在顯示的欄位中輸入的值。支援所有基本Java型別。例如，如果API使用字串、long、int和Boolean等輸入，則字串會轉換為正確型別並叫用服務。
Variable：輸入的值是電子郵件端點用來挑選輸入的檔案模式。例如，如果您為對應型別選取「變數」，且輸入檔案必須是PDF檔案，則可以指定*.pdf作為對應值。

對應值：指定對應型別的值。例如，如果您選取變數對應型別，則可以指定*.pdf做為檔案模式。

資料型別：指定輸入值的資料型別。例如，本節介紹之程式的輸入值的資料型別為com.adobe.idp.Document。

定義輸出引數值

建立電子郵件端點時，您必須定義輸出引數值。也就是說，您必須說明由電子郵件端點叫用的服務傳回的輸出值。例如，請考量本主題中介紹的程式。它有一個名為SecuredDoc的輸出值，其資料型別為com.adobe.idp.Document。為此流程建立電子郵件端點時（流程啟動後，就會變成服務），您必須定義輸出引數值。

若要定義電子郵件端點所需的輸出引數值，請指定下列值：

對應型別：用來設定服務和操作的輸出。下列選項可供使用：

如果服務傳回單一物件（單一檔案），則模式為%F.pdf，而來源目的地為sourcefilename.pdf。例如，本節介紹的程式會傳回單一檔案。因此，對應型別可以定義為%F.pdf （ %F表示使用指定的檔案名稱）。模式%E指定輸入檔案的副檔名。
如果服務傳回清單，則模式為Result\%F\，來源目的地為Result\sourcefilename\source1 （輸出1）和Result\sourcefilename\source2 （輸出2）。
如果服務傳回對應，則模式為Result\%F\，來源目的地為Result\sourcefilename\file1和Result\sourcefilename\file2。如果對應有多個物件，則模式為Result\%F.pdf，而來源目的地為Result\sourcefilename1.pdf （輸出1）、Result\sourcefilenam2.pdf （輸出2）等等。

資料型別：指定傳回值的資料型別。例如，此區段中引進之處理序的傳回值資料型別為com.adobe.idp.Document。

建立電子郵件端點

設定電子郵件端點屬性和設定值，並定義輸入和輸出引數值後，您必須建立電子郵件端點。

啟用端點

建立電子郵件端點後，您必須啟用它。端點啟用時，可用來叫用服務。啟用端點後，即可在管理主控台中檢視它。

另請參閱

使用Java API新增電子郵件端點

使用Java API新增電子郵件端點 add-an-email-endpoint-using-the-java-api

使用Java API新增電子郵件端點：

包含專案檔案。

在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-livecycle-client.jar。
建立EndpointRegistry使用者端物件。
- 建立包含連線屬性的ServiceClientFactory物件。
- 使用它的建構函式並傳遞ServiceClientFactory物件來建立EndpointRegistryClient物件。
設定電子郵件端點屬性。
- 使用物件的建構函式建立CreateEndpointInfo物件。
- 叫用CreateEndpointInfo物件的setConnectorId方法並傳遞字串值Email，以指定聯結器識別碼值。
- 透過叫用CreateEndpointInfo物件的setDescription方法並傳遞描述端點的字串值來指定端點的描述。
- 透過叫用CreateEndpointInfo物件的setName方法並傳遞指定名稱的字串值來指定端點的名稱。
- 透過叫用CreateEndpointInfo物件的setServiceId方法並傳遞指定服務名稱的字串值，來指定端點所屬的服務。
- 指定叫用CreateEndpointInfo物件的setOperationName方法，並傳遞指定作業名稱的字串值，以叫用的作業。一般而言，在為源自於Workbench中建立之程式的服務建立電子郵件端點時，會叫用操作的名稱。

指定設定值。

您必須叫用CreateEndpointInfo物件的setConfigParameterAsText方法，才能為電子郵件端點設定每個組態值。例如，若要設定smtpHost組態值，請叫用CreateEndpointInfo物件的setConfigParameterAsText方法，並傳遞下列值：

字串值，指定組態值的名稱。設定smtpHost組態值時，請指定smtpHost。
字串值，指定設定值的值。設定smtpHost組態值時，請指定字串值，以指定SMTP伺服器的名稱。

note note
NOTE
若要檢視在本節中介紹的EncryptDocument服務設定的所有設定值，請參閱位於QuickStart：使用Java API新增電子郵件端點的Java程式碼範例。

定義輸入引數值。

透過叫用CreateEndpointInfo物件的setInputParameterMapping方法定義輸入引數值，並傳遞下列值：

字串值，指定輸入引數的名稱。例如，EncryptDocument服務的輸入引數名稱是InDoc。
字串值，指定輸入引數的資料型別。例如，InDoc輸入引數的資料型別是com.adobe.idp.Document。
字串值，指定對應型別。例如，您可以指定variable。
字串值，指定對應型別值。例如，您可以指定&amp；ast；.pdf作為檔案模式。

note note
NOTE
叫用每個要定義的輸入引數值的`setInputParameterMapping`方法。由於EncryptDocument程式只有一個輸入引數，因此您需要叫用此方法一次。

定義輸出引數值。

透過叫用CreateEndpointInfo物件的setOutputParameterMapping方法並傳遞下列值來定義輸出引數值：
- 字串值，指定輸出引數的名稱。例如，EncryptDocument服務的輸出引數名稱是SecuredDoc。
- 字串值，指定輸出引數的資料型別。例如，SecuredDoc輸出引數的資料型別為com.adobe.idp.Document。
- 字串值，指定對應型別。例如，您可以指定%F.pdf。
建立電子郵件端點。

透過叫用EndpointRegistryClient物件的createEndpoint方法並傳遞CreateEndpointInfo物件來建立端點。此方法會傳回代表電子郵件端點的Endpoint物件。
啟用端點。

啟用端點，方法是叫用EndpointRegistryClient物件的enable方法，並傳遞createEndpoint方法傳回的Endpoint物件。

另請參閱

快速入門：使用Java API新增Watched資料夾端點

電子郵件設定值常數檔案 email-configuration-values-constant-file

QuickStart：使用Java API新增電子郵件端點，會使用必須屬於Java專案一部分的常數檔案來編譯快速入門。此常數檔案代表新增電子郵件端點時必須設定的設定值。下列Java程式碼代表常數檔案。

 /**
     * This class contains constants that can be used when setting email endpoint
     * configuration values
     */
 public class EmailEndpointConfigConstants {

     public static final String PROPERTY_EMAILPROVIDER_CRON_EXPRESSION = "cronExpression";
     public static final String PROPERTY_EMAILPROVIDER_REPREAT_COUNT = "repeatCount";
     public static final String PROPERTY_EMAILPROVIDER_REPREAT_INTERVAL = "repeatInterval";
     public static final String PROPERTY_EMAILPROVIDER_START_DELAY = "startDelay";
     public static final String PROPERTY_EMAILPROVIDER_BATCH_SIZE = "batchSize";
     public static final String PROPERTY_EMAILPROVIDER_USERNAME = "userName";
     public static final String PROPERTY_EMAILPROVIDER_DOMAINNAME = "domainName";
     public static final String PROPERTY_EMAILPROVIDER_DOMAINPATTERN = "domainPattern";
     public static final String PROPERTY_EMAILPROVIDER_FILEPATTERN = "filePattern";
     public static final String PROPERTY_EMAILPROVIDER_RECIPIENT_SUCCESSFUL_JOB = "recipientSuccessfulJob";
     public static final String PROPERTY_EMAILPROVIDER_RECIPIENT_FAILED_JOB = "recipientFailedJob";
     public static final String PROPERTY_EMAILPROVIDER_INBOX_HOST = "inboxHost";
     public static final String PROPERTY_EMAILPROVIDER_INBOX_PORT = "inboxPort";
     public static final String PROPERTY_EMAILPROVIDER_PROTOCOL = "inboxProtocol";
     public static final String PROPERTY_EMAILPROVIDER_INBOX_TIMEOUT = "inboxTimeOut";
     public static final String PROPERTY_EMAILPROVIDER_INBOX_USER = "inboxUser";
     public static final String PROPERTY_EMAILPROVIDER_INBOX_PASSWORD = "inboxPassword";
     public static final String PROPERTY_EMAILPROVIDER_INBOX_SSL = "inboxSSLEnabled";
     public static final String PROPERTY_EMAILPROVIDER_SMTP_HOST = "smtpHost";
     public static final String PROPERTY_EMAILPROVIDER_SMTP_PORT = "smtpPort";
     public static final String PROPERTY_EMAILPROVIDER_SMTP_USER = "smtpUser";
     public static final String PROPERTY_EMAILPROVIDER_SMTP_PASSWORD = "smtpPassword";
     public static final String PROPERTY_EMAILPROVIDER_CHARSET = "charSet";
     public static final String PROPERTY_EMAILPROVIDER_SMTP_SSL = "smtpSSLEnabled";
     public static final String PROPERTY_EMAILPROVIDER_FAILED_FOLDER = "failedJobFolder";
     public static final String PROPERTY_EMAILPROVIDER_ASYNCHRONOUS = "asynchronous";
 }

新增遠端端點 adding-remoting-endpoints

NOTE

JEE版的AEM表單已棄用LiveCycle Remoting API。

您可以使用AEM Forms Java API，以程式設計方式將遠端端點新增至服務。透過新增遠端端點，您可以啟用Flex應用程式以使用遠端來叫用服務。 (請參閱使用叫用AEM Forms (AEM表單已棄用) AEM Forms Remoting。)

為了以程式設計方式將Remoting端點新增至服務，請考慮下列名為 EncryptDocument 的短期程式。

ar_ar_encryptdocumentprocess

為了示範如何將Remoting端點新增至服務，本節將Remoting端點新增至名為EncryptDocument的服務。

NOTE

您無法使用Web服務來新增遠端端點。

步驟摘要 summary_of_steps-4

若要從服務移除端點，請執行下列工作：

包含專案檔案。
建立EndpointRegistryClient物件。
設定遠端端點屬性。
建立遠端端點。
啟用端點。

包含專案檔

在您的開發專案中包含必要的檔案。如果您使用Java建立使用者端應用程式，請包含必要的JAR檔案。如果您使用Web服務，請務必包含Proxy檔案。

必須將下列JAR檔案新增至專案的類別路徑：

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (如果將AEM Forms部署在JBoss Application Server上，則為必要)
jbossall-client.jar (如果AEM Forms部署在JBoss Application Server上，則為必要)

如需關於這些JAR檔案位置的資訊，請參閱包含AEM Forms Java程式庫檔案。

建立EndpointRegistry使用者端物件

若要以程式設計方式新增遠端端點，您必須建立EndpointRegistryClient物件。

設定遠端端點屬性

若要建立服務的Remoting端點，請指定下列值：

聯結器識別碼值：指定已建立的端點型別。若要建立遠端端點，請指定Remoting。
描述：指定端點的描述。
名稱：指定端點的名稱。
服務識別碼值：指定端點所屬的服務。例如，若要將Remoting端點新增至本節中介紹的處理序（在Workbench中啟動某個處理序時，該處理序就會變成服務），請指定EncryptDocument。
作業名稱：指定使用端點叫用的作業名稱。建立遠端端點時，請指定萬用字元(&amp；ast；)。

建立遠端端點

設定Remoting端點屬性之後，您就可以為服務建立Remoting端點。

啟用端點

建立端點後，您必須啟用它。遠端端點啟用時，可讓Flex使用者端叫用服務。

另請參閱

使用Java API新增遠端端點

使用Java API新增遠端端點 add-a-remoting-endpoint-using-the-java-api

使用Java API新增Remoting端點：

包含專案檔案。

在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-livecycle-client.jar。
建立EndpointRegistry使用者端物件。
- 建立包含連線屬性的ServiceClientFactory物件。
- 使用它的建構函式並傳遞ServiceClientFactory物件來建立EndpointRegistryClient物件。
設定遠端端點屬性。
- 使用物件的建構函式建立CreateEndpointInfo物件。
- 叫用CreateEndpointInfo物件的setConnectorId方法並傳遞字串值Remoting，以指定聯結器識別碼值。
- 透過叫用CreateEndpointInfo物件的setDescription方法並傳遞描述端點的字串值來指定端點的描述。
- 透過叫用CreateEndpointInfo物件的setName方法並傳遞指定名稱的字串值來指定端點的名稱。
- 透過叫用CreateEndpointInfo物件的setServiceId方法並傳遞指定服務名稱的字串值，來指定端點所屬的服務。
- 指定由CreateEndpointInfo物件的setOperationName方法呼叫的作業，並傳遞指定作業名稱的字串值。對於遠端端點，請指定萬用字元(&amp；ast；)。
建立遠端端點。

透過叫用EndpointRegistryClient物件的createEndpoint方法並傳遞CreateEndpointInfo物件來建立端點。此方法傳回代表新遠端端點的Endpoint物件。
啟用端點。

啟用端點，方法是叫用EndpointRegistryClient物件的enable方法，並傳遞createEndpoint方法傳回的Endpoint物件。

另請參閱

快速入門：使用Java API新增遠端端點

使用Java API新增TaskManager端點

新增TaskManager端點 adding-taskmanager-endpoints

您可以使用AEM Forms Java API，以程式設計方式將TaskManager端點新增至服務。透過將TaskManager端點新增至服務，您可以讓Workspace使用者叫用該服務。也就是說，在Workspace中工作的使用者可以叫用具有對應TaskManager端點的程式。

NOTE

您無法使用Web服務新增TaskManager端點。

步驟摘要 summary_of_steps-5

若要將TaskManager端點新增至服務，請執行下列工作：

包含專案檔案。
建立EndpointRegistryClient物件。
為端點建立類別。
設定TaskManager端點屬性。
建立TaskManager端點。
啟用端點。

包含專案檔

在您的開發專案中包含必要的檔案。如果您使用Java建立使用者端應用程式，請包含必要的JAR檔案。如果您使用Web服務，請務必包含Proxy檔案。

必須將下列JAR檔案新增至專案的類別路徑：

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (如果將AEM Forms部署在JBoss Application Server上，則為必要)
jbossall-client.jar (如果AEM Forms部署在JBoss Application Server上，則為必要)

如需關於這些JAR檔案位置的資訊，請參閱包含AEM Forms Java程式庫檔案。

建立EndpointRegistry使用者端物件

您必須先建立EndpointRegistryClient物件，才能以程式設計方式新增TaskManager端點。

為端點建立類別

類別是用來在Workspace中組織服務。也就是說，Workspace使用者可以在Workspace中選取類別，叫用具有TaskManager端點的服務。建立TaskManager端點時，您可以參照現有類別或以程式設計方式建立類別。

NOTE

本節會建立TaskManager端點新增至服務的新類別。

設定TaskManager端點屬性

若要建立服務的TaskManager端點，請指定下列值：

聯結器識別碼：指定已建立的端點型別。若要建立TaskManager端點，請指定TaskManagerConnector。
描述：指定端點的描述。
名稱：指定端點的名稱。
服務識別碼：指定端點所屬的服務。
類別：指定與TaskManager端點關聯的類別識別碼值。
作業名稱：一般而言，為源自於Workbench中建立之處理序的服務建立TaskManager端點時，作業名稱為invoke。

建立TaskManager端點

設定TaskManager端點屬性之後，就可以為服務建立TaskManager端點。

啟用端點

建立端點後，您必須啟用它。端點啟用時，可用來從Workspace內叫用服務。啟用端點後，即可在管理主控台中檢視它。

另請參閱

使用Java API新增TaskManager端點 add-a-taskmanager-endpoint-using-the-java-api

使用Java API新增TaskManager端點：

包含專案檔案。

在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-livecycle-client.jar。
建立EndpointRegistry使用者端物件。
- 建立包含連線屬性的ServiceClientFactory物件。
- 使用它的建構函式並傳遞ServiceClientFactory物件來建立EndpointRegistryClient物件。
為端點建立類別。
- 使用物件的建構函式並傳遞下列值來建立CreateEndpointCategoryInfo物件：
  - 字串值，指定類別的識別碼值
  - 字串值，指定類別的說明
- 叫用EndpointRegistryClient物件的createEndpointCategory方法並傳遞CreateEndpointCategoryInfo物件以建立類別。此方法會傳回代表新類別的EndpointCategory物件。
設定TaskManager端點屬性。
- 使用物件的建構函式建立CreateEndpointInfo物件。
- 叫用CreateEndpointInfo物件的setConnectorId方法並傳遞字串值TaskManagerConnector，以指定聯結器識別碼值。
- 透過叫用CreateEndpointInfo物件的setDescription方法並傳遞描述端點的字串值來指定端點的描述。
- 透過叫用CreateEndpointInfo物件的setName方法並傳遞指定名稱的字串值來指定端點的名稱。
- 透過叫用CreateEndpointInfo物件的setServiceId方法並傳遞指定服務名稱的字串值，來指定端點所屬的服務。
- 透過叫用CreateEndpointInfo物件的setCategoryId方法並傳遞指定類別識別碼值的字串值，來指定端點所屬的類別。您可以叫用EndpointCategory物件的getId方法，以取得此類別的識別碼值。
- 指定叫用CreateEndpointInfo物件的setOperationName方法，並傳遞指定作業名稱的字串值，以叫用的作業。一般而言，為源自於Workbench中建立之處理序的服務建立TaskManager端點時，作業名稱為invoke。
建立TaskManager端點。

透過叫用EndpointRegistryClient物件的createEndpoint方法並傳遞CreateEndpointInfo物件來建立端點。此方法會傳回代表新TaskManager端點的Endpoint物件。
啟用端點。

啟用端點，方法是叫用EndpointRegistryClient物件的enable方法，並傳遞createEndpoint方法傳回的Endpoint物件。

另請參閱

快速入門：使用Java API新增TaskManager端點

修改端點 modifying-endpoints

您可以使用AEM Forms Java API以程式設計方式修改現有端點。透過修改端點，您可以變更端點的行為。例如，假設一個Watched資料夾端點指定了一個資料夾作為watched資料夾使用。您可以以程式設計方式修改屬於Watched資料夾端點的設定值，導致另一個資料夾充當watched資料夾。如需屬於Watched資料夾端點的設定值相關資訊，請參閱新增Watched資料夾端點。

為了示範如何修改端點，本節會透過變更作為watched資料夾的資料夾來修改Watched資料夾端點。

NOTE

您不能使用Web服務來修改端點。

步驟摘要 summary_of_steps-6

若要修改端點，請執行下列工作：

包含專案檔案。
建立EndpointRegistryClient物件。
擷取端點。
指定新的設定值。

包含專案檔

在您的開發專案中包含必要的檔案。如果您使用Java建立使用者端應用程式，請包含必要的JAR檔案。如果您使用Web服務，請務必包含Proxy檔案。

必須將下列JAR檔案新增至專案的類別路徑：

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (如果將AEM Forms部署在JBoss Application Server上，則為必要)
jbossall-client.jar (如果AEM Forms部署在JBoss Application Server上，則為必要)

如需關於這些JAR檔案位置的資訊，請參閱包含AEM Forms Java程式庫檔案。

建立EndpointRegistry使用者端物件

若要以程式設計方式修改端點，您必須建立EndpointRegistryClient物件。

擷取要修改的端點

您必須先擷取端點，然後才能修改端點。若要擷取端點，您必須以可存取端點的使用者身分連線。建議您以管理員身分連線。（請參閱設定連線屬性）。

您可以透過擷取端點清單來擷取端點。然後，您可以逐一檢視清單，搜尋要移除的特定端點。例如，您可以判斷與端點對應的服務以及端點的型別，以找出端點。當您找到端點時，可以修改它。

指定新的設定值

修改端點時，請指定新的設定值。例如，若要修改Watched資料夾端點，請重設所有Watched資料夾端點設定值，而不僅僅是您要修改的設定值。如需屬於Watched資料夾端點的設定值相關資訊，請參閱新增Watched資料夾端點。

NOTE

如需屬於電子郵件端點的設定值相關資訊，請參閱新增電子郵件端點。

NOTE

您無法修改端點叫用的服務。如果您嘗試修改服務，則會擲回例外狀況。若要修改與指定端點關聯的服務，請移除端點並建立一個。（請參閱移除端點。）

另請參閱

使用Java API修改端點

使用Java API修改端點 modifying-an-endpoint-using-the-java-api

使用Java API修改端點：

包含專案檔案。

在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-livecycle-client.jar。
建立EndpointRegistry使用者端物件。
- 建立包含連線屬性的ServiceClientFactory物件。
- 使用它的建構函式並傳遞ServiceClientFactory物件來建立EndpointRegistryClient物件。
擷取要修改的端點。
- 擷取目前使用者（在連線屬性中指定）可以存取的所有端點清單，方法是叫用EndpointRegistryClient物件的getEndpoints方法，並傳遞作為篩選的PagingFilter物件。您可以傳遞(PagingFilter)null值以傳回所有端點。此方法會傳回java.util.List物件，其中每個元素都是Endpoint物件。如需PagingFilter物件的相關資訊，請參閱AEM Forms API參考。
- 逐一檢視java.util.List物件，以判斷它是否有端點。如果端點存在，則每個元素都是EndPoint執行個體。
- 透過叫用EndPoint物件的getServiceId方法，判斷對應到端點的服務。此方法會傳回指定服務名稱的字串值。
- 透過叫用EndPoint物件的getConnectorId方法來判斷端點的型別。此方法會傳回指定端點型別的字串值。例如，如果端點是Watched資料夾端點，則此方法會傳回WatchedFolder。
指定新的設定值。
- 透過叫用它的建構函式來建立ModifyEndpointInfo物件。
- 對於每個要設定的組態值，呼叫ModifyEndpointInfo物件的setConfigParameterAsText方法。例如，若要設定URL組態值，請叫用ModifyEndpointInfo物件的setConfigParameterAsText方法，並傳遞下列值：
  - 字串值，指定組態值的名稱。例如，若要設定url組態值，請指定url。
  - 字串值，指定設定值的值。若要定義url設定值的值，請指定watched資料夾位置。
- 叫用EndpointRegistryClient物件的modifyEndpoint方法並傳遞ModifyEndpointInfo物件。

另請參閱

快速入門：使用Java API修改端點

移除端點 removing-endpoints

您可以使用AEM Forms Java API，以程式設計方式從服務中移除端點。移除端點後，無法使用啟用端點的叫用方法來叫用服務。例如，如果您從服務中移除SOAP端點，則無法使用SOAP模式叫用服務。

為了示範如何從服務移除端點，本節從名為 EncryptDocument 的服務移除EJB端點。

NOTE

您無法使用網站服務移除端點。

步驟摘要 summary_of_steps-7

若要從服務移除端點，請執行下列工作：

包含專案檔案。
建立EndpointRegistryClient物件。
擷取端點。
移除端點。

包含專案檔

將必要的檔案納入您的開發專案中。如果您使用Java建立使用者端應用程式，請包含必要的JAR檔案。如果您使用Web服務，請務必包含Proxy檔案。

必須將下列JAR檔案新增至專案的類別路徑：

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (如果將AEM Forms部署在JBoss Application Server上，則為必要)
jbossall-client.jar (如果AEM Forms部署在JBoss Application Server上，則為必要)

如需關於這些JAR檔案位置的資訊，請參閱包含AEM Forms Java程式庫檔案。

建立EndpointRegistry使用者端物件

若要以程式設計方式移除端點，您必須建立EndpointRegistryClient物件。

擷取要移除的端點

您必須先擷取端點，才能移除端點。若要擷取端點，您必須以可存取端點的使用者身分連線。建議您以管理員身分連線。（請參閱設定連線屬性）。

您可以透過擷取端點清單來擷取端點。然後，您可以逐一檢視清單，搜尋要移除的特定端點。例如，您可以判斷與端點對應的服務以及端點的型別，以找出端點。當您找到端點時，可以將其移除。

移除端點

建立端點後，您必須啟用它。端點啟用時，可用來叫用服務。啟用端點後，即可在管理主控台中檢視它。

另請參閱

使用Java API移除端點

使用Java API移除端點 removing-an-endpoint-using-the-java-api

使用Java API移除端點：

包含專案檔案。

在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-livecycle-client.jar。
建立EndpointRegistry使用者端物件。
- 建立包含連線屬性的ServiceClientFactory物件。
- 使用它的建構函式並傳遞ServiceClientFactory物件來建立EndpointRegistryClient物件。
擷取端點以移除。
- 透過叫用EndpointRegistryClient物件的getEndpoints方法並傳遞作為篩選的PagingFilter物件，擷取目前使用者（在連線屬性中指定）有權存取的所有端點清單。您可以傳遞(PagingFilter)null以傳回所有端點。此方法會傳回java.util.List物件，其中每個元素都是Endpoint物件。
- 逐一檢視java.util.List物件，以判斷它是否有端點。如果端點存在，則每個元素都是EndPoint執行個體。
- 透過叫用EndPoint物件的getServiceId方法，判斷對應到端點的服務。此方法會傳回指定服務名稱的字串值。
- 透過叫用EndPoint物件的getConnectorId方法來判斷端點的型別。此方法會傳回指定端點型別的字串值。例如，如果端點是EJB端點，則此方法會傳回EJB。
移除端點。

透過叫用EndpointRegistryClient物件的remove方法並傳遞代表要移除之端點的EndPoint物件來移除端點。

另請參閱

快速入門：使用Java API移除端點

正在擷取端點聯結器資訊 retrieving-endpoint-connector-information

您可以使用AEM Forms API以程式設計方式擷取有關端點聯結器的資訊。聯結器可讓端點使用各種叫用方法來叫用服務。例如，Watched資料夾聯結器可讓端點使用watched資料夾叫用服務。透過以程式擷取端點聯結器的相關資訊，您可以擷取與聯結器相關的組態值，例如需要哪些組態值以及哪些是選用值。

為了示範如何擷取端點聯結器的相關資訊，本節會擷取Watched資料夾聯結器的相關資訊。（請參閱新增Watched資料夾端點。）

NOTE

您無法使用Web服務擷取有關端點的資訊。

NOTE

此主題使用ConnectorRegistryClient API來擷取端點聯結器的相關資訊。 (請參閱AEM Forms API參考。)

步驟摘要 summary_of_steps-8

若要擷取端點聯結器資訊，請執行下列工作：

包含專案檔案。
建立ConnectorRegistryClient物件。
指定聯結器型別。
擷取設定值。

包含專案檔

將必要的檔案納入您的開發專案中。如果您使用Java建立使用者端應用程式，請包含必要的JAR檔案。如果您使用Web服務，請務必包含Proxy檔案。

必須將下列JAR檔案新增至專案的類別路徑：

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (如果將AEM Forms部署在JBoss Application Server上，則為必要)
jbossall-client.jar (如果AEM Forms部署在JBoss Application Server上，則為必要)

如果將AEM Forms部署在支援的J2EE應用程式伺服器（不是JBoss）上，請將adobe-utilities.jar和jbossall-client.jar取代為特定於已部署AEM Forms之J2EE應用程式伺服器的JAR檔案。如需有關所有AEM Forms JAR檔案位置的資訊，請參閱包含AEM Forms Java程式庫檔案。

建立ConnectorRegistry使用者端物件

若要以程式擷取端點聯結器資訊，請建立ConnectorRegistryClient物件。

指定聯結器型別

指定要從中擷取資訊的聯結器型別。存在下列型別的聯結器：

EJB：讓使用者端應用程式能夠使用EJB模式叫用服務。
SOAP：允許使用者端應用程式使用SOAP模式叫用服務。
Watched資料夾：啟用watched資料夾以叫用服務。
電子郵件：啟用電子郵件訊息以叫用服務。
遠端處理：啟用Flex使用者端應用程式以叫用服務。
TaskManagerConnector：可讓Workspace使用者從Workspace內叫用服務。

擷取組態值

指定聯結器型別後，即可擷取有關聯結器的資訊，例如支援的組態值。例如，對於任何聯結器，您可以決定哪些組態值是必要值，哪些是選用值。

另請參閱

使用Java API擷取端點聯結器資訊

使用Java API擷取端點聯結器資訊 retrieve-endpoint-connector-information-using-the-java-api

使用Java API擷取端點聯結器資訊：

包含專案檔案。

在您的Java專案的類別路徑中包含使用者端JAR檔案，例如adobe-livecycle-client.jar。
建立ConnectorRegistry使用者端物件。
- 建立包含連線屬性的ServiceClientFactory物件。
- 使用它的建構函式並傳遞ServiceClientFactory物件來建立ConnectorRegistryClient物件。
指定聯結器型別。

透過叫用ConnectorRegistryClient物件的getEndpointDefinition方法並傳遞指定聯結器型別的字串值來指定聯結器型別。例如，若要指定Watched資料夾聯結器型別，請傳遞字串值WatchedFolder。此方法會傳回對應到聯結器型別的Endpoint物件。
擷取設定值。
- 透過叫用Endpoint物件的getConfigParameters方法，擷取與此端點關聯的設定值。此方法傳回ConfigParameter物件的陣列。
- 擷取陣列中的每個元素，以擷取有關每個設定值的資訊。每個元素都是ConfigParameter物件。例如，您可以叫用ConfigParameter物件的isRequired方法，以判斷組態值是必要值或選用值。如果需要組態值，則此方法會傳回true。

另請參閱

快速入門：使用Java API擷取端點聯結器資訊