Assegnazione di diritti di utilizzo

Informazioni su Acrobat Reader DC extensions Service

Il servizio di estensione Acrobat Reader DC consente alla vostra azienda di condividere facilmente 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 aggiunge i diritti di utilizzo a un documento PDF, attivando le funzioni normalmente non 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.

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

NOTA

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

Applicazione dei diritti di utilizzo ai documenti PDF

Potete applicare i diritti di utilizzo ai documenti PDF utilizzando l'API Java Client e il servizio Web di 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. Un 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 metodo applyUsageRights, che fa parte dell'API Java, è possibile impostare il parametro isModeFinal dell'oggetto ReaderExtensionsOptionSpec 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 parametro isModeFinal su false.

NOTA

Per ulteriori informazioni sul servizio delle estensioni Acrobat Reader DC, vedere Guida di riferimento dei 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 con estensioni Acrobat Reader DC.
  3. Recuperare un documento PDF.
  4. Specificate i diritti di utilizzo da applicare.
  5. Applicare i 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.

Creare un oggetto client con estensioni Acrobat Reader DC

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

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, attiva 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 diritti di utilizzo a un documento PDF, è necessario fare riferimento all'alias della credenziale utilizzata per applicare diritti di utilizzo (una credenziale viene in genere installata durante l'installazione di AEM Forms). È 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 applica i diritti di utilizzo a un documento PDF, è possibile salvare il documento PDF abilitato per i 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 file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido di Acrobat Reader DC Extensions Service API

Applicazione dei diritti di utilizzo tramite l'API Java

Applicazione dei diritti di utilizzo a un documento PDF tramite 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 con estensioni Acrobat Reader DC.

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

  3. Recuperare un documento PDF.

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

  4. Specificate i diritti di utilizzo da applicare.

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

  5. Applicare i diritti di utilizzo al documento PDF.

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

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

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

      • L'oggetto com.adobe.idp.Document 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. È possibile passare null.

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

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

  6. Salvare il documento PDF con diritti.

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

Consulta anche

Applicazione dei diritti di utilizzo ai documenti PDF

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

Inclusione file libreria Java AEM Forms

Impostazione delle proprietà di connessione

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

Applicazione dei diritti di utilizzo a un documento PDF tramite 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 che ospita AEM Forms.

  2. Creare un oggetto client con estensioni Acrobat Reader DC.

    • Creare un oggetto ReaderExtensionsServiceClient utilizzando il relativo costruttore predefinito.

    • Creare un oggetto ReaderExtensionsServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passate 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 oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo ReaderExtensionsServiceClient.Endpoint.Binding. Inserite il valore restituito in BasicHttpBinding.

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

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

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

  4. Specificate i diritti di utilizzo da applicare.

    • Creare un oggetto UsageRights 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'oggetto UsageRights. Ad esempio, per aggiungere il diritto di utilizzo enableFormFillIn, assegnare true al membro di dati UsageRights dell'oggetto enableFormFillIn. Ripetete questo passaggio per ogni diritto di utilizzo da applicare.

  5. Applicare i diritti di utilizzo al documento PDF.

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

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

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

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

      • L'oggetto BLOB 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. È possibile passare null.

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

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

  6. Salvare il documento PDF con diritti.

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

Consulta anche

Applicazione dei diritti di utilizzo ai documenti PDF

Chiamata AEM Forms tramite MTOM

Chiamata AEM Forms tramite SwaRef

Rimozione dei diritti di utilizzo dai documenti PDF

Potete rimuovere i diritti di utilizzo da un documento con diritti. La rimozione dei diritti di utilizzo da un documento PDF con diritti è necessaria anche per eseguire altre operazioni AEM Forms su di esso . 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, vedere Guida di riferimento dei 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 con 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.

Creare un oggetto client con estensioni Acrobat Reader DC

Prima di eseguire un'operazione del servizio di estensione Acrobat Reader DC a livello di programmazione, è necessario creare un oggetto client del servizio di estensione Acrobat Reader DC. Se utilizzate l'API Java, create un oggetto ReaderExtensionsServiceClient. Se utilizzate l'API del servizio Web con estensione Acrobat Reader DC, create un oggetto ReaderExtensionsServiceService.

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ù i diritti di utilizzo. Una volta salvato come file 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 file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido 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 abilitato per i diritti, utilizzate 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 con estensioni Acrobat Reader DC.

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

  4. Rimuovere i diritti di utilizzo dal documento PDF.

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

  5. Applicare i diritti di utilizzo al documento PDF.

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

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 file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Rimuovere i diritti di utilizzo mediante l'API del servizio Web

