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:

NOTE
Per ulteriori informazioni sul servizio Acrobat Reader DC Extension, consulta Guida di riferimento dei servizi per AEM Forms.

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.

NOTE
Quando si applicano diritti di utilizzo a documenti PDF utilizzando 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.
NOTE
Per ulteriori informazioni sul servizio Acrobat Reader DC Extension, consulta Guida di riferimento dei servizi per AEM Forms.

Riepilogo dei passaggi summary-of-steps

Per applicare i diritti di utilizzo a un documento PDF, effettuare le seguenti operazioni:

  1. Includi file di progetto.
  2. Crea un oggetto client per estensioni Acrobat Reader DC.
  3. Recuperare un documento PDF.
  4. Specificare i diritti di utilizzo da applicare.
  5. Applica i diritti di utilizzo al documento PDF.
  6. 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.

NOTE
Se si tenta di assegnare un diritto di utilizzo non consentito dalle credenziali, verrà generata un'eccezione.

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):

  1. Includi file di progetto

    Includi i file JAR client, ad esempio adobe-reader-extensions-client.jar, nel percorso della classe del progetto Java.

  2. 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 il ServiceClientFactory oggetto.
  3. 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 il java.io.FileInputStream oggetto.
  4. 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 aggiungere enableFormFillIn diritto di utilizzo, richiama UsageRights dell'oggetto enableFormFillIn metodo e passaggio true. (Ripeti questo passaggio per ogni diritto d’uso da applicare).
  5. 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.
    • Applicare i diritti di utilizzo al documento PDF richiamando ReaderExtensionsServiceClient dell'oggetto applyUsageRights 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 ReaderExtensionsOptionSpec oggetto contenente opzioni di runtime.

    Il applyUsageRights il metodo restituisce un com.adobe.idp.Document oggetto contenente il documento PDF con abilitazione per i diritti.

  6. 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'oggetto copyToFile metodo per copiare il contenuto del com.adobe.idp.Document al file (assicurati di utilizzare il com.adobe.idp.Document oggetto restituito da applyUsageRights metodo).

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):

  1. 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.
  2. Crea un oggetto client per estensioni Acrobat Reader DC.

    • Creare un ReaderExtensionsServiceClient utilizzando il costruttore predefinito.

    • Creare un ReaderExtensionsServiceClient.Endpoint.Address oggetto utilizzando System.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 del ReaderExtensionsServiceClient.Endpoint.Binding campo. Invia il valore restituito a BasicHttpBinding.

    • Imposta il System.ServiceModel.BasicHttpBinding dell'oggetto MessageEncoding campo a WSMessageEncoding.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 campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.
  3. Recuperare un documento PDF.

    • Creare un BLOB mediante il costruttore. Il BLOB 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 ottenendo System.IO.FileStream dell'oggetto Length proprietà.
    • Compilare la matrice di byte con i dati di flusso richiamando System.IO.FileStream dell'oggetto Read metodo. Passare la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Popolare il BLOB oggetto assegnando il relativo MTOM con il contenuto della matrice di byte.
  4. 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 al UsageRights oggetto. Ad esempio, per aggiungere enableFormFillIn diritto di utilizzo, assegnazione true al UsageRights dell'oggetto enableFormFillIn membro dati. (Ripeti questo passaggio per ogni diritto d’uso da applicare).
  5. 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 al ReaderExtensionsOptionSpec dell'oggetto usageRights 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'oggetto message membro dati.

    • Applicare i diritti di utilizzo al documento PDF richiamando ReaderExtensionsServiceClient dell'oggetto applyUsageRights 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 ReaderExtensionsOptionSpec oggetto contenente opzioni di runtime.

    Il applyUsageRights il metodo restituisce un BLOB oggetto contenente il documento PDF con abilitazione per i diritti.

  6. 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 da applyUsageRights metodo. Popolare la matrice di byte ottenendo il valore della BLOB dell'oggetto MTOM membro dati.
    • Creare un System.IO.BinaryWriter oggetto richiamando il relativo costruttore e passando il System.IO.FileStream oggetto.
    • Scrivere il contenuto della matrice di byte in un file PDF richiamando System.IO.BinaryWriter dell'oggetto Write e passando la matrice di byte.

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.

NOTE
Per ulteriori informazioni sul servizio Acrobat Reader DC Extension, consulta Guida di riferimento dei servizi per AEM Forms.

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:

  1. Includi file di progetto.
  2. Crea un oggetto client per estensioni Acrobat Reader DC.
  3. Recuperare un documento di PDF abilitato per i diritti.
  4. Rimuovi i diritti di utilizzo dal documento PDF.
  5. 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):

  1. Includi file di progetto.

    Includi i file JAR client, ad esempio adobe-reader-extensions-client.jar, nel percorso della classe del progetto Java.

  2. Crea un oggetto client per estensioni Acrobat Reader DC.

    Creare un ReaderExtensionsServiceClient oggetto utilizzando il relativo costruttore e passando un ServiceClientFactory oggetto che contiene proprietà di connessione.

  3. 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 il java.io.FileInputStream oggetto.
  4. Rimuovi i diritti di utilizzo dal documento PDF.

    Rimuovere i diritti di utilizzo dal documento PDF richiamando ReaderExtensionsServiceClient dell'oggetto removeUsageRights e passando il com.adobe.idp.Document oggetto contenente il documento PDF con abilitazione per i diritti. Questo metodo restituisce un com.adobe.idp.Document oggetto contenente un documento PDF che non dispone di diritti di utilizzo.

  5. 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'oggetto copyToFile metodo per copiare il contenuto del Document al file (assicurati di utilizzare il Document oggetto restituito da removeUsageRights metodo).

