Attribution des droits d’utilisation assigning-usage-rights

Inclure les fichiers du projet

Incluez les fichiers JAR du client, tels qu’adobe-livecycle-client.jar, dans le chemin d’accès aux classes de votre projet Java.

Créez un objet Client des extensions Acrobat Reader DC.

• Créez un objet ServiceClientFactory qui contient des propriétés de connexion.
• Créez un objet ReaderExtensionsServiceClient en utilisant son constructeur et en transmettant l’objet ServiceClientFactory.

Récupérez un document PDF.

• Créez un objet java.io.FileInputStream qui représente le document PDF en utilisant son constructeur et en transmettant une valeur de chaîne qui spécifie l’emplacement du document PDF.
• Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.

Spécifiez les droits d’utilisation à appliquer.

• Créez un objet UsageRights qui représente les droits d’utilisation à l’aide de son constructeur.
• Pour chaque droit d’utilisation à appliquer, appelez une méthode correspondante qui appartient à l’objet UsageRights. Par exemple, pour ajouter le droit d’utilisation enableFormFillIn, appelez la méthode enableFormFillIn de l’objet UsageRights et transmettez true. (Répétez cette étape pour chaque droit d’utilisation à appliquer).

Appliquez les droits d’utilisation au document PDF.

• Créez un objet ReaderExtensionsOptionSpec en utilisant son constructeur. Cet objet contient les options d’exécution requises par le service Extensions Acrobat Reader DC. Lorsque vous appelez ce constructeur, vous devez spécifier les valeurs suivantes :

  • Objet UsageRights contenant les droits d’utilisation à appliquer au document.
  • Valeur de chaîne qui spécifie un message que l’utilisateur voit lorsque le document PDF avec droits d’utilisation est ouvert dans Adobe Reader 7.x. Ce message n’est pas affiché dans Adobe Reader 8.0.

• Appliquez des droits d’utilisation au document PDF en appelant la méthode applyUsageRights de l’objet ReaderExtensionsServiceClient et en transmettant les valeurs suivantes :

  • Objet com.adobe.idp.Document contenant le document PDF auquel les droits d’utilisation sont appliqués.
  • Valeur de chaîne spécifiant l’alias des informations d’identification qui vous permettent d’appliquer les droits d’utilisation.
  • Valeur string qui spécifie la valeur du mot de passe correspondant. (Actuellement, ce paramètre est ignoré. Vous pouvez transmettre null.)

• Objet ReaderExtensionsOptionSpec contenant les options d’exécution.

La méthode applyUsageRights renvoie un objet com.adobe.idp.Document qui contient le document PDF dont les droits sont activés.

Enregistrez le document PDF défini avec des droits d’utilisation.

• Créez un objet java.io.File et assurez-vous que l’extension du fichier est .pdf.
• Appelez la méthode copyToFile de l’objet com.adobe.idp.Document pour copier le contenu de l’objet com.adobe.idp.Document dans le fichier (assurez-vous d’utiliser l’objet com.adobe.idp.Document qui a été renvoyé par la méthode applyUsageRights).

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1.

Créez un objet Client des extensions Acrobat Reader DC.

• Créez un objet ReaderExtensionsServiceClient en utilisant son constructeur par défaut.

• Créez un objet ReaderExtensionsServiceClient.Endpoint.Address en utilisant le constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur de chaîne qui spécifie le WSDL au service AEM Forms (par exemple http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom. Assurez-vous de spécifier ?blob=mtom).

• Créez un objet System.ServiceModel.BasicHttpBinding en récupérant la valeur du champ ReaderExtensionsServiceClient.Endpoint.Binding. Convertissez la valeur de retour en BasicHttpBinding.

• Définissez le champ MessageEncoding de l’objet System.ServiceModel.BasicHttpBinding sur WSMessageEncoding.Mtom. Cette valeur garantit l’utilisation de MTOM.

• Activez l’authentification HTTP de base en effectuant les tâches suivantes :

  • Attribuez le nom d’utilisateur AEM forms au champ ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ ReaderExtensionsServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Récupérez un document PDF.

