Assegnazione dei diritti di utilizzo

Informazioni su Acrobat Reader DC extensions Service

Il servizio di estensioni Acrobat Reader DC consente alla vostra azienda di condividere facilmente i documenti PDF interattivi estendendo le funzionalità di Adobe Reader. Il servizio di estensione 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 consente di aggiungere diritti di utilizzo a un documento PDF, attivando le funzioni normalmente non disponibili all'apertura di un documento PDF tramite Adobe Reader. Gli utenti di terze parti non richiedono software o plug-in aggiuntivi per lavorare con i documenti abilitati per i diritti.

È possibile eseguire le seguenti attività utilizzando il servizio di estensioni Acrobat Reader DC:

Nota

Per ulteriori informazioni sul servizio delle estensioni Acrobat Reader DC, consultate Guida di riferimento ai servizi per AEM Forms.

Applicazione dei diritti di utilizzo ai documenti PDF

È possibile applicare diritti di utilizzo ai documenti PDF utilizzando l'API Java Client 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 stati applicati diritti di utilizzo sono denominati documenti abilitati per i diritti. L'utente che apre un documento con diritti in Adobe Reader può eseguire operazioni abilitate per tale documento specifico.

Nota

Quando si applicano diritti di utilizzo ai documenti PDF utilizzando il applyUsageRights metodo, che fa parte dell'API Java, è possibile impostare il isModeFinal parametro dell' ReaderExtensionsOptionSpec oggetto su 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 il isModeFinal parametro su false.

Nota

Per ulteriori informazioni sul servizio delle estensioni Acrobat Reader DC, consultate Guida di riferimento ai servizi per AEM Forms.

Riepilogo dei passaggi

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

  1. Includere i file di progetto.
  2. Creare un oggetto Client di estensioni Acrobat Reader DC.
  3. Recuperare un documento PDF.
  4. Specificate i diritti di utilizzo da applicare.
  5. Applicare diritti di utilizzo al documento PDF.
  6. Salvare il documento PDF con diritti.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.

Creazione di un oggetto Client di estensioni Acrobat Reader DC

Per eseguire a livello di programmazione un'operazione di servizio di estensione di Acrobat Reader DC, è necessario creare un oggetto client del servizio di estensione di Acrobat Reader DC. Se si utilizza l'API Java delle estensioni Acrobat Reader DC, creare un ReaderExtensionsServiceClient oggetto. Se si utilizza l'API del servizio Web delle estensioni Acrobat Reader DC, creare un ReaderExtensionsServiceService oggetto.

Recupero di un documento PDF

È necessario recuperare un documento PDF per applicare i diritti di utilizzo. I documenti PDF con diritti di utilizzo 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 tale documento. Se il documento non contiene un dizionario dei diritti di utilizzo, il servizio di estensione Acrobat Reader DC ne crea uno. Se contiene già un dizionario, il servizio di estensione Acrobat Reader DC 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.

Nota

Se si tenta di assegnare un diritto di utilizzo non consentito dalla credenziale, si causerà un'eccezione.

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, consultate la guida all'installazione e alla distribuzione per il server delle applicazioni.

Salvare il documento PDF con diritti

Dopo che il servizio di estensione Acrobat Reader DC ha applicato i diritti di utilizzo a un documento PDF, è possibile salvare il documento PDF con diritti 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 di file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Guida rapida di Acrobat Reader DC Extensions Service API

Applicazione dei diritti di utilizzo tramite l'API Java

