Assegnazione dei diritti di utilizzo assigning-usage-rights
Informazioni sul servizio Acrobat Reader DC extensions about-the-acrobat-reader-dc-extensions-service
Il servizio Acrobat Reader DC extensions consente alla tua organizzazione di condividere facilmente documenti PDF interattivi estendendo le funzionalità di Adobe Reader. Il servizio Acrobat Reader DC extensions supporta completamente qualsiasi documento di PDF, fino a PDF 1.7 incluso, e funziona con Adobe Reader 7.0 e versioni successive. Il servizio aggiunge diritti di utilizzo a un documento di PDF, attivando funzioni solitamente non disponibili quando un documento di PDF viene aperto con 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 Acrobat Reader DC extensions:
- Applicazione dei diritti di utilizzo ai documenti PDF. Per informazioni, consulta Applicazione dei diritti di utilizzo ai documenti PDF.
- Rimuovere i diritti di utilizzo dai documenti PDF. Per informazioni, consulta Rimozione dei diritti di utilizzo dai documenti PDF.
- Recupera i dettagli delle credenziali. Per informazioni, consulta Recupero delle informazioni sulle credenziali.
Applicazione dei diritti di utilizzo ai documenti 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 Acrobat Reader DC extensions. I diritti di utilizzo si riferiscono a 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. Un utente che apre un documento abilitato per i diritti in Adobe Reader può eseguire operazioni abilitate per quel documento specifico.
applyUsageRights
, che fa parte dell’API Java, puoi impostare il isModeFinal
del ReaderExtensionsOptionSpec
oggetto false
. Ciò impedisce l’aggiornamento del contatore di elaborazione dei moduli e migliora le prestazioni. Se non si desidera aggiornare il contatore dei moduli elaborati, è consigliabile impostare la isModeFinal
parametro a false
.Riepilogo dei passaggi summary-of-steps
Per applicare i diritti di utilizzo a un documento PDF, eseguire le operazioni seguenti:
- Includi file di progetto.
- Crea un oggetto client Acrobat Reader DC extensions.
- Recupera un documento PDF.
- Specifica i diritti di utilizzo da applicare.
- Applicare i diritti di utilizzo al documento PDF.
- Salvare il documento PDF con diritti abilitati.
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, assicurati di includere i file proxy.
Creare un oggetto client Acrobat Reader DC extensions
Per eseguire programmaticamente un’operazione del servizio di estensione Acrobat Reader DC, devi creare un oggetto client del servizio di estensione Acrobat Reader DC. Se utilizzi l’API Java per le estensioni Acrobat Reader DC, crea un ReaderExtensionsServiceClient
oggetto. Se utilizzi l’API del servizio Web Acrobat Reader DC extensions, crea un ReaderExtensionsServiceService
oggetto.
Recuperare un documento PDF
È necessario recuperare un documento PDF per applicare i diritti di utilizzo. I documenti PDF abilitati 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 extensions 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. Ciascuna credenziale consente di creare un certo numero di documenti PDF abilitati per i diritti. Una credenziale di valutazione dà il diritto di creare un numero illimitato di bozze di documenti.
Applicazione dei diritti di utilizzo al documento PDF
Per applicare i diritti di utilizzo a un documento PDF, è necessario fare riferimento all’alias della credenziale utilizzata per applicare i diritti di utilizzo. In genere, durante l’installazione di AEM Forms viene installata una credenziale. È inoltre necessario specificare il documento PDF a cui vengono applicati i diritti di utilizzo. Per informazioni sulla configurazione di una credenziale, consulta la guida all’installazione e alla distribuzione per il server delle applicazioni.
Salvare il documento PDF con diritti abilitati
Dopo aver applicato i diritti di utilizzo a un documento PDF da parte del servizio Acrobat Reader DC extensions, è possibile salvare il documento PDF con diritti abilitati come file PDF.
Consulta anche
Applicazione dei diritti di utilizzo tramite l’API Java
Applicazione dei diritti di utilizzo tramite l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido dell'API del servizio Acrobat Reader DC Extensions
Applicazione dei diritti di utilizzo tramite 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 file JAR client, come adobe-reader-extensions-client.jar, nel percorso di classe del progetto Java.
-
Crea un oggetto client Acrobat Reader DC extensions.
- Crea un
ServiceClientFactory
oggetto contenente le proprietà di connessione. - Crea un
ReaderExtensionsServiceClient
utilizzando il relativo costruttore e passandoServiceClientFactory
oggetto.
- Crea un
-
Recupera un documento PDF.
- Crea un
java.io.FileInputStream
oggetto che rappresenta il documento PDF utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF. - Crea un
com.adobe.idp.Document
utilizzando il relativo costruttore e passandojava.io.FileInputStream
oggetto.
- Crea un
-
Specifica i diritti di utilizzo da applicare.
- Crea un
UsageRights
oggetto che rappresenta i diritti di utilizzo utilizzando il relativo costruttore. - Per ogni diritto di utilizzo da applicare, richiama un metodo corrispondente che appartiene al
UsageRights
oggetto. Ad esempio, per aggiungere ilenableFormFillIn
diritto di utilizzo, richiamareUsageRights
dell’oggettoenableFormFillIn
metodo e passaggiotrue
. (Ripeti questo passaggio per ogni diritto di utilizzo da applicare).
- Crea un
-
Applicare i diritti di utilizzo al documento PDF.
-
Crea un
ReaderExtensionsOptionSpec
utilizzando il relativo costruttore. Questo oggetto contiene le opzioni di esecuzione richieste dal servizio Acrobat Reader DC extensions. Quando si richiama questo costruttore, è necessario specificare i seguenti valori:- La
UsageRights
oggetto contenente i diritti di utilizzo da applicare al documento. - Valore stringa che specifica un messaggio visualizzato dall'utente quando il documento PDF abilitato per i diritti viene aperto in Adobe Reader 7.x. Questo messaggio non viene visualizzato in Adobe Reader 8.0.
- La
-
Applica i diritti di utilizzo al documento PDF richiamando il
ReaderExtensionsServiceClient
dell’oggettoapplyUsageRights
e passando i seguenti valori:- La
com.adobe.idp.Document
oggetto contenente il documento PDF a cui vengono applicati i diritti di utilizzo. - Valore stringa che specifica l'alias della credenziale che consente di applicare diritti di utilizzo.
- Valore stringa che specifica il valore della password corrispondente. (Questo parametro viene attualmente ignorato. Puoi passare
null
.)
- La
-
La
ReaderExtensionsOptionSpec
oggetto contenente opzioni di esecuzione.
La
applyUsageRights
restituisce uncom.adobe.idp.Document
oggetto contenente il documento PDF abilitato per i diritti. -
-
Salvare il documento PDF con diritti abilitati.
- Crea un
java.io.File
e assicurati che l'estensione del file sia .pdf. - Richiama il
com.adobe.idp.Document
dell’oggettocopyToFile
per copiare il contenuto delcom.adobe.idp.Document
al file (assicurati di utilizzarecom.adobe.idp.Document
oggetto restituito daapplyUsageRights
metodo).
- Crea un
Consulta anche
Applicazione dei diritti di utilizzo ai documenti PDF
Avvio rapido (modalità SOAP):applicazione dei diritti di utilizzo tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Applicazione dei diritti di utilizzo tramite 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 Acrobat Reader DC (servizio Web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati 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 Acrobat Reader DC extensions.
-
Crea un
ReaderExtensionsServiceClient
utilizzando il relativo costruttore predefinito. -
Crea un
ReaderExtensionsServiceClient.Endpoint.Address
utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom
. Assicurati di specificare?blob=mtom
.) -
Crea un
System.ServiceModel.BasicHttpBinding
ottenendo il valore delReaderExtensionsServiceClient.Endpoint.Binding
campo . Imposta il valore restituito suBasicHttpBinding
. -
Imposta la
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à:
- Assegnare il nome utente del modulo di AEM al campo
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore della 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
.
- Assegnare il nome utente del modulo di AEM al campo
-
-
Recupera un documento PDF.
- Crea un
BLOB
utilizzando il relativo costruttore. LaBLOB
viene utilizzato per memorizzare un documento PDF a cui vengono applicati i diritti di utilizzo. - Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStream
dell’oggettoLength
proprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStream
dell’oggettoRead
metodo . Passa la matrice dei byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOB
oggetto assegnando il relativoMTOM
con il contenuto dell'array di byte.
- Crea un
-
Specifica i diritti di utilizzo da applicare.
- Crea un
UsageRights
oggetto che rappresenta i diritti di utilizzo utilizzando il relativo costruttore. - Per ogni diritto di utilizzo da applicare, assegna il valore
true
al membro di dati corrispondente che appartiene alUsageRights
oggetto. Ad esempio, per aggiungere ilenableFormFillIn
diritto di utilizzo, assegnaretrue
alUsageRights
dell’oggettoenableFormFillIn
membro dati. (Ripeti questo passaggio per ogni diritto di utilizzo da applicare).
- Crea un
-
Applicare i diritti di utilizzo al documento PDF.
-
Crea un
ReaderExtensionsOptionSpec
utilizzando il relativo costruttore. Questo oggetto contiene le opzioni di esecuzione richieste dal servizio Acrobat Reader DC extensions. -
Assegna
UsageRights
dell'oggettoReaderExtensionsOptionSpec
dell’oggettousageRights
membro dati. -
Assegna un valore stringa che specifica il messaggio visualizzato dall’utente all’apertura del documento PDF con diritti abilitati in Adobe Reader al
ReaderExtensionsOptionSpec
dell’oggettomessage
membro dati. -
Applica i diritti di utilizzo al documento PDF richiamando il
ReaderExtensionsServiceClient
dell’oggettoapplyUsageRights
e passando i seguenti valori:- La
BLOB
oggetto contenente il documento PDF a cui vengono applicati i diritti di utilizzo. - Valore stringa che specifica l'alias della credenziale che consente di applicare diritti di utilizzo.
- Valore stringa che specifica il valore della password corrispondente. (Questo parametro viene attualmente ignorato. Puoi passare
null
.)
- La
-
La
ReaderExtensionsOptionSpec
oggetto contenente opzioni di esecuzione.
La
applyUsageRights
restituisce unBLOB
oggetto contenente il documento PDF abilitato per i diritti. -
-
Salvare il documento PDF con diritti abilitati.
- Crea un
System.IO.FileStream
richiamando il relativo costruttore. Passa un valore stringa che rappresenta la posizione del file del documento PDF abilitato per i diritti. - Creare un array di byte che memorizza il contenuto dei dati del
BLOB
oggetto restituito daapplyUsageRights
metodo . Compilare l’array di byte ottenendo il valore delBLOB
dell’oggettoMTOM
membro dati. - Crea un
System.IO.BinaryWriter
richiamando il relativo costruttore e passandoSystem.IO.FileStream
oggetto. - Scrivi il contenuto dell’array di byte in un file PDF richiamando il
System.IO.BinaryWriter
dell’oggettoWrite
e passare l'array di byte.
- Crea un
Consulta anche
Applicazione dei diritti di utilizzo ai documenti PDF
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
Rimozione dei diritti di utilizzo dai documenti PDF removing-usage-rights-from-pdf-documents
È possibile rimuovere i diritti di utilizzo da un documento abilitato per i diritti. È inoltre necessario rimuovere i diritti di utilizzo da un documento PDF abilitato per i diritti per eseguire altre operazioni AEM Forms al suo interno. Ad esempio, è necessario firmare (o certificare) digitalmente un documento PDF prima di impostare i diritti di utilizzo. Pertanto, se si desidera eseguire operazioni su un documento abilitato per i diritti, è necessario rimuovere i diritti di utilizzo dal documento PDF, eseguire le altre operazioni, ad esempio la firma digitale del documento e quindi riapplicare i diritti di utilizzo al documento.
Riepilogo dei passaggi summary_of_steps-1
Per rimuovere i diritti di utilizzo da un documento PDF abilitato per i diritti, eseguire le operazioni seguenti:
- Includi file di progetto.
- Crea un oggetto client Acrobat Reader DC extensions.
- Recupera un documento PDF abilitato per i diritti.
- Rimuovere 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, assicurati di includere i file proxy.
Creare un oggetto client Acrobat Reader DC extensions
Prima di poter eseguire programmaticamente un’operazione del servizio Acrobat Reader DC extensions, devi 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, crea un ReaderExtensionsServiceService
oggetto.
Recuperare un documento PDF abilitato per i diritti
Recupera un documento PDF abilitato per i diritti al fine di rimuovere i diritti di utilizzo.
Rimuovere i diritti di utilizzo dal documento PDF
Dopo aver recuperato un documento PDF abilitato per i diritti, è possibile rimuovere i diritti di utilizzo. Dopo aver rimosso i diritti di utilizzo, il documento PDF non disporrà di funzionalità aggiuntive durante la visualizzazione in Adobe Reader.
Salvare 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 tramite l’API Java
Rimuovere i diritti di utilizzo tramite l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido dell'API del servizio Acrobat Reader DC Extensions
Applicazione dei diritti di utilizzo ai documenti PDF
Rimuovere i diritti di utilizzo tramite l’API Java remove-usage-rights-using-the-java-api
È possibile rimuovere i diritti di utilizzo da un documento PDF abilitato per i diritti utilizzando l’API delle estensioni Acrobat Reader DC (Java):
-
Includi file di progetto.
Includi file JAR client, come adobe-reader-extensions-client.jar, nel percorso di classe del progetto Java.
-
Crea un oggetto client Acrobat Reader DC extensions.
Crea un
ReaderExtensionsServiceClient
utilizzando il relativo costruttore e passando unServiceClientFactory
oggetto contenente le proprietà di connessione. -
Recupera un documento PDF.
- Crea un
java.io.FileInputStream
oggetto che rappresenta il documento PDF abilitato per i diritti utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF. - Crea un
com.adobe.idp.Document
utilizzando il relativo costruttore e passandojava.io.FileInputStream
oggetto.
- Crea un
-
Rimuovere i diritti di utilizzo dal documento PDF.
Rimuovere i diritti di utilizzo dal documento PDF richiamando il
ReaderExtensionsServiceClient
dell’oggettoremoveUsageRights
e passarecom.adobe.idp.Document
oggetto contenente il documento PDF abilitato per i diritti. Questo metodo restituisce uncom.adobe.idp.Document
oggetto che contiene un documento PDF privo di diritti di utilizzo. -
Applicare i diritti di utilizzo al documento PDF.
- Crea un
java.io.File
e assicurati che l'estensione del file sia .PDF. - Richiama il
Document
dell’oggettocopyToFile
per copiare il contenuto delDocument
al file (assicurati di utilizzareDocument
oggetto restituito daremoveUsageRights
metodo).
- Crea un
Consulta anche
Rimozione dei diritti di utilizzo dai documenti PDF
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Rimuovere i diritti di utilizzo tramite l’API del servizio Web remove-usage-rights-using-the-web-service-api
È possibile rimuovere i diritti di utilizzo da un documento PDF abilitato per i diritti utilizzando l’API delle estensioni Acrobat Reader DC (servizio Web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati 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 Acrobat Reader DC extensions.
-
Crea un
ReaderExtensionsServiceClient
utilizzando il relativo costruttore predefinito. -
Crea un
ReaderExtensionsServiceClient.Endpoint.Address
utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom
. Assicurati di specificare?blob=mtom
.) -
Crea un
System.ServiceModel.BasicHttpBinding
ottenendo il valore delReaderExtensionsServiceClient.Endpoint.Binding
campo . Imposta il valore restituito suBasicHttpBinding
. -
Imposta la
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à:
- Assegnare il nome utente del modulo di AEM al campo
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore della 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
.
- Assegnare il nome utente del modulo di AEM al campo
-
-
Recupera un documento PDF.
- Crea un
BLOB
utilizzando il relativo costruttore. LaBLOB
viene utilizzato per memorizzare il documento PDF con diritti abilitati dal quale vengono rimossi i diritti di utilizzo. - Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF e la modalità di apertura del file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStream
dell’oggettoLength
proprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStream
dell’oggettoRead
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOB
oggetto assegnando il relativoMTOM
con il contenuto dell'array di byte.
- Crea un
-
Rimuovere i diritti di utilizzo dal documento PDF.
Rimuovere i diritti di utilizzo dal documento PDF richiamando il
ReaderExtensionsServiceClient
dell’oggettoremoveUsageRights
e passareBLOB
oggetto contenente il documento PDF abilitato per i diritti. Questo metodo restituisce unBLOB
oggetto che contiene un documento PDF privo di diritti di utilizzo. -
Applicare i diritti di utilizzo al documento PDF.
- Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file PDF. - Creare un array di byte che memorizza il contenuto dei dati del
BLOB
oggetto restituito daremoveUsageRights
metodo . Compilare l’array di byte ottenendo il valore delBLOB
dell’oggettoMTOM
membro dati. - Crea un
System.IO.BinaryWriter
richiamando il relativo costruttore e passandoSystem.IO.FileStream
oggetto.
- Crea un
Consulta anche
Rimozione dei diritti di utilizzo dai documenti PDF
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef
Recupero delle informazioni sulle credenziali retrieving-credential-information
È possibile recuperare informazioni sulla credenziale utilizzata per applicare diritti di utilizzo a un documento PDF abilitato per i diritti. Il recupero di informazioni su una credenziale consente di ottenere informazioni quali la data successiva alla quale il certificato non è più valido.
Riepilogo dei passaggi summary_of_steps-2
Per recuperare informazioni sulle credenziali utilizzate per applicare diritti di utilizzo a un documento PDF, eseguire le operazioni seguenti:
- Includi file di progetto.
- Crea un oggetto client Acrobat Reader DC extensions.
- Recupera un documento PDF abilitato per i diritti.
- Recupera informazioni sulla credenziale.
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, assicurati di includere i file proxy.
Creare un oggetto client Acrobat Reader DC extensions
Prima di poter eseguire programmaticamente un’operazione del servizio Acrobat Reader DC extensions, devi 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, crea un ReaderExtensionsServiceService
oggetto.
Recuperare un documento PDF abilitato per i diritti
È necessario recuperare un documento PDF con diritti abilitati per recuperare informazioni sulle credenziali. È inoltre possibile recuperare informazioni su una credenziale specificando il relativo alias; tuttavia, se si desidera recuperare informazioni su una credenziale utilizzata per applicare diritti di utilizzo a un documento PDF abilitato per diritti specifici, è necessario recuperare il documento.
Recupera informazioni sulla credenziale
Dopo aver recuperato un documento PDF con diritti abilitati, è possibile ottenere informazioni sulle credenziali utilizzate per applicarvi i diritti di utilizzo. È possibile ottenere le seguenti informazioni sulle credenziali:
- Messaggio visualizzato in Adobe Reader all’apertura del documento PDF con diritti abilitati.
- La data successiva alla quale la credenziale non è più valida.
- Data prima della quale la credenziale non è valida.
- I diritti di utilizzo impostati per questo documento PDF abilitato per i diritti.
- Il numero di volte in cui la credenziale è stata utilizzata.
Consulta anche
Rimuovere i diritti di utilizzo tramite l’API Java
Rimuovere i diritti di utilizzo tramite l’API del servizio Web
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Avvio rapido dell'API del servizio Acrobat Reader DC Extensions
Recuperare le informazioni sulle credenziali utilizzando l’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 file JAR client, come adobe-reader-extensions-client.jar, nel percorso di classe del progetto Java.
-
Crea un oggetto client Acrobat Reader DC extensions.
Crea un
ReaderExtensionsServiceClient
utilizzando il relativo costruttore e passando unServiceClientFactory
oggetto contenente le proprietà di connessione. -
Recupera un documento PDF.
- Crea un
java.io.FileInputStream
oggetto che rappresenta il documento PDF abilitato per i diritti utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF abilitato per i diritti. - Crea un
com.adobe.idp.Document
utilizzando il relativo costruttore e passandojava.io.FileInputStream
oggetto.
- Crea un
-
Rimuovere i diritti di utilizzo dal documento PDF.
- Recupera informazioni sulla credenziale utilizzata per applicare diritti di utilizzo al documento PDF richiamando il
ReaderExtensionsServiceClient
dell’oggettogetDocumentUsageRights
e passarecom.adobe.idp.Document
oggetto contenente il documento PDF abilitato per i diritti. Questo metodo restituisce unGetUsageRightsResult
oggetto contenente informazioni sulle credenziali. - Recupera la data successiva alla quale la credenziale non è più valida richiamando il
GetUsageRightsResult
dell’oggettogetNotAfter
metodo . Questo metodo restituisce unjava.util.Date
oggetto che rappresenta la data successiva alla quale la credenziale non è più valida. - Recupera il messaggio visualizzato in Adobe Reader all’apertura del documento PDF abilitato per i diritti richiamando il
GetUsageRightsResult
dell’oggettogetMessage
metodo . Questo metodo restituisce un valore stringa che rappresenta il messaggio.
- Recupera informazioni sulla credenziale utilizzata per applicare diritti di utilizzo al documento PDF richiamando il
Consulta anche
Recupero delle informazioni sulle credenziali
Avvio rapido (modalità SOAP): Recupero delle informazioni sulle credenziali tramite l’API Java
Inclusione dei file libreria Java di AEM Forms
Impostazione delle proprietà di connessione
Recuperare le informazioni sulle credenziali utilizzando l’API del servizio Web retrieve-credential-information-using-the-web-service-api
Recupera le informazioni sulle credenziali utilizzando l’API delle estensioni Acrobat Reader DC (servizio Web):
-
Includi file di progetto.
Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati 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 Acrobat Reader DC extensions.
-
Crea un
ReaderExtensionsServiceClient
utilizzando il relativo costruttore predefinito. -
Crea un
ReaderExtensionsServiceClient.Endpoint.Address
utilizzandoSystem.ServiceModel.EndpointAddress
costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio,http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom
. Assicurati di specificare?blob=mtom
.) -
Crea un
System.ServiceModel.BasicHttpBinding
ottenendo il valore delReaderExtensionsServiceClient.Endpoint.Binding
campo . Imposta il valore restituito suBasicHttpBinding
. -
Imposta la
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à:
- Assegnare il nome utente del modulo di AEM al campo
ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName
. - Assegna il valore della 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
.
- Assegnare il nome utente del modulo di AEM al campo
-
-
Recupera un documento PDF.
- Crea un
BLOB
utilizzando il relativo costruttore. LaBLOB
viene utilizzato per memorizzare un documento PDF con diritti abilitati. - Crea un
System.IO.FileStream
richiamando il relativo costruttore e passando un valore di stringa che rappresenta la posizione del file del documento PDF abilitato per i diritti e la modalità di apertura del file. - Creare un array di byte che memorizza il contenuto del
System.IO.FileStream
oggetto. È possibile determinare le dimensioni dell'array di byte ottenendo ilSystem.IO.FileStream
dell’oggettoLength
proprietà. - Compilare l'array di byte con i dati del flusso richiamando il
System.IO.FileStream
dell’oggettoRead
e passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere. - Popolare
BLOB
oggetto assegnando il relativoMTOM
con il contenuto dell'array di byte.
- Crea un
-
Rimuovere i diritti di utilizzo dal documento PDF.
- Recupera informazioni sulla credenziale utilizzata per applicare diritti di utilizzo al documento PDF richiamando il
ReaderExtensionsServiceClient
dell’oggettogetDocumentUsageRights
e passarecom.adobe.idp.Document
oggetto contenente il documento PDF abilitato per i diritti. Questo metodo restituisce unGetUsageRightsResult
oggetto contenente informazioni sulle credenziali. - Recupera la data successiva alla quale la credenziale non è più valida ottenendo il valore del
GetUsageRightsResult
dell’oggettonotAfter
membro dati. Il tipo di dati di questo membro dati èSystem.DateTime
. - Recupera il messaggio visualizzato quando il documento PDF abilitato per i diritti viene aperto in Adobe Reader ottenendo il valore del
GetUsageRightsResult
dell’oggettomessage
membro dati. Il tipo di dati di questo membro dati è una stringa. - Recupera il numero di volte in cui la credenziale viene utilizzata ottenendo il valore del
GetUsageRightsResult
dell’oggettouseCount
membro dati. Il tipo di dati del membro dati è un numero intero.
- Recupera informazioni sulla credenziale utilizzata per applicare diritti di utilizzo al documento PDF richiamando il
Consulta anche
Recupero delle informazioni sulle credenziali
Richiamo di AEM Forms tramite MTOM
Richiamo di AEM Forms tramite SwaRef