[Also applies to v8]{class="badge positive" title="Also applies to Campaign v8"}

Modifier des formulaires editing-forms

Vue d’ensemble

Les spécialistes marketing et les opérateurs utilisent des formulaires de saisie pour créer, modifier et prévisualiser des enregistrements. Les formulaires affichent une représentation visuelle des informations.

NOTE
Dans le cadre de la transition de Campaign v7 vers v8, la documentation de Campaign Classic a été rationalisé et réorganisé. Les fonctionnalités communes sont désormais disponibles exclusivement dans le jeu de documentation de Campaign v8. Pour en savoir plus sur les formulaires de saisie, consultez la documentation de Campaign v8.

Image

Vous pouvez créer et modifier des formulaires de saisie :

  • Vous pouvez modifier les formulaires de saisie d’usine fournis par défaut. Les formulaires de saisie d’usine sont basés sur les schémas de données d’usine.
  • Vous pouvez créer des formulaires de saisie personnalisés, en fonction des schémas de données que vous définissez.

Les formulaires sont des entités de type xtk:form. Vous pouvez afficher la structure du formulaire de saisie dans le schéma xtk:form. Pour afficher ce schéma, sélectionnez Administration >  Configuration  > Schémas de données à partir du menu. En savoir plus sur la structure des formulaires (documentation de Campaign v8).

Pour accéder aux formulaires de saisie, sélectionnez Administration > Configuration > Formulaires de saisie à partir du menu :

Pour concevoir des formulaires, modifiez le contenu XML dans l’éditeur XML :

En savoir plus (documentation de Campaign v8).

Pour prévisualiser un formulaire, cliquez sur l’onglet Aperçu :

Types de formulaires

Vous pouvez créer différents types de formulaires de saisie. Le type de formulaire détermine la manière dont les utilisateurs naviguent dans ce dernier :

  • Écran console

    Il s’agit du type de formulaire par défaut. Le formulaire comprend une seule page.

  • Gestion de contenu

    Utilisez ce type de formulaire pour la gestion de contenu. Consultez ce cas d’utilisation.

  • Assistant

    Ce formulaire comprend plusieurs écrans flottants organisés en séquences spécifiques. Les utilisateurs peuvent naviguer d’un écran à l’autre. En savoir plus (documentation de Campaign v8).

  • Iconbox

    Ce formulaire comprend plusieurs pages. Pour parcourir le formulaire, les utilisateurs doivent sélectionner les icônes à sa gauche.

  • Notebook

    Ce formulaire comprend plusieurs pages. Pour parcourir le formulaire, les utilisateurs doivent sélectionner les onglets dans la partie supérieure.

  • Séparation verticale

    Ce formulaire affiche une arborescence de navigation.

  • Séparation horizontale

    Ce formulaire affiche une liste d’éléments.

Références aux images

Pour rechercher des images, sélectionnez Administration >  Configuration  > Images à partir du menu.

Pour associer une image à un élément du formulaire, par exemple une icône, vous pouvez ajouter une référence à une image. Par exemple, utilisez l’attribut img dans l’élément <container>.

Syntaxe : img="namespace:filename.extension"

Cet exemple montre les références aux images book.png et detail.png de l’espace de noms ncm :

<container img="ncm:book.png" label="General">
[…]
</container>
<container img="ncm:detail.png" label="Details">
[…]
</container>

Ces images constituent les icônes sur lesquelles les utilisateurs cliquent pour parcourir un formulaire à plusieurs pages :

Création d’un formulaire simple create-simple-form