Per applicare i diritti di utilizzo a un documento PDF, utilizzare l’API Acrobat Reader DC Extensions (Java):

  1. Includi file di progetto

    Includete file JAR client, ad esempio adobe-reader-extensions-client.jar, nel percorso di classe del progetto Java.

  2. Creare un oggetto Client di estensioni Acrobat Reader DC.

    • Creare un ServiceClientFactory oggetto che contenga proprietà di connessione.
    • Creare un ReaderExtensionsServiceClient oggetto utilizzando il relativo costruttore e passando l' ServiceClientFactory oggetto.

  3. Recuperare un documento PDF.

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

  4. Specificate i diritti di utilizzo da applicare.

    • Creare un UsageRights oggetto che rappresenti i diritti di utilizzo utilizzando il relativo costruttore.
    • Per ogni diritto di utilizzo da applicare, richiamare un metodo corrispondente che appartiene all' UsageRights oggetto. Ad esempio, per aggiungere il diritto di enableFormFillIn utilizzo, richiamare il metodo dell' UsageRights oggetto enableFormFillIn e passare true. Ripetete questo passaggio per ogni diritto di utilizzo da applicare.

  5. Applicare diritti di utilizzo al documento PDF.

    • Creare un ReaderExtensionsOptionSpec oggetto utilizzando il relativo costruttore. Questo oggetto contiene le opzioni di esecuzione richieste dal servizio delle estensioni Acrobat Reader DC. Quando si richiama questo costruttore, è necessario specificare i seguenti valori:

      • L' UsageRights oggetto che contiene i diritti di utilizzo da applicare al documento.
      • Una stringa che specifica un messaggio visualizzato dall'utente all'apertura del documento PDF con diritti in Adobe Reader 7.x. Questo messaggio non viene visualizzato in Adobe Reader 8.0.

    • Per applicare i diritti di utilizzo al documento PDF, richiamare il metodo dell' ReaderExtensionsServiceClient oggetto applyUsageRights e passare i seguenti valori:

      • L' com.adobe.idp.Document oggetto che contiene il documento PDF a cui sono applicati i diritti di utilizzo.
      • Valore stringa che specifica l'alias della credenziale che consente di applicare diritti di utilizzo.
      • Un valore di stringa che specifica il valore della password corrispondente. (Attualmente questo parametro viene ignorato. Potete passare null.)

    • L' ReaderExtensionsOptionSpec oggetto che contiene le opzioni di esecuzione.

    Il applyUsageRights metodo restituisce un com.adobe.idp.Document oggetto che contiene il documento PDF abilitato per i diritti.

  6. Salvare il documento PDF con diritti.

    • Create un java.io.File oggetto e accertatevi che l'estensione sia .pdf.
    • Richiamare il metodo dell' com.adobe.idp.Document oggetto copyToFile per copiare il contenuto dell' com.adobe.idp.Document oggetto nel file (assicurarsi di utilizzare l' com.adobe.idp.Document oggetto restituito dal applyUsageRights metodo).

Consulta anche

Applicazione dei diritti di utilizzo ai documenti PDF

Avvio rapido (modalità SOAP):applicazione dei diritti di utilizzo tramite l'API Java

Inclusione di file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Applicazione dei diritti di utilizzo tramite l'API del servizio Web

Per applicare i diritti di utilizzo a un documento PDF, utilizzare l’API Acrobat Reader DC Extensions (servizio Web):

  1. Includere i 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.

    Nota

    Sostituire localhost con l'indirizzo IP del server in cui è installato AEM Forms.

  2. Creare un oggetto Client di estensioni Acrobat Reader DC.

    • Creare un ReaderExtensionsServiceClient oggetto utilizzando il relativo costruttore predefinito.

    • Creare un ReaderExtensionsServiceClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom. Assicurarsi di specificare ?blob=mtom.)

    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del ReaderExtensionsServiceClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding.

    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:

      • Assegnare il nome utente dei moduli AEM al campo ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName.
      • Assegnare il valore della password corrispondente al campo ReaderExtensionsServiceClient.ClientCredentials.UserName.Password.
      • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

  3. Recuperare un documento PDF.

    • Creare un BLOB oggetto utilizzando il relativo costruttore. L' BLOB oggetto viene utilizzato per memorizzare un documento PDF a cui sono applicati i diritti di utilizzo.
    • Creare un System.IO.FileStream oggetto 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 dell' System.IO.FileStream oggetto. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà dell' System.IO.FileStream oggetto Length .
    • Compilare l'array di byte con i dati del flusso richiamando il metodo dell' System.IO.FileStream oggetto Read . Passare l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l' BLOB oggetto assegnandone MTOM la proprietà con il contenuto dell'array di byte.

  4. Specificate i diritti di utilizzo da applicare.

    • Creare un UsageRights oggetto che rappresenti i diritti di utilizzo utilizzando il relativo costruttore.
    • Per ogni diritto di utilizzo da applicare, assegnare il valore true al membro di dati corrispondente che appartiene all' UsageRights oggetto. Ad esempio, per aggiungere il diritto di enableFormFillIn utilizzo, assegnare true al membro dati dell' UsageRights oggetto enableFormFillIn . Ripetete questo passaggio per ogni diritto di utilizzo da applicare.

  5. Applicare diritti di utilizzo al documento PDF.

    • Creare un ReaderExtensionsOptionSpec oggetto utilizzando il relativo costruttore. Questo oggetto contiene le opzioni di esecuzione richieste dal servizio delle estensioni Acrobat Reader DC.

    • Assegnare l' UsageRights oggetto al membro dati dell' ReaderExtensionsOptionSpec oggetto usageRights .

    • Assegnare un valore stringa che specifica il messaggio visualizzato dall'utente all'apertura del documento PDF con diritti in Adobe Reader al membro ReaderExtensionsOptionSpec dati message dell'oggetto.

    • Per applicare i diritti di utilizzo al documento PDF, richiamare il metodo dell' ReaderExtensionsServiceClient oggetto applyUsageRights e passare i seguenti valori:

      • L' BLOB oggetto che contiene il documento PDF a cui sono applicati i diritti di utilizzo.
      • Valore stringa che specifica l'alias della credenziale che consente di applicare diritti di utilizzo.
      • Un valore di stringa che specifica il valore della password corrispondente. (Attualmente questo parametro viene ignorato. Potete passare null.)

    • L' ReaderExtensionsOptionSpec oggetto che contiene le opzioni di esecuzione.

    Il applyUsageRights metodo restituisce un BLOB oggetto che contiene il documento PDF abilitato per i diritti.

  6. Salvare il documento PDF con diritti.

    • Creare un System.IO.FileStream oggetto richiamandone il costruttore. Passa un valore di 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 dell' BLOB oggetto restituito dal applyUsageRights metodo. Compilare l'array di byte ottenendo il valore del membro BLOB dati dell' MTOM oggetto.
    • Creare un System.IO.BinaryWriter oggetto richiamando il relativo costruttore e passando l' System.IO.FileStream oggetto.
    • Scrivere il contenuto dell'array di byte in un file PDF richiamando il metodo dell' System.IO.BinaryWriter oggetto Write e passando l'array di byte.

