Utilisation du modèle de données de formulaire (FDM)

Connectez-vous à l’instance d’auteur Experience Manager, accédez à Forms > Intégrations de données et ouvrez le modèle de données de formulaire (FDM) dans lequel vous souhaitez ajouter des objets de modèle de données.

Dans le volet Sources de données, développez les sources de données pour afficher les objets et services de modèle de données disponibles.

Sélectionnez les objets et services de modèle de données à ajouter au modèle de données de formulaire (FDM) et sélectionnez Ajouter la sélection.

Objets et services de modèle de données sélectionnés

L’onglet Modèle affiche une représentation graphique de tous les objets de modèle de données et de leurs propriétés ajoutés au modèle de données de formulaire (FDM). Chaque objet de modèle de données est représenté par une case dans le modèle de données de formulaire (FDM).

L’onglet Modèle affiche les objets de modèle de données ajoutés

REMARQUE

Vous pouvez appuyer sur des zones d’objet de modèle de données et les faire glisser pour les organiser dans la zone de contenu. Tous les objets de modèle de données ajoutés dans le modèle de données de formulaire (FDM) sont grisés dans le volet Sources de données.

L’onglet Services répertorie les services ajoutés.

L’onglet Services affiche les services de modèle de données

REMARQUE

En plus des objets et services de modèle de données, le document de métadonnées de service OData inclut des propriétés de navigation qui définissent l’association entre deux objets de modèle de données. Pour plus d’informations, voir Utilisation des propriétés de navigation des services OData.

Sélectionnez Enregistrer pour enregistrer l’objet de modèle de formulaire.

REMARQUE

Vous pouvez appeler les services que vous avez configurés dans l’onglet Services d’un modèle de données de formulaire (FDM) à l’aide des règles de formulaire adaptatif. Les services configurés sont disponibles dans l’action Appeler les services de l’éditeur de règles. Pour plus d’informations sur l’utilisation de ces services dans des règles de formulaire adaptatif, voir les règles Appeler des services et Définir la valeur des règles dans l’éditeur de règles.

Connectez-vous à l’instance d’auteur Experience Manager, accédez à Forms > Intégrations de données et ouvrez le modèle de données de formulaire (FDM) dans lequel vous souhaitez créer un objet ou une entité de modèle de données.

Sélectionnez Créer une entité.

Dans la boîte de dialogue Créer un modèle de données, spécifiez un nom pour l’objet de modèle de données et sélectionnez Ajouter. Un objet de modèle de données est ajouté au modèle de données de formulaire (FDM). L’objet de modèle de données ajouté n’est pas lié à une source de données et n’a aucune propriété comme indiqué dans l’image suivante.

Dans un modèle de données de formulaire, sélectionnez un objet de modèle de données puis Créer une propriété enfant.

Dans la boîte de dialogue Créer une propriété enfant, spécifiez un nom et un type de données pour la propriété dans les champs Nom et Type, respectivement. Vous avez la possibilité d’indiquer un titre et une description pour la propriété.

Activez Calculé si la propriété est une propriété calculée. La valeur d’une propriété calculée est évaluée en fonction d’une règle ou d’une expression. Pour plus d’informations, voir Modifier les propriétés.

Si l’objet de modèle de données est lié à une source de données, la propriété enfant ajoutée est automatiquement liée à la propriété de l’objet de modèle de données parent avec le même nom et le même type de données.

Pour lier manuellement une propriété enfant à une propriété d’objet de modèle de données, sélectionnez l’icône de navigation en regard du champ Référence de liaison. La boîte de dialogue Sélection d’objet répertorie toutes les propriétés de l’objet modèle de données parent. Sélectionnez une propriété puis l’icône en forme de coche. Notez que vous pouvez uniquement sélectionner une propriété du même type de données que la propriété enfant.

Sélectionnez Done (Terminé) pour enregistrer la propriété enfant et Save (Enregistrer) pour enregistrer le modèle de données de formulaire (FDM). La propriété enfant est maintenant ajoutée à l’objet de modèle de données.

