Convalida dei documenti DDX validating-ddx-documents

Includi file di progetto.

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

Creare un client PDF Assembler.

• Creare un oggetto ServiceClientFactory contenente le proprietà di connessione.
• Creare un oggetto AssemblerServiceClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory.

Fare riferimento a un documento DDX esistente.

• Creare un oggetto java.io.FileInputStream che rappresenta il documento DDX utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del file DDX.
• Creare un oggetto com.adobe.idp.Document utilizzando il relativo costruttore e passando l'oggetto java.io.FileInputStream.

Impostare le opzioni di runtime per convalidare il documento DDX.

• Creare un oggetto AssemblerOptionSpec che memorizza le opzioni di runtime utilizzando il relativo costruttore.
• Impostare l'opzione di runtime che indica al servizio Assembler di convalidare il documento DDX richiamando il metodo setValidateOnly dell'oggetto AssemblerOptionSpec e passando true.
• Impostare la quantità di informazioni che il servizio Assembler scrive nel file di log richiamando il metodo getLogLevel dell'oggetto AssemblerOptionSpec e fornendo un valore stringa che soddisfi i requisiti. Durante la convalida di un documento DDX, è necessario disporre di ulteriori informazioni scritte nel file di registro che possano essere utili per il processo di convalida. È quindi possibile passare il valore FINE o FINER.

Eseguire la convalida.

Richiama il metodo invokeDDX dell'oggetto AssemblerServiceClient e passa i seguenti valori:

• Oggetto com.adobe.idp.Document che rappresenta il documento DDX.
• Valore null per l'oggetto java.io.Map che in genere memorizza i documenti PDF.
• Oggetto com.adobe.livecycle.assembler.client.AssemblerOptionSpec che specifica le opzioni di runtime.

Il metodo invokeDDX restituisce un oggetto AssemblerResult che contiene informazioni che specificano se il documento DDX è valido.

Salvare i risultati della convalida in un file di registro.

• Creare un oggetto java.io.File e verificare che l'estensione del nome file sia .xml.
• Richiama il metodo getJobLog dell'oggetto AssemblerResult. Questo metodo restituisce un'istanza com.adobe.idp.Document che contiene informazioni di convalida.
• Richiama il metodo copyToFile dell'oggetto com.adobe.idp.Document per copiare il contenuto dell'oggetto com.adobe.idp.Document nel file.

Includi file di progetto.

Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1.

Creare un client PDF Assembler.

• Creare un oggetto AssemblerServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto AssemblerServiceClient.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/AssemblerService?blob=mtom). 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 AssemblerServiceClient.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 AssemblerServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo AssemblerServiceClient.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.

Fare riferimento a un documento DDX esistente.

• Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per archiviare il documento DDX.
• Creare un oggetto System.IO.FileStream richiamandone il costruttore e passando un valore stringa che rappresenta la posizione del file del documento DDX e la modalità di apertura del file in.
• Creare una matrice di byte che memorizza il contenuto dell'oggetto System.IO.FileStream. È possibile determinare le dimensioni della matrice di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
• Compilare la matrice di byte con i dati di flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
• Compilare l'oggetto BLOB assegnando la relativa proprietà MTOM al contenuto della matrice di byte.

Impostare le opzioni di runtime per convalidare il documento DDX.

• Creare un oggetto AssemblerOptionSpec che memorizza le opzioni di runtime utilizzando il relativo costruttore.
• Impostare l'opzione di runtime che indica al servizio Assembler di convalidare il documento DDX assegnando il valore true al membro dati validateOnly dell'oggetto AssemblerOptionSpec.
• Impostare la quantità di informazioni che il servizio Assembler scrive nel file di log assegnando un valore stringa al membro dati logLevel dell'oggetto AssemblerOptionSpec. Metodo Durante la convalida di un documento DDX, è necessario inserire nel file di registro ulteriori informazioni utili per il processo di convalida. È quindi possibile specificare il valore FINE o FINER. Per informazioni sulle opzioni di runtime che è possibile impostare, vedere il riferimento alla classe AssemblerOptionSpec in Riferimento API di AEM Forms.

Eseguire la convalida.

Richiama il metodo invokeDDX dell'oggetto AssemblerServiceClient e passa i seguenti valori:

• Oggetto BLOB che rappresenta il documento DDX.
• Valore null per l'oggetto Map che in genere memorizza i documenti PDF.
• Oggetto AssemblerOptionSpec che specifica le opzioni di runtime.

Il metodo invokeDDX restituisce un oggetto AssemblerResult che contiene informazioni che specificano se il documento DDX è valido.

Salvare i risultati della convalida in un file di registro.

• Creare un oggetto System.IO.FileStream richiamandone il costruttore e passando un valore stringa che rappresenta la posizione del file di log e la modalità di apertura del file in. Verificare che l'estensione del nome file sia .xml.
• Creare un oggetto BLOB che memorizza le informazioni di registro ottenendo il valore del membro dati jobLog dell'oggetto AssemblerResult.
• Creare una matrice di byte che memorizza il contenuto dell'oggetto BLOB. Compilare la matrice di byte ottenendo il valore del campo 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.