Trasmissione di documenti al servizio Forms passing-documents-to-the-formsservice

Includi file di progetto

Includi i file JAR client, come adobe-forms-client.jar e adobe-contentservices-client.jar, nel percorso di classe del progetto Java.

Creare un oggetto Forms e un oggetto API client di Document Management

• Creare un oggetto ServiceClientFactory contenente le proprietà di connessione. (Vedere Impostazione delle proprietà di connessione.)
• Creare un oggetto FormsServiceClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.
• Creare un oggetto DocumentManagementServiceClientImpl utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Recuperare la progettazione del modulo da Content Services (obsoleto)

Richiama il metodo retrieveContent dell'oggetto DocumentManagementServiceClientImpl e passa i seguenti valori:

• Valore stringa che specifica l'archivio in cui viene aggiunto il contenuto. L'archivio predefinito è SpacesStore. Questo valore è un parametro obbligatorio.
• Valore stringa che specifica il percorso completo del contenuto da recuperare, ad esempio /Company Home/Form Designs/Loan.xdp. Questo valore è un parametro obbligatorio.
• Valore stringa che specifica la versione. Questo valore è un parametro facoltativo e puoi trasmettere una stringa vuota. In questa situazione, viene recuperata la versione più recente.

Il metodo retrieveContent restituisce un oggetto CRCResult che contiene il file XDP. Ottenere un'istanza com.adobe.idp.Document richiamando il metodo getDocument dell'oggetto CRCResult.

Rendering di un modulo PDF interattivo

Richiama il metodo renderPDFForm2 dell'oggetto FormsServiceClient e passa i seguenti valori:

• Oggetto com.adobe.idp.Document contenente la struttura del modulo recuperato da Content Services (obsoleto).
• Oggetto com.adobe.idp.Document contenente dati da unire al modulo. Se non si desidera unire i dati, passare un oggetto com.adobe.idp.Document vuoto.
• Un oggetto PDFFormRenderSpec che memorizza le opzioni di runtime. Questo valore è un parametro facoltativo ed è possibile specificare null se non si desidera specificare le opzioni di runtime.
• Oggetto URLSpec contenente valori URI. Questo valore è un parametro facoltativo ed è possibile specificare null.
• Oggetto java.util.HashMap che memorizza gli allegati. Questo valore è un parametro facoltativo ed è possibile specificare null se non si desidera allegare file al modulo.

Il metodo renderPDFForm restituisce un oggetto FormsResult che contiene un flusso di dati del modulo che deve essere scritto nel browser Web client.

Eseguire un'azione con il flusso di dati del modulo

• Creare un oggetto com.adobe.idp.Document richiamando il metodo getOutputContent dell'oggetto FormsResult.
• Ottenere il tipo di contenuto dell'oggetto com.adobe.idp.Document richiamando il relativo metodo getContentType.
• Impostare il tipo di contenuto dell'oggetto javax.servlet.http.HttpServletResponse richiamando il relativo metodo setContentType e passando il tipo di contenuto dell'oggetto com.adobe.idp.Document.
• Creare un oggetto javax.servlet.ServletOutputStream utilizzato per scrivere il flusso di dati del modulo nel browser Web client richiamando il metodo getOutputStream dell'oggetto javax.servlet.http.HttpServletResponse.
• Creare un oggetto java.io.InputStream richiamando il metodo getInputStream dell'oggetto com.adobe.idp.Document.
• Creare una matrice di byte e popolarla con il flusso di dati del modulo richiamando il metodo read dell'oggetto InputStream. Passa la matrice di byte come argomento.
• Richiama il metodo write dell'oggetto javax.servlet.ServletOutputStream per inviare il flusso di dati del modulo al browser Web client. Passare la matrice di byte al metodo write.

Includi file di progetto

Creare un progetto Microsoft .NET che utilizza MTOM. Poiché questa applicazione client richiama due servizi AEM Forms, creare due riferimenti al servizio. Utilizzare la seguente definizione WSDL per il riferimento al servizio associato al servizio Forms: http://localhost:8080/soap/services/FormsService?WSDL&lc_version=9.0.1.

Utilizzare la seguente definizione WSDL per il riferimento al servizio associato al servizio Document Management: http://localhost:8080/soap/services/DocumentManagementService?WSDL&lc_version=9.0.1.

