Utilisation d’un modèle de données de formulaire work-with-form-data-model

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.

L’intégration de données fournit un éditeur de modèle de données de formulaire pour configurer et utiliser des modèles de données de formulaire.

L’éditeur de modèle de données de formulaire fournit une interface utilisateur intuitive et des outils d’édition et de configuration d’un modèle de données de formulaire. L’éditeur vous permet d’ajouter et de configurer des objets, des propriétés et des services de modèle de données à partir des sources de données disponibles dans le modèle de données de formulaire. En outre, il vous permet de créer des objets et des propriétés de modèle de données sans sources de données et de les lier ultérieurement aux objets et propriétés de modèle de données respectifs. Vous pouvez également générer et modifier des exemples de données pour les propriétés d’objet de modèle de données que vous pouvez utiliser pour préremplir des formulaires adaptatifs et des communications interactives lors de la prévisualisation. Vous pouvez tester les objets et services de modèle de données configurés dans un modèle de données de formulaire pour vous assurer qu’ils sont correctement intégrés aux sources de données.

Si vous êtes novice en intégration de données Forms et n’avez pas configuré de source de données ou créé de modèle de données de formulaire, consultez les rubriques suivantes :

Lisez la suite pour plus de détails sur les diverses tâches et configurations que vous pouvez effectuer à l’aide de l’éditeur de modèle de données de formulaire.

NOTE
Vous devez être membre des deux groupes fdm-author et forms-user pour pouvoir créer et utiliser le modèle de données de formulaire. Contactez votre administrateur AEM pour devenir membre des groupes.

Ajout d’objets et de services de modèle de données add-data-model-objects-and-services

Une fois que vous avez créé un modèle de données de formulaire et ajouté des sources de données, vous pouvez utiliser l’éditeur de modèles de données pour ajouter des objets et des services de modèle de données, configurer leurs propriétés, créer des associations entre objets de modèle de données et tester le modèle et les services de données de formulaire.

Vous pouvez ajouter des objets et des services de modèle de données à partir des sources de données disponibles dans le modèle de données de formulaire. Tandis que les objets de modèle de données ajoutés apparaissent dans l’onglet Modèle, les services ajoutés apparaissent dans l’onglet Services.

Pour ajouter des objets et services de modèle de données :

  1. Connectez-vous à l’instance d’auteur AEM, accédez à Formulaires > Intégrations de données et ouvrez le modèle de données du formulaire dans lequel vous souhaitez ajouter des objets de modèle de données.

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

  3. Sélectionnez les objets et services de modèle de données que vous souhaitez ajouter au modèle de données de formulaire, puis appuyez sur Ajouter la sélection.

    selected-objects

    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ées au modèle de données de formulaire. Chaque objet de modèle de données est représenté par une boîte dans le modèle de données de formulaire.

    model-tab

    note note
    NOTE
    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 sont grisés dans le volet Sources de données.

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

    services-tab

    note note
    NOTE
    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.
  4. Appuyer Enregistrer pour enregistrer l’objet de modèle de formulaire.

    note note
    NOTE
    Vous pouvez appeler les services que vous avez configurés dans l’onglet Services d’un modèle de données de formulaire à 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 les règles de formulaire adaptatif, voir Appeler des services et Définir la valeur de règles dans éditeur de règles.

Création des objets de modèle de données et des propriétés enfant create-data-model-objects-and-child-properties

Création des objets de modèle de données create-data-model-objects

Bien que vous puissiez ajouter des objets de modèle de données provenant de sources de données configurées, vous pouvez également créer des objets ou des entités de modèle de données sans sources de données. Cela s’avère particulièrement utile si vous n’avez pas configuré de sources de données dans le modèle de données de formulaire.

Pour créer un objet de modèle de données sans sources de données :

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

  2. Appuyez sur Créer une entité.

  3. Dans la boîte de dialogue Créer un modèle de données de formulaire, spécifiez un nom pour l’objet de modèle de données de formulaire et appuyez sur Ajouter. Un objet de modèle de données est ajouté au modèle de données de formulaire. Notez que 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.

    new-entity

Vous pouvez ensuite ajouter des propriétés enfants dans les objets de modèle de données non liés.

Ajout des propriétés enfant child-properties

L’éditeur de modèle de données de formulaire vous permet de créer des propriétés enfants dans un objet de modèle de données. Une fois créée, la propriété n’est liée à aucune propriété d’une source de données. Vous pouvez ensuite lier la propriété enfant à une autre propriété dans l’objet de modèle de données conteneur.