Per rimuovere i diritti di utilizzo da un documento PDF abilitato per i diritti, utilizzate 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 che ospita AEM Forms.

  2. Creare un oggetto client con estensioni Acrobat Reader DC.

    • Creare un oggetto ReaderExtensionsServiceClient utilizzando il relativo costruttore predefinito.

    • Creare un oggetto ReaderExtensionsServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passate 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 oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo ReaderExtensionsServiceClient.Endpoint.Binding. Inserite il valore restituito in BasicHttpBinding.

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

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

      • Assegnare il nome utente del modulo 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 oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare il documento PDF con diritti abilitati dal quale vengono rimossi i diritti di utilizzo.
    • Creare un oggetto 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 dell'oggetto System.IO.FileStream. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà System.IO.FileStream dell'oggetto Length.
    • Compilare l'array di byte con i dati del flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l'oggetto BLOB assegnandone la proprietà MTOM 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 metodo ReaderExtensionsServiceClient dell'oggetto removeUsageRights e passando l'oggetto <a2/> che contiene il documento PDF abilitato per i diritti. BLOB Questo metodo restituisce un oggetto BLOB contenente un documento PDF che non dispone dei diritti di utilizzo.

  5. Applicare i diritti di utilizzo al documento PDF.

    • Creare un oggetto System.IO.FileStream richiamandone il costruttore e passando un valore di stringa che rappresenta il percorso del file PDF.
    • Creare un array di byte che memorizza il contenuto dei dati dell'oggetto BLOB restituito dal metodo removeUsageRights. Compilare l'array di byte ottenendo il valore del membro di dati BLOB dell'oggetto MTOM.
    • Creare un oggetto System.IO.BinaryWriter richiamandone il costruttore e passando l'oggetto System.IO.FileStream.

Consulta anche

Rimozione dei diritti di utilizzo dai documenti PDF

Chiamata AEM Forms tramite MTOM

Chiamata AEM Forms tramite SwaRef

Recupero delle informazioni sulle credenziali

È possibile recuperare informazioni sulle credenziali utilizzate per applicare i 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, vedere Guida di riferimento dei 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 con 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.

Creare un oggetto client con estensioni Acrobat Reader DC

Prima di eseguire un'operazione del servizio di estensione Acrobat Reader DC a livello di programmazione, è necessario creare un oggetto client del servizio di estensione Acrobat Reader DC. Se utilizzate l'API Java, create un oggetto ReaderExtensionsServiceClient. Se utilizzate l'API del servizio Web con estensione Acrobat Reader DC, create un oggetto ReaderExtensionsServiceService.

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 file libreria Java AEM Forms

Impostazione delle proprietà di connessione

Avvio rapido di Acrobat Reader DC Extensions Service API

Recuperare le informazioni sulle credenziali utilizzando l'API Java

Recuperate 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 con estensioni Acrobat Reader DC.

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

  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 ReaderExtensionsServiceClient dell'oggetto getDocumentUsageRights e passando l'oggetto com.adobe.idp.Document che contiene il documento PDF abilitato per i diritti. Questo metodo restituisce un oggetto GetUsageRightsResult che contiene informazioni sulle credenziali.
    • Recuperare la data dopo la quale la credenziale non è più valida richiamando il metodo GetUsageRightsResult dell'oggetto getNotAfter. Questo metodo restituisce un oggetto java.util.Date che rappresenta la data dopo la quale la credenziale non è più valida.
    • Recuperare il messaggio visualizzato in Adobe Reader quando il documento PDF abilitato per i diritti viene aperto richiamando il metodo GetUsageRightsResult dell'oggetto getMessage. 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 file libreria Java AEM Forms

Impostazione delle proprietà di connessione

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

Recuperate 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 che ospita AEM Forms.

  2. Creare un oggetto client con estensioni Acrobat Reader DC.

    • Creare un oggetto ReaderExtensionsServiceClient utilizzando il relativo costruttore predefinito.

    • Creare un oggetto ReaderExtensionsServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. Passate 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 oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo ReaderExtensionsServiceClient.Endpoint.Binding. Inserite il valore restituito in BasicHttpBinding.

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

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

      • Assegnare il nome utente del modulo 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 oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per memorizzare un documento PDF abilitato per i diritti.
    • Creare un oggetto System.IO.FileStream richiamando il relativo costruttore e passando un valore di stringa che rappresenta il percorso 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'oggetto System.IO.FileStream. È possibile determinare la dimensione dell'array di byte ottenendo la proprietà System.IO.FileStream dell'oggetto Length.
    • Compilare l'array di byte con i dati del flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando l'array di byte, la posizione iniziale e la lunghezza del flusso da leggere.
    • Compilare l'oggetto BLOB assegnandone la proprietà MTOM 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 ReaderExtensionsServiceClient dell'oggetto getDocumentUsageRights e passando l'oggetto com.adobe.idp.Document che contiene il documento PDF abilitato per i diritti. Questo metodo restituisce un oggetto GetUsageRightsResult che contiene informazioni sulle credenziali.
    • Recuperare la data dopo la quale la credenziale non è più valida ottenendo il valore del membro di dati GetUsageRightsResult dell'oggetto notAfter. Il tipo di dati di questo membro è System.DateTime.
    • Recuperare il messaggio visualizzato quando il documento PDF con diritti viene aperto in Adobe Reader ottenendo il valore del membro di dati GetUsageRightsResult dell'oggetto message. 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 di dati GetUsageRightsResult dell'oggetto useCount. Il tipo di dati di questo membro dati è un numero intero.

Consulta anche

Recupero delle informazioni sulle credenziali

Chiamata AEM Forms tramite MTOM

Chiamata AEM Forms tramite SwaRef

In questa pagina