Dans le modèle de données de formulaire, sélectionnez la source de données non liée que vous souhaitez lier à une source de données.

Sélectionnez Modifier les propriétés.

Dans le volet Modifier les propriétés, sélectionnez l’icône de navigation en regard du champ Liaison. Elle ouvre la boîte de dialogue Sélectionner l’objet qui répertorie les sources de données ajoutées dans le modèle de données de formulaire (FDM).

Développez l’arborescence des sources de données, sélectionnez un objet de modèle de données à lier puis l’icône en forme de coche.

Sélectionnez Terminé pour enregistrer les propriétés, puis sélectionnez Enregistrer pour enregistrer le modèle de données du formulaire. L’objet de modèle de données est maintenant lié à une source de données. Notez que l’objet de modèle de données n’est plus marqué comme Non lié.

Cochez la case en haut d’un objet de modèle de données pour le sélectionner et sélectionnez Modifier les propriétés.

Modification des propriétés pour configurer les services de lecture et d’écriture pour un objet de modèle de données

La boîte de dialogue Modifier les propriétés s’ouvre.

Boîte de dialogue Modifier les propriétés

REMARQUE

En plus des objets et services de modèle de données, le document de métadonnées de service OData inclut des propriétés de navigation qui définissent l’association entre deux objets de modèle de données. Lorsque vous ajoutez une source de données de service OData à un modèle de données de formulaire (FDM), un service est disponible dans Form Data Model (FDM) pour toutes les propriétés de navigation d’un objet de modèle de données. Vous pouvez utiliser ce service pour lire les propriétés de navigation de l’objet de modèle de données correspondant.

Pour plus d’informations sur l’utilisation du service, voir Utilisation des propriétés de navigation des services OData.

Activez/désactivez Objet de niveau supérieur pour spécifier si l’objet de modèle de données est un objet de modèle de niveau supérieur.

Les objets de modèle de données configurés dans un modèle de données de formulaire (FDM) peuvent être utilisés dans l’onglet Objets de modèle de données de l’explorateur de contenu d’un formulaire adaptatif basé sur le modèle de données de formulaire (FDM). Lorsque vous ajoutez une association entre deux objets de modèle de données, l’objet de modèle de données à associer est imbriqué sous l’objet de modèle de données auquel vous l’associez dans l’onglet Objets de modèle de données. Si le modèle de données imbriqué est un objet de niveau supérieur, il apparaît également séparément dans l’onglet Objets de modèle de données. Par conséquent, vous en voyez deux entrées, l’une à l’intérieur et l’autre à l’extérieur de la hiérarchie imbriquée, ce qui pourrait perturber les auteurs de formulaires. Pour que l’objet de modèle de données associé apparaisse uniquement dans la hiérarchie imbriquée, désactivez la propriété Objet de niveau supérieur.

Sélectionnez les services de lecture et d’écriture pour les objets de modèle de données sélectionnés. Les arguments pour les services apparaissent.

Services de lecture et d’écriture configurés pour la source de données des employés

Sélectionnez pour l’argument de service de lecture afin de lier l’argument à une valeur Attribut du profil utilisateur, Attribut de requête ou Littéral et spécifiez la valeur de liaison.

Sélectionnez Done pour enregistrer l’argument, Done pour enregistrer les propriétés, puis Save pour enregistrer le modèle de données de formulaire (FDM).

Sélectionnez Attribut de requête dans le menu déroulant Liaison à et saisissez le nom de l’attribut dans le champ Valeur de liaison.

Créez une superposition pour head.jsp. Pour créer la superposition, ouvrez CRX DE et copiez le fichier https://<server-name>:<port number>/crx/de/index.jsp#/libs/fd/af/components/page2/afStaticTemplatePage/head.jsp dans https://<server-name>:<port number>/crx/de/index.jsp#/apps/fd/af/components/page2/afStaticTemplatePage/head.jsp

