Modifiez l'exemple Configuration des champs de formulaire dynamiques pour créer une configuration de champs de formulaire dynamiques (DFF) personnalisée.

Introduction : janvier 2025

Définissez les affichages, les groupes et les champs que vous souhaitez créer. Les affichages apparaissent sous forme d'onglets supplémentaires dans le volet de configuration. Vous pouvez regrouper des champs en groupes pour les organiser de manière logique.
Avant de commencer, lancez la configuration de vos DFF.
  1. Ouvrez votre fichier de configuration de DFF. 
    ...
            "views": [
                {
                    "key": "View_Example",
                    "order": "10",
                    "displayText": "View Example",
                    "helpText": "",
...
  2. Pour spécifier le nom de votre onglet personnalisé, modifiez la clé displayText.
  3. Spécifiez l'ordre dans lequel l'onglet apparaît. NI recommande les valeurs d'ordre suivantes.
    • Assignez votre premier onglet personnalisé à l'ordre "10".
    • Augmentez les onglets suivants par incréments de 10. Par exemple, "20" et "30".
    Les incréments de10 vous permettent de réorganiser facilement des onglets ou d'en insérer de nouveaux entre des onglets existants.
  4. Facultatif : Modifiez la clé i18n pour pouvoir fournir une version localisée de l'onglet que vous ajoutez. 
    ...
                    "i18n": [
                        {
                            "localeId": "de",
                            "displayText": "View Beispiel",
                            "helpText": ""
                        }
...
    1. Spécifiez la valeur localeId. Utilisez l'une des valeurs prises en charge suivantes.
      • "fr" pour le français
      • "de" pour l'allemand
      • "en" pour l'anglais
      • "ja" pour le japonais
      • "zh" pour le chinois simplifié
    2. Mettez à jour displayText avec le texte localisé.
    Par défaut, SystemLink Enterprise affiche la valeur de displayText que vous avez définie dans la clé views. SystemLink Enterprise affiche la valeur localisée pour displayText lorsque les conditions suivantes sont remplies.
    • displayText est défini dans la clé i18n.
    • Vous avez défini la langue de votre navigateur sur l'une des langues localisées prises en charge.
  5. Facultatif : Listez les valeurs de clé des groupes que vous prévoyez d'utiliser pour organiser vos champs sur l'interface utilisateur. Ces groupes sont définis ultérieurement dans le fichier de configuration. 
    ...
                    "groups": [
                        "Group_1_Example",
                        "Group_2_Example"
                    ]
...
    1. Spécifiez les champs du groupe.
  6. Définissez les groupes que vous prévoyez d'utiliser pour organiser vos champs sur l'interface utilisateur. 
    ...
"groups": [
        {
            "workspace": "f58beba8-66de-4ba5-89f4-3388fd814f2e",
            "key": "Group_1_Example",
            "displayText": "Group 1 Example",
            "helpText": "",
...
    1. Listez les valeurs de clé des champs du groupe. Ces champs sont définis ultérieurement dans le fichier de configuration. 
      ...
            "editable": false,
            "fields": [
                "Text_Field_Example",
                "Checkbox_Field_Example",
                "Number_Field_Example",
                "Enum_Field_Example"
            ]
...
  7. Définissez les champs que vous voulez ajouter. L'exemple de fichier de configuration comprend un champ de chaque type.
    • "TEXT"
    • "BOOLEAN"
    • "NUMBER"
    • "ENUM" 
    ...
    "fields": [
        {
            "workspace": "f58beba8-66de-4ba5-89f4-3388fd814f2e",
            "key": "Text_Field_Example",
            "type": "TEXT",
            "displayText": "Text Field Example",
            "helpText": "Help Text",
...
    1. Facultatif : Supprimez les champs que vous ne souhaitez pas ajouter.
    2. Facultatif : Dupliquez les champs pour lesquels vous souhaitez d'autres occurrences. Créez une valeur de clé unique pour tout champ dupliqué.
    3. Mettez à jour le texte affiché.
    4. Facultatif : Ajoutez une clé i18n pour pouvoir fournir une version localisée de chaque champ que vous ajoutez.
  8. Ajoutez des exigences et des paramètres de validation sur le terrain. 
    ...
                }
            ],
            "editable": true,
            "mandatory": false,
            "defaultValue": null,
            "validation": {
                "minValue": 0,
                "maxValue": 10
            }
...
  9. Enregistrez votre fichier de configuration mis à jour.
  10. Copiez le contenu du fichier de configuration et utilisez l'API DFF pour mettre à jour votre configuration initiale. 
    post_nidynamicformfields_v1_update-configurations
  11. Ouvrez SystemLink Enterprise.
  12. Accédez à la ressource que vous avez spécifiée dans le fichier de configuration pour voir vos champs de formulaire dynamiques.