SAINET apis and documentation

Task Descriptor

Les descripteurs de tâche permettent de définir la présentation des différents écrans de la solution SAINet.

Chain

Le noeud de base du fichier de configuration est la Chaîne SAINet. Chaque chaîne est définie dans son propre fichier au format TasksAndFields_CHAIN.xml dans la configuration.

Attributs:

  • ID * {ChainIdentifier: string[3]} - Identifiant de la chaîne. L’identifiant doit coincider avec le nom du fichier dans lequel la chaîne est déclarée.
  • Units {0-1} (Units) - Liste des unités de la chaîne. Une unité permet de regrouper les tâches ayant un rôle similaire ou une utilisation commune afin de faciliter la navigation des utilisateurs. Cette division est présentée dans le menu des tâches s’il est affiché.
  • Task {0-∞} (Task) - Une tâche est un écran de la solution permettant à l’utilisateur d’afficher ou de saisir des données.
  • SuperTask {0-∞} (SuperTask) - Une SuperTask est une tâche regroupant plusieurs tâches opérant sur des données différentes du même enregistrement et utilisées fréquemment ensembles. Il est ainsi possible de regrouper en une fenêtre tous les éléments d’un même dossier sous le même toit: Le dossier, les factures liées, l’emploi du temps, les documents, …

Units

Liste des unités de la chaîne. Une unité permet de regrouper les tâches ayant un rôle similaire ou une utilisation commune afin de faciliter la navigation des utilisateurs. Cette division est présentée dans le menu des tâches s’il est affiché.

Eléments:

  • Unit {0-∞} (Unit) - Unité de la chaîne.

Unit

Une unité permet de regrouper les tâches ayant un rôle similaire ou une utilisation commune afin de faciliter la navigation des utilisateurs.

Attributs:

  • ID * {string} - Identifiant de l’unité. Cet identifiant doit commencer par l’identifiant de la chaîne courante et être unique.
  • InternLabel {string} - Libellé interne pour le développeur. Si aucune redéfinition n’est effectuée dans les fichiers de propriétés, ce libellé est affiché à l’utilisateur.

Task

Une tâche est un écran de la solution permettant à l’utilisateur d’afficher ou de saisir des données.