Consulta anche

Applicazione dei diritti di utilizzo ai documenti PDF

Attivazione di moduli AEM tramite MTOM

Richiamo di moduli AEM con SwaRef

Rimozione dei diritti di utilizzo dai documenti PDF

Potete rimuovere i diritti di utilizzo da un documento con diritti. È inoltre necessario rimuovere i diritti di utilizzo da un documento PDF con diritti per eseguire altre operazioni su AEM Forms. 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 con diritti, è necessario rimuovere i diritti di utilizzo dal documento PDF, eseguire altre operazioni, ad esempio firmare digitalmente il documento e quindi riapplicare i diritti di utilizzo al documento.

Nota

Per ulteriori informazioni sul servizio delle estensioni Acrobat Reader DC, consultate Guida di riferimento ai servizi per AEM Forms.

Riepilogo dei passaggi

Per rimuovere i diritti di utilizzo da un documento PDF abilitato per i diritti, effettuare le seguenti operazioni:

  1. Includere i file di progetto.
  2. Creare un oggetto Client di estensioni Acrobat Reader DC.
  3. Recuperare un documento PDF abilitato per diritti.
  4. Rimuovere i diritti di utilizzo dal documento PDF.
  5. Salvare il documento PDF.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.

Creazione di un oggetto Client di estensioni Acrobat Reader DC

Prima di poter 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 utilizzate l'API Java, create un ReaderExtensionsServiceClient oggetto. Se si utilizza l'API del servizio Web delle estensioni Acrobat Reader DC, creare un ReaderExtensionsServiceService oggetto.

Recupero di un documento PDF con diritti

Per rimuovere i diritti di utilizzo, recuperate un documento PDF abilitato per i diritti.