Poiché il tipo di dati BLOB è comune a entrambi i riferimenti al servizio, il tipo di dati BLOB viene completamente qualificato quando viene utilizzato. Nel servizio Web corrispondente, avvio rapido, tutte le BLOB istanze sono completamente qualificate.

Creare un oggetto Forms e un oggetto API client di Document Management

• Creare un oggetto FormsServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto FormsServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/FormsService?WSDL). Non è necessario utilizzare l'attributo lc_version. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.)

• Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo FormsServiceClient.Endpoint.Binding. Eseguire il cast del valore restituito in BasicHttpBinding.

• Impostare il campo MessageEncoding dell'oggetto System.ServiceModel.BasicHttpBinding su WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

• Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:

  • Assegnare il nome utente dei moduli AEM al campo FormsServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo FormsServiceClient.ClientCredentials.UserName.Password.
  • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.

• Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

Recuperare la progettazione del modulo da Content Services (obsoleto)

Recuperare il contenuto richiamando il metodo retrieveContent dell'oggetto DocumentManagementServiceClient e passando i valori seguenti:

• Valore stringa che specifica l'archivio in cui viene aggiunto il contenuto. L'archivio predefinito è SpacesStore. Questo valore è un parametro obbligatorio.
• Valore stringa che specifica il percorso completo del contenuto da recuperare, ad esempio /Company Home/Form Designs/Loan.xdp. Questo valore è un parametro obbligatorio.
• Valore stringa che specifica la versione. Questo valore è un parametro facoltativo e puoi trasmettere una stringa vuota. In questa situazione, viene recuperata la versione più recente.
• Parametro di output stringa che memorizza il valore del collegamento Sfoglia.
• Un parametro di output BLOB che memorizza il contenuto. Puoi utilizzare questo parametro di output per recuperare il contenuto.
• Un parametro di output ServiceReference1.MyMapOf_xsd_string_To_xsd_anyType che memorizza gli attributi del contenuto.
• Un parametro di output CRCResult. Anziché utilizzare questo oggetto, è possibile utilizzare il parametro di output BLOB per ottenere il contenuto.

Rendering di un modulo PDF interattivo

Richiama il metodo renderPDFForm2 dell'oggetto FormsServiceClient e passa i seguenti valori:

• Oggetto BLOB contenente la struttura del modulo recuperato da Content Services (obsoleto).
• Oggetto BLOB contenente dati da unire al modulo. Se non si desidera unire i dati, passare un oggetto BLOB vuoto.
• Un oggetto PDFFormRenderSpec che memorizza le opzioni di runtime. Questo valore è un parametro facoltativo ed è possibile specificare null se non si desidera specificare le opzioni di runtime.
• Oggetto URLSpec contenente valori URI. Questo valore è un parametro facoltativo ed è possibile specificare null.
• Oggetto Map che memorizza gli allegati. Questo valore è un parametro facoltativo ed è possibile specificare null se non si desidera allegare file al modulo.
• Un parametro di output lungo utilizzato per memorizzare il conteggio delle pagine.
• Parametro di output stringa utilizzato per memorizzare il valore delle impostazioni locali.
• Un parametro di output FormsResult utilizzato per memorizzare il modulo di interactrive PDF .

Il metodo renderPDFForm2 restituisce un oggetto FormsResult che contiene il modulo PDF interattivo.

Eseguire un'azione con il flusso di dati del modulo

• Creare un oggetto BLOB contenente dati del modulo ottenendo il valore del campo outputContent dell'oggetto FormsResult.
• Creare un oggetto System.IO.FileStream richiamando il relativo costruttore. Passa un valore stringa che rappresenta la posizione del file del documento interattivo di PDF e la modalità di apertura del file.
• Creare una matrice di byte che memorizza il contenuto dell'oggetto BLOB recuperato dall'oggetto FormsResult. Popolare la matrice di byte ottenendo il valore del membro dati MTOM dell'oggetto BLOB.
• Creare un oggetto System.IO.BinaryWriter richiamandone il costruttore e passando l'oggetto System.IO.FileStream.
• Scrivere il contenuto della matrice di byte in un file PDF richiamando il metodo Write dell'oggetto System.IO.BinaryWriter e passando la matrice di byte.