• Créez un objet BLOB en utilisant son constructeur. L’objet BLOB sert à stocker un document PDF auquel des droits d’utilisation sont appliqués.
• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne représentant l’emplacement du document PDF et le mode d’ouverture du fichier.
• Créez un tableau d’octets qui stocke le contenu de l’objet System.IO.FileStream. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété Length de l’objet System.IO.FileStream.
• Renseignez le tableau d’octets avec le flux de données en appelant la méthode Read de l’objet System.IO.FileStream. Transmettez le tableau d’octets, la position de départ et la longueur du flux à lire.
• Renseignez l’objet BLOB en affectant à sa propriété MTOM le contenu du tableau d’octets.

Spécifiez les droits d’utilisation à appliquer.

• Créez un objet UsageRights représentant les droits d’utilisation à l’aide de son constructeur.
• Pour chaque droit d’utilisation à appliquer, affectez la valeur true au membre de données correspondant appartenant à l’objet UsageRights. Par exemple, pour ajouter le droit d’utilisation enableFormFillIn, affectez true au membre de données enableFormFillIn de l’objet UsageRights. (Répétez cette étape pour chaque droit d’utilisation à appliquer).

Appliquez les droits d’utilisation au document PDF.

• Créez un objet ReaderExtensionsOptionSpec en utilisant son constructeur. Cet objet contient des options d’exécution requises par le service Extensions Acrobat Reader DC.

• Affectez l’objet UsageRights au membre de données usageRights de l’objet ReaderExtensionsOptionSpec.

• Affectez une valeur de chaîne spécifiant le message qu’un utilisateur voit lorsqu’un document PDF défini avec des droits d’utilisation est ouvert dans Adobe Reader au membre de données message de l’objet ReaderExtensionsOptionSpec.

• Appliquez des droits d’utilisation au document PDF en appelant la méthode applyUsageRights de l’objet ReaderExtensionsServiceClient et en transmettant les valeurs suivantes :

  • Objet BLOB contenant le document PDF auquel les droits d’utilisation sont appliqués.
  • Valeur de chaîne spécifiant l’alias des informations d’identification qui vous permettent d’appliquer les droits d’utilisation.
  • Valeur string qui spécifie la valeur du mot de passe correspondant. (Actuellement, ce paramètre est ignoré. Vous pouvez transmettre null.)

• Objet ReaderExtensionsOptionSpec contenant les options d’exécution.

La méthode applyUsageRights renvoie un objet BLOB qui contient le document PDF dont les droits sont activés.

Enregistrez le document PDF défini avec des droits d’utilisation.

• Créez un objet System.IO.FileStream en utilisant son constructeur. Transmettez une valeur de chaîne représentant l’emplacement du document PDF défini avec des droits d’utilisation.
• Créez un tableau d’octets qui stocke le contenu des données de l’objet BLOB qui a été renvoyé par la méthode applyUsageRights. Renseignez le tableau d’octets en obtenant la valeur du membre de données MTOM de l’objet BLOB.
• Créez un objet System.IO.BinaryWriter en utilisant son constructeur et en transmettant l’objet System.IO.FileStream.
• Écrivez le contenu du tableau d’octets dans un fichier PDF en appelant la méthode Write de l’objet System.IO.BinaryWriter et en transmettant le tableau d’octets.

Incluez les fichiers de projet.

Incluez les fichiers JAR client, tels qu’adobe-livecycle-client.jar, dans le chemin d’accès aux classes de votre projet Java.

Créez un objet Client des extensions Acrobat Reader DC.

Créez un objet ReaderExtensionsServiceClient en utilisant son constructeur et en transmettant un objet ServiceClientFactory contenant des propriétés de connexion.

Récupérez un document PDF.

• Créez un objet java.io.FileInputStream qui représente le document PDF dont les droits sont activés en utilisant son constructeur et en transmettant une valeur de chaîne qui spécifie l’emplacement du document PDF.
• Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.