Pour créer un formulaire, procédez comme suit :

  1. Dans le menu, sélectionnez Administration >  Configuration  > Formulaires de saisie.

  2. Cliquez sur le bouton Nouveau dans le coin supérieur droit de la liste.

  3. Renseignez les propriétés du formulaire :

    • Renseignez le nom du formulaire et l’espace de noms.

      Le nom du formulaire et l’espace de noms peuvent correspondre au schéma de données associé. Cet exemple montre un formulaire pour le schéma de données cus:order :

      code language-xml
      <form entitySchema="xtk:form" img="xtk:form.png" label="Order" name="order" namespace="cus" type="iconbox" xtkschema="xtk:form">
        […]
      </form>
      

      Vous pouvez également renseigner explicitement le schéma de données dans l’attribut entity-schema.

      code language-xml
      <form entity-schema="cus:stockLine" entitySchema="xtk:form" img="xtk:form.png" label="Stock order" name="stockOrder" namespace="cus" xtkschema="xtk:form">
        […]
      </form>
      
    • Renseignez le libellé à afficher sur le formulaire.

    • Vous pouvez éventuellement renseigner le type de formulaire. Si vous ne renseignez pas de type de formulaire, le type Écran console est utilisé par défaut.

      Si vous concevez un formulaire à plusieurs pages, vous pouvez omettre le type de formulaire dans l’élément <form> et renseigner le type dans un conteneur.

  4. Cliquez sur Enregistrer.

  5. Insérez les éléments de formulaire.

    Par exemple, pour insérer un champ de saisie, utilisez l’élément <input>. Définissez l’attribut xpath sur la référence du champ en tant qu’expression XPath. En savoir plus (documentation de Campaign v8).

    Cet exemple montre des champs de saisie basés sur le schéma nms:recipient.

    code language-xml
    <input xpath="@firstName"/>
    <input xpath="@lastName"/>
    
  6. Si le formulaire est basé sur un type de schéma spécifique, vous pouvez rechercher les champs de ce schéma :

    1. Cliquez sur Insérer > Champs du document.

    2. Sélectionnez le champ et cliquez sur OK.

  7. Vous pouvez éventuellement renseigner l’éditeur de champ.

    Un éditeur de champ par défaut est associé à chaque type de données :

    • Pour un champ de type date, le formulaire affiche un calendrier de saisie.
    • Pour un champ de type énumération, le formulaire affiche une liste de sélection.

    Vous pouvez utiliser les types d’éditeur de champ suivants :

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Éditeur de champ Attribut de formulaire
    Bouton radio type="radiobutton"
    Case à cocher type="checkbox"
    Modifier l’arborescence type="tree"

    En savoir plus sur les contrôles de liste mémoire (documentation de Campaign v8).

  8. Vous pouvez éventuellement définir l’accès aux champs :

    table 0-row-3 1-row-3 2-row-3 3-row-3
    Élément Attribut Description
    <input> read-only="true" Fournit un accès en lecture seule à un champ
    <container> type="visibleGroup" visibleIf="edit-expr" Affiche de manière conditionnelle un groupe de champs
    <container> type="enabledGroup" enabledIf="edit-expr" Active de manière conditionnelle un groupe de champs

    Exemple :

    code language-xml
    <container type="enabledGroup" enabledIf="@gender=1">
      […]
    </container>
    <container type="enabledGroup" enabledIf="@gender=2">
      […]
    </container>
    
  9. Vous pouvez éventuellement utiliser des conteneurs pour regrouper des champs en sections.

    code language-xml
    <container type="frame" label="Name">
       <input xpath="@firstName"/>
       <input xpath="@lastName"/>
    </container>
    <container type="frame" label="Contact details">
       <input xpath="@email"/>
       <input xpath="@phone"/>
    </container>
    

Création d’un formulaire à plusieurs pages create-multipage-form

Vous pouvez créer des formulaires à plusieurs pages. Vous pouvez également imbriquer des formulaires dans d’autres formulaires. En savoir plus sur les ​ conteneurs, notebooks et formulaires iconbox ​ (documentation de Campaign v8).

Modification d’un formulaire de saisie d’usine modify-factory-form

