Assegnazione dei diritti di utilizzo assigning-usage-rights

Includi file di progetto

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

Crea un oggetto client per estensioni Acrobat Reader DC.

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

Recuperare un documento PDF.

• Creare un oggetto java.io.FileInputStream che rappresenta il documento PDF utilizzando il relativo costruttore e passando un valore 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.

Specificare i diritti di utilizzo da applicare.

• Creare un oggetto UsageRights che rappresenta i diritti di utilizzo utilizzando il relativo costruttore.
• Per ogni diritto di utilizzo da applicare, richiamare un metodo corrispondente appartenente all'oggetto UsageRights. Ad esempio, per aggiungere il diritto di utilizzo enableFormFillIn, richiamare il metodo enableFormFillIn dell'oggetto UsageRights e passare true. (Ripeti questo passaggio per ogni diritto d’uso da applicare).

Applica i diritti di utilizzo al documento PDF.

• Creare un oggetto ReaderExtensionsOptionSpec utilizzando il relativo 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:

  • Oggetto UsageRights 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 il metodo applyUsageRights dell'oggetto ReaderExtensionsServiceClient e passando i valori seguenti:

  • 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 i diritti di utilizzo.
  • Valore stringa che specifica il valore password corrispondente. (Attualmente questo parametro viene ignorato. È possibile passare null.)

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

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

Salva il documento di PDF con abilitazione per i diritti.

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

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.

Crea un oggetto client per 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. Passa un valore 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. Eseguire il cast del valore restituito in BasicHttpBinding.

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

• Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:

  • 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.

Recuperare un documento PDF.

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

Specificare i diritti di utilizzo da applicare.

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

Applica i diritti di utilizzo al documento PDF.

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

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

• Assegnare un valore stringa che specifichi il messaggio visualizzato da un utente quando il documento PDF con abilitazione per i diritti viene aperto in Adobe Reader al membro dati message dell'oggetto ReaderExtensionsOptionSpec.

• Applicare i diritti di utilizzo al documento PDF richiamando il metodo applyUsageRights dell'oggetto ReaderExtensionsServiceClient e passando i valori seguenti:

  • 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 i diritti di utilizzo.
  • Valore stringa che specifica il valore password corrispondente. (Attualmente questo parametro viene ignorato. È possibile passare null.)

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

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

Salva il documento di PDF con abilitazione per i diritti.

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

Includi file di progetto.

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

Crea un oggetto client per estensioni Acrobat Reader DC.

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

Recuperare un documento PDF.

• Creare un oggetto java.io.FileInputStream che rappresenta il documento PDF con abilitazione per i diritti utilizzando il relativo costruttore e passando un valore 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.

Rimuovi i diritti di utilizzo dal documento PDF.

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

Applica i diritti di utilizzo al documento PDF.

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

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.

Crea un oggetto client per 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. Passa un valore 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. Eseguire il cast del valore restituito in BasicHttpBinding.

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

• Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:

  • 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.

Recuperare un documento PDF.

• Creare un oggetto BLOB utilizzando il relativo costruttore. L'oggetto BLOB viene utilizzato per archiviare il documento PDF con diritti di utilizzo da cui vengono rimossi i diritti di utilizzo.
• Creare un oggetto System.IO.FileStream richiamandone il 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 dell'oggetto System.IO.FileStream. È possibile determinare le dimensioni della matrice di byte ottenendo la proprietà Length dell'oggetto System.IO.FileStream.
• Compilare la matrice di byte con i dati di flusso richiamando il metodo Read dell'oggetto System.IO.FileStream e passando la matrice di byte, la posizione iniziale e la lunghezza del flusso da leggere.
• Compilare l'oggetto BLOB assegnando la relativa proprietà MTOM al contenuto della matrice di byte.

Rimuovi i diritti di utilizzo dal documento PDF.

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

Applica i diritti di utilizzo al documento PDF.

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

Includi file di progetto.

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

Crea un oggetto client per estensioni Acrobat Reader DC.

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

Recuperare un documento PDF.

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

Rimuovi i diritti di utilizzo dal documento PDF.

• Recuperare le informazioni sulle credenziali utilizzate per applicare i diritti di utilizzo al documento PDF richiamando il metodo getDocumentUsageRights dell'oggetto ReaderExtensionsServiceClient e passando l'oggetto com.adobe.idp.Document che contiene il documento PDF abilitato per i diritti. Questo metodo restituisce un oggetto GetUsageRightsResult contenente informazioni sulle credenziali.
• Recuperare la data dopo la quale le credenziali non sono più valide richiamando il metodo getNotAfter dell'oggetto GetUsageRightsResult. Questo metodo restituisce un oggetto java.util.Date che rappresenta la data dopo la quale le credenziali non sono più valide.
• Recuperare il messaggio visualizzato in Adobe Reader quando il documento di PDF con abilitazione per i diritti viene aperto richiamando il metodo getMessage dell'oggetto GetUsageRightsResult. Questo metodo restituisce un valore stringa che rappresenta il messaggio.

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.

Crea un oggetto client per 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. Passa un valore 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. Eseguire il cast del valore restituito in BasicHttpBinding.

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

• Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:

  • 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.

Recuperare un documento PDF.

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

Rimuovi i diritti di utilizzo dal documento PDF.

• Recuperare le informazioni sulle credenziali utilizzate per applicare i diritti di utilizzo al documento PDF richiamando il metodo getDocumentUsageRights dell'oggetto ReaderExtensionsServiceClient 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 le credenziali non sono più valide ottenendo il valore del membro dati notAfter dell'oggetto GetUsageRightsResult. Il tipo di dati di questo membro dati è System.DateTime.
• Recuperare il messaggio visualizzato quando il documento PDF con abilitazione per i diritti viene aperto in Adobe Reader ottenendo il valore del membro dati message dell'oggetto GetUsageRightsResult. Il tipo di dati di questo membro dati è una stringa.
• Recuperare il numero di volte in cui le credenziali vengono utilizzate ottenendo il valore del membro dati useCount dell'oggetto GetUsageRightsResult. Il tipo di dati di questo membro dati è un numero intero.