Assegnazione dei diritti di utilizzo assigning-usage-rights
Gli esempi e gli esempi contenuti in questo documento sono solo per l’ambiente AEM Forms su JEE.
Informazioni sul servizio estensioni Acrobat Reader DC about-the-acrobat-reader-dc-extensions-service
Il servizio Estensioni di Acrobat Reader DC consente all’organizzazione di condividere facilmente i documenti interattivi di PDF estendendo le funzionalità di Adobe Reader. Il servizio Estensioni di Acrobat Reader DC supporta completamente qualsiasi documento PDF, fino a PDF 1.7 incluso. Funziona con Adobe Reader 7.0 e versioni successive. Il servizio aggiunge diritti di utilizzo a un documento PDF, attivando funzionalità che in genere non sono disponibili quando un documento PDF viene aperto tramite Adobe Reader. Gli utenti di terze parti non richiedono software o plug-in aggiuntivi per lavorare con i documenti abilitati per i diritti.
Puoi eseguire queste attività utilizzando il servizio Estensioni di Acrobat Reader DC:
- Applica i diritti di utilizzo ai documenti di PDF. Per informazioni, consulta Applicazione dei diritti di utilizzo ai documenti di PDF.
- Rimuovere i diritti di utilizzo dai documenti PDF. Per informazioni, consulta Rimozione dei diritti di utilizzo dai documenti di PDF.
- Recupera i dettagli delle credenziali. Per informazioni, consulta Recupero informazioni sulle credenziali.
Applicazione dei diritti di utilizzo ai documenti di PDF applying-usage-rights-to-pdf-documents
Puoi applicare i diritti di utilizzo ai documenti PDF utilizzando l’API client Java e il servizio web per le estensioni di Acrobat Reader DC. I diritti di utilizzo riguardano funzionalità disponibili per impostazione predefinita in Acrobat ma non in Adobe Reader, ad esempio la possibilità di aggiungere commenti a un modulo o di compilare campi modulo e salvare il modulo. I documenti PDF a cui sono applicati diritti di utilizzo sono denominati documenti abilitati per i diritti. L’utente che apre un documento abilitato ai diritti in Adobe Reader può eseguire operazioni abilitate per quel documento specifico.
applyUsageRights
, che fa parte dell'API Java, puoi impostare il isModeFinal
parametro di ReaderExtensionsOptionSpec
oggetto a false
. In questo modo il contatore dei moduli elaborati non viene aggiornato e si ottiene un miglioramento delle prestazioni. Se non si desidera aggiornare il contatore dei moduli elaborati, si consiglia di impostare isModeFinal
parametro a false
.Riepilogo dei passaggi summary-of-steps
Per applicare i diritti di utilizzo a un documento PDF, effettuare le seguenti operazioni:
- Includi file di progetto.
- Crea un oggetto client per estensioni Acrobat Reader DC.
- Recuperare un documento PDF.
- Specificare i diritti di utilizzo da applicare.
- Applica i diritti di utilizzo al documento PDF.
- Salva il documento di PDF con abilitazione per i diritti.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
Creare un oggetto client per estensioni Acrobat Reader DC
Per eseguire a livello di programmazione un'operazione del servizio di estensione di Acrobat Reader DC, è necessario creare un oggetto client del servizio di estensione di Acrobat Reader DC. Se utilizzi le estensioni Java API di Acrobat Reader DC, crea un’ ReaderExtensionsServiceClient
oggetto. Se utilizzi l’API del servizio web Acrobat Reader DC extensions, puoi creare una ReaderExtensionsServiceService
oggetto.
Recuperare un documento PDF
Recupera un documento PDF per applicare i diritti di utilizzo. I documenti PDF con abilitazione per i diritti contengono un dizionario dei diritti di utilizzo. Quando Adobe Reader apre un documento contenente tale dizionario, abilita i diritti di utilizzo specificati nel dizionario solo per quel documento. Se il documento non contiene un dizionario dei diritti di utilizzo, il servizio Acrobat Reader DC Extension ne crea uno. Se contiene già un dizionario, il servizio Acrobat Reader DC extensions sovrascrive i diritti di utilizzo esistenti con quelli specificati. Il dizionario specifica quali diritti di utilizzo sono abilitati. Quando un utente apre il documento in Adobe Reader, sono consentiti solo i diritti di utilizzo specificati nel dizionario.
Specificare i diritti di utilizzo da applicare
I diritti di utilizzo che è possibile impostare sono determinati da una credenziale acquistata da Adobe Systems Incorporated. Le credenziali forniscono in genere l'autorizzazione per impostare un gruppo di diritti di utilizzo correlati, ad esempio quelli relativi ai moduli interattivi. Ogni credenziale consente di creare un determinato numero di documenti di PDF abilitati per i diritti. Una credenziale di valutazione consente di creare un numero illimitato di bozze di documenti.
Applica i diritti di utilizzo al documento PDF
Per applicare i diritti di utilizzo a un documento PDF, si fa riferimento all'alias delle credenziali utilizzate per applicare i diritti di utilizzo (una credenziale viene in genere installata durante l'installazione di AEM Forms). È inoltre necessario specificare il documento PDF al quale vengono applicati i diritti di utilizzo. Per informazioni sulla configurazione di una credenziale, vedere la guida all'installazione e alla distribuzione per il server applicazioni.
Salva il documento di PDF con abilitazione per i diritti
Dopo aver applicato i diritti di utilizzo a un documento di Acrobat Reader DC PDF, è possibile salvare il documento di PDF con abilitazione per i diritti come file di PDF.
Consulta anche
Applicare i diritti di utilizzo utilizzando l’API Java
Applicare i diritti di utilizzo utilizzando l’API del servizio web
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio Estensioni di Acrobat Reader DC
Applicare i diritti di utilizzo utilizzando l’API Java apply-usage-rights-using-the-java-api
Applica i diritti di utilizzo a un documento PDF utilizzando l’API delle estensioni Acrobat Reader DC (Java):
-
Includi file di progetto
Includi i file JAR client, ad esempio adobe-reader-extensions-client.jar, nel percorso della classe del progetto Java.
-
Crea un oggetto client per estensioni Acrobat Reader DC.
- Creare un
ServiceClientFactory
oggetto che contiene proprietà di connessione. - Creare un
ReaderExtensionsServiceClient
mediante il costruttore e passando ilServiceClientFactory
oggetto.
- Creare un
-
Recuperare un documento PDF.
- Creare un
java.io.FileInputStream
oggetto che rappresenta il documento PDF utilizzando il relativo costruttore e passando un valore stringa che specifica la posizione del documento PDF. - Creare un
com.adobe.idp.Document
mediante il costruttore e passando iljava.io.FileInputStream
oggetto.
- Creare un
-
Specificare i diritti di utilizzo da applicare.
- Creare un
UsageRights
oggetto che rappresenta i diritti di utilizzo mediante il relativo costruttore. - Per ogni diritto di utilizzo da applicare, richiama un metodo corrispondente che appartiene al
UsageRights
oggetto. Ad esempio, per aggiungereenableFormFillIn
diritto di utilizzo, richiamaUsageRights
dell'oggettoenableFormFillIn
metodo e passaggiotrue
. (Ripeti questo passaggio per ogni diritto d’uso da applicare).
- Creare un
-
Applica i diritti di utilizzo al documento PDF.
-
Creare un
ReaderExtensionsOptionSpec
mediante il costruttore. Questo oggetto contiene le opzioni di runtime richieste dal servizio Acrobat Reader DC extensions. Quando si richiama questo costruttore, è necessario specificare i seguenti valori:- Il
UsageRights
oggetto contenente i diritti di utilizzo da applicare al documento. - Valore stringa che specifica un messaggio visualizzato da un utente quando il documento di PDF con abilitazione per i diritti viene aperto in Adobe Reader 7.x. Questo messaggio non viene visualizzato in Adobe Reader 8.0.
- Il
-
Applicare i diritti di utilizzo al documento PDF richiamando
ReaderExtensionsServiceClient
dell'oggettoapplyUsageRights
e fornendo i seguenti valori:- Il
com.adobe.idp.Document
oggetto che contiene il documento PDF a cui vengono applicati i diritti di utilizzo. - Valore stringa che specifica l'alias della credenziale che consente di applicare i diritti di utilizzo.
- Valore stringa che specifica il valore password corrispondente. (Attualmente questo parametro viene ignorato. È possibile trasmettere
null
.)
- Il
-
Il
ReaderExtensionsOptionSpec
oggetto contenente opzioni di runtime.
Il
applyUsageRights
il metodo restituisce uncom.adobe.idp.Document
oggetto contenente il documento PDF con abilitazione per i diritti. -
-
Salva il documento di PDF con abilitazione per i diritti.
- Creare un
java.io.File
e assicurarsi che l'estensione del file sia .pdf. - Richiama
com.adobe.idp.Document
dell'oggettocopyToFile
metodo per copiare il contenuto delcom.adobe.idp.Document
al file (assicurati di utilizzare ilcom.adobe.idp.Document
oggetto restituito daapplyUsageRights
metodo).
- Creare un
Consulta anche
Applicazione dei diritti di utilizzo ai documenti di PDF
Quick Start (modalità SOAP):Applicazione dei diritti di utilizzo tramite l’API Java
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Applicare i diritti di utilizzo utilizzando l’API del servizio web apply-usage-rights-using-the-web-service-api
Applica i diritti di utilizzo a un documento PDF utilizzando l’API delle estensioni di Acrobat Reader DC (servizio web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Crea un oggetto client per estensioni Acrobat Reader DC.
-
Creare un
ReaderExtensionsServiceClient
utilizzando il costruttore predefinito. -
Creare un
ReaderExtensionsServiceClient.Endpoint.Address
oggetto utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom
. Assicurati di specificare?blob=mtom
.) -
Creare un
System.ServiceModel.BasicHttpBinding
dell'oggetto ottenendo il valore delReaderExtensionsServiceClient.Endpoint.Binding
campo. Invia il valore restituito aBasicHttpBinding
. -
Imposta il
System.ServiceModel.BasicHttpBinding
dell'oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegna al campo il nome utente dei moduli AEM
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore password corrispondente al campo
ReaderExtensionsServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- Assegna al campo il nome utente dei moduli AEM
-
-
Recuperare un documento PDF.
- Creare un
BLOB
mediante il costruttore. IlBLOB
L'oggetto viene utilizzato per memorizzare un documento PDF a cui sono applicati diritti di utilizzo. - Creare un
System.IO.FileStream
dell'oggetto richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file. - Creare una matrice di byte che memorizza il contenuto della
System.IO.FileStream
oggetto. È possibile determinare le dimensioni della matrice di byte ottenendoSystem.IO.FileStream
dell'oggettoLength
proprietà. - Compilare la matrice di byte con i dati di flusso richiamando
System.IO.FileStream
dell'oggettoRead
metodo. Passare la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare il
BLOB
oggetto assegnando il relativoMTOM
con il contenuto della matrice di byte.
- Creare un
-
Specificare i diritti di utilizzo da applicare.
- Creare un
UsageRights
oggetto che rappresenta i diritti di utilizzo mediante il relativo costruttore. - Per ogni diritto di utilizzo da applicare, assegna il valore
true
al membro dati corrispondente che appartiene alUsageRights
oggetto. Ad esempio, per aggiungereenableFormFillIn
diritto di utilizzo, assegnazionetrue
alUsageRights
dell'oggettoenableFormFillIn
membro dati. (Ripeti questo passaggio per ogni diritto d’uso da applicare).
- Creare un
-
Applica i diritti di utilizzo al documento PDF.
-
Creare un
ReaderExtensionsOptionSpec
mediante il costruttore. Questo oggetto contiene le opzioni di runtime richieste dal servizio Acrobat Reader DC extensions. -
Assegna la
UsageRights
oggetto alReaderExtensionsOptionSpec
dell'oggettousageRights
membro dati. -
Assegna un valore stringa che specifica il messaggio visualizzato da un utente quando il documento PDF con abilitazione per i diritti viene aperto in Adobe Reader al
ReaderExtensionsOptionSpec
dell'oggettomessage
membro dati. -
Applicare i diritti di utilizzo al documento PDF richiamando
ReaderExtensionsServiceClient
dell'oggettoapplyUsageRights
e fornendo i seguenti valori:- Il
BLOB
oggetto che contiene il documento PDF a cui vengono applicati i diritti di utilizzo. - Valore stringa che specifica l'alias della credenziale che consente di applicare i diritti di utilizzo.
- Valore stringa che specifica il valore password corrispondente. (Attualmente questo parametro viene ignorato. È possibile trasmettere
null
.)
- Il
-
Il
ReaderExtensionsOptionSpec
oggetto contenente opzioni di runtime.
Il
applyUsageRights
il metodo restituisce unBLOB
oggetto contenente il documento PDF con abilitazione per i diritti. -
-
Salva il documento di PDF con abilitazione per i diritti.
- Creare un
System.IO.FileStream
richiamando il relativo costruttore. Passa un valore stringa che rappresenta la posizione del file del documento di PDF con abilitazione per i diritti. - Creare una matrice di byte che memorizza il contenuto dei dati
BLOB
oggetto restituito daapplyUsageRights
metodo. Popolare la matrice di byte ottenendo il valore dellaBLOB
dell'oggettoMTOM
membro dati. - Creare un
System.IO.BinaryWriter
oggetto richiamando il relativo costruttore e passando ilSystem.IO.FileStream
oggetto. - Scrivere il contenuto della matrice di byte in un file PDF richiamando
System.IO.BinaryWriter
dell'oggettoWrite
e passando la matrice di byte.
- Creare un
Consulta anche
Applicazione dei diritti di utilizzo ai documenti di PDF
Richiamare AEM Forms tramite MTOM
Richiamare AEM Forms con SwaRef
Rimozione dei diritti di utilizzo dai documenti di PDF removing-usage-rights-from-pdf-documents
È possibile rimuovere i diritti di utilizzo da un documento abilitato per i diritti. La rimozione dei diritti di utilizzo da un documento PDF abilitato ai diritti è necessaria anche per eseguire altre operazioni AEM Forms su di esso. È ad esempio necessario firmare digitalmente (o certificare) un documento di PDF prima di impostare i diritti di utilizzo. Pertanto, se si desidera eseguire operazioni su un documento abilitato ai diritti, è necessario rimuovere i diritti di utilizzo dal documento PDF, eseguire le altre operazioni, ad esempio la firma digitale del documento, quindi riapplicare i diritti di utilizzo al documento.
Riepilogo dei passaggi summary_of_steps-1
Per rimuovere i diritti di utilizzo da un documento di PDF abilitato per i diritti, effettuare le seguenti operazioni:
- Includi file di progetto.
- Crea un oggetto client per estensioni Acrobat Reader DC.
- Recuperare un documento di PDF abilitato per i diritti.
- Rimuovi i diritti di utilizzo dal documento PDF.
- Salvare il documento PDF.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
Creare un oggetto client per estensioni Acrobat Reader DC
Prima di poter eseguire un'operazione del servizio Acrobat Reader DC extensions a livello di programmazione, è necessario creare un oggetto client del servizio Acrobat Reader DC extensions. Se utilizzi l’API Java, crea un’ ReaderExtensionsServiceClient
oggetto. Se utilizzi l’API del servizio web Acrobat Reader DC extensions, puoi creare una ReaderExtensionsServiceService
oggetto.
Recuperare un documento di PDF abilitato per i diritti
Recupera un documento PDF con abilitazione dei diritti per rimuovere i diritti di utilizzo.
Rimuovi i diritti di utilizzo dal documento di PDF
Dopo aver recuperato un documento di PDF con abilitazione dei diritti, è possibile rimuovere i diritti di utilizzo. Dopo aver rimosso i diritti di utilizzo, il documento PDF non avrà alcuna funzionalità aggiuntiva durante la visualizzazione in Adobe Reader.
Salva il documento PDF
È possibile salvare il documento PDF che non contiene più diritti di utilizzo come file PDF. Una volta salvato come file PDF, il documento PDF può essere visualizzato in Adobe Reader o Acrobat.
Consulta anche
Rimuovere i diritti di utilizzo utilizzando l’API Java
Rimuovere i diritti di utilizzo utilizzando l’API del servizio web
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio Estensioni di Acrobat Reader DC
Applicazione dei diritti di utilizzo ai documenti di PDF
Rimuovere i diritti di utilizzo utilizzando l’API Java remove-usage-rights-using-the-java-api
Rimuovere i diritti di utilizzo da un documento PDF con abilitazione per i diritti utilizzando l’API delle estensioni Acrobat Reader DC (Java):
-
Includi file di progetto.
Includi i file JAR client, ad esempio adobe-reader-extensions-client.jar, nel percorso della classe del progetto Java.
-
Crea un oggetto client per estensioni Acrobat Reader DC.
Creare un
ReaderExtensionsServiceClient
oggetto utilizzando il relativo costruttore e passando unServiceClientFactory
oggetto che contiene proprietà di connessione. -
Recuperare un documento PDF.
- Creare un
java.io.FileInputStream
oggetto che rappresenta il documento PDF con abilitazione per i diritti tramite il relativo costruttore e passando un valore stringa che specifica la posizione del documento PDF. - Creare un
com.adobe.idp.Document
mediante il costruttore e passando iljava.io.FileInputStream
oggetto.
- Creare un
-
Rimuovi i diritti di utilizzo dal documento PDF.
Rimuovere i diritti di utilizzo dal documento PDF richiamando
ReaderExtensionsServiceClient
dell'oggettoremoveUsageRights
e passando ilcom.adobe.idp.Document
oggetto contenente il documento PDF con abilitazione per i diritti. Questo metodo restituisce uncom.adobe.idp.Document
oggetto contenente un documento PDF che non dispone di diritti di utilizzo. -
Applica i diritti di utilizzo al documento PDF.
- Creare un
java.io.File
e assicurarsi che l'estensione del file sia .PDF. - Richiama
Document
dell'oggettocopyToFile
metodo per copiare il contenuto delDocument
al file (assicurati di utilizzare ilDocument
oggetto restituito daremoveUsageRights
metodo).
- Creare un
Consulta anche
Rimozione dei diritti di utilizzo dai documenti di PDF
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Rimuovere i diritti di utilizzo utilizzando l’API del servizio web remove-usage-rights-using-the-web-service-api
Rimuovi i diritti di utilizzo da un documento di PDF abilitato ai diritti utilizzando l’API delle estensioni di Acrobat Reader DC (servizio web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Crea un oggetto client per estensioni Acrobat Reader DC.
-
Creare un
ReaderExtensionsServiceClient
utilizzando il costruttore predefinito. -
Creare un
ReaderExtensionsServiceClient.Endpoint.Address
oggetto utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom
. Assicurati di specificare?blob=mtom
.) -
Creare un
System.ServiceModel.BasicHttpBinding
dell'oggetto ottenendo il valore delReaderExtensionsServiceClient.Endpoint.Binding
campo. Invia il valore restituito aBasicHttpBinding
. -
Imposta il
System.ServiceModel.BasicHttpBinding
dell'oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegna al campo il nome utente dei moduli AEM
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore password corrispondente al campo
ReaderExtensionsServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- Assegna al campo il nome utente dei moduli AEM
-
-
Recuperare un documento PDF.
- Creare un
BLOB
mediante il costruttore. IlBLOB
L'oggetto viene utilizzato per memorizzare il documento PDF con abilitazione per i diritti da cui vengono rimossi i diritti di utilizzo. - Creare un
System.IO.FileStream
dell'oggetto richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file. - Creare una matrice di byte che memorizza il contenuto della
System.IO.FileStream
oggetto. È possibile determinare le dimensioni della matrice di byte ottenendoSystem.IO.FileStream
dell'oggettoLength
proprietà. - Compilare la matrice di byte con i dati di flusso richiamando
System.IO.FileStream
dell'oggettoRead
e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare il
BLOB
oggetto assegnando il relativoMTOM
con il contenuto della matrice di byte.
- Creare un
-
Rimuovi i diritti di utilizzo dal documento PDF.
Rimuovere i diritti di utilizzo dal documento PDF richiamando
ReaderExtensionsServiceClient
dell'oggettoremoveUsageRights
e passando ilBLOB
oggetto contenente il documento PDF con abilitazione per i diritti. Questo metodo restituisce unBLOB
oggetto contenente un documento PDF che non dispone di diritti di utilizzo. -
Applica i diritti di utilizzo al documento PDF.
- Creare un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file PDF. - Creare una matrice di byte che memorizza il contenuto dei dati
BLOB
oggetto restituito daremoveUsageRights
metodo. Popolare la matrice di byte ottenendo il valore dellaBLOB
dell'oggettoMTOM
membro dati. - Creare un
System.IO.BinaryWriter
oggetto richiamando il relativo costruttore e passando ilSystem.IO.FileStream
oggetto.
- Creare un
Consulta anche
Rimozione dei diritti di utilizzo dai documenti di PDF
Richiamare AEM Forms tramite MTOM
Richiamare AEM Forms con SwaRef
Recupero informazioni sulle credenziali retrieving-credential-information
È possibile recuperare informazioni sulle credenziali utilizzate per applicare i diritti di utilizzo a un documento di PDF abilitato per i diritti. Recuperando le informazioni su una credenziale, è possibile ottenere informazioni quali la data dopo la quale il certificato non è più valido.
Riepilogo dei passaggi summary_of_steps-2
Per recuperare informazioni sulle credenziali utilizzate per applicare i diritti di utilizzo a un documento PDF, effettuare le seguenti operazioni:
- Includi file di progetto.
- Crea un oggetto client per estensioni Acrobat Reader DC.
- Recuperare un documento di PDF abilitato per i diritti.
- Recuperare le informazioni sulle credenziali.
Includi file di progetto
Includi i file necessari nel progetto di sviluppo. Se stai creando un’applicazione client utilizzando Java, includi i file JAR necessari. Se utilizzi i servizi web, accertati di includere i file proxy.
Creare un oggetto client per estensioni Acrobat Reader DC
Prima di poter eseguire un'operazione del servizio Acrobat Reader DC extensions a livello di programmazione, è necessario creare un oggetto client del servizio Acrobat Reader DC extensions. Se utilizzi l’API Java, crea un’ ReaderExtensionsServiceClient
oggetto. Se utilizzi l’API del servizio web Acrobat Reader DC extensions, puoi creare una ReaderExtensionsServiceService
oggetto.
Recuperare un documento di PDF abilitato per i diritti
Recuperare un documento PDF abilitato per i diritti per recuperare informazioni sulle credenziali. È inoltre possibile recuperare informazioni su una credenziale specificandone l'alias. Tuttavia, se si desidera recuperare informazioni su una credenziale utilizzata per applicare i diritti di utilizzo a un documento PDF con diritti specifici, è necessario recuperare il documento.
Recupera informazioni sulle credenziali
Dopo aver recuperato un documento di PDF abilitato per i diritti, è possibile ottenere informazioni sulle credenziali utilizzate per applicare i diritti di utilizzo. È possibile ottenere le seguenti informazioni sulle credenziali:
- Messaggio visualizzato in Adobe Reader quando viene aperto il documento di PDF con abilitazione per i diritti.
- Data dopo la quale le credenziali non sono più valide.
- Data prima della quale le credenziali non sono valide.
- Diritti di utilizzo impostati per questo documento di PDF con abilitazione per i diritti.
- Il numero di volte in cui le credenziali sono state utilizzate.
Consulta anche
Rimuovere i diritti di utilizzo utilizzando l’API Java
Rimuovere i diritti di utilizzo utilizzando l’API del servizio web
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido API del servizio Estensioni di Acrobat Reader DC
Recuperare le informazioni sulle credenziali tramite API Java retrieve-credential-information-using-the-java-api
Recupera le informazioni sulle credenziali utilizzando l’API delle estensioni Acrobat Reader DC (Java):
-
Includi file di progetto.
Includi i file JAR client, ad esempio adobe-reader-extensions-client.jar, nel percorso della classe del progetto Java.
-
Crea un oggetto client per estensioni Acrobat Reader DC.
Creare un
ReaderExtensionsServiceClient
oggetto utilizzando il relativo costruttore e passando unServiceClientFactory
oggetto che contiene proprietà di connessione. -
Recuperare un documento PDF.
- Creare un
java.io.FileInputStream
oggetto che rappresenta il documento PDF con abilitazione per i diritti tramite il relativo costruttore e passando un valore stringa che specifica la posizione del documento PDF con abilitazione per i diritti. - Creare un
com.adobe.idp.Document
mediante il costruttore e passando iljava.io.FileInputStream
oggetto.
- Creare un
-
Rimuovi i diritti di utilizzo dal documento PDF.
- Recuperare informazioni sulle credenziali utilizzate per applicare i diritti di utilizzo al documento PDF richiamando
ReaderExtensionsServiceClient
dell'oggettogetDocumentUsageRights
e passando ilcom.adobe.idp.Document
oggetto contenente il documento PDF con abilitazione per i diritti. Questo metodo restituisce unGetUsageRightsResult
oggetto contenente informazioni sulle credenziali. - Recuperare la data dopo la quale le credenziali non sono più valide richiamando
GetUsageRightsResult
dell'oggettogetNotAfter
metodo. Questo metodo restituisce unjava.util.Date
oggetto che rappresenta la data dopo la quale le credenziali non sono più valide. - Recupera il messaggio visualizzato in Adobe Reader quando il documento di PDF con abilitazione per i diritti viene aperto richiamando
GetUsageRightsResult
dell'oggettogetMessage
metodo. Questo metodo restituisce un valore stringa che rappresenta il messaggio.
- Recuperare informazioni sulle credenziali utilizzate per applicare i diritti di utilizzo al documento PDF richiamando
Consulta anche
Recupero informazioni sulle credenziali
Quick Start (modalità SOAP): recupero delle informazioni sulle credenziali tramite l’API Java
Inclusione dei file della libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Recuperare le informazioni sulle credenziali tramite l’API del servizio web retrieve-credential-information-using-the-web-service-api
Recupera le informazioni sulle credenziali tramite l’API delle estensioni di Acrobat Reader DC (servizio web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurarsi di utilizzare la seguente definizione WSDL:
http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1
.note note NOTE Sostituisci localhost
con l’indirizzo IP del server che ospita AEM Forms. -
Crea un oggetto client per estensioni Acrobat Reader DC.
-
Creare un
ReaderExtensionsServiceClient
utilizzando il costruttore predefinito. -
Creare un
ReaderExtensionsServiceClient.Endpoint.Address
oggetto utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il file WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom
. Assicurati di specificare?blob=mtom
.) -
Creare un
System.ServiceModel.BasicHttpBinding
dell'oggetto ottenendo il valore delReaderExtensionsServiceClient.Endpoint.Binding
campo. Invia il valore restituito aBasicHttpBinding
. -
Imposta il
System.ServiceModel.BasicHttpBinding
dell'oggettoMessageEncoding
campo aWSMessageEncoding.Mtom
. Questo valore assicura che venga utilizzato MTOM. -
Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:
- Assegna al campo il nome utente dei moduli AEM
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore password corrispondente al campo
ReaderExtensionsServiceClient.ClientCredentials.UserName.Password
. - Assegna il valore costante
HttpClientCredentialType.Basic
al campoBasicHttpBindingSecurity.Transport.ClientCredentialType
. - Assegna il valore costante
BasicHttpSecurityMode.TransportCredentialOnly
al campoBasicHttpBindingSecurity.Security.Mode
.
- Assegna al campo il nome utente dei moduli AEM
-
-
Recuperare un documento PDF.
- Creare un
BLOB
mediante il costruttore. IlBLOB
L'oggetto viene utilizzato per memorizzare un documento PDF con abilitazione per i diritti. - Creare un
System.IO.FileStream
oggetto richiamando il relativo costruttore e passando un valore stringa che rappresenta la posizione del file del documento PDF con abilitazione per i diritti e la modalità di apertura del file. - Creare una matrice di byte che memorizza il contenuto della
System.IO.FileStream
oggetto. È possibile determinare le dimensioni della matrice di byte ottenendoSystem.IO.FileStream
dell'oggettoLength
proprietà. - Compilare la matrice di byte con i dati di flusso richiamando
System.IO.FileStream
dell'oggettoRead
e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare il
BLOB
oggetto assegnando il relativoMTOM
con il contenuto della matrice di byte.
- Creare un
-
Rimuovi i diritti di utilizzo dal documento PDF.
- Recuperare informazioni sulle credenziali utilizzate per applicare i diritti di utilizzo al documento PDF richiamando
ReaderExtensionsServiceClient
dell'oggettogetDocumentUsageRights
e passando ilcom.adobe.idp.Document
oggetto contenente il documento PDF con abilitazione per i diritti. Questo metodo restituisce unGetUsageRightsResult
oggetto contenente informazioni sulle credenziali. - Recupera la data dopo la quale le credenziali non sono più valide ottenendo il valore di
GetUsageRightsResult
dell'oggettonotAfter
membro dati. Il tipo di dati di questo membro dati èSystem.DateTime
. - Recupera il messaggio visualizzato quando il documento PDF con abilitazione per i diritti viene aperto in Adobe Reader ottenendo il valore di
GetUsageRightsResult
dell'oggettomessage
membro dati. Il tipo di dati di questo membro dati è una stringa. - Recupera il numero di volte in cui le credenziali vengono utilizzate ottenendo il valore di
GetUsageRightsResult
dell'oggettouseCount
membro dati. Il tipo di dati di questo membro dati è un numero intero.
- Recuperare informazioni sulle credenziali utilizzate per applicare i diritti di utilizzo al documento PDF richiamando
Consulta anche
Recupero informazioni sulle credenziali
Richiamare AEM Forms tramite MTOM
Richiamare AEM Forms con SwaRef