[Integrazione]{class="badge positive"}

Utilizzo dei metodi helper di Adobe Sign

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

In alcuni casi di utilizzo, potrebbe essere necessario inviare un documento per le firme senza utilizzare un flusso di lavoro AEM. In questi casi, sarà molto comodo utilizzare i metodi di wrapper esposti dal bundle di esempio fornito in questo articolo.

Distribuire il bundle OSGi di esempio

Distribuisci il bundle OSGi tramite la console Web OSGi dell'AEM. Specifica la chiave di integrazione API e l’utente API che utilizza la configurazione OSGi come mostrato di seguito, tramite Configuration Manager della console web OSGi dell’AEM.

Il bundle OSGi AdobeSignHelperMethods non è riconosciuto come codice di prodotto Adobe Experience Manager (AEM) e pertanto non è supportato dal supporto Adobe.

Documentazione API

Di seguito sono riportati i servizi OSGi AcrobatSignHelperMethods forniti nel bundle OSGi.

getTransientDocumentID

String getTransientDocumentID(Document documentForSigning) throws IOException

Documento utilizzato per creare un contratto o un modulo Web. Il documento viene caricato per la prima volta in Acrobat Sign dal mittente. Questo è definito transitorio poiché è disponibile per l'uso solo per 7 giorni dopo il caricamento. Questo metodo accetta com.adobe.aemfd.docmanager.Document e restituisce un ID documento transitorio.

getAgreementID

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

Invia il documento per la firma utilizzando l’ID documento transitorio per la firma all’utente identificato dal parametro e-mail.

getWidgetID

String getWidgetID(String transientDocumentID)

Un widget è come un modello riutilizzabile che può essere presentato agli utenti più volte e firmato più volte. Utilizza questo metodo per ottenere l'ID del widget utilizzando l'ID del documento transitorio.

getWidgetURL

String getWidgetURL(String widgetId) throws ClientProtocolException, IOException

Ottieni un URL widget per un ID widget specifico. Questo URL del widget può quindi essere presentato agli utenti per la firma del documento.

Utilizzare l’API

AcrobatSignHelperMethods è un servizio OSGi, pertanto deve essere annotato utilizzando l'annotazione @Reference nel codice Java.

...
// 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");
    ...
 }
}