Supprimez les droits d’utilisation du document PDF.

Supprimez les droits d’utilisation du document PDF en appelant la méthode removeUsageRights de l’objet ReaderExtensionsServiceClient et en transmettant l’objet com.adobe.idp.Document qui contient le document PDF dont les droits sont activés. Cette méthode renvoie un objet com.adobe.idp.Document qui contient un document PDF ne disposant pas de droits d’utilisation.

Appliquez les droits d’utilisation au document PDF.

• Créez un objet java.io.File et assurez-vous que l’extension du fichier est .PDF.
• Appelez la méthode copyToFile de l’objet Document pour copier le contenu de l’objet Document dans le fichier (assurez-vous d’utiliser l’objet Document qui a été renvoyé par la méthode removeUsageRights).

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1.

Créez un objet Client des extensions Acrobat Reader DC.

• Créez un objet ReaderExtensionsServiceClient en utilisant son constructeur par défaut.

• Créez un objet ReaderExtensionsServiceClient.Endpoint.Address en utilisant le constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur de chaîne qui spécifie le WSDL au service AEM Forms (par exemple http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom. Assurez-vous de spécifier ?blob=mtom).

• Créez un objet System.ServiceModel.BasicHttpBinding en récupérant la valeur du champ ReaderExtensionsServiceClient.Endpoint.Binding. Convertissez la valeur de retour en BasicHttpBinding.

• Définissez le champ MessageEncoding de l’objet System.ServiceModel.BasicHttpBinding sur WSMessageEncoding.Mtom. Cette valeur garantit l’utilisation de MTOM.

• Activez l’authentification HTTP de base en effectuant les tâches suivantes :

  • Attribuez le nom d’utilisateur AEM forms au champ ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ ReaderExtensionsServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Récupérez un document PDF.

• Créez un objet BLOB en utilisant son constructeur. L’objet BLOB sert à stocker le document PDF défini avec des droits d’utilisation et à partir duquel les droits d’utilisation sont supprimés.
• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne représentant l’emplacement du document PDF et le mode d’ouverture du fichier.
• Créez un tableau d’octets qui stocke le contenu de l’objet System.IO.FileStream. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété Length de l’objet System.IO.FileStream.
• Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode Read de l’objet System.IO.FileStream et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.
• Renseignez l’objet BLOB en affectant sa propriété MTOM au contenu du tableau d’octets.

Supprimez les droits d’utilisation du document PDF.

Supprimez les droits d’utilisation du document PDF en appelant la méthode removeUsageRights de l’objet ReaderExtensionsServiceClient et en transmettant l’objet BLOB qui contient le document PDF dont les droits sont activés. Cette méthode renvoie un objet BLOB qui contient un document PDF ne disposant pas de droits d’utilisation.

Appliquez les droits d’utilisation au document PDF.

• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne représentant l’emplacement du fichier du PDF.
• Créez un tableau d’octets qui stocke le contenu des données de l’objet BLOB qui a été renvoyé par la méthode removeUsageRights. Renseignez le tableau d’octets en obtenant la valeur du membre de données MTOM de l’objet BLOB.
• Créez un objet System.IO.BinaryWriter en appelant son constructeur et en transmettant l’objet System.IO.FileStream.

Incluez les fichiers de projet.

Incluez les fichiers JAR client, tels qu’adobe-livecycle-client.jar, dans le chemin d’accès aux classes de votre projet Java.

Créez un objet Client des extensions Acrobat Reader DC.

Créez un objet ReaderExtensionsServiceClient en utilisant son constructeur et en transmettant un objet ServiceClientFactory contenant des propriétés de connexion.

Récupérez un document PDF.

• Créez un objet java.io.FileInputStream qui représentent le document PDF dont les droits sont activés en utilisant son constructeur et en transmettant une valeur de chaîne qui spécifie l’emplacement du document PDF dont les droits sont activés.
• Créez un objet com.adobe.idp.Document en utilisant son constructeur et en transmettant l’objet java.io.FileInputStream.

