[整合]{class="badge positive"}

使用Adobe Sign協助程式方法

[AEM Forms 6.5]{class="badge informative"}

在某些使用案例中，您可能需要在不使用AEM工作流程的情況下傳送檔案以索取簽名。 在這種情況下，使用本文提供的範例套件所公開的包裝函式方法會非常方便。

部署範例OSGi套件

透過AEM OSGi Web主控台部署OSGi套件。 透過AEM OSGi Web主控台的Configuration Manager，使用如下所示的OSGi設定，指定API整合金鑰和API使用者。

請注意，AdobeSignHelperMethods OSGi套件組合無法辨識為Adobe Experience Manager (AEM)產品代碼，因此Adobe支援不支援它。

API檔案

下列專案可透過OSGi套件組合中提供的AcrobatSignHelperMethods OSGi服務取得。

getTransientDocumentID

String getTransientDocumentID(Document documentForSigning) throws IOException

用來建立合約或網頁表單的檔案。 檔案會先由寄件者上傳至Acrobat Sign。 這稱為​ 暫時，因為它在上傳後7天內才可供使用。 此方法接受com.adobe.aemfd.docmanager.Document並傳回暫時性檔案識別碼。

getAgreementID

String getAgreementId(String transientDocumentID, String email) throws ClientProtocolException, IOException

使用暫時性檔案ID傳送待簽署檔案給電子郵件引數所識別的使用者。

getWidgetID

String getWidgetID(String transientDocumentID)

Widget就像可重複使用的範本，可以多次向使用者展示並多次簽署。 使用此方法以暫時性檔案ID取得Widget ID。

getWidgetURL

String getWidgetURL(String widgetId) throws ClientProtocolException, IOException

取得特定Widget ID的Widget URL。 然後可以將此Widget URL呈現給使用者以供簽署檔案。

使用API

AcrobatSignHelperMethods是OSGi服務，因此必須在您的Java程式碼中使用@Reference註解來加上註解。

...
// Import the AcrobatSignHelperMethods from the provided bundle
import com.acrobatsign.core.AcrobatSignHelperMethods;
...

@Component(service = { Example.class })
public class ExampleImpl implements Example {

 // Gain a reference to the provided AcrobatSignHelperMethods OSGi service
 @Reference
 com.acrobatsign.core.AcrobatSignHelperMethods acrobatSignHelperMethods;

 function void example() {
    ...
    // Use the AcrobatSignHelperMethods API methods in your code
    String transientDocumentId = acrobatSignHelperMethods.getTransientDocumentID(documentForSigning);

    String agreementId = acrobatSignHelperMethods.getAgreementId(transientDocumentID, "johndoe@example.com");
    ...
 }
}