Nouveau service de rendu et d’envoi new-render-and-submit-service

CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

Présentation introduction

Dans Workbench, lorsque vous définissez une opération AssignTask, spécifiez un formulaire particulier (XDP ou PDF). Spécifiez également un ensemble de services de rendu et d’envoi, via un profil d’action.

Un XDP peut être rendu sous la forme d’un formulaire PDF ou d’un formulaire HTML. Les nouvelles fonctionnalités incluent la possibilité de :

  • Rendu et envoi d’un formulaire XDP en tant que HTML
  • Rendu et envoi d’un formulaire XDP en tant que PDF sur le bureau et en tant que HTML sur les appareils mobiles (par exemple, un iPad)

Nouveau service Forms HTML new-html-forms-service

Le nouveau service de formulaires HTML exploite la nouvelle fonction dans les formulaires pour prendre en charge le rendu de formulaire XDP au format HTML. Le nouveau service Forms HTML expose les méthodes suivantes :

/*
 * Generates a URL (for the HTML Form) to be passed to client, given a TaskContext.
 * The output of this API is something like this - /lc/content/xfaforms/profiles/default.ws.html?ContentRoot=repository://Applications/MyApplication/MyFolder&template=MyForm.xdp
 * @param taskContext task context
 * @param profileName Forms servlet URL.
 * @return form URL string
 */
public String generateFormURL(TaskContext taskContext, String profileName);

/*
 * Render the XDP Form as HTML. Can be used directly for updating the runtimeMap in render.
 * It adds the following keys to the map -
 * hint:new html form = true
 * newHTMLFormURL = the URL returned after calling 'generateFormURL' API.
 * @param TaskContext taskContext
 * @param profileName Forms servlet URL.
 * @param runtimeMap runtime map<string,object> associated with form rendering.
 * return runtimeMap
 */
public Map<String, Object> renderHTMLForm (TaskContext taskContext, String profileName, Map<String,Object> runtimeMap);

Pour plus d’informations sur les profils de formulaire mobile, voir Création d’un profil personnalisé.

Nouveaux processus de rendu et d’envoi de formulaire de HTML new-html-form-render-amp-submit-processes

Pour chaque opération « AssignTask », spécifiez un processus de rendu et d’envoi avec le formulaire. Ces processus sont appelés par les API TaskManager renderForm et submitForm pour autoriser la gestion personnalisée. Sémantique de ces processus pour le nouveau formulaire de HTML :

Rendu d’un nouveau formulaire de HTML render-a-new-html-form

Le nouveau processus de rendu de HTML, comme chaque processus de rendu, comporte les paramètres d’E/S suivants :

Entrée - taskContext

Sortie - runtimeMap

Sortie - outFormDoc

Cette méthode simule le comportement exact de l’API renderHTMLForm du NewHTMLFormsService. Elle appelle l’API generateFormURL pour obtenir l’URL pour le rendu HTML du formulaire. Il renseigne ensuite la variable runtimeMap avec les clés ou valeurs suivantes :

nouveau formulaire html = true

newHTMLFormURL = l’URL renvoyé après avoir appelé l’API generateFormURL.

Envoyer un nouveau HTML submit-a-new-html-form

Ce processus d’envoi d’un nouveau formulaire de HTML fonctionne avec les paramètres d’E/S suivants :

Entrée - taskContext

Sortie - runtimeMap

Sortie - outputDocument

Le processus définit le outputDocument sur le inputDocument récupéré de taskContext.

Processus de rendu ou d’envoi par défaut et profils d’action default-render-or-submit-processes-and-action-profiles

Les services de rendu et d’envoi par défaut permettent la prise en charge du rendu des PDF sur un bureau et du HTML sur les périphériques mobiles (iPad).

Formulaire de rendu par défaut default-render-form

Ce processus rend un formulaire XDP sur plusieurs plates-formes en toute simplicité. Le processus récupère l’agent utilisateur de taskContext, et utilise les données pour appeler le processus pour le rendu HTML ou PDF.

default-render-form

Formulaire d’envoi par défaut default-submit-form