Pour créer une propriété enfant :

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

  2. Dans le Créer une propriété enfant spécifiez un nom et un type de données pour la propriété dans la boîte de dialogue Nom et Type , respectivement. Vous pouvez éventuellement spécifier un titre et une description pour la propriété.

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

  4. 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 portant 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, appuyez sur l’icône Parcourir en regard de la propriété Référence de liaison champ . 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é à lier et appuyez sur l’icône de coche. Notez que vous ne pouvez sélectionner qu’une propriété du même type de données que la propriété enfant.

  5. Appuyez sur Terminé pour enregistrer la propriété enfant puis sur Enregistrer pour enregistrer le modèle de données de formulaire. La propriété enfant est maintenant ajoutée à l’objet de modèle de données.

Après avoir créé des objets et des propriétés de modèle de données, vous pouvez continuer à créer des formulaires adaptatifs et des communications interactives basés sur le modèle de données de formulaire. Par la suite, lorsque des sources de données sont disponibles et configurées, vous pouvez lier le modèle de données de formulaire aux sources de données. La liaison sera automatiquement mise à jour dans les formulaires adaptatifs et les communications interactives associés. Pour plus d’informations sur la création de formulaires adaptatifs et de communications interactives à l’aide du modèle de données de formulaire, consultez la section Utiliser le modèle de données de formulaire.

Liaison des objets et des propriétés de modèle de données bind-data-model-objects-and-properties

Lorsque les sources de données que vous souhaitez intégrer au modèle de données de formulaire sont disponibles, vous pouvez les ajouter au modèle de données de formulaire, comme indiqué dans la section Mettre à jour les sources de données. Ensuite, procédez comme suit pour lier les objets et propriétés de modèle de données non liés :

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

  2. Appuyez sur Modifier les propriétés.

  3. Dans le Modifier les propriétés Appuyez sur l’icône de navigation en regard du volet Liaison champ . Elle ouvre la fenêtre Sélectionner un objet qui répertorie les sources de données ajoutées dans le modèle de données de formulaire.

    select-object

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

  5. Appuyer Terminé pour enregistrer les propriétés, puis appuyez sur Enregistrer pour enregistrer le modèle de données de formulaire. L’objet de modèle de données est désormais lié à une source de données. Notez que l’objet de modèle de données n’est plus marqué comme Non lié.

    bound-model-object

Configuration des services configure-services

Pour lire et écrire des données pour un objet de modèle de données, procédez comme suit pour configurer les services de lecture et d’écriture :

  1. Cochez la case en haut d’un objet de modèle de données pour le sélectionner, puis appuyez sur Modifier les propriétés.

    edit-properties

    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.

    edit-properties-2

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

    note note
    NOTE
    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, un service est disponible dans le modèle de données de formulaire 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.
  2. Basculer 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 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. 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 verrez deux entrées, l’une à l’intérieur et l’autre à l’extérieur de la hiérarchie imbriquée, ce qui peut dérouter 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.

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

    read-write-services

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

  4. Appuyez sur  aem_6_3_edit 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. Elle lie l’argument de service à la valeur d’attribut de liaison ou littérale spécifiée, qui est transmise au service en tant qu’argument pour extraire les détails associés à la valeur spécifiée de la source de données.

    Dans cet exemple, la variable id prend la valeur de la variable empid du profil utilisateur et transmettez-le en tant qu’argument au service de lecture. Elle lit et renvoie les valeurs des propriétés associées à partir de la propriété employee objet de modèle de données pour l’objet spécifié empid. Ainsi, si vous spécifiez 00250 dans la variable empid dans le formulaire, le service de lecture lit les détails de l’employé avec l’ID d’employé 00250.

    En outre, vous pouvez rendre un argument obligatoire ou facultatif.

    edit-argument

    Liaison de l’argument id à l’attribut empid du profil utilisateur AEM

  5. Appuyez sur Terminé pour enregistrer l’argument, Terminé pour enregistrer les propriétés, puis sur Enregistrer pour enregistrer le modèle de données de formulaire.

Ajout des associations add-associations

En règle générale, il existe des associations entre des objets de modèle de données dans une source de données. L’association peut être un-à-un ou un-à-plusieurs. Par exemple, plusieurs personnes à charge peuvent être associées à un employé. Il s’agit d’une association d’un objet à plusieurs objets, désignée par 1:n sur la ligne reliant les objets de modèle de données associés. Toutefois, si une association renvoie un nom d’employé unique pour un ID d’employé donné, elle est appelée association un-à-un.

Lorsque vous ajoutez des objets de modèle de données associés d’une source de données à un modèle de données de formulaire, leurs associations sont conservées et affichées comme étant liées par des lignes fléchées. Vous pouvez ajouter des associations entre des objets de modèle de données sur des sources de données disparates dans un modèle de données de formulaire.

NOTE
Les associations prédéfinies dans une source de données JDBC ne sont pas conservées dans le modèle de données de formulaire. Vous devez les créer manuellement.

