Attribution des droits d'utilisation

Les exemples et exemples de ce document ne concernent que l’environnement AEM Forms on JEE.

À propos du service des extensions Acrobat Reader DC

Le service Acrobat Reader DC Extensions permet à votre entreprise de partager facilement des documents PDF interactifs en étendant les fonctionnalités de Adobe Reader. Le service Acrobat Reader DC Extensions prend entièrement en charge tout document PDF, jusqu’à PDF 1.7 inclus. Il fonctionne avec Adobe Reader 7.0 et versions ultérieures. Le service ajoute des droits d’utilisation à un document PDF, en activant des fonctions qui ne sont généralement pas disponibles à l’ouverture d’un document PDF à l’aide de Adobe Reader. Les utilisateurs tiers n’ont pas besoin de logiciels ou de modules complémentaires supplémentaires pour travailler avec les documents dotés de droits d’utilisation.

Vous pouvez effectuer ces tâches à l’aide du service Acrobat Reader DC Extensions :

REMARQUE

Pour plus d’informations sur le service des extensions Acrobat Reader DC, voir Guide de référence des services pour AEM Forms.

Application des droits d’utilisation aux Documents PDF

Vous pouvez appliquer des droits d’utilisation aux documents PDF à l’aide de l’API client Java Extensions Acrobat Reader DC et du service Web. Les droits d’utilisation appartiennent à la fonctionnalité disponible par défaut dans Acrobat mais non dans Adobe Reader, telle que la capacité à ajouter des commentaires à un formulaire ou à remplir des champs de formulaire et enregistrer ce dernier. Les documents PDF dotés de droits d’utilisation sont appelés des documents dont les droits sont activés. Un utilisateur qui ouvre un document dont les droits sont activés dans Adobe Reader peut effectuer les opérations autorisées pour ce document spécifique.

REMARQUE

Lorsque vous appliquez des droits d’utilisation aux documents PDF à l’aide de la méthode applyUsageRights, qui fait partie de l’API Java, vous pouvez définir le paramètre isModeFinal de l’objet ReaderExtensionsOptionSpec sur false. Le compteur traité des formulaires n’est donc pas mis à jour et les performances s’en trouvent améliorées. Si la mise à jour du compteur traité de formulaires ne vous préoccupe pas, il est recommandé de définir le paramètre isModeFinal sur false.

REMARQUE

Pour plus d’informations sur le service des extensions Acrobat Reader DC, voir Guide de référence des services pour AEM Forms.

Résumé des étapes

Pour appliquer des droits d’utilisation à un document PDF, procédez comme suit :

  1. Incluez des fichiers de projet.
  2. Créez un objet Client d’extensions Acrobat Reader DC.
  3. Récupérez un document PDF.
  4. Spécifiez les droits d’utilisation à appliquer.
  5. Appliquez des droits d’utilisation au document PDF.
  6. Enregistrez le document PDF dont les droits sont activés.

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services Web, veillez à inclure les fichiers proxy.

Création d’un objet Client d’extensions Acrobat Reader DC

Pour exécuter par programmation une opération de service d’extensions Acrobat Reader DC, vous devez créer un objet client de service d’extensions Acrobat Reader DC. Si vous utilisez l’API Java des extensions Acrobat Reader DC, créez un objet ReaderExtensionsServiceClient. Si vous utilisez l’API du service Web des extensions Acrobat Reader DC, créez un objet ReaderExtensionsServiceService.

Récupération d’un document PDF

Vous devez récupérer un document PDF pour appliquer des droits d’utilisation. Les documents PDF dont les droits sont activés contiennent un dictionnaire de droits d’utilisation. Lorsque Adobe Reader ouvre un document contenant un tel dictionnaire, il active les droits d’utilisation spécifiés dans le dictionnaire pour ce document uniquement. Si le document ne contient pas de dictionnaire de droits d’utilisation, le service Acrobat Reader DC Extensions en crée un. S’il contient déjà un dictionnaire, le service des extensions Acrobat Reader DC remplace les droits d’utilisation existants par ceux que vous spécifiez. Le dictionnaire spécifie les droits d’utilisation activés. Lorsqu’un utilisateur ouvre le document dans Adobe Reader, seuls les droits d’utilisation spécifiés dans le dictionnaire sont autorisés.