Pour modifier un formulaire d’usine, procédez comme suit :

  1. Modifiez le formulaire de saisie d’usine :

    1. Dans le menu, sélectionnez Administration >  Configuration  > Formulaires de saisie.
    2. Sélectionnez un formulaire de saisie et modifiez-le.

    Vous pouvez étendre les schémas de données d’usine, mais pas les formulaires de saisie d’usine. Nous vous recommandons de modifier directement les formulaires de saisie d’usine sans les recréer. Lors des mises à niveau logicielles, les modifications que vous avez apportées dans les formulaires de saisie d’usine sont fusionnées avec les mises à niveau. Si la fusion automatique échoue, vous pouvez résoudre les conflits. En savoir plus.

    Par exemple, si vous étendez un schéma d’usine avec un champ supplémentaire, vous pouvez ajouter ce champ au formulaire d’usine associé.

Validation des formulaires validate-forms

Vous pouvez inclure des contrôles de validation dans les formulaires.

Vérification des champs obligatoires

Vous pouvez vérifier les informations obligatoires :

  • Utilisez l’attribut required="true" pour les champs obligatoires.
  • Utilisez le nœud <leave> pour vérifier ces champs et afficher les messages d’erreur.

Dans cet exemple, l’adresse e-mail est requise et un message d’erreur s’affiche si l’utilisateur n’a pas fourni ces informations :

<input xpath="@email" required="true"/>
<leave>
  <check expr="@email!=''">
    <error>The email address is required.</error>
  </check>
</leave>

En savoir plus sur les champs d’expression (documentation de Campaign v8) et sur le contexte de formulaire (documentation de Campaign v8).

Validation des valeurs

Vous pouvez utiliser des appels SOAP JavaScript pour valider les données de formulaire à partir de la console. Utilisez ces appels pour une validation complexe, par exemple pour comparer une valeur à une liste de valeurs autorisées. En savoir plus (documentation de Campaign v8).

  1. Créez une fonction de validation dans un fichier JS.

    Exemple :

    code language-js
    function nms_recipient_checkValue(value)
    {
      logInfo("checking value " + value)
      if (…)
      {
        logError("Value " + value + " is not valid")
      }
      return 1
    }
    

    Dans cet exemple, la fonction est nommée checkValue. Cette fonction permet de vérifier le type de données recipient dans l’espace de noms nms. La valeur en cours de vérification est consignée. Si la valeur n’est pas valide, un message d’erreur est consigné. Si la valeur est valide, la valeur 1 est renvoyée.

    Vous pouvez utiliser la valeur renvoyée pour modifier le formulaire.

  2. Dans le formulaire, ajoutez l’élément <soapCall> à l’élément <leave>.

    Dans cet exemple, un appel SOAP est utilisé pour valider la chaîne @valueToCheck :

    code language-xml
    <form name="recipient" (…)>
    (…)
      <leave>
        <soapCall name="checkValue" service="nms:recipient">
          <param exprIn="@valueToCheck" type="string"/>
        </soapCall>
      </leave>
    </form>
    

    Dans cet exemple, la méthode checkValue et le service nms:recipient sont utilisés :

    • Le service correspond à l’espace de noms et au type de données.
    • La méthode correspond au nom de la fonction. Le nom est sensible à la casse.

    L’appel est effectué de manière synchrone.

    Toutes les exceptions s’affichent. Si vous utilisez l’élément <leave>, les utilisateurs ne peuvent pas enregistrer le formulaire tant que les informations saisies ne sont pas validées.

Cet exemple montre comment effectuer des appels de service depuis les formulaires :

<enter>
  <soapCall name="client" service="c4:ybClient">
    <param exprIn="@id" type="string"/>
    <param type="boolean" xpathOut="/tmp/@count"/>
  </soapCall>
</enter>

Dans cet exemple, l’entrée est un identifiant, qui correspond à une clé primaire. Lorsque les utilisateurs remplissent le formulaire pour cet identifiant, un appel SOAP est effectué avec cet identifiant comme paramètre d’entrée. La sortie est une valeur booléenne qui est écrite dans ce champ : /tmp/@count. Vous pouvez utiliser cette valeur booléenne dans le formulaire. En savoir plus sur le contexte de formulaire (documentation de Campaign v8).

recommendation-more-help
campaign-classic-help