Disassemblare un documento PDF utilizzando l’API del servizio web disassemble-a-pdf-document-usingthe-web-service-api
Gli esempi e gli esempi contenuti in questo documento sono solo per AEM Forms in ambiente JEE.
Disassemblare un documento PDF utilizzando l'API del servizio Assembler (servizio Web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL durante l'impostazione di un riferimento al servizio:
http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l'indirizzo IP del server che ospita AEM Forms. -
Creare un client PDF Assembler.
-
Creare un oggetto
AssemblerServiceClient
utilizzando il relativo costruttore predefinito. -
Creare un oggetto
AssemblerServiceClient.Endpoint.Address
utilizzando il costruttoreSystem.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'attributolc_version
. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. -
Creare un oggetto
System.ServiceModel.BasicHttpBinding
ottenendo il valore del campoAssemblerServiceClient.Endpoint.Binding
. Eseguire il cast del valore restituito inBasicHttpBinding
. -
Impostare il campo
MessageEncoding
dell'oggettoSystem.ServiceModel.BasicHttpBinding
suWSMessageEncoding.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 campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Assegnare il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- Assegnare il nome utente dei moduli AEM al campo
-
-
Fare riferimento a un documento DDX esistente.
- Creare un oggetto
BLOB
utilizzando il relativo costruttore. L'oggettoBLOB
viene utilizzato per archiviare il documento DDX. - Creare un oggetto
System.IO.FileStream
richiamando il relativo costruttore. Passa un valore stringa che rappresenta la posizione del file del documento DDX e la modalità di apertura del file. - 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'oggettoSystem.IO.FileStream
. - Compilare la matrice di byte con i dati di flusso richiamando il metodo
Read
dell'oggettoSystem.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.
- Creare un oggetto
-
Fare riferimento a un documento PDF da disassemblare.
- Creare un oggetto
BLOB
utilizzando il relativo costruttore. L'oggettoBLOB
viene utilizzato per memorizzare il documento PDF di input. Questo oggettoBLOB
è passato ainvokeOneDocument
come argomento. - Creare un oggetto
System.IO.FileStream
richiamandone il costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF di input e la modalità di apertura del file. - 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'oggettoSystem.IO.FileStream
. - Compilare la matrice di byte con i dati di flusso richiamando il metodo
Read
dell'oggettoSystem.IO.FileStream
e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Compilare l'oggetto
BLOB
assegnando al relativo campoMTOM
il contenuto della matrice di byte. - Creare un oggetto
MyMapOf_xsd_string_To_xsd_anyType
. Questo oggetto insieme viene utilizzato per memorizzare il PDF da disassemblare. - Creare un oggetto
MyMapOf_xsd_string_To_xsd_anyType_Item
. - Assegnare un valore stringa che rappresenta il nome chiave al campo
key
dell'oggettoMyMapOf_xsd_string_To_xsd_anyType_Item
. Questo valore deve corrispondere al valore dell'elemento di origine PDF specificato nel documento DDX. - Assegnare l'oggetto
BLOB
che memorizza il documento PDF al campovalue
dell'oggettoMyMapOf_xsd_string_To_xsd_anyType_Item
. - Aggiungere l'oggetto
MyMapOf_xsd_string_To_xsd_anyType_Item
all'oggettoMyMapOf_xsd_string_To_xsd_anyType
. Richiama il metodoAdd
dell'oggettoMyMapOf_xsd_string_To_xsd_anyType
e passa l'oggettoMyMapOf_xsd_string_To_xsd_anyType
.
- Creare un oggetto
-
Impostare le opzioni di runtime.
- Creare un oggetto
AssemblerOptionSpec
che memorizza le opzioni di runtime utilizzando il relativo costruttore. - Impostare le opzioni di runtime per soddisfare i requisiti aziendali assegnando un valore a un membro dati che appartiene all'oggetto
AssemblerOptionSpec
. Ad esempio, per indicare al servizio Assembler di continuare a elaborare un processo quando si verifica un errore, assegnarefalse
al campofailOnError
dell'oggettoAssemblerOptionSpec
.
- Creare un oggetto
-
Disassemblare il documento PDF.
Richiama il metodo
invokeDDX
dell'oggettoAssemblerServiceClient
e passa i seguenti valori:- Oggetto
BLOB
che rappresenta il documento DDX che disassembla il documento PDF - L'oggetto
MyMapOf_xsd_string_To_xsd_anyType
che contiene il documento PDF da disassemblare - Oggetto
AssemblerOptionSpec
che specifica le opzioni di runtime
Il metodo
invokeDDX
restituisce un oggettoAssemblerResult
contenente i risultati del processo ed eventuali eccezioni. - Oggetto
-
Salvare i documenti PDF disassemblati.
Per ottenere i documenti di PDF appena creati, effettuare le seguenti operazioni:
- Accedere al campo
documents
dell'oggettoAssemblerResult
, che è un oggettoMap
contenente i documenti PDF disassemblati. - Scorrere l'oggetto
Map
per ottenere ogni documento risultante. Quindi, esegui il cast divalue
del membro dell'array in unBLOB
. - Estrarre i dati binari che rappresentano il documento PDF accedendo alla proprietà
MTOM
dell'oggettoBLOB
. Restituisce una matrice di byte che è possibile scrivere in un file PDF.
- Accedere al campo
Consulta anche
Disassemblaggio di documenti PDF a livello di programmazione
Richiamare AEM Forms tramite MTOM