Rimozione dei diritti di utilizzo dal documento PDF

Dopo aver ottenuto un documento PDF con diritti, potete rimuovere i diritti di utilizzo. Dopo aver rimosso i diritti di utilizzo, il documento PDF non disporrà di alcuna funzionalità aggiuntiva durante la visualizzazione in Adobe Reader.

Salvare il documento PDF

È possibile salvare come file PDF il documento PDF che non contiene più diritti di utilizzo. Una volta salvato il file come PDF, il documento PDF può essere visualizzato in Adobe Reader o Acrobat.

Consulta anche

Rimuovere i diritti di utilizzo mediante l'API Java

Rimozione dei diritti di utilizzo tramite l'API del servizio Web

Inclusione di file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Guida rapida di Acrobat Reader DC Extensions Service API

Applicazione dei diritti di utilizzo ai documenti PDF

Rimuovere i diritti di utilizzo mediante l'API Java

Per rimuovere i diritti di utilizzo da un documento PDF con diritti, utilizzare l’API delle estensioni Acrobat Reader DC (Java):

  1. Includere i file di progetto.

    Includete file JAR client, ad esempio adobe-reader-extensions-client.jar, nel percorso di classe del progetto Java.

  2. Creare un oggetto Client di estensioni Acrobat Reader DC.

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

  3. Recuperare un documento PDF.

    • Creare un oggetto java.io.FileInputStream che rappresenti il documento PDF con diritti, utilizzando il relativo costruttore e passando un valore di stringa che specifica la posizione del documento PDF.
    • Creare un com.adobe.idp.Document oggetto utilizzando il relativo costruttore e passando l' java.io.FileInputStream oggetto.

  4. Rimuovere i diritti di utilizzo dal documento PDF.

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

  5. Applicare diritti di utilizzo al documento PDF.

    • Creare un java.io.File oggetto e assicurarsi che l'estensione del file sia .PDF.
    • Richiamare il metodo dell' Document oggetto copyToFile per copiare il contenuto dell' Document oggetto nel file (assicurarsi di utilizzare l' Document oggetto restituito dal removeUsageRights metodo).

Consulta anche

Rimozione dei diritti di utilizzo dai documenti PDF

Avvio rapido (modalità SOAP): Rimozione di diritti di utilizzo da un documento PDF tramite l'API Java

Inclusione di file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Rimozione dei diritti di utilizzo tramite l'API del servizio Web

Per rimuovere i diritti di utilizzo da un documento PDF con diritti, utilizzare l’API delle estensioni Acrobat Reader DC (servizio Web):

  1. Includere i 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.

    Nota

    Sostituire localhost con l'indirizzo IP del server in cui è installato AEM Forms.

  2. Creare un oggetto Client di estensioni Acrobat Reader DC.

    • Creare un ReaderExtensionsServiceClient oggetto utilizzando il relativo costruttore predefinito.

    • Creare un ReaderExtensionsServiceClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom. Assicurarsi di specificare ?blob=mtom.)

    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del ReaderExtensionsServiceClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding.

    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:

      • Assegnare il nome utente dei moduli AEM al campo ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName.
      • Assegnare il valore della password corrispondente al campo ReaderExtensionsServiceClient.ClientCredentials.UserName.Password.
      • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

  3. Recuperare un documento PDF.

    • Creare un BLOB oggetto utilizzando il relativo costruttore. L' BLOB oggetto viene utilizzato per memorizzare il documento PDF con diritti abilitati dal quale vengono rimossi i diritti di utilizzo.
    • Creare un System.IO.FileStream oggetto 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 dell' System.IO.FileStream oggetto. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà dell' System.IO.FileStream oggetto Length .
    • Compilare l'array di byte con i dati del flusso richiamando il System.IO.FileStream Read metodo dell'oggetto e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l' BLOB oggetto assegnandone MTOM la proprietà con il contenuto dell'array di byte.

  4. Rimuovere i diritti di utilizzo dal documento PDF.

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

  5. Applicare diritti di utilizzo al documento PDF.

    • Creare un System.IO.FileStream oggetto 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 dell' BLOB oggetto restituito dal removeUsageRights metodo. Compilare l'array di byte ottenendo il valore del membro BLOB dati dell' MTOM oggetto.
    • Creare un System.IO.BinaryWriter oggetto richiamando il relativo costruttore e passando l' System.IO.FileStream oggetto.

