Attribution de droits d’utilisation

Les exemples et les exemples de ce document sont réservés à l’environnement AEM Forms on JEE.

À propos du service des extensions Acrobat Reader DC

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

Vous pouvez accomplir ces tâches à l’aide du service d’extensions Acrobat Reader DC :

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 Acrobat Reader DC Extensions 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

Lors de l’application de 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 de formulaires traités n’est alors pas mis à jour et les performances s’en trouvent améliorées. Si la mise à jour du compteur de formulaires traités 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. Inclure les 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 effectuer par programmation une opération de service d’extension Acrobat Reader DC, vous devez créer un objet client de service Acrobat Reader DC Extensions. 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. Lorsqu’Adobe Reader ouvre un document contenant un tel dictionnaire, il active uniquement les droits d’utilisation spécifiés dans le dictionnaire pour ce document. Si le document ne contient pas de dictionnaire des droits d’utilisation, le service d’extensions Acrobat Reader DC en crée un. S’il contient déjà un dictionnaire, le service d’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écification des droits d’utilisation à appliquer

Les droits d’utilisation que vous pouvez définir sont déterminés par des informations d’identification que vous achetez à Adobe Systems Incorporated. Les informations d’identification permettent généralement de définir un groupe de droits d’utilisation associés, 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 brouillons de documents.

REMARQUE

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

Application de 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 d’AEM Forms). Vous devez également spécifier le document PDF auquel des droits d’utilisation sont appliqués. Pour plus d’informations sur la configuration d’informations d’identification, consultez le guide d’installation et de déploiement de votre serveur d’applications.

Enregistrement du document PDF dont les droits sont activés

Une fois que le service d’extensions Acrobat Reader DC a appliqué 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

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

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

Inclusion des fichiers de bibliothèque Java d’AEM Forms

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

Démarrages rapides de l’API du service d’extensions Acrobat Reader DC

Appliquez des 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 les 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 string 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 appartenant à 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).

  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 d’extensions Acrobat Reader DC. Lors de l’appel de ce constructeur, vous devez spécifier les valeurs suivantes :

      • Objet UsageRights contenant les droits d’utilisation à appliquer au document.
      • Une valeur string qui spécifie un message que voit un utilisateur lorsqu’un document PDF dont les droits sont activés est ouvert dans Adobe Reader 7.x. Ce message ne s’affiche pas 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 des droits d’utilisation sont appliqués.
      • Une valeur string qui spécifie l’alias des informations d’identification qui vous permettent 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 copyToFile de l’objet com.adobe.idp.Document 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émarrage rapide (mode SOAP) : application des droits d’utilisation à l’aide de l’API Java

Inclusion des fichiers de bibliothèque Java d’AEM Forms

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

Appliquez 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. Inclure les 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 à l’aide de son constructeur par défaut.

    • Créez un objet ReaderExtensionsServiceClient.Endpoint.Address à l’aide du constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string 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 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 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.

  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 auquel des droits d’utilisation sont appliqués.
    • Créez un objet System.IO.FileStream en appelant son constructeur et en transmettant une valeur string 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 diffusion 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 attribuant sa propriété MTOM avec le 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 enableFormFillIn de l’objet UsageRights. (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 d’extensions Acrobat Reader DC.

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

    • Attribuez une valeur string qui spécifie le message qu’un utilisateur voit lorsqu’un document PDF dont les droits sont activés 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 des droits d’utilisation sont appliqués.
      • Une valeur string qui spécifie l’alias des informations d’identification qui vous permettent 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 string 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 d’AEM Forms à l’aide de MTOM

Appel d’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. La suppression des droits d’utilisation d’un document PDF dont les droits sont activés est également nécessaire pour effectuer d’autres opérations AEM Forms sur celui-ci. 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 dont les droits sont activés, 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. Inclure les 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 d’effectuer 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, 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 dont les droits sont activés, vous pouvez supprimer les 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.

Enregistrement du 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 visualisé 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 d’AEM Forms

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

Démarrages rapides de l’API du service d’extensions Acrobat Reader DC

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. Inclure les fichiers de projet.

    Incluez les 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 qui représente le document PDF dont les droits sont activés à l’aide de son constructeur et en transmettant une valeur string 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. 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 copyToFile de l’objet Document 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émarrage 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 d’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. Inclure les 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 à l’aide de son constructeur par défaut.

    • Créez un objet ReaderExtensionsServiceClient.Endpoint.Address à l’aide du constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string 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 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 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.

  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 sont activés à 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 string 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 avec le 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 string 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 d’AEM Forms à l’aide de MTOM

Appel d’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 dont les droits sont activés. 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. Inclure les 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 d’effectuer 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, 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

Pour récupérer des informations sur les informations d’identification, vous devez récupérer un document PDF dont les droits sont activés. Vous pouvez également récupérer des informations sur une information 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 spécifique dont les droits sont activés, vous devez récupérer le document.

Récupération d’informations sur les informations d’identification

Après avoir récupéré un document PDF dont les droits sont activés, vous pouvez obtenir des informations sur les informations d’identification qui ont été 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’utilisations 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 d’AEM Forms

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

Démarrages rapides de l’API du service d’extensions Acrobat Reader DC

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. Inclure les fichiers de projet.

    Incluez les 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 qui représente le document PDF dont les droits sont activés en utilisant son constructeur et en transmettant une valeur string 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 les 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 getNotAfter de l’objet GetUsageRightsResult. 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 dans 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 string qui représente le message.

Voir également

Récupération des informations d’identification

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

Inclusion des fichiers de bibliothèque Java d’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. Inclure les 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 à l’aide de son constructeur par défaut.

    • Créez un objet ReaderExtensionsServiceClient.Endpoint.Address à l’aide du constructeur System.ServiceModel.EndpointAddress. Transmettez une valeur string 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 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 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.

  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 string 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 avec le 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 les 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 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.

Voir également

Récupération des informations d’identification

Appel d’AEM Forms à l’aide de MTOM

Appel d’AEM Forms à l’aide de SwaRef

Sur cette page