Spécifier les droits d’utilisation à appliquer

Les droits d’utilisation que vous pouvez définir sont déterminés par les informations d’identification que vous achetez à Adobe Systems Incorporated. En règle générale, les informations d’identification permettent de définir un groupe de droits d’utilisation connexes, tels que ceux relatifs aux formulaires interactifs. Chaque information d’identification permet de créer un certain nombre de documents PDF dont les droits sont activés. Les informations d’identification d’évaluation permettent de créer un nombre illimité de documents préliminaires.

REMARQUE

Si vous tentez d’attribuer un droit d’utilisation non autorisé par vos informations d’identification, vous provoquerez une exception.

Appliquer des droits d’utilisation au document PDF

Pour appliquer des droits d’utilisation à un document PDF, vous référencez l’alias des informations d’identification que vous utilisez pour appliquer des droits d’utilisation (les informations d’identification sont généralement installées lors de l’installation de AEM Forms). Vous devez également spécifier le document PDF auquel les droits d’utilisation sont appliqués. Pour plus d’informations sur la configuration d’informations d’identification, voir le guide d’installation et de déploiement de votre serveur d’applications.

Enregistrer le document PDF dont les droits sont activés

Une fois que le service Acrobat Reader DC Extensions applique des droits d’utilisation à un document PDF, vous pouvez enregistrer le document PDF dont les droits sont activés en tant que fichier PDF.

Voir également

Appliquer les droits d’utilisation à l’aide de l’API Java

Appliquer des droits d’utilisation à l’aide de l’API de service Web

Inclusion des fichiers de bibliothèque Java AEM Forms

Réglage des propriétés de la connexion

débuts rapides de l’API du service Acrobat Reader DC Extensions

Appliquer les droits d’utilisation à l’aide de l’API Java

Appliquez des droits d’utilisation à un document PDF à l’aide de l’API Acrobat Reader DC Extensions (Java) :

  1. Inclure les fichiers de projet

    Incluez des fichiers JAR client, tels que adobe-reader-extensions-client.jar, dans le chemin de classe de votre projet Java.

  2. Créez un objet Client d’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.

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

  4. 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 UsageRights de l’objet enableFormFillIn et transmettez true. (Répétez cette étape pour chaque droit d’utilisation à appliquer).

  5. Appliquez des 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 des 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 lorsqu’un document PDF doté de 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 ReaderExtensionsServiceClient de l’objet applyUsageRights 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 qui spécifie l’alias des informations d’identification qui vous permet d’appliquer des 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 contenant le document PDF dont les droits sont activés.

  6. Enregistrez le document PDF dont les droits sont activés.

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

Voir également

Application des droits d’utilisation aux Documents PDF

Début rapide (mode SOAP) : application de droits d’utilisation à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java AEM Forms

Réglage des propriétés de la connexion

Appliquer des droits d’utilisation à l’aide de l’API de service Web

Appliquez des droits d’utilisation à un document PDF à l’aide de l’API Acrobat Reader DC Extensions (service Web) :

  1. Incluez des fichiers de projet.

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

    REMARQUE

    Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.

  2. Créez un objet Client d’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. Veillez à spécifier ?blob=mtom.)

    • Créez un objet System.ServiceModel.BasicHttpBinding en obtenant 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 exécutant 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.
      • Affectez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

  3. Récupérez un document PDF.

    • Créez un objet BLOB en utilisant son constructeur. L’objet BLOB permet de 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 qui représente l’emplacement du fichier 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é System.IO.FileStream de l’objet Length.
    • Renseignez le tableau d’octets avec les données de flux en appelant la méthode System.IO.FileStream de l’objet Read. Passez le tableau d’octets, la position de départ et la longueur du flux à lire.
    • Renseignez l’objet BLOB en attribuant sa propriété MTOM au contenu du tableau d’octets.

  4. 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, affectez la valeur true au membre de données correspondant qui appartient à l'objet UsageRights. Par exemple, pour ajouter le droit d’utilisation enableFormFillIn, affectez true au membre de données UsageRights de l’objet enableFormFillIn. (Répétez cette étape pour chaque droit d’utilisation à appliquer).

  5. Appliquez des 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 des extensions Acrobat Reader DC.

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

    • Attribuez une valeur de chaîne qui spécifie le message qu’un utilisateur voit lorsqu’un document PDF doté de droits 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 ReaderExtensionsServiceClient de l’objet applyUsageRights et en transmettant les valeurs suivantes :

      • Objet BLOB contenant le document PDF auquel les droits d’utilisation sont appliqués.
      • Valeur de chaîne qui spécifie l’alias des informations d’identification qui vous permet d’appliquer des 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 contenant le document PDF dont les droits sont activés.

  6. Enregistrez le document PDF dont les droits sont activés.

    • Créez un objet System.IO.FileStream en appelant son constructeur. Transmettez une valeur de chaîne qui représente l’emplacement du fichier du document PDF dont les droits sont activés.
    • Créez un tableau d’octets qui stocke le contenu des données de l’objet BLOB 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 appelant son constructeur et en transmettant l'objet System.IO.FileStream.
    • Ecrivez le contenu du tableau d’octets dans un fichier PDF en appelant la méthode System.IO.BinaryWriter de l’objet Write et en transmettant le tableau d’octets.