Pour ajouter une association :

  1. Cochez la case en haut d’un objet de modèle de données pour le sélectionner, puis appuyez sur Ajouter une association. La boîte de dialogue Ajouter une association s’ouvre.

    ajouter-association

    note note
    NOTE
    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. Vous pouvez utiliser ces propriétés de navigation lors de l’ajout d’associations dans le modèle de données de formulaire. Pour plus d’informations, voir Utilisation des propriétés de navigation des services OData.

    La boîte de dialogue Ajouter une association s’ouvre.

    add-association-2

    Boîte de dialogue Ajouter une association

  2. Dans le volet Ajouter une association :

    • Indiquez un titre pour l’association.
    • Sélectionnez le type d’association : un à un ou un à plusieurs.
    • Sélectionnez l’objet de modèle de données à associer.
    • Sélectionnez le service de lecture pour lire les données de l’objet de modèle sélectionné. L’argument de service de lecture s’affiche. Modifiez l’argument si nécessaire et liez-le à la propriété de l’objet de modèle de données à associer.

    Dans l’exemple suivant, l’argument par défaut pour le service de lecture de l’objet de modèle de données Personnes à charge est dependentid.

    add-association-example

    L’argument par défaut pour le service de lecture Personnes à charge est dependentid

    Toutefois, l’argument doit être une propriété commune entre l’objet de modèle de données associé, qui est Employeeid dans cet exemple. Par conséquent, l’argument Employeeid doit être lié à la propriété id de l’objet de modèle de données Employé pour extraire les détails des personnes à charge associés de l’objet de modèle de données Personnes à charge.

    add-association-example-2

    Argument et liaison mis à jour

    Appuyer Terminé pour enregistrer l’argument .

  3. Appuyer Terminé pour enregistrer l’association, puis Enregistrer pour enregistrer le modèle de données de formulaire.

  4. Répétez les étapes pour créer d’autres associations selon les besoins.

NOTE
L’association ajoutée apparaît dans la zone d’objet de modèle de données avec le titre spécifié et une ligne reliant les objets de modèle de données associés.
Vous pouvez modifier une association en cochant la case correspondante et en appuyant sur  Modifier l’association.

added-association

Modification des propriétés properties

Vous pouvez modifier les propriétés des objets de modèle de données, leurs propriétés et les services ajoutés dans le modèle de données de formulaire.

Pour modifier les propriétés :

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

  2. Appuyez sur Modifier les propriétés. Le Modifier les propriétés Le volet correspondant à l’objet de modèle, la propriété ou le 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 .

    edit-properties-service

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

  3. Appuyer Terminé pour enregistrer les propriétés, puis Enregistrer pour enregistrer le modèle de données de formulaire.

Création des propriétés calculées computed

Une propriété calculée est celle dont la valeur est calculée sur la base d’une règle ou d’une expression. À l’aide d’une règle, vous pouvez définir la valeur d’une propriété calculée sur une chaîne littérale, un nombre, le résultat d’une expression mathématique ou la valeur d’une autre propriété dans le modèle de données de formulaire.

Par exemple, vous pouvez créer une propriété calculée. FullName dont la valeur est le résultat d’une concaténation de la variable FirstName et LastName propriétés. Pour ce faire :

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

  2. Activez Calculé et appuyez sur Terminé pour créer la propriété.

    calculé

    La propriété calculée FullName est créée. Notez l’icône en regard de la propriété pour représenter une propriété calculée.

    prop-calculée

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

  4. Dans la fenêtre Éditeur de règles, cliquez sur Créer. A 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.

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

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

    règle

  6. Sur le modèle de données de formulaire, appuyez sur Enregistrer. La propriété calculée est configurée.

Utilisation des propriétés de navigation des services OData work-with-navigation-properties-of-odata-services

Dans les services OData, les propriétés de navigation sont utilisées pour définir des associations entre deux objets de modèle de données. Ces propriétés sont définies sur un type d’entité ou un type complexe. Par exemple, dans l’extrait suivant du fichier de métadonnées des exemples de services OData TripPin, l’entité de personne contient trois propriétés de navigation : Friends, BestFriend et Trips.

Pour plus d’informations sur les propriétés de navigation, voir Documentation OData.