Supprimez les droits d’utilisation du document PDF.

• Récupérez les informations relatives aux informations d’identification utilisées pour appliquer les droits d’utilisation au document PDF en appelant la méthode getDocumentUsageRights de l’objet ReaderExtensionsServiceClient et en transmettant l’objet com.adobe.idp.Document qui contient le document PDF dont les droits sont activés. Cette méthode renvoie un objet GetUsageRightsResult qui contient des informations d’identification.
• Récupérez la date après laquelle les informations d’identification ne sont plus valides en appelant la méthode getNotAfter de l’objet GetUsageRightsResult. Cette méthode renvoie un objet java.util.Date qui représente la date après laquelle les informations d’identification ne sont plus valides.
• Récupérez le message qui s’affiche dans Adobe Reader lors de l’ouverture d’un document PDF dont les droits sont activés en appelant la méthode getMessage de l’objet GetUsageRightsResult. Cette méthode renvoie une valeur de chaîne qui représente le message.

Incluez les fichiers de projet.

Créez un projet Microsoft .NET qui utilise MTOM. Veillez à utiliser la définition WSDL suivante : http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1.

Créez un objet Client des extensions Acrobat Reader DC.

• Créez un objet ReaderExtensionsServiceClient en utilisant son constructeur par défaut.

• Créez un objet ReaderExtensionsServiceClient.Endpoint.Address en utilisant le constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur de chaîne qui spécifie le WSDL au service AEM Forms (par exemple http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom. Assurez-vous de spécifier ?blob=mtom).

• Créez un objet System.ServiceModel.BasicHttpBinding en récupérant la valeur du champ ReaderExtensionsServiceClient.Endpoint.Binding. Convertissez la valeur de retour en BasicHttpBinding.

• Définissez le champ MessageEncoding de l’objet System.ServiceModel.BasicHttpBinding sur WSMessageEncoding.Mtom. Cette valeur garantit l’utilisation de MTOM.

• Activez l’authentification HTTP de base en effectuant les tâches suivantes :

  • Attribuez le nom d’utilisateur AEM forms au champ ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName.
  • Attribuez la valeur de mot de passe correspondante au champ ReaderExtensionsServiceClient.ClientCredentials.UserName.Password.
  • Attribuez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Attribuez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

Récupérez un document PDF.

• Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker un document de PDF dont les droits sont activés.
• Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur de chaîne qui représente l’emplacement du fichier du document PDF dont les droits sont activés et le mode d’ouverture du fichier.
• Créez un tableau d’octets qui stocke le contenu de l’objet System.IO.FileStream. Vous pouvez déterminer la taille du tableau d’octets en obtenant la propriété Length de l’objet System.IO.FileStream.
• Renseignez le tableau d’octets avec les données de diffusion en appelant la méthode Read de l’objet System.IO.FileStream et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.
• Renseignez l’objet BLOB en affectant sa propriété MTOM au contenu du tableau d’octets.

Supprimez les droits d’utilisation du document PDF.

• Récupérez des informations sur les informations d’identification utilisées pour appliquer des droits d’utilisation au document PDF en appelant la méthode getDocumentUsageRights de l’objet ReaderExtensionsServiceClient et en transmettant l’objet com.adobe.idp.Document contenant le document PDF dont les droits sont activés. Cette méthode renvoie un objet GetUsageRightsResult contenant des informations d’identification.
• Récupérez la date après laquelle les informations d’identification ne sont plus valides en obtenant la valeur du membre de données notAfter de l’objet GetUsageRightsResult. Le type de données de ce membre de données est System.DateTime.
• Récupérez le message qui s’affiche lorsque le document PDF dont les droits sont activés est ouvert dans Adobe Reader en obtenant la valeur du membre de données message de l’objet GetUsageRightsResult. Le type de données de ce membre de données est une chaîne.
• Récupérez le nombre de fois où les informations d’identification sont utilisées en obtenant la valeur du membre de données useCount de l’objet GetUsageRightsResult. Le type de données de ce membre de données est un entier.