Voir également

Application des droits d’utilisation aux Documents PDF

Appel de AEM Forms à l’aide de MTOM

Appel de AEM Forms à l’aide de SwaRef

Suppression des droits d’utilisation des Documents PDF

Vous pouvez supprimer des droits d’utilisation d’un document dont les droits sont activés. Il est également nécessaire de supprimer les droits d’utilisation d’un document PDF doté de droits d’utilisation pour effectuer d’autres opérations AEM Forms sur ce . Vous devez par exemple signer numériquement (ou certifier) un document PDF avant de définir ses droits d’utilisation. Par conséquent, si vous souhaitez effectuer des opérations sur un document doté de droits d’utilisation, vous devez supprimer les droits d’utilisation du document PDF, effectuer les autres opérations, telles que la signature numérique du document, puis réappliquer les droits d’utilisation au document.

REMARQUE

Pour plus d’informations sur le service des extensions Acrobat Reader DC, voir Guide de référence des services pour AEM Forms.

Résumé des étapes

Pour supprimer des droits d’utilisation d’un document PDF dont les droits sont activés, procédez comme suit :

  1. Incluez des fichiers de projet.
  2. Créez un objet Client d’extensions Acrobat Reader DC.
  3. Récupérez un document PDF dont les droits sont activés.
  4. Supprimez les droits d’utilisation du document PDF.
  5. Enregistrez le document PDF.

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services Web, veillez à inclure les fichiers proxy.

Création d’un objet Client d’extensions Acrobat Reader DC

Avant de pouvoir exécuter une opération de service d’extensions Acrobat Reader DC par programmation, vous devez créer un objet client de service d’extensions Acrobat Reader DC. Si vous utilisez l’API Java, créez un objet ReaderExtensionsServiceClient. Si vous utilisez l’API du service Web des extensions Acrobat Reader DC, créez un objet ReaderExtensionsServiceService.

Récupération d’un document PDF dont les droits sont activés

Récupérez un document PDF dont les droits sont activés afin de supprimer les droits d’utilisation.

Suppression des droits d’utilisation du document PDF

Après avoir récupéré un document PDF doté de droits d’utilisation, vous pouvez supprimer des droits d’utilisation. Une fois les droits d’utilisation supprimés, le document PDF ne comporte aucune fonctionnalité supplémentaire lors de son affichage dans Adobe Reader.

Enregistrer le document PDF

Vous pouvez enregistrer le document PDF qui ne contient plus de droits d’utilisation en tant que fichier PDF. Une fois enregistré en tant que fichier PDF, le document PDF peut être affiché dans Adobe Reader ou Acrobat.

Voir également

Suppression des droits d’utilisation à l’aide de l’API Java

Suppression des droits d’utilisation à l’aide de l’API de service Web

Inclusion des fichiers de bibliothèque Java AEM Forms

Réglage des propriétés de la connexion

débuts rapides de l’API du service Acrobat Reader DC Extensions

Application des droits d’utilisation aux Documents PDF

Supprimer les droits d'utilisation à l'aide de l'API Java

