Le service Forms peut effectuer le rendu des formulaires auxquels des droits d’utilisation sont appliqués. 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 Forms auxquelles des droits d’utilisation sont appliqués sont appelées des formulaires dont les droits sont activés. Un utilisateur qui ouvre un formulaire dont les droits sont activés dans Adobe Reader peut effectuer les opérations activées pour ce formulaire.
Pour appliquer des droits d’utilisation à un formulaire, le service d’extensions Acrobat Reader DC doit faire partie de votre installation d’AEM forms. En outre, vous devez disposer d’informations d’identification valides qui vous permettent d’appliquer des droits d’utilisation aux documents de PDF. En d’autres termes, vous devez configurer correctement le service d’extensions Acrobat Reader DC avant de pouvoir générer un formulaire dont les droits sont activés. (Voir À propos du service des extensions Acrobat Reader DC.)
Pour générer un formulaire contenant des droits d’utilisation, vous devez utiliser un fichier XDP comme entrée, et non un fichier PDF. Si vous utilisez un fichier de PDF comme entrée, le formulaire est toujours rendu ; cependant, il ne s’agira pas d’un formulaire dont les droits sont activés.
Vous ne pouvez pas préremplir un formulaire avec des données XML lorsque vous spécifiez les droits d’utilisation suivants : enableComments
, enableCommentsOnline
, enableEmbeddedFiles
ou enableDigitalSignatures
. (Voir Préremplissage de Forms avec des dispositions souple.)
Pour plus d’informations sur le service Forms, voir Référence des services pour AEM Forms.
Pour effectuer le rendu d’un formulaire dont les droits sont activés, effectuez les tâches suivantes :
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 API client Forms
Avant d’effectuer par programmation une opération d’API client de service Forms, vous devez créer un client de service Forms.
Définition des options d’exécution des droits d’utilisation
Vous devez définir les options d’exécution des droits d’utilisation pour générer un formulaire dont les droits sont activés. Vous devez également spécifier l’alias des informations d’identification utilisées pour appliquer des droits d’utilisation à un formulaire. Après avoir défini la valeur d’alias, vous indiquez chaque droit d’utilisation à appliquer au formulaire.
Rendu d’un formulaire dont les droits sont activés
Pour générer un formulaire dont les droits sont activés, vous utilisez la même logique d’application que pour générer un formulaire sans droits d’utilisation. La seule différence est que vous devez vous assurer que les options d’exécution des droits d’utilisation sont incluses dans la logique de votre application.
Lors du rendu d’un formulaire dont les droits sont activés à l’aide de l’API du service Web Forms, vous ne pouvez pas joindre de fichiers au formulaire.
Écrire le flux de données de formulaire dans le navigateur Web client
Lorsque le service Forms génère un formulaire dont les droits sont activés, il renvoie un flux de données de formulaire que vous devez écrire dans le navigateur Web client. Une fois écrit dans le navigateur Web client, le formulaire est visible par l’utilisateur. Un utilisateur qui consulte le formulaire dont les droits sont activés dans Adobe Reader peut effectuer les opérations qui sont activées pour ce formulaire.
Voir également
Rendu des formulaires activés pour les droits à l’aide de l’API Java
Rendu de formulaires activés pour les droits à 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 Forms Service
Rendu des PDF forms interactifs
Création d’applications web qui renvoient Forms
Rendre un formulaire dont les droits sont activés à l’aide de l’API Forms (Java) :
Inclure les fichiers de projet
Incluez les fichiers JAR client, tels que adobe-forms-client.jar, dans le chemin de classe de votre projet Java.
Création d’un objet API client Forms
ServiceClientFactory
qui contient des propriétés de connexion.FormsServiceClient
en utilisant son constructeur et en transmettant l’objet ServiceClientFactory
.Définition des options d’exécution des droits d’utilisation
ReaderExtensionSpec
en utilisant son constructeur.ReaderExtensionSpec
de setReCredentialAlias
et indiquez une valeur string qui représente la valeur d’alias.ReaderExtensionSpec
. Cependant, vous ne pouvez définir un droit d’utilisation que si les informations d’identification que vous référencez vous permettent de le faire. En d’autres termes, vous ne pouvez pas définir un droit d’utilisation si les informations d’identification ne vous permettent pas de le définir. Par exemple. pour définir le droit d’utilisation qui permet à l’utilisateur de remplir des champs de formulaire et d’enregistrer le formulaire, appelez la méthode ReaderExtensionSpec
de setReFillIn
méthode et transmission true
.Il n’est pas nécessaire d’appeler la variable ReaderExtensionSpec
de setReCredentialPassword
* . Cette méthode n’est pas utilisée par le service Forms. *
Rendu d’un formulaire dont les droits sont activés
Appeler la variable FormsServiceClient
de renderPDFFormWithUsageRights
et transmettez les valeurs suivantes :
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
.com.adobe.idp.Document
contenant les données à fusionner avec le formulaire. Si vous ne souhaitez pas fusionner des données, transmettez un com.adobe.idp.Document
.PDFFormRenderSpec
qui stocke les options d’exécution.ReaderExtensionSpec
qui stocke les options d’exécution des droits d’utilisation.URLSpec
contenant des valeurs URI requises par le service Forms.Le renderPDFFormWithUsageRights
renvoie une FormsResult
contenant un flux de données de formulaire qui doit être écrit dans le navigateur Web client.
Écrire le flux de données de formulaire dans le navigateur Web client
com.adobe.idp.Document
en appelant le FormsResult
object ‘s getOutputContent
.com.adobe.idp.Document
en appelant son objet getContentType
.javax.servlet.http.HttpServletResponse
type de contenu de l’objet en appelant sa propriété setContentType
et transmettre le type de contenu de la méthode com.adobe.idp.Document
.javax.servlet.ServletOutputStream
objet utilisé pour écrire le flux de données de formulaire dans le navigateur Web client en appelant la fonction javax.servlet.http.HttpServletResponse
de getOutputStream
.java.io.InputStream
en appelant le com.adobe.idp.Document
de getInputStream
.InputStream
de read
et transmission du tableau d’octets en tant qu’argument.javax.servlet.ServletOutputStream
de write
pour envoyer le flux de données de formulaire au navigateur web client. Transmettez le tableau d’octets au write
.Voir également
Inclusion des fichiers de bibliothèque Java d’AEM Forms
Réglage des propriétés de la connexion
Rendre un formulaire dont les droits sont activés à l’aide de l’API Forms (service Web) :
Inclure les fichiers de projet
Création d’un objet API client Forms
Créez un FormsService
et définissez les valeurs d’authentification.
Définition des options d’exécution des droits d’utilisation
ReaderExtensionSpec
en utilisant son constructeur.ReaderExtensionSpec
de setReCredentialAlias
et indiquez une valeur string qui représente la valeur d’alias.ReaderExtensionSpec
. Cependant, vous ne pouvez définir un droit d’utilisation que si les informations d’identification que vous référencez vous permettent de le faire. En d’autres termes, vous ne pouvez pas définir un droit d’utilisation si les informations d’identification ne vous permettent pas de le définir. Pour définir le droit d’utilisation qui permet à l’utilisateur de remplir des champs de formulaire et d’enregistrer le formulaire, appelez la méthode ReaderExtensionSpec
de setReFillIn
méthode et transmission true
.Rendu d’un formulaire dont les droits sont activés
Appeler la variable FormsService
de renderPDFFormWithUsageRights
et transmettez les valeurs suivantes :
Applications/FormsApplication/1.0/FormsFolder/Loan.xdp
.BLOB
contenant les données à fusionner avec le formulaire. Si vous ne souhaitez pas fusionner des données avec le formulaire, vous devez transmettre une BLOB
basé sur une source de données XML vide. Vous ne pouvez pas transmettre une BLOB
objet nul ; dans le cas contraire, une exception est générée.PDFFormRenderSpec
qui stocke les options d’exécution.ReaderExtensionSpec
qui stocke les options d’exécution des droits d’utilisation.URLSpec
contenant des valeurs URI requises par le service Forms.Le renderPDFFormWithUsageRights
renvoie une FormsResult
contenant un flux de données de formulaire qui doit être écrit dans le navigateur Web client.
Écrire le flux de données de formulaire dans le navigateur Web client
BLOB
qui contient des données de formulaire en appelant la méthode FormsResult
de getOutputContent
.BLOB
en appelant son objet getContentType
.javax.servlet.http.HttpServletResponse
type de contenu de l’objet en appelant sa propriété setContentType
et transmettre le type de contenu de la méthode BLOB
.javax.servlet.ServletOutputStream
objet utilisé pour écrire le flux de données de formulaire dans le navigateur Web client en appelant la fonction javax.servlet.http.HttpServletResponse
de getOutputStream
.BLOB
de getBinaryData
. Cette tâche affecte le contenu de la FormsResult
vers le tableau d’octets.javax.servlet.http.HttpServletResponse
de write
pour envoyer le flux de données de formulaire au navigateur web client. Transmettez le tableau d’octets au write
.Voir également
Rendu de Forms compatible avec les droits
Appel d’AEM Forms à l’aide du codage Base64