<edmx:Edmx xmlns:edmx="https://docs.oasis-open.org/odata/ns/edmx" Version="4.0">
<script/>
<edmx:DataServices>
<Schema xmlns="https://docs.oasis-open.org/odata/ns/edm" Namespace="Microsoft.OData.Service.Sample.TrippinInMemory.Models">
<EntityType Name="Person">
<Key>
<PropertyRef Name="UserName"/>
</Key>
<Property Name="UserName" Type="Edm.String" Nullable="false"/>
<Property Name="FirstName" Type="Edm.String" Nullable="false"/>
<Property Name="LastName" Type="Edm.String"/>
<Property Name="MiddleName" Type="Edm.String"/>
<Property Name="Gender" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.PersonGender" Nullable="false"/>
<Property Name="Age" Type="Edm.Int64"/>
<Property Name="Emails" Type="Collection(Edm.String)"/>
<Property Name="AddressInfo" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location)"/>
<Property Name="HomeAddress" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location"/>
<Property Name="FavoriteFeature" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature" Nullable="false"/>
<Property Name="Features" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature)" Nullable="false"/>
<NavigationProperty Name="Friends" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person)"/>
<NavigationProperty Name="BestFriend" Type="Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person"/>
<NavigationProperty Name="Trips" Type="Collection(Microsoft.OData.Service.Sample.TrippinInMemory.Models.Trip)"/>
</EntityType>

Lorsque vous configurez un service OData dans un modèle de données de formulaire, toutes les propriétés de navigation d’un conteneur d’entités sont mises à disposition via un service dans le modèle de données de formulaire. Dans cet exemple de service ODP TripPin, les trois propriétés de navigation du conteneur d’entité Person peuvent être lues à l’aide d’un service GET LINK dans le modèle de données de formulaire.

Les éléments suivants mettent en évidence le service GET LINK of Person /People dans le modèle de données de formulaire, qui est un service combiné pour les trois propriétés de navigation dans l’entité Person du service TripPin OData.

nav-prop-service

Une fois que vous avez ajouté le service GET LINK à l’onglet Modèle de données de formulaire, vous pouvez modifier les propriétés pour choisir l’objet de modèle de sortie et la propriété de navigation à utiliser dans le service. Par exemple, le service GET LINK of Person /People dans l’exemple suivant utilise Trip comme objet de modèle de sortie et la propriété de navigation Trips.

edit-prop-nav-prop

NOTE
Les valeurs disponibles dans le champ Valeur par défaut de l’argument NavigationPropertyName dépendent de l’état du bouton bascule Revenir au tableau ?Bouton bascule. Lorsqu’elle est activée, elle affiche les propriétés de navigation du type Collection.

Dans cet exemple, vous pouvez également choisir l’objet de modèle de sortie Person et l’argument de propriété de navigation Friends ou BestFriend (selon que Revenir au tableau ? est activé ou désactivé).

edit-prop-nav-prop2

De même, vous pouvez choisir un service GET LINK et configurer ses propriétés de navigation lors de l’ajout d’associations dans le modèle de données de formulaire. Toutefois, pour pouvoir sélectionner une propriété de navigation, assurez-vous que le champ Liaison à est défini sur Littéral.

add-association-nav-prop

Génération et modification des exemples de données sample

L’éditeur de modèle de données de formulaire vous permet de générer des données d’exemple pour toutes les propriétés d’objet de modèle de données, y compris les propriétés calculées, dans un modèle de données de formulaire. Il s’agit d’un ensemble de valeurs aléatoires conformes au type de données configuré pour chaque propriété. Vous pouvez également modifier et enregistrer des données, qui sont conservées même si vous régénérez les données d’exemple.

Pour générer et modifier des exemples de données, procédez comme suit :

  1. Ouvrez un modèle de données de formulaire et appuyez sur Modifier des 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.

    sample-data

  2. Dans la fenêtre Modifier les exemples de données, modifiez les données selon les besoins puis appuyez sur Enregistrer.

Vous pouvez ensuite utiliser les exemples de données pour préremplir et tester les communications interactives en fonction du modèle de données de formulaire. Pour plus d’informations, reportez-vous à la section Utilisation d’un modèle de données de formulaire.

Test des objets et des services de modèle de données test-data-model-objects-and-services

Votre modèle de données de formulaire est configuré, mais avant de le mettre en service, vous pouvez vouloir tester si les objets et services de modèle de données configurés fonctionnent comme prévu. Pour tester les objets et les services de modèle de données :

  1. Sélectionnez un objet ou un service de modèle de données dans le modèle de données de formulaire et appuyez sur Objet de modèle de test ou Service de test, respectivement.

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

    test-data-model

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

  3. Spécifiez une valeur d’argument dans le code de test et appuyez sur Test. Un test réussi renvoie la sortie dans le volet Output (Sortie).

    test-data-model-2

De même, vous pouvez tester d’autres objets et services de modèle de données dans le modèle de données de formulaire.

Étapes suivantes next-steps

Vous disposez d’un modèle de données de formulaire de travail prêt à être utilisé dans les formulaires adaptatifs et les processus de communication interactive. Pour plus d’informations, reportez-vous à la section Utilisation d’un modèle de données de formulaire.

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