Supprimez les droits d’utilisation d’un document PDF dont les droits sont activés à l’aide de l’API des extensions Acrobat Reader DC (Java) :

  1. Incluez des fichiers de projet.

    Incluez des fichiers JAR client, tels que adobe-reader-extensions-client.jar, dans le chemin de classe de votre projet Java.

  2. Créez un objet Client d’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.

  3. Récupérez un document PDF.

    • Créez un objet java.io.FileInputStream représentant le document PDF dont les droits sont activés à l’aide de son constructeur et transmettez une valeur de chaîne indiquant 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.

  4. Supprimez les droits d’utilisation du document PDF.

    Supprimez les droits d’utilisation du document PDF en appelant la méthode ReaderExtensionsServiceClient de l’objet removeUsageRights 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 com.adobe.idp.Document contenant un document PDF sans droits d’utilisation.

  5. Appliquez des droits d’utilisation au document PDF.

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

Voir également

Suppression des droits d’utilisation des Documents PDF

Début rapide (mode SOAP) : Suppression des droits d’utilisation d’un document PDF à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java AEM Forms

Réglage des propriétés de la connexion

Supprimer les droits d’utilisation à l’aide de l’API de service Web

Supprimez les droits d’utilisation d’un document PDF dont les droits sont activés à l’aide de l’API des extensions Acrobat Reader DC (service Web) :

  1. Incluez des fichiers de projet.

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

    REMARQUE

    Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.

  2. Créez un objet Client d’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. Veillez à spécifier ?blob=mtom.)

    • Créez un objet System.ServiceModel.BasicHttpBinding en obtenant 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 exécutant 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.
      • Affectez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

  3. Récupérez un document PDF.

    • Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker le document PDF dont 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 qui représente l’emplacement du fichier 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é System.IO.FileStream de l’objet Length.
    • Renseignez le tableau d’octets avec les données de flux en appelant la méthode System.IO.FileStream de l’objet Read et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.
    • Renseignez l’objet BLOB en attribuant sa propriété MTOM au contenu du tableau d’octets.

  4. Supprimez les droits d’utilisation du document PDF.

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

  5. Appliquez des 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 qui représente l’emplacement du fichier PDF.
    • Créez un tableau d’octets qui stocke le contenu des données de l’objet BLOB 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.

Voir également

Suppression des droits d’utilisation des Documents PDF

Appel de AEM Forms à l’aide de MTOM

Appel de AEM Forms à l’aide de SwaRef

Récupération des informations d'identification

Vous pouvez récupérer des informations sur les informations d’identification utilisées pour appliquer des droits d’utilisation à un document PDF doté de droits d’utilisation. En récupérant des informations sur les informations d’identification, vous pouvez obtenir des informations telles que la date à laquelle le certificat n’est plus valide.

REMARQUE

Pour plus d’informations sur le service des extensions Acrobat Reader DC, voir Guide de référence des services pour AEM Forms.

Résumé des étapes

Pour récupérer des informations sur les informations d’identification utilisées pour appliquer des droits d’utilisation à un document PDF, procédez comme suit :

  1. Incluez des fichiers de projet.
  2. Créez un objet Client d’extensions Acrobat Reader DC.
  3. Récupérez un document PDF dont les droits sont activés.
  4. Récupérez des informations sur les informations d’identification.

Inclure les fichiers de projet

Incluez les fichiers nécessaires dans votre projet de développement. Si vous créez une application cliente à l’aide de Java, incluez les fichiers JAR nécessaires. Si vous utilisez des services Web, veillez à inclure les fichiers proxy.

Création d’un objet Client d’extensions Acrobat Reader DC

Avant de pouvoir exécuter une opération de service d’extensions Acrobat Reader DC par programmation, vous devez créer un objet client de service d’extensions Acrobat Reader DC. Si vous utilisez l’API Java, créez un objet ReaderExtensionsServiceClient. Si vous utilisez l’API du service Web des extensions Acrobat Reader DC, créez un objet ReaderExtensionsServiceService.

Récupération d’un document PDF dont les droits sont activés

Vous devez récupérer un document PDF dont les droits sont activés afin de récupérer des informations sur les informations d’identification. Vous pouvez également récupérer des informations sur les informations d’identification en spécifiant son alias ; toutefois, si vous souhaitez récupérer des informations sur des informations d’identification qui ont été utilisées pour appliquer des droits d’utilisation à un document PDF dont les droits sont activés, vous devez récupérer le document.

