本檔案中的範例和範例僅適用於JEE環境上的AEM Forms 。
關於端點登入服務
Endpoint Registry服務提供以程式設計方式管理端點的功能。 例如,您可以將下列型別的端點新增至服務:
SOAP、EJB和(JEE上的AEM Forms已棄用)遠端端點會自動為每個啟用的服務建立。 SOAP和EJB端點為所有服務作業啟用SOAP和EJB。
遠端端點可讓Flex使用者端叫用新增端點的AEM Forms服務上的操作。 會建立與端點同名的Flex目的地,且Flex使用者端可建立指向此目的地的RemoteObjects,以叫用相關服務的作業。
電子郵件、工作管理員和Watched Folder端點只會公開服務的特定操作。 新增這些端點需要第二個設定步驟,以選取要呼叫的方法、設定設定引數,以及指定輸入和輸出引數對應。
您可以將TaskManager端點組織成群組,稱為 類別. 然後這些類別會透過TaskManager向工作區公開,使用者在分類時可看到TaskManager端點。 在Workspace中,一般使用者可在導覽窗格中看到這些類別。 每個類別中的端點在Workspace的「開始程式」頁面上會顯示為程式卡。
您可以使用Endpoint Registry服務完成這些工作:
您可以使用AEM Forms Java API,以程式設計方式將EJB端點新增至服務。 藉由將EJB端點加入服務,即可讓從屬端應用程式使用EJB模式來呼叫服務。 也就是說,在設定呼叫AEM Forms所需的連線屬性時,您可以選取EJB模式。 (請參閱 設定連線屬性.)
您無法使用Web服務新增EJB端點。
一般而言,EJB端點會依預設新增至服務。不過,EJB端點可以新增至以程式設計方式建置的處理,或是移除EJB端點而必須再次新增的處理程式。
若要將EJB端點新增至服務,請執行下列工作:
EndpointRegistry Client
物件。包含專案檔案
在您的開發專案中包含必要的檔案。 必須將以下JAR檔案新增到專案的類別路徑中:
有關這些JAR檔案位置的資訊,請參見 包含AEM Forms Java程式庫檔案.
建立EndpointRegistry使用者端物件
您必須先建立 EndpointRegistryClient
物件。
設定EJB端點屬性
若要建立服務的EJB端點,請指定下列值:
EJB
.*
)。 不過,如果您想要指定特定作業而不是叫用所有服務作業,請指定作業的名稱,而不是使用萬用字元( *
)。建立EJB端點
設定EJB端點屬性後,即可建立服務的EJB端點。
啟用端點
建立新端點後,您必須啟用它。 啟用端點後,即可用來叫用服務。 啟用端點後,即可在管理主控台中檢視它。
另請參閱
使用Java API新增EJB端點:
包含專案檔案。
在您的Java專案的類別路徑中包含使用者端JAR檔案,例如adobe-livecycle-client.jar。 (
建立EndpointRegistry使用者端物件。
ServiceClientFactory
包含連線屬性的物件。EndpointRegistryClient
物件,使用它的建構函式並傳遞 ServiceClientFactory
物件。設定EJB端點屬性。
CreateEndpointInfo
物件(使用其建構函式)。CreateEndpointInfo
物件的 setConnectorId
方法和傳遞字串值 EJB
.CreateEndpointInfo
物件的 setDescription
方法和傳遞描述端點的字串值。CreateEndpointInfo
物件的 setName
並傳遞指定名稱的字串值。CreateEndpointInfo
物件的 setServiceId
方法並傳遞指定服務名稱的字串值。CreateEndpointInfo
物件的 setOperationName
方法,並傳遞指定作業名稱的字串值。 對於SOAP和EJB端點,請指定萬用字元( *
),這表示所有作業。建立EJB端點。
透過叫用端點來建立端點 EndpointRegistryClient
物件的 createEndpoint
方法和傳遞 CreateEndpointInfo
物件。 此方法會傳回 Endpoint
代表新EJB端點的物件。
啟用端點。
透過叫用啟用端點 EndpointRegistryClient
物件的enable方法並傳遞 Endpoint
物件,由 createEndpoint
方法。
另請參閱
您可以使用AEM Forms Java API,以程式設計方式將SOAP端點新增至服務。 透過新增SOAP端點,您可以讓使用者端應用程式使用SOAP模式來叫用服務。 也就是說,在設定呼叫AEM Forms所需的連線屬性時,您可以選取SOAP模式。
您無法使用Web服務新增SOAP端點。
通常,SOAP端點會預設新增到服務。但是,SOAP端點可以新增到以程式設計方式部署的流程中,或者在移除SOAP端點且必須再次新增時。
若要將SOAP端點新增至服務,請執行下列工作:
EndpointRegistryClient
物件。包含專案檔案
在您的開發專案中包含必要的檔案。 如果您使用Java建立使用者端應用程式,請包含必要的JAR檔案。 如果您使用Web服務,請務必包含Proxy檔案。
必須將以下JAR檔案新增到專案的類別路徑中:
建立SOAP端點需要這些JAR檔案。 不過,如果您使用SOAP端點來叫用服務,則需要額外的JAR檔案。 如需AEM Forms JAR檔案的相關資訊,請參閱 包含AEM Forms Java程式庫檔案.
建立EndpointRegistry使用者端物件
若要以程式設計方式將SOAP端點新增至服務,您必須建立 EndpointRegistryClient
物件。
設定SOAP端點屬性
若要將SOAP端點新增至服務,請指定下列值:
SOAP
.*
)。 不過,如果您想要指定特定作業而不是叫用所有服務作業,請指定作業的名稱,而不是使用萬用字元( *
)。建立SOAP端點
設定SOAP端點屬性後,您可以建立SOAP端點。
啟用端點
建立新端點後,您必須啟用它。 端點啟用時,可用於叫用服務。 啟用端點後,您可以在管理主控台中檢視它。
另請參閱
使用Java API將SOAP端點新增至服務:
包含專案檔案。
在您的Java專案的類別路徑中包含使用者端JAR檔案,例如adobe-livecycle-client.jar。
建立EndpointRegistry使用者端物件。
ServiceClientFactory
包含連線屬性的物件。EndpointRegistryClient
物件,使用它的建構函式並傳遞 ServiceClientFactory
物件。設定SOAP端點屬性。
CreateEndpointInfo
物件(使用其建構函式)。CreateEndpointInfo
物件的 setConnectorId
方法和傳遞字串值 SOAP
.CreateEndpointInfo
物件的 setDescription
方法和傳遞描述端點的字串值。CreateEndpointInfo
物件的 setName
並傳遞指定名稱的字串值。CreateEndpointInfo
物件的 setServiceId
方法並傳遞指定服務名稱的字串值。CreateEndpointInfo
物件的 setOperationName
方法並傳遞指定作業名稱的字串值。 對於SOAP和EJB端點,請指定萬用字元( *
),這表示所有作業。建立SOAP端點。
透過叫用端點來建立端點 EndpointRegistryClient
物件的 createEndpoint
方法和傳遞 CreateEndpointInfo
物件。 此方法會傳回 Endpoint
代表新SOAP端點的物件。
啟用端點。
透過叫用啟用端點 EndpointRegistryClient
物件的enable方法並傳遞 Endpoint
物件,由 createEndpoint
方法。
另請參閱
您可以使用AEM Forms Java API,以程式設計方式將Watched資料夾端點新增至服務。 透過新增Watched資料夾端點,您可以讓使用者將檔案(例如PDF檔案)放在資料夾中。 將檔案放在資料夾中時,會叫用已設定的服務並操作檔案。 服務執行指定的操作後,會將修改的檔案儲存在指定的輸出資料夾中。 監看資料夾已設定為以固定速率間隔或以cron排程掃描,例如每個星期一、星期三和星期五中午。
為了以程式設計方式將Watched資料夾端點新增至服務,請考慮以下名為的短期程式 EncryDocument. (請參閱 瞭解AEM Forms程式.)
此程式接受不安全的PDF檔案作為輸入值,然後將不安全的PDF檔案傳遞至加密服務的 EncryptPDFUsingPassword
作業。 PDF檔案使用密碼加密,而密碼加密的PDF檔案是此程式的輸出值。 輸入值的名稱(無保護PDF檔案)為 InDoc
而且資料型別為 com.adobe.idp.Document
. 輸出值的名稱(密碼加密的PDF檔案)為 SecuredDoc
而且資料型別為 com.adobe.idp.Document
.
您無法使用Web服務新增Watched資料夾端點。
若要將Watched資料夾端點新增至服務,請執行下列工作:
EndpointRegistryClient
物件。包含專案檔案
在您的開發專案中包含必要的檔案。 如果您使用Java建立使用者端應用程式,請包含必要的JAR檔案。 如果您使用Web服務,請務必包含Proxy檔案。
必須將以下JAR檔案新增到專案的類別路徑中:
有關這些JAR檔案位置的資訊,請參見 包含AEM Forms Java程式庫檔案.
建立EndpointRegistry使用者端物件
若要以程式設計方式新增Watched資料夾端點,您必須建立 EndpointRegistryClient
物件。
設定Watched資料夾端點屬性
若要為服務建立Watched資料夾端點,請指定下列值:
WatchedFolder
.EncryptDocument
.invoke
.指定設定值
以程式設計方式將Watched資料夾端點新增至服務時,您必須指定Watched資料夾端點的設定值。 如果使用Administration Console新增Watched資料夾端點,則管理員會指定這些設定值。
下列清單指定以程式設計方式將Watched資料夾端點新增至服務時所設定的設定值:
data*
,所有相符的檔案和資料夾 data*
未選取。 這包括名為的檔案和資料夾 data1
, data2
、等等。 此外,該模式可以附加萬用字元模式來指定檔案模式。 Watched資料夾會修改規則運算式,以支援萬用字元模式,例如 *.*
和 *.pdf
. 規則運算式不支援這些萬用字元模式。*
,所有相符的檔案和資料夾 input*
已選取。 這包括名為的檔案和資料夾 input1
, input2
、等等。 預設值為 *
。此值表示所有檔案和資料夾。 此外,該模式可以附加萬用字元模式來指定檔案模式。 Watched資料夾會修改規則運算式,以支援萬用字元模式,例如 *.*
和 *.pdf
. 規則運算式不支援這些萬用字元模式。 此值為必要值。result/%Y/%M/%D/
。這是watched資料夾中的結果資料夾。preserve/%Y/%M/%D/
。failure/%Y/%M/%D/
。定義輸入引數值
建立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資料夾端點後,您必須啟用它。 端點啟用時,可用於叫用服務。 啟用端點後,即可在管理主控台中檢視它。
另請參閱
使用AEM Forms Java API新增Watched資料夾端點:
包含專案檔案。
在您的Java專案的類別路徑中包含使用者端JAR檔案,例如adobe-livecycle-client.jar。
建立EndpointRegistry使用者端物件。
ServiceClientFactory
包含連線屬性的物件。EndpointRegistryClient
物件,使用它的建構函式並傳遞 ServiceClientFactory
物件。設定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資料夾位置。若要檢視為EncryptDocument服務設定的所有設定值,請參閱位於 快速入門:使用Java API新增Watched資料夾端點.
定義輸入引數值。
透過叫用 CreateEndpointInfo
物件的 setInputParameterMapping
方法並傳遞下列值:
InDoc
.InDoc
輸入引數為 com.adobe.idp.Document
.variable
.叫用 setInputParameterMapping
每個要定義的輸入引數值的方法。 由於EncryptDocument程式只有一個輸入引數,因此您需要叫用此方法一次。
定義輸出引數值。
透過叫用 CreateEndpointInfo
物件的 setOutputParameterMapping
方法並傳遞下列值:
SecuredDoc
.SecuredDoc
輸出引數為 com.adobe.idp.Document
.%F.pdf
.建立監看資料夾端點。
透過叫用端點來建立端點 EndpointRegistryClient
物件的 createEndpoint
方法和傳遞 CreateEndpointInfo
物件。 此方法會傳回 Endpoint
代表Watched資料夾端點的物件。
啟用端點。
透過叫用啟用端點 EndpointRegistryClient
物件的 enable
方法和傳遞 Endpoint
物件,由 createEndpoint
方法。
另請參閱
此 快速入門:使用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";
}
您可以使用AEM Forms Java API,以程式設計方式將電子郵件端點新增至服務。 透過新增電子郵件端點,您可以讓使用者將包含一個或多個檔案附件的電子郵件訊息傳送至指定的電子郵件帳戶。 然後叫用設定服務操作並操作檔案。 服務執行指定的操作後,會傳送電子郵件訊息給寄件者,其中包含修改後的檔案作為檔案附件。
為了以程式設計方式將電子郵件端點新增至服務,請考慮以下名為的短期程式 MyApplication\EncryptDocument. 如需有關短期程式的資訊,請參閱 瞭解AEM Forms程式.
此程式接受不安全的PDF檔案作為輸入值,然後將不安全的PDF檔案傳遞至加密服務的 EncryptPDFUsingPassword
作業。 此程式會使用密碼加密PDF檔案,並傳回密碼加密的PDF檔案作為輸出值。 輸入值的名稱(無保護PDF檔案)為 InDoc
而且資料型別為 com.adobe.idp.Document
. 輸出值的名稱(密碼加密的PDF檔案)為 SecuredDoc
而且資料型別為 com.adobe.idp.Document
.
您無法使用Web服務新增電子郵件端點。
若要將電子郵件端點新增至服務,請執行下列工作:
EndpointRegistryClient
物件。包含專案檔案
在您的開發專案中包含必要的檔案。 如果您使用Java建立使用者端應用程式,請包含必要的JAR檔案。 如果您使用Web服務,請務必包含Proxy檔案。
必須將以下JAR檔案新增到專案的類別路徑中:
有關這些JAR檔案位置的資訊,請參見 包含AEM Forms Java程式庫檔案.
建立EndpointRegistry使用者端物件
您必須先建立「 」,才能以程式設計方式新增電子郵件端點 EndpointRegistryClient
物件。
設定電子郵件端點屬性
若要建立服務的電子郵件端點,請指定下列值:
Email
.EncryptDocument
.invoke
.指定設定值
以程式設計方式將電子郵件端點新增至服務時,您必須指定電子郵件端點的設定值。 如果使用管理主控台新增電子郵件端點,則管理員會指定這些設定值。
受監控的電子郵件帳戶是僅用於電子郵件端點的特殊帳戶。 此帳戶不是一般使用者的電子郵件帳戶。 一般使用者的電子郵件帳戶不可設定為電子郵件提供者使用的帳戶,因為電子郵件提供者會在完成訊息處理之後,從收件匣中刪除電子郵件訊息。
以程式設計方式將電子郵件端點新增至服務時,會設定下列設定值:
SuperAdmin
。DefaultDom
。adobe.com
會使用,只會處理來自adobe.com的電子郵件,而忽略來自其他網域的電子郵件。*
。sender
,電子郵件結果會傳送給寄件者。 最多可支援100個收件者。 使用電子郵件地址指定其他收件者,每個收件者之間以逗號分隔。 若要關閉此選項,請將此值留空。 某些情況下,您可能會想要觸發程式,而不想收到結果的電子郵件通知。 預設值為 sender
。sender
,電子郵件結果會傳送給寄件者。 最多可支援100個收件者。 使用電子郵件地址指定其他收件者,每個收件者之間以逗號分隔。 若要關閉此選項,請將此值留空。 預設值為 sender
。IMAP
或 POP3
. 收件匣主機郵件伺服器必須支援這些通訊協定。UTF-8
。定義輸入引數值
建立電子郵件端點時,您必須定義輸入引數值。 也就是說,您必須說明傳遞至電子郵件端點所叫用之作業的輸入值。 例如,請考量本主題中介紹的程式。 它有一個輸入值,名為 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
. 為此程式建立電子郵件端點時(程式啟動後,它會變成服務),您必須定義輸出引數值。
若要定義電子郵件端點所需的輸出引數值,請指定下列值:
輸出引數名稱:輸出引數的名稱。 在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
.
建立電子郵件端點
設定電子郵件端點屬性和設定值,並定義輸入和輸出引數值後,您必須建立電子郵件端點。
啟用端點
建立電子郵件端點後,您必須啟用它。 端點啟用時,可用於叫用服務。 啟用端點後,即可在管理主控台中檢視它。
另請參閱
使用Java API新增電子郵件端點:
包含專案檔案。
在您的Java專案的類別路徑中包含使用者端JAR檔案,例如adobe-livecycle-client.jar。
建立EndpointRegistry使用者端物件。
ServiceClientFactory
包含連線屬性的物件。EndpointRegistryClient
物件,使用它的建構函式並傳遞 ServiceClientFactory
物件。設定電子郵件端點屬性。
CreateEndpointInfo
物件(使用其建構函式)。CreateEndpointInfo
物件的 setConnectorId
方法和傳遞字串值 Email
.CreateEndpointInfo
物件的 setDescription
方法和傳遞描述端點的字串值。CreateEndpointInfo
物件的 setName
並傳遞指定名稱的字串值。CreateEndpointInfo
物件的 setServiceId
方法並傳遞指定服務名稱的字串值。CreateEndpointInfo
物件的 setOperationName
方法並傳遞指定作業名稱的字串值。 通常,在為源自於Workbench中建立之程式的服務建立電子郵件端點時,會叫用操作的名稱。指定設定值。
針對要設定電子郵件端點的每個設定值,您必須叫用 CreateEndpointInfo
物件的 setConfigParameterAsText
方法。 例如,若要設定 smtpHost
設定值,叫用 CreateEndpointInfo
物件的 setConfigParameterAsText
方法並傳遞下列值:
smtpHost
設定值,指定 smtpHost
.smtpHost
設定值,指定字串值,指定SMTP伺服器的名稱。若要檢視本節中介紹的EncryptDocument服務的所有設定值,請參閱位於以下位置的Java程式碼範例: 快速入門:使用Java API新增電子郵件端點.
定義輸入引數值。
透過叫用 CreateEndpointInfo
物件的 setInputParameterMapping
方法並傳遞下列值:
InDoc
.InDoc
輸入引數為 com.adobe.idp.Document
.variable
.叫用 setInputParameterMapping
每個要定義的輸入引數值的方法。 由於EncryptDocument程式只有一個輸入引數,因此您需要叫用此方法一次。
定義輸出引數值。
透過叫用 CreateEndpointInfo
物件的 setOutputParameterMapping
並傳遞下列值:
SecuredDoc
.SecuredDoc
輸出引數為 com.adobe.idp.Document
.%F.pdf
.建立電子郵件端點。
透過叫用端點來建立端點 EndpointRegistryClient
物件的 createEndpoint
方法和傳遞 CreateEndpointInfo
物件。 此方法會傳回 Endpoint
代表電子郵件端點的物件。
啟用端點。
透過叫用啟用端點 EndpointRegistryClient
物件的 enable
方法和傳遞 Endpoint
物件,由 createEndpoint
方法。
另請參閱
此 快速入門:使用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";
}
JEE版的AEM表單已棄用LiveCycle RemotingAPI。
您可以使用AEM Forms Java API,以程式設計方式將遠端端點新增至服務。 透過新增Remoting端點,您可以讓Flex應用程式使用遠端來叫用服務。 (請參閱 使用AEM Forms叫用(AEM表單已棄用) AEM Forms Remoting.)
為了以程式設計方式將遠端端點新增至服務,請考慮以下名為的短期程式 EncryDocument.
此程式接受不安全的PDF檔案作為輸入值,然後將不安全的PDF檔案傳遞至加密服務的 EncryptPDFUsingPassword
作業。 PDF檔案使用密碼加密,而密碼加密的PDF檔案是此程式的輸出值。 輸入值的名稱(無保護PDF檔案)為 InDoc
而且資料型別為 com.adobe.idp.Document
. 輸出值的名稱(密碼加密的PDF檔案)為 SecuredDoc
而且資料型別為 com.adobe.idp.Document
.
為了示範如何將Remoting端點新增至服務,本節將Remoting端點新增至名為EncryptDocument的服務。
您無法使用網站服務來新增遠端端點。
若要從服務移除端點,請執行下列工作:
EndpointRegistryClient
物件。包含專案檔案
在您的開發專案中包含必要的檔案。 如果您使用Java建立使用者端應用程式,請包含必要的JAR檔案。 如果您使用Web服務,請務必包含Proxy檔案。
必須將以下JAR檔案新增到專案的類別路徑中:
有關這些JAR檔案位置的資訊,請參見 包含AEM Forms Java程式庫檔案.
建立EndpointRegistry使用者端物件
若要以程式設計方式新增遠端端點,您必須建立 EndpointRegistryClient
物件。
設定遠端端點屬性
若要建立服務的Remoting端點,請指定下列值:
Remoting
.EncryptDocument
.建立遠端端點
設定Remoting端點屬性後,您可以為服務建立Remoting端點。
啟用端點
建立新端點後,您必須啟用它。 遠端端點啟用時,可讓Flex使用者端叫用服務。
另請參閱
使用Java API新增Remoting端點:
包含專案檔案。
在您的Java專案的類別路徑中包含使用者端JAR檔案,例如adobe-livecycle-client.jar。
建立EndpointRegistry使用者端物件。
ServiceClientFactory
包含連線屬性的物件。EndpointRegistryClient
物件,使用它的建構函式並傳遞 ServiceClientFactory
物件。設定遠端端點屬性。
CreateEndpointInfo
物件(使用其建構函式)。CreateEndpointInfo
物件的 setConnectorId
方法和傳遞字串值 Remoting
.CreateEndpointInfo
物件的 setDescription
方法和傳遞描述端點的字串值。CreateEndpointInfo
物件的 setName
並傳遞指定名稱的字串值。CreateEndpointInfo
物件的 setServiceId
方法並傳遞指定服務名稱的字串值。CreateEndpointInfo
物件的 setOperationName
方法並傳遞指定作業名稱的字串值。 對於遠端端點,請指定萬用字元(*)。建立遠端端點。
透過叫用端點來建立端點 EndpointRegistryClient
物件的 createEndpoint
方法和傳遞 CreateEndpointInfo
物件。 此方法會傳回 Endpoint
代表新遠端端點的物件。
啟用端點。
透過叫用啟用端點 EndpointRegistryClient
物件的 enable
方法和傳遞 Endpoint
物件,由 createEndpoint
方法。
另請參閱
您可以使用AEM Forms Java API,以程式設計方式將TaskManager端點新增至服務。 透過將TaskManager端點新增至服務,您可以讓Workspace使用者叫用該服務。 也就是說,在Workspace中工作的使用者可以叫用具有對應TaskManager端點的程式。
您無法使用Web服務新增TaskManager端點。
若要將TaskManager端點新增至服務,請執行下列工作:
EndpointRegistryClient
物件。包含專案檔案
在您的開發專案中包含必要的檔案。 如果您使用Java建立使用者端應用程式,請包含必要的JAR檔案。 如果您使用Web服務,請務必包含Proxy檔案。
必須將以下JAR檔案新增到專案的類別路徑中:
有關這些JAR檔案位置的資訊,請參見 包含AEM Forms Java程式庫檔案.
建立EndpointRegistry使用者端物件
您必須先建立TaskManager端點,才能以程式設計方式新增 EndpointRegistryClient
物件。
為端點建立類別
類別是用來在工作區中組織服務。 也就是說,Workspace使用者可以透過在Workspace中選取類別來叫用具有TaskManager端點的服務。 建立TaskManager端點時,您可以參照現有類別或以程式設計方式建立新類別。
本節會在將TaskManager端點新增至服務時,建立新類別。
設定TaskManager端點屬性
若要為服務建立TaskManager端點,請指定下列值:
TaskManagerConnector
.invoke
.建立TaskManager端點
設定TaskManager端點屬性後,即可為服務建立TaskManager端點。
啟用端點
建立新端點後,您必須啟用它。 端點啟用時,可用來從Workspace內叫用服務。 啟用端點後,即可在管理主控台中檢視它。
另請參閱
使用Java API新增TaskManager端點:
包含專案檔案。
在您的Java專案的類別路徑中包含使用者端JAR檔案,例如adobe-livecycle-client.jar。
建立EndpointRegistry使用者端物件。
ServiceClientFactory
包含連線屬性的物件。EndpointRegistryClient
物件,使用它的建構函式並傳遞 ServiceClientFactory
物件。為端點建立類別。
建立 CreateEndpointCategoryInfo
物件,使用它的建構函式並傳遞下列值:
透過叫用 EndpointRegistryClient
物件的 createEndpointCategory
方法和傳遞 CreateEndpointCategoryInfo
物件。 此方法會傳回 EndpointCategory
代表新類別的物件。
設定TaskManager端點屬性。
CreateEndpointInfo
物件(使用其建構函式)。CreateEndpointInfo
物件的 setConnectorId
方法和傳遞字串值 TaskManagerConnector
.CreateEndpointInfo
物件的 setDescription
方法和傳遞描述端點的字串值。CreateEndpointInfo
物件的 setName
並傳遞指定名稱的字串值。CreateEndpointInfo
物件的 setServiceId
方法並傳遞指定服務名稱的字串值。CreateEndpointInfo
物件的 setCategoryId
並傳遞指定類別識別碼值的字串值。 您可以叫用 EndpointCategory
物件的 getId
取得此類別識別碼值的方法。CreateEndpointInfo
物件的 setOperationName
方法並傳遞指定作業名稱的字串值。 通常,建立 TaskManager
源自於Workbench中建立之處理序的服務端點,作業名稱為 invoke
.建立TaskManager端點。
透過叫用端點來建立端點 EndpointRegistryClient
物件的 createEndpoint
方法和傳遞 CreateEndpointInfo
物件。 此方法會傳回 Endpoint
代表新TaskManager端點的物件。
啟用端點。
透過叫用啟用端點 EndpointRegistryClient
物件的 enable
方法和傳遞 Endpoint
物件,由 createEndpoint
方法。
另請參閱
快速入門:使用Java API新增TaskManager端點
您可以使用AEM Forms Java API以程式設計方式修改現有端點。 透過修改端點,您可以變更端點的行為。 例如,假設有一個Watched資料夾端點,它指定用來作為watched資料夾的資料夾。 您可以以程式設計方式修改屬於Watched資料夾端點的設定值,導致另一個資料夾充當Watched資料夾。 如需屬於Watched資料夾端點的設定值相關資訊,請參閱 新增Watched資料夾端點.
為了示範如何修改端點,本節透過變更作為Watched資料夾的資料夾來修改Watched資料夾端點。
您不能使用Web服務來修改端點。
若要修改端點,請執行下列工作:
EndpointRegistryClient
物件。包含專案檔案
在您的開發專案中包含必要的檔案。 如果您使用Java建立使用者端應用程式,請包含必要的JAR檔案。 如果您使用Web服務,請務必包含Proxy檔案。
必須將以下JAR檔案新增到專案的類別路徑中:
有關這些JAR檔案位置的資訊,請參見 包含AEM Forms Java程式庫檔案.
建立EndpointRegistry使用者端物件
若要以程式設計方式修改端點,您必須建立 EndpointRegistryClient
物件。
擷取端點以進行修改
您必須先擷取端點,然後才能修改端點。 若要擷取端點,您必須以可存取端點的使用者身分連線。 建議您以管理員身分連線。 (請參閱 設定連線屬性)。
您可以透過擷取端點清單來擷取端點。 然後您可以逐一檢視清單,搜尋要移除的特定端點。 例如,您可以判斷與端點對應的服務以及端點的型別,以找出端點。 當您找到端點時,可以修改它。
指定新的設定值
修改端點時,請指定新的設定值。 例如,若要修改Watched資料夾端點,請重設所有Watched資料夾端點設定值,而不只是您要修改的設定值。 如需屬於Watched資料夾端點的設定值相關資訊,請參閱 新增Watched資料夾端點.
如需屬於電子郵件端點的設定值相關資訊,請參閱 新增電子郵件端點.
您無法修改端點叫用的服務。 如果您嘗試修改服務,則會擲回例外狀況。 若要修改與指定端點關聯的服務,請移除端點並建立新端點。 (請參閱 移除端點.)
另請參閱
使用Java API修改端點:
包含專案檔案。
在您的Java專案的類別路徑中包含使用者端JAR檔案,例如adobe-livecycle-client.jar。
建立EndpointRegistry使用者端物件。
ServiceClientFactory
包含連線屬性的物件。EndpointRegistryClient
物件,使用它的建構函式並傳遞 ServiceClientFactory
物件。擷取要修改的端點。
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
物件。
另請參閱
您可以使用AEM Forms Java API以程式設計方式從服務中移除端點。 移除端點後,無法使用啟用端點的叫用方法來叫用服務。 例如,如果您從服務中移除SOAP端點,則無法使用SOAP模式叫用該服務。
若要示範如何從服務移除端點,本節會從名為的服務移除EJB端點 EncryDocument.
您無法使用網站服務移除端點。
若要從服務移除端點,請執行下列工作:
EndpointRegistryClient
物件。包含專案檔案
將必要的檔案納入您的開發專案中。 如果您使用Java建立使用者端應用程式,請包含必要的JAR檔案。 如果您使用Web服務,請務必包含Proxy檔案。
必須將以下JAR檔案新增到專案的類別路徑中:
有關這些JAR檔案位置的資訊,請參見 包含AEM Forms Java程式庫檔案.
建立EndpointRegistry使用者端物件
若要以程式設計方式移除端點,您必須建立 EndpointRegistryClient
物件。
擷取要移除的端點
您必須先擷取端點,才能移除端點。 若要擷取端點,您必須以可存取端點的使用者身分連線。 建議您以管理員身分連線。 (請參閱 設定連線屬性)。
您可以透過擷取端點清單來擷取端點。 然後您可以逐一檢視清單,搜尋要移除的特定端點。 例如,您可以判斷與端點對應的服務以及端點的型別,以找出端點。 當您找到端點時,可以將其移除。
移除端點
建立新端點後,您必須啟用它。 端點啟用時,可用於叫用服務。 啟用端點後,即可在管理主控台中檢視它。
另請參閱
使用Java API移除端點:
包含專案檔案。
在您的Java專案的類別路徑中包含使用者端JAR檔案,例如adobe-livecycle-client.jar。
建立EndpointRegistry使用者端物件。
ServiceClientFactory
包含連線屬性的物件。EndpointRegistryClient
物件,使用它的建構函式並傳遞 ServiceClientFactory
物件。擷取端點以移除。
EndpointRegistryClient
物件的 getEndpoints
方法和傳遞 PagingFilter
做為濾鏡的物件。 您可以通過 (PagingFilter)null
以傳回所有端點。 此方法會傳回 java.util.List
物件,其中每個元素為 Endpoint
物件。java.util.List
物件來判斷它是否有端點。 如果端點存在,則每個元素都為 EndPoint
執行個體。EndPoint
物件的 getServiceId
方法。 此方法會傳回指定服務名稱的字串值。EndPoint
物件的 getConnectorId
方法。 此方法會傳回指定端點型別的字串值。 例如,如果端點是EJB端點,則此方法會傳回 EJB
.移除端點。
透過叫用來移除端點 EndpointRegistryClient
物件的 remove
方法和傳遞 EndPoint
代表要移除之端點的物件。
另請參閱
您可以使用AEM Forms API以程式設計方式擷取端點聯結器的相關資訊。 聯結器可讓端點使用各種叫用方法叫用服務。 例如,Watched資料夾聯結器可讓端點使用watched資料夾叫用服務。 透過以程式擷取端點聯結器的相關資訊,您可以擷取與聯結器相關的組態值,例如需要哪些組態值以及哪些是選用值。
若要示範如何擷取端點聯結器的相關資訊,本節會擷取Watched資料夾聯結器的相關資訊。 (請參閱 新增Watched資料夾端點.)
您無法使用Web服務擷取端點的相關資訊。
本主題使用 ConnectorRegistryClient
用於擷取端點聯結器相關資訊的API。 (請參閱 AEM Forms API參考.)
若要擷取端點聯結器資訊,請執行下列工作:
ConnectorRegistryClient
物件。包含專案檔案
將必要的檔案納入您的開發專案中。 如果您使用Java建立使用者端應用程式,請包含必要的JAR檔案。 如果您使用Web服務,請務必包含Proxy檔案。
必須將以下JAR檔案新增到專案的類別路徑中:
如果將AEM Forms部署在非JBoss的支援J2EE應用程式伺服器上,則將adobe-utilities.jar和jbossall-client.jar取代為部署AEM Forms之J2EE應用程式伺服器專屬的JAR檔案。 如需有關所有AEM Forms JAR檔案位置的資訊,請參閱 包含AEM Forms Java程式庫檔案.
建立ConnectorRegistry使用者端物件
若要以程式設計方式擷取端點聯結器資訊,請建立 ConnectorRegistryClient
物件。
指定聯結器型別
指定要從中擷取資訊的聯結器型別。 存在下列型別的聯結器:
擷取設定值
指定聯結器型別後,您可以擷取有關聯結器的資訊,例如支援的組態值。 例如,對於任何聯結器,您可以決定哪些組態值是必要值,哪些是選用值。
另請參閱
使用Java API擷取端點聯結器資訊:
包含專案檔案。.
在您的Java專案的類別路徑中包含使用者端JAR檔案,例如adobe-livecycle-client.jar。
建立ConnectorRegistry使用者端物件。
ServiceClientFactory
包含連線屬性的物件。ConnectorRegistryClient
物件,使用它的建構函式並傳遞 ServiceClientFactory
物件。指定聯結器型別。
透過叫用指定聯結器型別 ConnectorRegistryClient
物件的 getEndpointDefinition
方法並傳遞指定聯結器型別的字串值。 例如,若要指定Watched資料夾聯結器型別,請傳遞字串值 WatchedFolder
. 此方法會傳回 Endpoint
與聯結器型別對應的物件。
擷取設定值。
Endpoint
物件的 getConfigParameters
方法。 此方法傳回陣列 ConfigParameter
物件。ConfigParameter
物件。 例如,您可以叫用 ConfigParameter
物件的 isRequired
方法。 如果需要設定值,則此方法會傳回 true
.另請參閱