Consulta anche

Rimozione dei diritti di utilizzo dai documenti PDF

Attivazione di moduli AEM tramite MTOM

Richiamo di moduli AEM con SwaRef

Recupero delle informazioni sulle credenziali

È possibile recuperare informazioni sulle credenziali utilizzate per applicare diritti di utilizzo a un documento PDF abilitato per i diritti. Recuperando informazioni su una credenziale, è possibile ottenere informazioni quali la data dopo la quale il certificato non è più valido.

Nota

Per ulteriori informazioni sul servizio delle estensioni Acrobat Reader DC, consultate Guida di riferimento ai servizi per AEM Forms.

Riepilogo dei passaggi

Per recuperare informazioni sulle credenziali utilizzate per applicare diritti di utilizzo a un documento PDF, effettuare le seguenti operazioni:

  1. Includere i file di progetto.
  2. Creare un oggetto Client di estensioni Acrobat Reader DC.
  3. Recuperare un documento PDF abilitato per diritti.
  4. Recuperare informazioni sulla credenziale.

Includi file di progetto

Includete i file necessari nel progetto di sviluppo. Se state creando un'applicazione client utilizzando Java, includete i file JAR necessari. Se utilizzate servizi Web, accertatevi di includere i file proxy.

Creazione di un oggetto Client di estensioni Acrobat Reader DC

Prima di poter 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 utilizzate l'API Java, create un ReaderExtensionsServiceClient oggetto. Se si utilizza l'API del servizio Web delle estensioni Acrobat Reader DC, creare un ReaderExtensionsServiceService oggetto.

Recupero di un documento PDF con diritti

Per recuperare informazioni sulle credenziali, è necessario recuperare un documento PDF abilitato per i diritti. È inoltre possibile recuperare informazioni su una credenziale specificandone l'alias; tuttavia, se si desidera recuperare informazioni su una credenziale utilizzata per applicare diritti di utilizzo a un documento PDF con diritti specifici, è necessario recuperare il documento.

Recupero di informazioni sulla credenziale

Dopo aver ottenuto un documento PDF con diritti, potete ottenere informazioni sulle credenziali utilizzate per applicarvi i diritti di utilizzo. È possibile ottenere le seguenti informazioni sulla credenziale:

  • Messaggio visualizzato in Adobe Reader all’apertura del documento PDF con diritti.
  • Data dopo la quale la credenziale non è più valida.
  • Data prima della quale la credenziale non è valida.
  • I diritti di utilizzo impostati per questo documento PDF con diritti.
  • Il numero di volte in cui è stata utilizzata la credenziale.

Consulta anche

Rimuovere i diritti di utilizzo mediante l'API Java

Rimozione dei diritti di utilizzo tramite l'API del servizio Web

Inclusione di file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Guida rapida di Acrobat Reader DC Extensions Service API

Recupero delle informazioni sulle credenziali tramite l'API Java

Ottenere le informazioni sulle credenziali utilizzando l’API delle estensioni Acrobat Reader DC (Java):

  1. Includere i file di progetto.

    Includete file JAR client, ad esempio adobe-reader-extensions-client.jar, nel percorso di classe del progetto Java.

  2. Creare un oggetto Client di estensioni Acrobat Reader DC.

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

  3. Recuperare un documento PDF.

    • Creare un oggetto java.io.FileInputStream che rappresenti 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.
    • Creare un com.adobe.idp.Document oggetto utilizzando il relativo costruttore e passando l' java.io.FileInputStream oggetto.

  4. Rimuovere i diritti di utilizzo dal documento PDF.

    • Recuperare informazioni sulle credenziali utilizzate per applicare diritti di utilizzo al documento PDF richiamando il metodo dell' ReaderExtensionsServiceClient oggetto getDocumentUsageRights e passando l' com.adobe.idp.Document oggetto che contiene il documento PDF abilitato per i diritti. Questo metodo restituisce un GetUsageRightsResult oggetto che contiene informazioni sulle credenziali.
    • Recuperare la data dopo la quale la credenziale non è più valida richiamando il GetUsageRightsResult metodo dell'oggetto getNotAfter . Questo metodo restituisce un oggetto java.util.Date che rappresenta la data dopo la quale la credenziale non è più valida.
    • Per recuperare il messaggio visualizzato in Adobe Reader all'apertura del documento PDF con diritti, è necessario richiamare il GetUsageRightsResult metodo getMessage dell'oggetto. Questo metodo restituisce un valore di stringa che rappresenta il messaggio.