Attributs:

  • ID * {TaskIdentifier: string[5]} - Identifiant de la tâche. Cet identifiant doit commencer par l’identifiant de la chaîne courante et doit compter 5 caractères.
  • UnitID * {string} - Identifiant de l’unité à laquelle appartient la tâche courante. Cette unité doit exister dans la chaîne courante.
  • Type * {TaskType} - Type de tâche. Le type de tâche défini les fonctionnalités disponibles sur une tâche et sa présentation. Valeurs possibles:
    • B - Tâche de saisie simple. Ces tâches possèdent un navigateur d’entrées et un ou plusieurs panels permettant la saisie des informations.
    • R - Tâche de saisie de dossier. Ces tâches possèdent un navigateur d’entrées, un ou plusieurs panels permettant la saisie des informations ainsi qu’un navigateur de page permettant de saisir les informations d’un dossier.
    • F - Tâche de saisie double. Ces tâches possèdent un navigateur d’entrées, un ou plusieurs panels permettant la saisie des informations ainsi qu’un sous-navigateur présentant les sous-entrées liées au record en cours d’édition.
    • V - Tâche de vue. Ces tâches possèdent un écran de lancement permettant de saisir les paramètres de lancement, le type de vue désiré ainsi qu’un filtre de données. Elles retournent les données sous forme de grille, permettant d’utiliser les outils interne d’analyse tel que les statistiques ou les graphiques.
    • W - Tâche de vue longue. Ces tâches possèdent un écran de lancement permettant de saisir les paramètres de lancement, le type de vue désiré ainsi qu’un filtre de données. Elles retournent les données sous forme de grille, permettant d’utiliser les outils interne d’analyse tel que les statistiques ou les graphiques. À la différence des tâches de vue, elles sont lancées en arrière-plan et prennent généralement plusieurs minutes avant de retourner un résultat.
    • T - Tâche de traitement. Ces tâches possèdent un écran de lancement permettant de saisir les paramètres de lancement. Elles ne retournent aucun résultat ou ne retournent qu’un message d’information à l’utilisateur. Aucun document n’est présenté.
    • U - Tâche de traitement long. Ces tâches possèdent un écran de lancement permettant de saisir les paramètres de lancement. Elles ne retournent aucun résultat ou ne retournent qu’un message d’information à l’utilisateur. Aucun document n’est présenté. À la différence des tâches de traitement, elles sont lancées en arrière-plan et prennent généralement plusieurs minutes avant de se terminer.
    • L - Tâche de liste. Ces tâches possèdent un écran de lancement permettant de saisir le type d’output et les paramètres de lancement. Elles retournent une liste au format HTML.
    • M - Tâche de liste longue. Ces tâches possèdent un écran de lancement permettant de saisir le type d’output et les paramètres de lancement. Elles retournent une liste au format HTML. À la différence des tâches de liste, elles sont lancées en arrière-plan et prennent généralement plusieurs minutes avant de retourner un résultat.
  • TableID * {TableIdentifier: string[6]} - Table principale de la tâche. La table doit exister dans la solution.
  • HeaderID {string} - Identifiant de la grille à utiliser si le mode de présentation du navigateur est en mode header. Cet attribut n’est pas pris en compte dans les autres modes de présentation.
  • SystemType {TaskSystemType} - Type de tâche au niveau système. Ce type permet de définir comment les droits d’accès sont appliqués sur la tâche. Une tâche de données courante ne nécessite pas de changement de type. Valeurs possibles:
    • ACL_DEFINED - Droits gérés par le système normal des droits. Cette valeur est la valeur par défaut.
    • READSHARE - Lecture forcée. La tâche est toujours lisible par tous les utilisateurs.
    • MODIFYSHARE - Modification forcée. La tâche est toujours accessible en lecture et modification par tous les utilisateurs même si les droits interdisent l’accès à la tâche.
    • EXECUTESHARE - Exécution forcée. La tâche peut être exécutée par tous les utilisateurs même si les droits interdisent l’accès à la tâche.
    • USER_ONLY - Seuls les utilisateurs normaux peuvent accéder à cette tâche. Les administrateurs et super administrateurs ne peuvent pas y accéder.
    • ADMIN_ONLY - Seuls les administrateurs et super administrateurs peuvent accéder à cette tâche. Les utilisateurs ne peuvent pas y accéder, même si les droits permettraient aux utilisateurs l’accès aux données.
    • SUPERADMIN_ONLY - Seuls les super administrateurs peuvent accéder à cette tâche. Les utilisateurs et administrateurs ne peuvent pas y accéder quel que soient les droits d’accès sur la tâche.
  • NavigatorPresentation {NavigatorPresentationType} - Type de présentation du navigateur dans les tâches de saisie simple, de saisie double et de dossier. Cet attribut est actuellement géré uniquement sur le client mobile. Si cet attribut n’est pas spécifié, la présentation utilisée est le mode grid. Valeurs possibles:
    • grid - Présentation en grille des enregistrements.
    • header - Présentation des enregistrement en mode header. Si l’attribut HeaderID est précisé, la grille spécifiée dans cet attribut est utilisée.
  • NavigatorGridView {string} - Identifiant de la grille utilisée pour afficher les données dans le navigateur. Cet attribut ne peut être utilisé que dans des tâches de saisie simple, saisie double ou saisie de dossier.
  • NavigatorFilter {string} - Identifiant du filtre de données du navigateur. Cet attribut ne peut être utilisé que dans des tâches de saisie simple, saisie double ou saisie de dossier.
  • NavigatorTableID {TableIdentifier: string[6]} - Identifiant de la table référencée par la grille du navigateur. Cet attribut ne peut être utilisé que dans des tâches de saisie simple, saisie double ou saisie de dossier.
  • SubNavigatorGridView {string} - Identifiant de la grille utilisée pour afficher les données dans le sous-navigateur. Cet attribut ne peut être utilisé que dans des tâches de saisie double.
  • SubNavigatorFilter {string} - Identifiant du filtre de données du sous-navigateur. Cet attribut ne peut être utilisé que dans des tâches de saisie double.
  • SubNavigatorTableID {TableIdentifier: string[6]} - Identifiant de la table référencée par la grille du sous-navigateur. Cet attribut ne peut être utilisé que dans des tâches de saisie double.
  • CallOnOpenTask {boolean} - Définit si le client riche doit effectuer un appel serveur lors de l’ouverture de la tâche. Cet attribut peut être utilisé sur tout type de tâche mais est principalement défini sur les tâches de traitement, de vue et de liste.
  • CallOnPrepareNewEntry {boolean} - Définit si le client riche doit effectuer un appel serveur lors de la création d’une nouvelle entrée. Cet attribut ne peut être utilisé que sur des tâches de saisie simple, double ou de dossier.
  • EnableMultipleDelete {boolean} - Indique qu’il est possible de sélectionner plusieurs records pour effectuer une suppression en bloc. Généralement, cet attribut dépend du code métier en arrière-plan.
  • SubNavigatorAutoSelectFirst {boolean} - Dans les tâches à deux niveaux, permet de sélectionner et ouvrir automatiquement la première entrée du sous-navigateur lorsqu’une entrée est sélectionnée.
  • CanCloseWithoutTerminate {boolean} - Dans le cas d’une tâche de dossier ® où à deux niveau (F), permet de forcer l’utilisateur a cliquer sur le bouton ‘Terminer’ après une modification. L’utilisateur ne pourra pas fermer la fenêtre tant qu’il ne l’aura pas fait. La valeur de cet attribut dépend du code métier de la tâche et du traitement effectué lors du onTerminate.
  • HandlesProgression {boolean} - Indique que la tâche ne gère pas la progression. Cet attribut est généralement utilisé pour des tâches spécifiques legacy et est entièrement géré coté serveur.
  • Visible {boolean} - Définit si la tâche est visible dans le menu des tâches. Si elle n’est pas visible, elle peut tout de même être appelée depuis un raccourci, un script ou par l’utilisateur en entrant l’identifiant de la tâche.
  • ShowRecordHeader {boolean} -
  • ButtonsVisibles {TaskButtonsVisibles} - Gestion de l’affichage des boutons de validation. Dans le cas des tâches de type dossier, cela ne concerne que les boutons de l’en-tête. Valeurs possibles:
    • Always -
    • Never -
  • SubButtonsVisibles {TaskButtonsVisibles} - Gestion de l’affichage des boutons de validation. Valeurs possibles:
    • Always -
    • Never -
  • InternLabel {string} - Libellé interne pour le développeur. Si aucun libellé n’est défini dans les fichiers de propriétés, la valeur définie dans cet attribut est présenté à l’utilisateur comme le nom de la tâche.
  • Existence {string} - Permet de spécifier l’existence de la tâche. Cet attribut va généralement contenir une condition scriptée par rapport à une valeur de la tâche 01 de la chaîne courante. Si la condition est évaluée à false, alors la tâche n’existe plus du point de vue de l’utilisateur.
  • ListTask {TaskIdentifier: string[5]} - Tâche de liste ou liste longue liée aux données présentées dans la tâche courante. Par défaut, le système recherche automatiquement les tâches opérant sur la même table, cet attribut permet de définir manuellement quelle tâche est présentée à l’utilisateur.
  • ViewTask {TaskIdentifier: string[5]} - Tâche de vue ou vue longue liée aux données présentées dans la tâche courante. Par défaut, le système recherche automatiquement les tâches opérant sur la même table, cet attribut permet de définir manuellement quelle tâche est présentée à l’utilisateur.
  • EditTask {TaskIdentifier: string[5]} - Tâche de saisie simple, double ou de dossier liée aux données présentées dans la tâche courante. Par défaut, le système recherche automatiquement les tâches opérant sur la même table, cet attribut permet de définir manuellement quelle tâche est présentée à l’utilisateur.
  • ReadTables {string} - Liste de tables auxquelles la tâche doit avoir accès en lecture. Cette liste s’applique en supplément à la table principale et aux tables lues dans les grilles accessibles par la tâche. En cas de mise à jour de cet attribut, le paramétrage doit être rechargé par l’AdminClient afin d’être pris en compte.
  • WriteTables {string} - Liste de tables auxquelles la tâche doit avoir accès en écriture. Cette liste s’applique en supplément à la table principale et le sous-navigateur dans le cas de tâches de saisie double. En cas de mise à jour de cet attribut, le paramétrage doit être rechargé par l’AdminClient afin d’être pris en compte.
  • AllowFileDrop {boolean} -
  • AllowOutlookFileDrop {boolean} -
  • AutoUpdateOnTaskChange {string} - Permet de spécifier une liste de tâches “écoutées”. Si un changement est effectué dans l’une d’elles, alors la tâche courante est automatiquement rafraîchie. Cet attribut n’est autorisé que sur les tâches de liste (L,M) et vues (V,W).
  • InheritsDomainVarsFromChain {string} - Permet d’hériter des variables par défaut d’une autre chaîne. Est utilisé afin d’envoyer l’exercice courant dans les tâches ayant des éléments de comptabilité mais provenant d’autres chaînes. Est utilisé la plupart du temps sous la forme InheritsDomainVarsFromChain="CGE".
  • HeaderEnabledActions {TaskHeaderEnabledActions} - Permet de définir quelles sont les actions autorisées dans la tâche. Seuls les caractères N,M,D,R et X sont autorisés. Ils peuvent être combinés, sans séparateur, et exactement dans cet ordre (par exemple RX, ou NMR). Si toutes les lettres sont précisées (tous les droits), alors l’attribut ne doit pas être spécifié. A noter que les droits d’accès (SYS04) interdisent une opération, celle-ci ne sera de toute façon pas autorisée.
  • SubLevelEnabledActions {TaskHeaderEnabledActions} - Permet de définir quelles sont les actions autorisées dans le sous-panel d’une tâche à 2 niveaux. Seuls les caractères N,M,D,R et X sont autorisés. Ils peuvent être combinés, sans séparateur, et exactement dans cet ordre (par exemple RX, ou NMR). Si toutes les lettres sont précisées (tous les droits), alors l’attribut ne doit pas être spécifié. A noter que les droits d’accès (SYS04) interdisent une opération, celle-ci ne sera de toute façon pas autorisée.
  • DisableHeaderOnValidate {boolean} - Désactive tous les champs de l’en-tête lors de la validation d’une entrée.
  • CanInterruptLongTask {boolean} - Définit si la tâche longue peut être interrompue. Par défaut, une tâche longue ne peut pas être interrompue.
  • EnableSubNavigatorMoveArrows {boolean} - Permet d’afficher les flèches haut/bas dans le sous-navigateur d’une tâche à deux niveaux. Si cet attribut est à true, alors l’attribut SubNavigatorMoveArrowsDataFieldID doit également être précisé.
  • SubNavigatorMoveArrowsDataFieldID {string} - Définit le datafield du sous-navigateur qui doit être inversé entre deux enregistrement lorsque l’utilisateur utiliser les flèches haut/bas.
  • NewIsSelect {boolean} - La tâche ne permet pas de créer de nouvelle entrée libre. Lors du clic sur le bouton Nouveau, un écran de sélection est présenté à l’utilisateur afin de sélectionner une entrée existante dans une autre table. Est utilisé par exemple dans les tâches à deux niveau afin de forcer la sélection d’un tiers déjà existant avant de permettre la saisie d’écritures le concernant. Doit être utilisé conjointement avec l’attribut SelectionGridView.
  • SelectionGridView {string} - Définit la grille de sélection permettant de sélectionner une entrée pour la création dans une tâche NewIsSelect. Doit être utilisé conjointement avec l’attribut NewIsSelect.
  • HeaderInPage {string} - Identifiant de la page contenant les informations de l’entête du dossier. Cette page sera ouverte automatiquement lors de la création d’un nouveau dossier. Cet attribut ne peut être utilisé que sur les tâches de type Dossier.
  • HeaderDisplayMode {TaskHeaderDisplayMode} - Valeurs possibles:
    • Big -
    • Medium -
    • Small -
    • Note -
  • PagesAutoSelectFirst {boolean} -
  • ScriptOnValidate {boolean} -
  • Mode {TaskMode} - Développement courant de la tâche. Les tâches n’ayant pas un mode autorisé par le serveur ne sont pas présentées à l’utilisateur et sont interdites par le système de droits. Valeurs possibles:
    • dev -
    • qas -
    • prod -
  • Lock {TaskLock} - Mode de verrouillage de la tâche. N’est utile que pour les tâches de traitement, de listes longues et de vues longues. Par défaut, aucun verrouillage de la tâche n’est présent, ne limitant pas le lancement multiple d’un traitement. Valeurs possibles:
    • ByDomain - Une seule exécution simultanée n’est autorisée par domaine.
    • Exclusive - Une seule exécution simultanée n’est autorisée, même à travers plusieurs instances.
  • InputInterface {TaskInputInterface} - Type de présentation de la tâche de saisie. Valeurs possibles:
    • Normal - Présentation normale de la saisie.
    • Grid - Présentation de saisie en grille. Cette interface permet de saisir des données en masse sur de nombreux records.
    • History/Planning - Présentation de saisie en historique. Cette interface permet de présenter et saisir des données datées de manière aisée.
  • ReloadPagesOnValidate {boolean} -
  • NavigatorShowFastSearchPanelOnStartup {boolean} - Affiche une box de saisie pour le filtre rapide en bas du navigateur. Ce filtre rapide permet à l’utilisateur de chercher rapidement une valeur à travers les données chargées dans la grille du navigateur. Il ne pourra donc rechercher que dans les valeurs définies dans la grille.
  • NavigatorFormatter {string} -
  • NavigatorSkipFirstLoad {boolean} - Permet de désactiver le chargement du navigateur à l’ouverture de la tâche. Cela est typiquement utile pour les navigateurs contenant beaucoup de données, ou l’utilisateur va forcément utiliser le filtre.
  • NavigatorNewOnTop {boolean} - Tout nouvel enregistrement sera affiché au sommet de la grille du navigateur. Par défaut, un nouvel enregistrement est créée en dernier.
  • SkipHeaderCreation {boolean} -
  • OpenThrough {TaskIdentifier: string[5]} - Tâche à ouvrir à la place de la tâche courante lorsque l’utilisateur ouvre la tâche au travers d’un raccourci ou lorsqu’il saisi l’identifiant de la tâche manuellement. Cette propriété peut être utilisée afin de forcer les utilisateurs à passer par une super-tâche afin de saisir les données ou à passer par une autre tâche permettant de choisir des paramètres de récupération de données.
  • AllowedDocuments {string} - Spécifie la liste des documents pouvant être créés/attachés sur cette page. Cette liste représente des pages dans UNI00.
  • ShrinkToFit {TaskShrinkToFit} - Permet de forcer l’activation (ou la désactivation) de l’option ShrinkToFit (ajustement automatique) du document lors de l’impression. Il est également possible de définir l’attribut shrinkToFit au niveau du noeud <html> pour prendre la main sur le comportement de cette option. Par défaut, la valeur Auto est utilisée. Valeurs possibles:
    • Auto - L’option ShrinkToFit n’est pas touchée. Cela dépendra de la configuration de l’imprimante.
    • true - L’option ShrinkToFit est activée et forcée lors de l’impression. Cela peut être utile dans certaines listes legacy pour forcer l’ajustement du contenu sur une page et éviter que des colonnes ne débordent.
    • false - L’option ShrinkToFit est désactivée et ne peut pas être utilisée lors de l’impression. Cela est typiquement le cas dans des impressions de template comme des factures.