Consulta anche

Rimozione dei diritti di utilizzo dai documenti di PDF

Guida rapida (modalità SOAP): rimozione dei diritti di utilizzo da un documento PDF tramite l’API Java

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):

  1. 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.
  2. Crea un oggetto client per estensioni Acrobat Reader DC.

    • Creare un ReaderExtensionsServiceClient utilizzando il costruttore predefinito.

    • Creare un ReaderExtensionsServiceClient.Endpoint.Address oggetto utilizzando System.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 del ReaderExtensionsServiceClient.Endpoint.Binding campo. Invia il valore restituito a BasicHttpBinding.

    • Imposta il System.ServiceModel.BasicHttpBinding dell'oggetto MessageEncoding campo a WSMessageEncoding.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 campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.
  3. Recuperare un documento PDF.

    • Creare un BLOB mediante il costruttore. Il BLOB 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 ottenendo System.IO.FileStream dell'oggetto Length proprietà.
    • Compilare la matrice di byte con i dati di flusso richiamando System.IO.FileStream dell'oggetto Read e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Popolare il BLOB oggetto assegnando il relativo MTOM con il contenuto della matrice di byte.
  4. Rimuovi i diritti di utilizzo dal documento PDF.

    Rimuovere i diritti di utilizzo dal documento PDF richiamando ReaderExtensionsServiceClient dell'oggetto removeUsageRights e passando il BLOB oggetto contenente il documento PDF con abilitazione per i diritti. Questo metodo restituisce un BLOB oggetto contenente un documento PDF che non dispone di diritti di utilizzo.

  5. 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 da removeUsageRights metodo. Popolare la matrice di byte ottenendo il valore della BLOB dell'oggetto MTOM membro dati.
    • Creare un System.IO.BinaryWriter oggetto richiamando il relativo costruttore e passando il System.IO.FileStream oggetto.

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.

NOTE
Per ulteriori informazioni sul servizio Acrobat Reader DC Extension, consulta Guida di riferimento dei servizi per AEM Forms.

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:

  1. Includi file di progetto.
  2. Crea un oggetto client per estensioni Acrobat Reader DC.
  3. Recuperare un documento di PDF abilitato per i diritti.
  4. 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):

  1. Includi file di progetto.

    Includi i file JAR client, ad esempio adobe-reader-extensions-client.jar, nel percorso della classe del progetto Java.

  2. Crea un oggetto client per estensioni Acrobat Reader DC.

    Creare un ReaderExtensionsServiceClient oggetto utilizzando il relativo costruttore e passando un ServiceClientFactory oggetto che contiene proprietà di connessione.

  3. 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 il java.io.FileInputStream oggetto.
  4. 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'oggetto getDocumentUsageRights e passando il com.adobe.idp.Document oggetto contenente il documento PDF con abilitazione per i diritti. Questo metodo restituisce un GetUsageRightsResult oggetto contenente informazioni sulle credenziali.
    • Recuperare la data dopo la quale le credenziali non sono più valide richiamando GetUsageRightsResult dell'oggetto getNotAfter metodo. Questo metodo restituisce un java.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'oggetto getMessage metodo. Questo metodo restituisce un valore stringa che rappresenta il messaggio.

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):

  1. 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.
  2. Crea un oggetto client per estensioni Acrobat Reader DC.

    • Creare un ReaderExtensionsServiceClient utilizzando il costruttore predefinito.

    • Creare un ReaderExtensionsServiceClient.Endpoint.Address oggetto utilizzando System.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 del ReaderExtensionsServiceClient.Endpoint.Binding campo. Invia il valore restituito a BasicHttpBinding.

    • Imposta il System.ServiceModel.BasicHttpBinding dell'oggetto MessageEncoding campo a WSMessageEncoding.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 campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.
  3. Recuperare un documento PDF.

    • Creare un BLOB mediante il costruttore. Il BLOB 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 ottenendo System.IO.FileStream dell'oggetto Length proprietà.
    • Compilare la matrice di byte con i dati di flusso richiamando System.IO.FileStream dell'oggetto Read e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Popolare il BLOB oggetto assegnando il relativo MTOM con il contenuto della matrice di byte.
  4. 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'oggetto getDocumentUsageRights e passando il com.adobe.idp.Document oggetto contenente il documento PDF con abilitazione per i diritti. Questo metodo restituisce un GetUsageRightsResult oggetto contenente informazioni sulle credenziali.
    • Recupera la data dopo la quale le credenziali non sono più valide ottenendo il valore di GetUsageRightsResult dell'oggetto notAfter 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'oggetto message 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'oggetto useCount membro dati. Il tipo di dati di questo membro dati è un numero intero.

Consulta anche

Recupero informazioni sulle credenziali

Richiamare AEM Forms tramite MTOM

Richiamare AEM Forms con SwaRef

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2