Modification de formulaires editing-forms

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

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

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.

Cliquez sur Enregistrer.

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.

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

<input xpath="@firstName"/>
<input xpath="@lastName"/>

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.

   

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 :

En savoir plus sur les contrôles de liste de mémoire.

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

Exemple :

<container type="enabledGroup" enabledIf="@gender=1">
  […]
</container>
<container type="enabledGroup" enabledIf="@gender=2">
  […]
</container>

Vous pouvez éventuellement utiliser des conteneurs pour regrouper des champs en sections.

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

Modifiez l’attribut type de l’élément <form> en iconbox :

<form […] type="iconbox">

Définissez un conteneur pour chaque page de formulaire :

1. Ajoutez un élément <container> comme enfant de l’élément <form>.

2. Pour définir un libellé et une image pour l’icône, utilisez les attributs label et img.

   code language-xml
   <form entitySchema="xtk:form" name="Service provider" namespace="nms" type="iconbox" xtkschema="xtk:form"> <container img="xtk:properties.png" label="General"> <input xpath="@label"/> <input xpath="@name"/> […] </container> <container img="nms:msgfolder.png" label="Details"> <input xpath="@address"/> […] </container> <container img="nms:supplier.png" label="Services"> […] </container> </form>

Vous pouvez également supprimer l’attribut type="frame" des éléments <container> existants.

Modifiez l’attribut type de l’élément <form> en notebook :

<form […] type="notebook">

Ajoutez un conteneur pour chaque page de formulaire :

1. Ajoutez un élément <container> comme enfant de l’élément <form>.
2. Pour définir le libellé et l’image de l’icône, utilisez les attributs label et img.

  <form entitySchema="xtk:form" name="Service provider" namespace="nms" type="notebook" xtkschema="xtk:form">
      <container label="General">
          <input xpath="@label"/>
          <input xpath="@name"/>
          […]
      </container>
      <container label="Details">
          <input xpath="@address"/>
          […]
      </container>
      <container label="Services">
          […]
      </container>
  </form>

Vous pouvez également supprimer l’attribut type="frame" des éléments <container> existants.

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

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

Exemple :

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.

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 :

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