Eléments:

  • DataField {0-∞} (DataField) - Une tâche peut définir ses propres datafields. Les datafields qui sont définis ici doivent être de type TaskOnly et leur identifiant commencer par l’identifiant de la tâche. Ils peuvent être utilisés uniquement pour les champs de la tâche qui les déclare.
  • Panel {0-3} (Panel) -
  • SubPanel {0-1} (SubPanel) -
  • Pages {0-1} (Pages) -

SuperTask

Une SuperTask est une tâche regroupant plusieurs tâches opérant sur des données différentes du même enregistrement et utilisées fréquemment ensembles. Il est ainsi possible de regrouper en une fenêtre tous les éléments d’un même dossier sous le même toit: Le dossier, les factures liées, l’emploi du temps, les documents, …

Attributs:

  • ID * {TaskIdentifier: string[5]} -
  • UnitID * {string} -
  • TableID * {TableIdentifier: string[6]} -
  • Type * {SuperTaskTypeFixed} - Valeurs possibles:
    • X -
  • SuperTaskType * {SuperTaskType} - Type de super-tâche. Le type permet de définir l’interaction entre les différentes tâches comprises dans la super-tâche. Valeurs possibles:
    • 2 - Super-tâche de sélection. La permière tâche permet de sélectionner une entrée qui est ensuite utilisée comme filtre dans les autres tâches afin de n’afficher que les entrées qui sont liées à l’entrée sélectionnée dans la tâche principale.
    • 4 - Super-tâche sans sélection. La sélection d’une entrée dans la première tâche n’est pas obligatoire.
  • InternLabel {string} - Libellé interne pour le développeur. Si aucune redéfinition n’est effectuée dans les fichiers de propriétés, ce libellé est affiché à l’utilisateur.

Eléments:

  • Child {1-∞} (SuperTaskChild) - Un Child correspond à une tâche normale intégrée comme enfant de la supertâche.

SuperTaskChild

Un Child correspond à une tâche normale intégrée comme enfant de la supertâche.

Attributs:

  • ID * {string} -
  • TaskID * {TaskIdentifier: string[5]} -
  • MainTask {boolean} -
  • AdditionalFilter {string} -
  • InternLabel {string} -
  • OperationOnSelect {SuperTaskChildOperation} - Valeurs possibles:
    • refresh -
  • NavigatorGridView {string} -
  • NavigatorFilter {string} - Permet d’overrider le filtre du navigateur de la tâche
  • InputInterface {TaskInputInterface} - Type de présentation de la tâche de saisie. Valeurs possibles:
    • Normal - Présentation normale de la saisie.
    • Grid - Présentation de saisie en grille. Cette interface permet de saisir des données en masse sur de nombreux records.
    • History/Planning - Présentation de saisie en historique. Cette interface permet de présenter et saisir des données datées de manière aisée.
  • SelectionIsFilter {boolean} -
  • Icon {string} -

Panel

Attributs:

  • ID * {string} - Identifiant du panel. Cet identifiant doit être unique au sein d’une tâche. Par convention, le premier panel est 1.
  • ShowSubNavigator {boolean} - Définit si le sous-navigateur est affiché dans le panel courant. Cet attribut n’est utile que pour les tâches de saisie double. Il est important pour le bon fonctionnement et la bonne utilisation de la tâche qu’au moins un des panels affiche le sous-navigateur.
  • ShowPagesManager {boolean} - Définit si le navigateur de pages est affiché dans le panel courant. Cet attribut n’est utile que pour les tâches de dossier. Il est important pour le bon fonctionnement et la bonne utilisation de la tâche qu’au moins un des panels affiche le navigateur de pages.
  • InternLabel {string} - Libellé interne pour le développeur. Si aucune redéfinition n’est effectuée dans les fichiers de propriétés, ce libellé est affiché à l’utilisateur. Si un seul panel est défini dans la tâche, ce libellé n’est pas affiché. Les onglets de panels ne sont affichés que si plusieurs panels sont définis.

Eléments:

Eléments:

  • Group {0-∞} (Group) - Un groupe permet de réunir un ensemble de champs à l’écran. Ceux-ci sont ensuite placés relativement à leur groupe, permettant de rapidement déplacer des groupes entiers sans avoir à modifier chacun des champs.

SubPanel

Attributs:

  • ID * {string} - Identifiant du panel de sous-entrée. L’identifiant doit être unique au sein d’une tâche. Il ne doit pas être le même qu’un autre panel Panel ou SubPanel.
  • Row {positiveInteger} - Position du panel de sous-entrée.
  • Column {positiveInteger} - Position du panel de sous-entrée.
  • Width {positiveInteger} - Taille du panel de sous-entrée.
  • Height {positiveInteger} - Taille du panel de sous-entrée.
  • InternLabel {string} - Libellé interne pour le développeur. Ce libellé n’est jamais affiché à l’écran.
  • CallOnPrepareNewEntry {boolean} - Comme pour une tâche, spécifie si le serveur doit être appelé lors de la création d’un nouvelle sous-entrée avec le contenu de l’écran afin de préparer la nouvelle entrée.

Eléments:

Eléments:

  • Group {0-∞} (Group) - Un groupe permet de réunir un ensemble de champs à l’écran. Ceux-ci sont ensuite placés relativement à leur groupe, permettant de rapidement déplacer des groupes entiers sans avoir à modifier chacun des champs.

LevelGlobal

Attributs:

  • ID {string} -