Ce processus envoie un formulaire XDP sur plusieurs plates-formes en toute simplicité. Il récupère l’agent utilisateur de taskContext et utilise les données pour appeler le processus pour l’envoi HTML ou PDF.

default-submit-form

Basculer le rendu des formulaires mobiles du PDF vers le HTML switch-the-rendering-of-mobile-forms-from-pdf-to-html

Les navigateurs retirent progressivement la prise en charge des modules externes basés sur NPAPI, y compris les modules externes pour Adobe Acrobat et Adobe Acrobat Reader. Vous pouvez modifier le rendu des formulaires mobiles du PDF au HTML en procédant comme suit :

  1. Connectez-vous à Workbench en tant qu’utilisateur valide.

  2. Sélectionnez Fichier > Obtenir les applications.

    La boîte de dialogue Obtenir les applications s’affiche.

  3. Choisissez les applications pour lesquelles vous voulez changer le rendu de formulaire mobile, puis cliquez sur OK.

  4. Ouvrez le processus pour lequel vous souhaitez modifier le rendu.

  5. Ouvrez le point de départ/la tâche ciblé(e), accédez à la section Présentation et Données, puis cliquez sur Gérer les profils d’action.

    La boîte de dialogue Gérer les profils d’action apparaît.

  6. Redéfinissez les configurations de profil de rendu par défaut de PDF à HTML, puis cliquez sur OK.

  7. Enregistrez le processus.

  8. Répétez les étapes afin de changer le rendu pour d’autres processus.

  9. Déployez l’application adaptée aux processus que vous avez modifiés.

Profil d’action par défaut default-action-profile

Le profil d’action par défaut a rendu le formulaire XDP au format PDF. Ce comportement a maintenant été modifié pour utiliser les processus Default Render Form et Default Submit Form.

Voici quelques questions fréquentes sur les profils d’action :

gen_question_b_20 Quels processus de rendu / d’envoi seront disponibles prêt à l’emploi ?

  • Render Guide (Guides est obsolète)
  • Render Form Guide
  • Render PDF form
  • Formulaire de HTML de rendu
  • Rendre le nouveau formulaire de HTML (nouveau)
  • Formulaire de rendu par défaut (nouveau)

Et des processus d’envoi équivalents.

gen_question_b_20 Quels profils d’action seront disponibles prêt à l’emploi ?

Pour XDP Forms :

  • Par défaut (rendu/envoi à l’aide des nouveaux processus "Default Render/Submit")

gen_question_b_20 Que doit faire le concepteur du processus pour que le formulaire puisse être rendu au format HTML sur un périphérique et au format PDF sur un bureau ?

Rien. Le profil d’action par défaut est automatiquement sélectionné et le mode de rendu est automatiquement pris en charge.

gen_question_b_20 Que faire pour que le formulaire puisse être rendu au format HTML sur un bureau ?

L’utilisateur doit sélectionner le bouton radio HTML pour le profil par défaut.

gen_question_b_20 Y aura-t-il un impact de mise à niveau en cas de changement du comportement du profil d’action par défaut ?

Oui ; étant donné que le rendu précédent et les services d’envoi associés au profil d’action par défaut étaient différents, ils sont gérés en tant que personnalisations des formulaires existants. En cliquant sur Restaurer les paramètres par défaut, les services de rendu / d’envoi par défaut sont définis.

Si vous aviez modifié les services liés aux formulaires PDF de rendu/d’envoi existants ou aviez créé des services personnalisés (par exemple, custom1) et souhaitez maintenant utiliser la même fonctionnalité pour un rendu HTML : Vous devez répliquer le nouveau service de rendu/d’envoi (par exemple, en tant que custom2) et appliquer des personnalisations identiques. Maintenant, modifiez le profil d’action pour que votre XDP commence à utiliser les services custom2, au lieu de custom1 pour le rendu ou l’envoi.

Que doit faire le concepteur de processus pour que le formulaire puisse être rendu au format HTML sur un périphérique et au format PDF sur un bureau ?
Que doit faire le concepteur de processus pour que le formulaire puisse être rendu au format HTML sur un périphérique et au format PDF sur un bureau ?

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da