Consulta anche

Recupero delle informazioni sulle credenziali

Avvio rapido (modalità SOAP): Recupero delle informazioni sulle credenziali tramite l'API Java

Inclusione di file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Recupero delle informazioni sulle credenziali tramite l'API del servizio Web

Recuperare le informazioni sulle credenziali utilizzando l’API delle estensioni Acrobat Reader DC (servizio Web):

  1. Includere i 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.

    Nota

    Sostituire localhost con l'indirizzo IP del server in cui è installato AEM Forms.

  2. Creare un oggetto Client di estensioni Acrobat Reader DC.

    • Creare un ReaderExtensionsServiceClient oggetto utilizzando il relativo costruttore predefinito.

    • Creare un ReaderExtensionsServiceClient.Endpoint.Address oggetto utilizzando il System.ServiceModel.EndpointAddress costruttore. Passa un valore di stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom. Assicurarsi di specificare ?blob=mtom.)

    • Creare un System.ServiceModel.BasicHttpBinding oggetto ottenendo il valore del ReaderExtensionsServiceClient.Endpoint.Binding campo. Inserite il valore restituito in BasicHttpBinding.

    • Impostare il campo System.ServiceModel.BasicHttpBinding dell' MessageEncoding oggetto su WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

    • Abilitate l'autenticazione HTTP di base eseguendo le seguenti operazioni:

      • Assegnare il nome utente dei moduli AEM al campo ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName.
      • Assegnare il valore della password corrispondente al campo ReaderExtensionsServiceClient.ClientCredentials.UserName.Password.
      • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Assegnare il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

  3. Recuperare un documento PDF.

    • Creare un BLOB oggetto utilizzando il relativo costruttore. L' BLOB oggetto viene utilizzato per memorizzare un documento PDF abilitato per i diritti.
    • Creare un System.IO.FileStream oggetto 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 dell' System.IO.FileStream oggetto. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà dell' System.IO.FileStream oggetto Length .
    • Compilare l'array di byte con i dati del flusso richiamando il System.IO.FileStream Read metodo dell'oggetto e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l' BLOB oggetto assegnandone MTOM la proprietà con il contenuto dell'array di byte.

  4. Rimuovere i diritti di utilizzo dal documento PDF.

    • Recuperare informazioni sulle credenziali utilizzate per applicare diritti di utilizzo al documento PDF richiamando il metodo dell' ReaderExtensionsServiceClient oggetto getDocumentUsageRights e passando l' com.adobe.idp.Document oggetto che contiene il documento PDF abilitato per i diritti. Questo metodo restituisce un GetUsageRightsResult oggetto che contiene informazioni sulle credenziali.
    • Recuperare la data dopo la quale la credenziale non è più valida ottenendo il valore del membro GetUsageRightsResult dati dell' notAfter oggetto. Il tipo di dati di questo membro è System.DateTime.
    • Per ottenere il messaggio visualizzato quando il documento PDF con diritti è aperto in Adobe Reader, è necessario recuperare il valore del membro GetUsageRightsResult dati message dell'oggetto. Il tipo di dati di questo membro è una stringa.
    • Recuperare il numero di volte in cui la credenziale viene utilizzata ottenendo il valore del membro GetUsageRightsResult dati dell' useCount oggetto. Il tipo di dati di questo membro è un numero intero.

Consulta anche

Recupero delle informazioni sulle credenziali

Attivazione di moduli AEM tramite MTOM

Richiamo di moduli AEM con SwaRef

In questa pagina