Eléments:

  • Key (Key) - Une clé permet de lier plusieurs tables afin de présenter des informations stockées dans chacunes de manière liée au sein d’une même grille par exemple.

Eléments:

  • Group {0-∞} (Group) - Un groupe permet de réunir un ensemble de champs à l’écran. Ceux-ci sont ensuite placés relativement à leur groupe, permettant de rapidement déplacer des groupes entiers sans avoir à modifier chacun des champs.
  • Level {0-∞} (LevelGlobal) -

LevelGroup

Attributs:

  • ID {string} -

Eléments:

  • Key (Key) - Une clé permet de lier plusieurs tables afin de présenter des informations stockées dans chacunes de manière liée au sein d’une même grille par exemple.
  • Couple (Couple) - Un couple permet de lier deux champs ensemble afin de permettre une sélection d’une entrée dans une autre table. Le premier champ est stocké dans la table courante alors que le deuxième champ est récupéré à la volée, permettant ainsi de sélectionner et afficher le nom d’une entrée sans que celui-ci ne soit copié dans la table courante.

Eléments:

  • Field {0-∞} (Field) - Champ de saisie ou de présentation permettant d’afficher les données à l’écran. Les DataField permettent de préciser le stockage des données tandis que les Field précisent l’affichage de celles-ci à l’utilisateur.
  • Couple {0-∞} (Couple) - Un couple permet de lier deux champs ensemble afin de permettre une sélection d’une entrée dans une autre table. Le premier champ est stocké dans la table courante alors que le deuxième champ est récupéré à la volée, permettant ainsi de sélectionner et afficher le nom d’une entrée sans que celui-ci ne soit copié dans la table courante.
  • Level {0-∞} (LevelGroup) -

Key

Une clé permet de lier plusieurs tables afin de présenter des informations stockées dans chacunes de manière liée au sein d’une même grille par exemple.

Eléments:

  • DataField (KeyDataField) - Chaque datafield de la clé permet de préciser le lien entre les deux tables. La valeur de l’élément est la valeur dans la table courante à laquelle doit répondre le datafield de la clé. Dans l’exemple ci-dessous, la table courante est EPLPRI et la table vers laquelle on pointe sera EPLSEC : <DataField DataFieldID="EPLSEC.ID_PK">$EPLPRI.EPLSECFK</DataField>

KeyDataField

Chaque datafield de la clé permet de préciser le lien entre les deux tables. La valeur de l’élément est la valeur dans la table courante à laquelle doit répondre le datafield de la clé. Dans l’exemple ci-dessous, la table courante est EPLPRI et la table vers laquelle on pointe sera EPLSEC : <DataField DataFieldID="EPLSEC.ID_PK">$EPLPRI.EPLSECFK</DataField>

Attributs:

  • DataFieldID * {string} - Identifiant d’un datafield dans la table vers laquelle le Level pointe.

Group

Un groupe permet de réunir un ensemble de champs à l’écran. Ceux-ci sont ensuite placés relativement à leur groupe, permettant de rapidement déplacer des groupes entiers sans avoir à modifier chacun des champs.