REMARQUE

• Si vous utilisez un modèle statique, superposez le fichier head.jsp à l’adresse suivante :
  /libs/fd/af/components/page2/afStaticTemplatePage/head.jsp
• Si vous utilisez un modèle modifiable, superposez le fichier aftemplatedpage.jsp à l’adresse suivante :
  /libs/fd/af/components/page2/aftemplatedpage/aftemplatedpage.jsp

Définissez paramMap pour l’attribut de requête. Par exemple, incluez le code suivant dans le fichier .jsp du dossier des applications :

<%Map paraMap = new HashMap();
 paraMap.put("<request_attribute>",request.getParameter("<request_attribute>"));
 request.setAttribute("paramMap",paraMap);

Par exemple, utilisez le code ci-suivant pour récupérer la valeur de petid à partir de la source de données :

<%Map paraMap = new HashMap();
paraMap.put("petId",request.getParameter("petId"));
request.setAttribute("paramMap",paraMap);%>

Cochez la case en regard d’un objet de modèle de données, d’une propriété ou d’un service dans le modèle de données de formulaire (FDM).

Sélectionnez Modifier les propriétés. Le volet Modifier les propriétés de l’objet de modèle, de la propriété ou du service sélectionné s’ouvre.

• Objet de modèle de données  : spécifiez les services de lecture et d’écriture et modifiez les arguments.

• Propriété  : spécifiez le type, le sous-type et le format de la propriété. Vous pouvez également spécifier si la propriété sélectionnée est la clé principale de l’objet de modèle de données.

• Service  : spécifiez l’objet de modèle d’entrée, le type de sortie et les arguments du service. Pour un service Get, vous pouvez spécifier s’il doit renvoyer un tableau.

  

Boîte de dialogue Modifier les propriétés pour un service Get

Sélectionnez Done (Terminé) pour enregistrer les propriétés, puis Save (Enregistrer) pour enregistrer le modèle de données de formulaire (FDM).

Créez une nouvelle propriété nommée FullName dont le type de données est Chaîne.

Activez Calculé et sélectionnez Terminé pour créer la propriété.

La propriété calculée FullName est créée. Identifiez l’icône en regard de la propriété comme illustration d’une propriété calculée.

Sélectionnez la propriété FullName puis Modifier la règle. Une fenêtre Éditeur de règles s’ouvre.

Dans la fenêtre Éditeur de règles, sélectionnez Créer. Une fenêtre de règles Définir la valeur s’ouvre.

Dans la liste déroulante Sélectionner une option, sélectionnez Expression mathématique. Les autres options disponibles sont Objet de modèle de données de formulaire et Chaîne.

Dans l’expression mathématique, sélectionnez FirstName et LastName dans les premier et second objets, respectivement. Sélectionnez plus en tant qu’opérateur.

Sélectionnez Terminé, puis Fermer pour fermer la fenêtre de l’éditeur de règles. La règle se présente comme suit :

Sur le modèle de données de formulaire (FDM), sélectionnez Enregistrer. La propriété calculée est configurée.

Ouvrez un modèle de données de formulaire (FDM) et sélectionnez Modifier les exemples de données. Cela génère et affiche les exemples de données dans la fenêtre Modifier les exemples de données.

Dans la fenêtre Modifier les données d’exemple, modifiez les données, si nécessaire, et sélectionnez Enregistrer.

Sélectionnez un objet ou un service de modèle de données dans le modèle de données de formulaire (FDM) et sélectionnez respectivement Objet de modèle de test ou Service de test.

La fenêtre Tester le modèle de données de formulaire s’ouvre.

Dans la fenêtre Tester le modèle de données de formulaire, sélectionnez l’objet ou le service de modèle de données à tester dans le volet de saisie.

Indiquez une valeur d’argument dans le code de test et sélectionnez Tester. Un test réussi renvoie la sortie dans le volet Sortie.