Récupérer des informations sur les informations d’identification

Après avoir récupéré un document PDF doté de droits, vous pouvez obtenir des informations sur les informations d’identification utilisées pour lui appliquer des droits d’utilisation. Vous pouvez obtenir les informations d’identification suivantes :

  • Message affiché dans Adobe Reader à l’ouverture du document PDF dont les droits sont activés.
  • Date à laquelle les informations d’identification ne sont plus valides.
  • Date avant laquelle les informations d’identification ne sont pas valides.
  • Droits d’utilisation définis pour ce document PDF dont les droits sont activés.
  • Nombre d’utilisation des informations d’identification.

Voir également

Suppression des droits d’utilisation à l’aide de l’API Java

Suppression des droits d’utilisation à l’aide de l’API de service Web

Inclusion des fichiers de bibliothèque Java AEM Forms

Réglage des propriétés de la connexion

débuts rapides de l’API du service Acrobat Reader DC Extensions

Récupérer les informations d’identification à l’aide de l’API Java

Récupérez les informations d’identification à l’aide de l’API des extensions Acrobat Reader DC (Java) :

  1. Incluez des fichiers de projet.

    Incluez des fichiers JAR client, tels que adobe-reader-extensions-client.jar, dans le chemin de classe de votre projet Java.

  2. Créez un objet Client d’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.

  3. Récupérez un document PDF.

    • Créez un objet java.io.FileInputStream représentant le document PDF dont les droits sont activés à l’aide de son constructeur et transmettez 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.

  4. 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 ReaderExtensionsServiceClient de l’objet getDocumentUsageRights 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 à laquelle les informations d’identification ne sont plus valides en appelant la méthode GetUsageRightsResult de l’objet getNotAfter. Cette méthode renvoie un objet java.util.Date qui représente la date à laquelle les informations d’identification ne sont plus valides.
    • Récupérez le message qui s’affiche en Adobe Reader lorsque le document PDF dont les droits sont activés est ouvert en appelant la méthode GetUsageRightsResult de l’objet getMessage. Cette méthode renvoie une valeur de chaîne qui représente le message.

Voir également

Récupération des informations d’identification

Début rapide (mode SOAP) : Récupération des informations d’identification à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java AEM Forms

Réglage des propriétés de la connexion

Récupérer les informations d’identification à l’aide de l’API de service Web

Récupérez les informations d’identification à l’aide de l’API des extensions Acrobat Reader DC (service Web) :

  1. Incluez des fichiers de projet.

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

    REMARQUE

    Remplacez localhost par l’adresse IP du serveur hébergeant AEM Forms.

  2. Créez un objet Client d’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. Veillez à spécifier ?blob=mtom.)

    • Créez un objet System.ServiceModel.BasicHttpBinding en obtenant 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 exécutant 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.
      • Affectez la valeur constante HttpClientCredentialType.Basic au champ BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • Affectez la valeur constante BasicHttpSecurityMode.TransportCredentialOnly au champ BasicHttpBindingSecurity.Security.Mode.

  3. Récupérez un document PDF.

    • Créez un objet BLOB en utilisant son constructeur. L’objet BLOB est utilisé pour stocker un document 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é System.IO.FileStream de l’objet Length.
    • Renseignez le tableau d’octets avec les données de flux en appelant la méthode System.IO.FileStream de l’objet Read et en transmettant le tableau d’octets, la position de départ et la longueur du flux à lire.
    • Renseignez l’objet BLOB en attribuant sa propriété MTOM au contenu du tableau d’octets.

  4. 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 ReaderExtensionsServiceClient de l’objet getDocumentUsageRights 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 à laquelle les informations d’identification ne sont plus valides en obtenant la valeur du membre de données GetUsageRightsResult de l’objet notAfter. 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 doté de droits est ouvert dans Adobe Reader en obtenant la valeur du membre de données GetUsageRightsResult de l’objet message. Le type de données de ce membre de données est une chaîne.
    • Récupérez le nombre d’utilisation des informations d’identification en obtenant la valeur du membre de données GetUsageRightsResult de l’objet useCount. Le type de données de ce membre de données est un entier.

Voir également

Récupération des informations d’identification

Appel de AEM Forms à l’aide de MTOM

Appel de AEM Forms à l’aide de SwaRef

Sur cette page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now