Attributs:

  • ID * {string} - Identifiant du groupe dans la tâche. Les identifiants de groupe doivent être uniques à l’intérieur d’un panel.
  • Row {integer} - Ligne à laquelle le groupe débute.
  • Column {integer} - Colonne à laquelle le groupe débute.
  • Width {integer} - Largeur du groupe. Celle-ci doit être supérieure à la colonne à laquelle se termine le champ le plus large.
  • Height {integer} - Hauteur du group. Celle-ci doit être supérieure à la ligne à laquelle se termine le champ le plus bas.
  • PhoneRow {string} - Voir Row. Ne s’applique que sur les tâches affichées sur smartphone et contextes petits.
  • PhoneColumn {string} - Voir Column. Ne s’applique que sur les tâches affichées sur smartphone et contextes petits.
  • PhoneLabelColumn {string} - Voir LabelColumn. Ne s’applique que sur les tâches affichées sur smartphone et contextes petits.
  • PhoneWidth {string} - Voir Width. Ne s’applique que sur les tâches affichées sur smartphone et contextes petits.
  • PhoneHeight {string} - Voir Height. Ne s’applique que sur les tâches affichées sur smartphone et contextes petits.
  • MobileRow {integer} - Voir Row. Ne s’applique que sur les tâches affichées sur mobile.
  • MobileColumn {string} - Voir Column. Ne s’applique que sur les tâches affichées sur mobile.
  • MobileWidth {string} - Voir Width. Ne s’applique que sur les tâches affichées sur mobile.
  • MobileHeight {integer} - Voir Height. Ne s’applique que sur les tâches affichées sur mobile.
  • DesktopRow {string} - Voir Row. Ne s’applique que sur les tâches affichées sur un browser.
  • DesktopColumn {string} - Voir Column. Ne s’applique que sur les tâches affichées sur un browser.
  • DesktopWidth {string} - Voir Width. Ne s’applique que sur les tâches affichées sur un browser.
  • DesktopHeight {string} - Voir Height. Ne s’applique que sur les tâches affichées sur un browser.
  • InternLabel {string} - Libellé interne pour le développeur. Si aucune redéfinition n’est effectuée dans les fichiers de propriétés, ce libellé est affiché à l’utilisateur.
  • BackgroundColor {GroupBackgroundColor} - Permet de spécifier une couleur d’arrière-plan à un groupe. Cet attribut peut contenir soir ‘gray’ ou un code hexadécimal commencant par un dièse (#FFFFFF).
  • LeftBorderVisible {boolean} -
  • Icon {string} -
  • State {TaskGroupState} - Etat du groupe à l’ouverture de la tâche (Open par défaut). Valeurs possibles:
    • Open -
    • Closed -

Eléments:

  • Field {0-∞} (Field) - Champ de saisie ou de présentation permettant d’afficher les données à l’écran. Les DataField permettent de préciser le stockage des données tandis que les Field précisent l’affichage de celles-ci à l’utilisateur.
  • Couple {0-∞} (Couple) - Un couple permet de lier deux champs ensemble afin de permettre une sélection d’une entrée dans une autre table. Le premier champ est stocké dans la table courante alors que le deuxième champ est récupéré à la volée, permettant ainsi de sélectionner et afficher le nom d’une entrée sans que celui-ci ne soit copié dans la table courante.
  • Level {0-∞} (LevelGroup) -

Field

Champ de saisie ou de présentation permettant d’afficher les données à l’écran. Les DataField permettent de préciser le stockage des données tandis que les Field précisent l’affichage de celles-ci à l’utilisateur.

Attributs:

  • ID * {string} - Identifiant du champ dans le panel. Les identifiants de champ doivent être uniques au sein d’un panel.
  • DataFieldID * {string} - Identifiant du datafield stockant les données de ce champ. Le datafield peut être soit issu d’une table, soit TaskOnly et défini dans la chaîne, la tâche courante ou dans les datafields globaux.
  • Row {integer} - Ligne à laquelle commence le champ à l’intérieur du groupe.
  • Column {integer} - Colonne à laquelle commence le champ à l’intérieur du groupe.
  • LabelColumn {integer} - Ligne à laquelle commence le libellé du champ à l’intérieur du groupe.
  • Width {integer} - Largeur du champ en colonnes.
  • Height {integer} - Hauteur du champ en lignes. Seuls certains champs permettent de définir une hauteur supérieure à 1, dont les datafields de type MultiLineString.
  • PhoneRow {string} - Voir Row. Ne s’applique que sur les tâches affichées sur smartphone et contextes petits.
  • PhoneColumn {string} - Voir Column. Ne s’applique que sur les tâches affichées sur smartphone et contextes petits.
  • PhoneLabelColumn {string} - Voir LabelColumn. Ne s’applique que sur les tâches affichées sur smartphone et contextes petits.
  • PhoneWidth {string} - Voir Width. Ne s’applique que sur les tâches affichées sur smartphone et contextes petits.
  • PhoneHeight {string} - Voir Height. Ne s’applique que sur les tâches affichées sur smartphone et contextes petits.
  • MobileRow {integer} - Voir Row. Ne s’applique que sur les tâches affichées sur mobile.
  • MobileColumn {string} - Voir Column. Ne s’applique que sur les tâches affichées sur mobile.
  • MobileLabelColumn {string} - Voir LabelColumn. Ne s’applique que sur les tâches affichées sur mobile.
  • MobileWidth {string} - Voir Width. Ne s’applique que sur les tâches affichées sur mobile.
  • MobileHeight {integer} - Voir Height. Ne s’applique que sur les tâches affichées sur mobile.
  • MobileVisible {boolean} - Voir Visible. Ne s’applique que sur les tâches affichées sur mobile.
  • DesktopRow {string} - Voir Row. Ne s’applique que sur les tâches affichées sur un browser.
  • DesktopColumn {string} - Voir Column. Ne s’applique que sur les tâches affichées sur un browser.
  • DesktopLabelColumn {string} - Voir LabelColumn. Ne s’applique que sur les tâches affichées sur un browser.
  • DesktopWidth {string} - Voir Width. Ne s’applique que sur les tâches affichées sur un browser.
  • DesktopHeight {string} - Voir Height. Ne s’applique que sur les tâches affichées sur un browser.
  • DesktopVisible {boolean} - Voir Visible. Ne s’applique que sur les tâches affichées sur un browser.
  • DecX {integer} - Offset en pixels sur l’axe des colonnes. Ne peut être utilisé que sur des champs de type Image. Permet le positionnement précis d’images sur l’écran.
  • DecY {integer} - Offset en pixels sur l’axe des lignes. Ne peut être utilisé que sur des champs de type Image. Permet le positionnement précis d’images sur l’écran.
  • Visible {boolean} - Définit si le champ doit être affiché. Les champs d’un couple doivent toujours être affichés, qu’ils soient fusionnés ou séparés.
  • LabelVisible {boolean} - Définit si le libellé du champ doit être affiché.
  • DisplayColumn {string} - Spécifie quelle colonne est utilisée pour afficher les textes dans un champ au format List. Dans le cas d’un datafield au format Enum, il représente un attribut (ID ou Label) et sinon, une colonne présente dans la grille pointée par GridView.
  • DisplayCode {EnumDisplayCode} - Spécifie le type d’affichage des éléments de la combo. Cet attribut n’est valide que sur les datafields de type Enum. Valeurs possibles:
    • CodeOnly - Affiche uniquement l’identifiant des éléments de la combo.
    • TextOnly - Affiche uniquement le texte des éléments de la combo.
    • CodeAndText - Valeur par défaut. Affiche à la fois l’identifiant de la combo et le texte.
  • ShowInnerIcon {boolean} -
  • CallOnValidate {boolean} - Définit si le client doit effectuer un appel serveur lorsque la valeur du champ est modifiée par l’utilisateur.
  • ScriptOnValidate {string} - Définit le script à appeler sur le client lorsque la valeur du champ est modifiée par l’utilisateur. Si la valeur est true, la section OnFieldChange du script de la tâche courante sera appellée. Il est également possible de spécifier <file>:<section> comme valeur (ex : ADR02:MySection) et la
    du fichier <file>.script sera appellée
  • ScriptOnNoteValidate {string} - Définit le script à appeler sur le client lorsque la note du champ est validée par l’utilisateur. Si la valeur est true, la section OnFieldNoteChange du script de la tâche courante sera appellée. Il est également possible de spécifier <file>:<section> comme valeur (ex : MyFile:MySection) et la
    du fichier <file>.script sera appellée
  • CallOnClick {boolean} - Définit si le client doit effectuer un appel serveur lorsque l’utilisateur clique sur le lien ou sur le bouton. Cet attribut ne peut être utilisé que sur des champs dont la présentation est Link ou Button.
  • ScriptOnClick {string} - Définit le script à appeler sur le clien lorsque l’utilisateur clique sur le lien ou sur le bouton. Cet attribut ne peut être utilisé que sur des champs dont la présentation est Link ou Button.
  • ScriptOnEnter {string} - Spécifie si un script doit être exécuté lorsque l’utilisateur sélectionne le champ. L’utilisation de cet attribut est très rare et ne doit être faite que dans des cas précis. Les valeurs possibles sont false si aucun appel ne doit être effectué et le nom de la méthode de script à appeler lorsque l’utilisateur entre dans le champ.
  • SendAllPanels {boolean} - Spécifie si les appels tels que OnFieldChange,OnFieldClick, etc… sur le serveur doivent communiquer l’intégralité des panels de la tâche ou seulement le panel courant du champ changé. Par défaut, l’attribut est false
  • Enabled {boolean} - Définit si le champ est actif ou non. Par défaut tous les champs sont actifs à l’exception des champs de clé lors de la modification d’un record. Les champs désactivés ne sont pas modifiables, pas sélectionnables et aucune action n’est possible. Pour rendre un champ non modifiable mais sélectionnable, voir ReadOnly.
  • ModifyColorOnChange {boolean} -
  • NoReactionOnChange {boolean} -
  • IsTitle {boolean} -
  • IsHeader {boolean} -
  • Existence {string} - Spécifie si le champ existera à l’écran ou s’il doit être ignoré. Un script peut être spécifié directement dans l’attribut. Cet attribut est utile dans le cas de fonctionnalités configurables dans la tâche 01 de la chaîne.
  • Silo {string} - Spécifie si le silo est activé sur le champ. Le silo permet de mémoriser les dernières valeurs saisies par l’utilisateur dans ce champ. Les valeurs possibles sont true/false pour activer/ désactiver le silo ou un identifiant de silo à utiliser si les valeurs doivent être communes entre plusieurs champs.
  • PreloadSilo {boolean} - Permet de gérer le comportement du chargement du Silo. Si cette propriété n’est pas définie, le silo se précharge si la propriété client PROPERTY_FIELD_SILO_MODE vaut PRELOAD. Si cette propriété est présente et vaut true, le silo se précharge quelle que soit la valeur de la propriété client PROPERTY_FIELD_SILO_MODE. Si cette propriété est présente et vaut false, le silo ne se préchage jamais même si la propriété client PROPERTY_FIELD_SILO_MODE vaut PRELOAD. Cette propriété n’affecte en aucun cas l’existence du silo ou son contenu.
  • ReadOnly {boolean} - Définit si le champ est modifiable ou non. Par défaut tous les champs sont modifiable à l’exception des champs désactivés. Les champs en lecture seule sont sélectionnables mais non modifiables. Ils permettent aux utilisateurs de copier le contenu du champ dans le presse-papier.
  • EnableRichText {boolean} -
  • ContentConversion {ContentConversionType} - Spécifie le traitement à effectuer sur le contenu du champ lors de la saisie. Valeurs possibles:
    • 1 - Converti le contenu du champ en majuscules.
  • CopyIgnore {boolean} - Spécifie si le champ doit être pris en compte lorsque l’utilisateur demande à copier le XML de l’état de la tâche. Si le champ comprend des valeurs générées devant rester uniques, il est possible de spécifier cet attribut à true. Par défaut, tous les champs qui ne sont pas des clés (PK) sont pris en compte.
  • PasteIgnore {boolean} - Permet de préciser le comportement de CopyIgnore. CopyIgnore permet d’exclure des champs lors de la copie d’un écran, PasteIgnore permet d’ignorer un champ au moment où il est appliqué dans un écran, même si il est présent dans le modèle initial. Utile lorsqu’on doit pouvoir sauver un modèle, récupérer des informations par copier-coller, mais qu’on ne veut en aucun cas qu’un champ puisse modifier la valeur courante lorsque le modèle/l’écran est utilisé.
  • PlaceHolder {string} - Spécifie le placeholder affiché dans le champ. Il est également possible d’internationaliser la valeur dans les properties en spécifiant une entrée comme pour le field avec .PlaceHolder à la fin. Dans le cas ou le placeholder ne serait pas défini, le field reprend le placeholder du datafield
  • AutoGeneratedContent {boolean} - Spécifie si le contenu du champ est généré automatiquement. Le serveur recevra une valeur par défaut de AUTO.
  • DefaultValue {string} - Valeur par défaut lors de la création d’une nouvelle entrée ou ouverture de tâche. Cette valeur est modifiable par l’utilisateur.
  • PermanentValue {string} - Valeur par défaut lors de la création d’une nouvelle entrée ou ouverture de tâche. Cette valeur est permanente et ne peut pas être modifiée par l’utilisateur.
  • KeepInSessionVar {string} -
  • Importance {DataFieldImportance} - Spécifie l’importance du champ. Valeurs possibles:
    • 0 - Le field n’est pas obligatoire pour validation.
    • 1 - Le field est obligatoire pour la validation de l’entrée. S’il n’est pas spécifié lors de la validation, une étoile apparaît à côté du champ.
    • 2 - Le field est obligatoire pour la validation de l’entrée. Une étoile est toujours affichée lors de la saisie.
  • Presentation {DataFieldPresentation} - Type d’affichage du champ. Valeurs possibles:
    • Link - Présentation sous forme d’hyperlien cliquable par l’utilisateur. Aucune donnée ne peut être saisie.
    • Memo - Présentation du champ de saisie sous forme de champ de saisie multiligne extensible.
    • Button - Présentation sous forme de bouton cliquable par l’utilisateur. Aucune donnée ne peut être saisie.
    • RadioButton - Présentation de la combo sous forme de liste à puces (radio button) sélectionnables.
    • FileName - Présentation sous forme de sélection de fichier avec hyperlien ouvrant une fenêtre de sélection.
    • Image - Présentation sous forme d’image. Aucune donnée ne peut être saisie.
    • CheckBox - Présentation de la combo ou du booléen sous forme de case à cocher.
    • Edit - Présentation par défaut d’un champ de saisie.
    • Icon - Présentation de la combo sous forme d’icone pouvant être sélectionnée. Fonctionne sur le web uniquemenent. L’icone est récupérée dans le champ Icon de la combo.
    • Mail - Un champ de type mail vérifie le format entré par l’utilisateur afin de garantir qu’il respecte le format général d’une adresse mail. Il permet également directement d’ouvrir l’application mail par défaut de l’appareil en cliquant sur la petite icône associée. Cette fonctionnalité est actuellement seulement disponible sur les devices mobiles.
    • Phone - Ce champ est géré à travers la librairie de gestion des indicatifs téléphoniques par pays. Ceci permet de garantir que le format de tous les téléphones sont bien formattés et préfixés de la même et bonne manière en fonction du pays. Cette fonctionnalité est actuellement seulement disponible sur les devices mobiles.
  • AddressBlockID {string} -
  • InternLabel {string} - Libellé interne pour le développeur. Ce libellé n’est jamais affiché à l’utilisateur.
  • AllowNonExistentEntry {boolean} - Dans le cas d’un champ dans un couple, permet à l’utilisateur de saisir une valeur qui n’existe pas dans la table liée et de permettre la validation. Les données peuvent ensuite être traitée coté serveur de manière spécifique pour créer une entrée dynamiquement.

Couple

Un couple permet de lier deux champs ensemble afin de permettre une sélection d’une entrée dans une autre table. Le premier champ est stocké dans la table courante alors que le deuxième champ est récupéré à la volée, permettant ainsi de sélectionner et afficher le nom d’une entrée sans que celui-ci ne soit copié dans la table courante.

Attributs:

  • Key * {string} - Identifiant du datafield stockant la clé de l’enregistrement dans la table courante.
  • ForeignKey * {string} - Identifiant du datafield stockant la clé de l’enregistrement dans sa table.
  • GridView {string} - Identifiant de la grille utilisée afin de récupérer les enregistrements distants. Cette grille doit exister et pointer sur la même table que l’attribut ForeignKey.
  • Filter {string} - Identifiant du filtre de données appliqué lors de la récupération des enregistrements distants. Si aucun filtre n’est spécifié, aucun filtre n’est appliqué et tous les enregistrements sont affichés. Ce filtre doit exister et pointer sur la même table que l’attribut ForeignKey.
  • Raw {boolean} - Spécifie si les appels serveurs de récupération de la liste des enregistrements sont effectués en mode Raw ou pas. Par défaut, aucun traitement métier n’est appliqué sur les appels Raw. Si l’attribut n’est pas spécifié, les appels sont effectués en mode Raw.
  • Cache {boolean} - Active le cache des enregistrements retournés. Par défaut le client riche garde les enregistrements retournés en cache afin de réduire le nombre d’appels. Si un traitement métier est appliqué sur la grille, ce cache devrait être désactivé.
  • Fusion {boolean} - Les deux champs du couple sont fusionnés pour ne présenter qu’un champ à l’utilisateur, permettant de rechercher ainsi par identifiant ou par libellé.
  • Switch {boolean} - Inverse le libellé et l’identifiant du couple. Ceci permet de présenter le libellé en premier dans des couples fusionnés.
  • ShowLink {boolean} - Affiche un lien Choisir permettant d’ouvrir une fenêtre de sélection présentant la grille précisée pour le couple.
  • OpenWith {string} - Précise la tâche à utiliser afin d’ouvrir l’entrée sélectionnée. La tâche précisée doit exister. Si l’attribut n’est pas spécifié, l’icône n’ouvre pas de tâche et présente la fichie simplifiée de l’enregistrement sélectionné.

Eléments:

  • Field {2-2} (Field) - Deux champs de texte normaux permettant d’afficher la clé et le libellé de l’enregistrement. Les deux champs peuvent être sur la même ligne ou sur deux lignes séparées. Un d’eux doit utiliser le datafield précisé dans l’attribut Key, le deuxième un champ de la même table que celui précisé dans l’attribut ForeignKey.

Pages

Eléments:

  • Page {0-∞} (Page) - Une page affiche les données issues de DataPages stockées en base de données dans un dossier. Les pages peuvent être soit uniques soit multiples, en fonction de ce qui a été défini dans la DataPage.

Page

Une page affiche les données issues de DataPages stockées en base de données dans un dossier. Les pages peuvent être soit uniques soit multiples, en fonction de ce qui a été défini dans la DataPage.

Attributs:

  • ID {string} - Identifiant de la Page, obligatoire si plusieurs pages pointent vers la même DataPage. Chaque identifiant de page doit être unique.
  • DataPageID * {string} - Identifiant de la DataPage dans le fichier TablesAndDataFields qui stocke les données de cette page. La DataPage doit exister dans la table définie comme table principale de la tâche de dossier.
  • Title {string} - Titre de la page. Ce titre est affiché dans le navigateur de pages. Les champs de la page peuvent être référencés sous la forme $!{FIELD_ID}.
  • CallOnPrepareNewPage {boolean} - Définit si le client doit effectuer un appel serveur lorsque l’utilisateur sélectionne une page à créer. Cet appel peut pré-remplir des champs de la page avant qu’elle ne soit affichée à l’utilisateur.
  • InitialShrinkedState {PageShrinkedState} - Etat du regroupement des pages du même type lors de l’ouverture du dossier. Valeurs possibles:
    • shrinked - Les groupes de pages sont fermés lors de l’ouverture du dossier.
    • partial - Seul le nombre de pages spécifiées dans l’attribut ShrinkedPagesDisplayed sont affichées.
    • full - Toutes les pages sont affichées lors de l’ouverture du dossier.
  • ShrinkedPagesDisplayed {PageShrinkedPartialDisplay} - Pages affichées dans l’arbre de pages lorsque l’attribut InitialShrinkedState est en mode partiel. L’utilisateur peut également alterner entre les modes d’affichage en cliquant sur le groupe. Par défaut, l’attribut prend une valeur de 0, alternant entre l’affichage complet de toutes les pages et l’affichage uniquement du groupe de pages.
  • AllowedDocuments {string} - Spécifie la liste des documents pouvant être créés/attachés sur cette page. Cette liste représente des pages dans UNI00.

Eléments:

  • DataField {0-∞} (DataField) - Une page peut définir ses propres datafields. Les datafields qui sont définis ici doivent être de type TaskOnly et leur identifiant commencer par l’identifiant de la page. Ils peuvent être utilisés uniquement pour les champs de la page qui les déclare.

Eléments:

Eléments:

  • Group {0-∞} (Group) - Un groupe permet de réunir un ensemble de champs à l’écran. Ceux-ci sont ensuite placés relativement à leur groupe, permettant de rapidement déplacer des groupes entiers sans avoir à modifier chacun des champs.

DataField

Attributs:

  • ID * {string} - Identifiant du datafield. Cet identifiant correspond à l’identifiant en base de données. Cet identifiant doit être unique au sein d’une même table. Les datafields de clé doivent se terminer par _PK par convention.
  • Source * {DataFieldSource} - Spécifie la source de données du datafield. Valeurs possibles:
    • DataBaseDirect - Le datafield est stocké dans une colonne de la base de données. Il s’agit du stockage normal de données dans les tables standard et les entêtes de dossier.
    • DataBaseDossier - Le datafield est stocké dans la table des champs de dossier. Aucune colonne spécifique au datafield n’est nécessaire dans la base de données. Il s’agit du stockage standard dans les tables de type dossier.
    • TaskOnly - Le datafield n’est pas stocké automatiquement. Par défaut, le serveur ne rempli pas les champs issus de datafields de ce type. Les valeurs sont envoyées lors de la validation mais ne sont pas sauvegardés par le système.
  • Format * {DataFieldFormat} - Format des données stockées au travers du datafield. Valeurs possibles:
    • String - Chaine de caractères simple.
    • MultiLineString - Chaîne de caractères sur plusieurs lignes. Il s’agit d’un des types de données qui peuvent être présentés sur plusieurs lignes.
    • Script - Chaîne de caractères sur plusieurs lignes représentant un script saisi par l’utilisateur. Il s’agit d’un des types de données qui peuvent être présentés sur plusieurs lignes.
    • Integer - Nombre entier
    • Financial - Nombre décimal stocké sans perte de précision en base de données
    • Float - Nombre à virgule flottante. Ce format ne doit pas être utilisé pour des calculs financiers
    • Year - Nombre entier représentant une année
    • Date - Date
    • DateTime - Date et heure
    • Time - Heure
    • Boolean - Booléen
    • ByForeignKey - Le format de ce datafield est calculé à partir du champ vers lequel il est lié. Doit préciser un attribut TableName.
    • Percentage - Nombre à virgule flottante représentant un pourcentage
    • Enum - Élément de combo. Doit préciser un attribut EnumName.
    • List - Liste d’éléments sélectionnés à partir d’une autre table ou d’un Enum. Doit préciser un attribut TableName pour lier à une table. Doit préciser un attribut EnumName pour lier à une combo. Si l’attribut DisplayColumn est précisé, le champ affiche la valeur indiqué dans la colonne spécifiée de la grille de selection dans le cas d’un TableName. Dans le cas d’un Enum, la displayColumn doit être Label.
    • GEDDocument - Lien vers un document stocké en base de données.
    • GEDImage - Lien vers une image stockée en base de données.
    • GPSCoordinates - Coordonnées GPS.
    • File - Fichier sur le disque. Ce format est utilisé en règle générale sur un champ TaskOnly pour permettre à l’utilisateur d’uploader un document.
    • Filter - Filtre de données. Utilisé principalement sur un champ TaskOnly dans les tâches de vue, de liste et de traitement. Doit définir un attribut FilterName pointant vers un filtre existant dans le paramétrage.
    • PrintSettings - Configuration d’impression. Utilisé principalement sur un champ TaskOnly dans les tâches de liste afin de permettre à l’utilisateur de configurer le format de sortie du document.
    • PagesAndFields - Sélecteur de page et champs. Seulement utilisé par le datafield global SELECT_PAGES_AND_FIELDS.
  • InternLabel {string} - Libellé interne pour le développeur. Si aucune redéfinition n’est effectuée dans les fichiers de propriétés, ce libellé est affiché à l’utilisateur.
  • InternDescription {string} - Description interne pour le développeur. Ce texte n’est jamais affiché à l’utilisateur.
  • IsKey {boolean} - Attribut obligatoire pour les datafields faisant partie de la clé. Ces datafields doivent se terminer par le suffixe _PK.
  • IsHeader {boolean} - Si true, ce DataField fera partie du titre de l’écran (au-dessus du premier groupe). Le titre est généré dans l’ordre de définition des DataFields.
  • IsTitle {boolean} - Déprécié: préférer l’utilisation de l’attribut Title dans la Page du TasksAndFields. Si true, ce DataField fera partie du titre dans le navigateur de page. Le titre est généré dans l’ordre de définition des DataFields.
  • Importance {DataFieldImportance} - Valeurs possibles:
    • 0 - Le field n’est pas obligatoire pour validation.
    • 1 - Le field est obligatoire pour la validation de l’entrée. S’il n’est pas spécifié lors de la validation, une étoile apparaît à côté du champ.
    • 2 - Le field est obligatoire pour la validation de l’entrée. Une étoile est toujours affichée lors de la saisie.
  • TableName {string} - Spécifie la table vers laquelle les données stockées dans le datafield pointent. Cet attribut est obligatoire si le format du datafield est ByForeignKey.
  • FilterName {string} - Spécifie le filtre à appliquer. Est obligatoire si le format du datafield est Filter.
  • PlaceHolder {string} - Spécifie le placeholder affiché dans le champ qui pointe vers ce datafield. Il est également possible d’internationaliser la valeur dans les properties en spécifiant une entrée datafieldId.PlaceHolder
  • EnumName {string} - Spécifie l’identifiant de la combo liée au datafield. Cet attribut n’est valide que sur les datafields de type Enum. Les valeurs possibles sont soit une combo définie dans les fichiers de combo. Il est également possible d’utiliser la valeur ByDataFieldName afin d’utiliser automatiquement la combo ayant le même identifiant que le datafield. La valeur ByTaskAndFieldName permet également d’utiliser automatiquement la combo ayant le même identifiant que la tâche et le champ utilisant le datafield.
  • GridView {string} - Pour les champs pointant sur une autre table, spécifie la grille de données utilisée afin de récupérer les valeurs. Cet attribut ne peut être utilisé que pour les formats ByForeignKey, List et Filter et doit faire référence à une grille existante dans le paramétrage.
  • MaxLength {integer} - Spécifie la longueur maximale du contenu du champ. Cette valeur doit être prise en compte lors de la création des colonnes en base de données. Si l’attribut AllowMultipleLanguages est activé, le contenu en base doit également être plus long que la longueur définie ici (MaxLength*nombre de langues). Pour les types Enum, la longueur doit permettre de stocker tous les identifiants de la combo.
  • AllowMultipleLanguages {boolean} - Spécifie si l’utilisateur peut saisir des valeurs par langue dans les champs liés à ce datafield. Si activé, le client riche active les fonctionnalités de saisie multilingue et les rendus affichent la valeur définie dans la langue de l’utilisateur courant.
  • NbDecimals {integer} - Nombre de décimales stockées et présentées. Par défaut, les datafields de type Financial utilisent 2 chiffres décimaux. Cet attribut n’est valide que sur les datafields de type Financial et Percentage.
  • SortIndex {string} - Tri par défaut dans les grilles. Si aucun filtre ne redéfini d’ordre, le système insère le datafield à la position définie dans le filtre. Si un ordre est défini dans le filtre, cet attribut est ignoré. Par exemple, si un datafield de la table affichée dans la grille défini un attribut SortIndex avec la valeur 1 DESC, le client va ajouter automatiquement ce datafield comme tri par défaut.
  • SpecialMask {string} - Masque de saisie. Si aucun masque n’est spécifié, toutes les valeurs possibles pour le champ peuvent être entrées. Avec un masque de saisie, le format des données peut être forcé. Les masques sont définis sous la forme 999.9999.9999.99 par exemple si l’on veut permettre à l’utilisateur de saisir un identifiant sous la forme '3 chiffres, un point (ajouté automatiquement), 4 chiffres, un point, 4 chiffres, un point et finalement 2 chiffres. Certains formats plus complexes sont gérés directement par le système. Ceux-ci sont BVRMask, Phone et Mail. La documentation complète sur les masques est disponible ici: http://docwiki.embarcadero.com/Libraries/XE2/en/System.MaskUtils.TEditMask
  • StoreMaskCharsInDataBase {boolean} - Indique si les caractères du masque (SpecialMask) doivent être stockés en base de donnée (true par défaut).
  • SpecialRegExp {string} - Masque de saisie avancé. Cet attribut peut être utilisé si le masque de saisie “SpecialMask” n’est pas suffisamment souple. Les expressions régulières doivent être saisie au format standard PCRE.
  • DefaultValue {string} - Valeur par défaut lors de l’ouverture de la tâche ou lors de la création d’une nouvelle entrée. La valeur peut être soit en dur, soit faire référence à un script ou à une variable de script.
  • PermanentValue {string} - Valeur forcée du champ. À la différence d’un DefaultValue, la valeur ne peut pas être modifiée par l’utilisateur. La valeur peut être soit en dur, soit faire référence à un script ou à une variable de script.
  • EnableRichText {boolean} - Active les fonctionnalités de présentation dans les champs de saisie MultiLineString. Ces fonctionnalités permettent de modifier le style du texte, d’ajouter du gras, italique, … Dans ces champs il est important de prendre en compte la longueur des données de formatage qui sont insérées par le champ.
  • CanBeUsedForFilter {boolean} - Permet d’afficher ou masquer de champ dans les filtres qui sont de type ByDataFields ou ByDataFieldsAndGridView. Par défaut, cette valeur vaut true.
  • CanBeUsedForSelection {boolean} - Permet d’afficher ou masquer le champ dans les selections de champs des vues de dossier. A noter que si un field pointe vers un datafield TaskOnly, il n’apparaitra pas même si cet attribut est true Par défaut, cette valeur vaut true.
  • CanBeUsedForOperations {boolean} -
  • ForeignKeyField {string} - Permet de préciser quelle colonne doit être utilisée comme clé étrangère dans la grille ouverte pour la sélection lorsque l’utilisateur clique sur le bouton ‘Choisir’ dans un filtre (uniquement pour les champs au format ByForeignKey). Par défaut, le système va récupérer la première colonne dont le datafield contient _PK. Si cette valeur est précisée, la colonne précisée sera utilisée.
  • StrictForeignKey {boolean} -
  • Presentation {DataFieldPresentation} - Type de présentation du champ à l’écran. Valeurs possibles:
    • Link - Présentation sous forme d’hyperlien cliquable par l’utilisateur. Aucune donnée ne peut être saisie.
    • Memo - Présentation du champ de saisie sous forme de champ de saisie multiligne extensible.
    • Button - Présentation sous forme de bouton cliquable par l’utilisateur. Aucune donnée ne peut être saisie.
    • RadioButton - Présentation de la combo sous forme de liste à puces (radio button) sélectionnables.
    • FileName - Présentation sous forme de sélection de fichier avec hyperlien ouvrant une fenêtre de sélection.
    • Image - Présentation sous forme d’image. Aucune donnée ne peut être saisie.
    • CheckBox - Présentation de la combo ou du booléen sous forme de case à cocher.
    • Edit - Présentation par défaut d’un champ de saisie.
    • Icon - Présentation de la combo sous forme d’icone pouvant être sélectionnée. Fonctionne sur le web uniquemenent. L’icone est récupérée dans le champ Icon de la combo.
    • Mail - Un champ de type mail vérifie le format entré par l’utilisateur afin de garantir qu’il respecte le format général d’une adresse mail. Il permet également directement d’ouvrir l’application mail par défaut de l’appareil en cliquant sur la petite icône associée. Cette fonctionnalité est actuellement seulement disponible sur les devices mobiles.
    • Phone - Ce champ est géré à travers la librairie de gestion des indicatifs téléphoniques par pays. Ceci permet de garantir que le format de tous les téléphones sont bien formattés et préfixés de la même et bonne manière en fonction du pays. Cette fonctionnalité est actuellement seulement disponible sur les devices mobiles.
  • SingleOnAllRecords {boolean} - Pour les formats booléens, force une seule valeur à être active au travers de toutes les entrées présentes. Ceci permet l’activation d’une seule valeur à la fois au travers de la solution, étendant la fonctionnalité d’un bouton radio.
  • Existence {string} -
  • Silo {string} - Le silo permet de stocker les dernières valeurs saisies par l’utilisateur dans le champ. La valeur peut être soit un booléen true/false pour activer ou désactiver la fonctionnalité, soit un identifiant permettant de stocker l’historique de plusieurs champs dans un seul silo partagé, par exemple lorsque plusieurs champs sont destinés à recevoir les mêmes valeurs.
  • ScriptOnClick {string} - Lorsque l’utilisateur clique sur le champ, le script spécifié par la valeur de l’attribut sera appellé. Il pourra modifier les valeurs de l’écran ou effectuer des actions telles que télécharger un fichier ou poser des questions à l’utilisateur. Le script à appeler peut être soit inclu dans l’attribut pour des scripts simples, soit faire référence à un fichier de script dans le paramétrage ainsi qu’un libellé pour les scripts plus complexes.
  • NotificationOnClick {string} - Lorsque l’utilisateur clique sur le champ, la notification spécifiée par la valeur de l’attribut sera appellée
  • NotificationType {NotificationType} - Spécifie le type de notification à appeler dans le cas d’un NotificationOnClick. Valeurs possibles:
    • Local -
    • Remote -
  • RemoteTask {string} - Dans le cas d’un NotificationOnClick de type Remote, la tâche spécifiée sera utilisée pour l’appel.
  • RemoteArguments {string} - Dans le cas d’un NotificationOnClick de type Remote, les arguments spécifiés seront passés à la tâche lors de l’appel.
  • ShowDays {boolean} - Pour les champs de date, permet de définir si les jours doivent être affichés. Si cet attribut est à false, seul le mois et l’année peuvent être saisis. Par défaut, les jours sont affichés pour les formats date.
  • ShowSeconds {boolean} - Pour les champs de date, permet de définir si les secondes doivent être affichés. Par défaut, seules les heures et minutes sont affichées pour les formats de date avec heure.
  • Supremum {boolean} - Pour les champs au format Date sans affichage des jours, précise que le jour ajouté en interne doit être le dernier jour du mois et non pas le premier jour du mois. N’a aucun impact sur les autres types de champ ni sur les champs de date où le jour peut être précisé par l’utilisateur.
  • DisplayCode {EnumDisplayCode} - Spécifie le type d’affichage des éléments de la combo. Cet attribut n’est valide que sur les datafields de type Enum. Valeurs possibles:
    • CodeOnly - Affiche uniquement l’identifiant des éléments de la combo.
    • TextOnly - Affiche uniquement le texte des éléments de la combo.
    • CodeAndText - Valeur par défaut. Affiche à la fois l’identifiant de la combo et le texte.
  • DocumentTemplate {string} - Pour les boutons de document, spécifie le template qui doit être utilisé afin de générer le document qui sera ouvert à l’utilisateur. Le template doit exister dans UNI94 ou dans le paramétrage sinon l’utilisateur rencontrera une erreur lors de l’utilisation.
  • DocumentApplication {DocumentApplication} - Pour les boutons de document, spécifie l’application qui sera utilisée pour ouvrir le template. Cet attribut permet également de définir l’icône qui est présente sur le bouton. Valeurs possibles:
    • Word -
    • Excel -
  • DocumentPrintLanguage {string} - Pour les boutons de document, permet de définir la langue du document à récupérer pour générer le document présenté à l’utilisateur. Par défaut, la langue de l’utilisateur est utilisée. Cet attribut permet de définir la langue du document par exemple en fonction de la langue de la société ou du client pour lequel le document doit être généré.
  • BoolPresentInFilter {BooleanFilterPresence} - Permet de spécifier comment le filtre doit être généré par rapport à la valeur du boolean. Par défaut, cette valeur est PresentIfTrue, ce qui signifie que le prédicat est ajouté au filtre seulement si la checkbox et cochée. Valeurs possibles:
    • PresentIfTrue -
    • PresentIfFalse -
    • Always -
  • ShowDocumentSaveBtn {boolean} -
  • KeepDocumentVersions {boolean} -
  • AutoSaveDocument {boolean} -
  • ScriptLanguage {FormatScriptLanguage} - Pour les champs au format Script, permet de définir le langage utilisé afin d’activer la coloration syntaxique. Aucune vérification des données saisies n’est effectuée lorsqu’un langage est défini. Valeurs possibles:
    • JavaScript -
    • Script -
    • XML -
  • Protected {boolean} - Active le masquage des données saisies. Les données sont envoyées et récupérées normalement, seul l’affichage est impacté. Ainsi un traitement supplémentaire devrait être prévu si le champ contient un mot de passe ou autres données ne devant pas pouvoir être récupérées.
  • FileType {string} - Pour les champs au format “File”, permet de définir quels formats de fichier peuvent être sélectionnés dans l’explorateur de fichiers. Le format de cet attribut doit correspondre aux valeurs attendues par l’explorateur Windows. Par exemple HTML files (*.html)|*.htm;*.html ou BVR (*.xml,*.V11)|*.xml;*.V11|ZIP (*.zip)|*.zip.
  • ImageLimit {integer} -
  • IsMainPicture {boolean} -
  • ImageSource {string} -
  • Generic {boolean} - Pour les champs Button dans les tâches présentées en HistoryViewer, affiche le champ sur l’HistoryViewer. Permet de présenter des fonctionnalités liées aux événements affichés dans l’historique, en passant par les attributs ScriptOnClick ou CallOnClick par exemple.

Structure de base
Tâches simples
Tâches doubles