élément element element--element
Modèle de contenu content-model-4
element:==(attribute | compute-string | dbindex | default | element | help | join | key | sysFilter | translatedDefault)
Attributs attributes-4
_operation (string), advanced (boolean), aggregate (string), applicableIf (string), autopk (boolean), belongsTo (string), convDate (string), dataPolicy (string), dataSource (string), dbEnum (string), defOnDuplicate (boolean), default (string), desc (string), displayAsField (boolean), doesNotSupportDiff (boolean), edit (string), emptyKeyValue (string), enum (string), enumImage (string), expandSchemaTarget (string), expr (string), externalJoin (boolean), feature (string), featureDate (boolean), filterPath (string), folderLink (string), folderModel (string), folderProcess (string), fullLoad (boolean), hierarchical (boolean), hierarchicalPath (string), img (string), inout (string), integrity (string), label (string), labelSingular (string), length (string), localizable (boolean), name (MNTOKEN), noDbIndex (boolean), noKey (boolean), ordered (boolean), overflowtable (boolean), pkSequence (string), pkgStatus (string), ref (string), required (boolean), revAdvanced (boolean), revCardinality (string), revDesc (string), revExternalJoin (boolean), revIntegrity (string), revLabel (string), revLink (string), revTarget (string), revVisibleIf (string), sql (boolean), sqlname (string), sqltable (string), tableSpace (string), tableSpaceIndex (string), target (MNTOKEN), template (string), temporaryTable (boolean), translatedDefault (string), translatedExpr (string), type (MNTOKEN), unbound (boolean), user (boolean), userEnum (string), visibleIf (string), xml (boolean), xmlChildren (boolean)
Parents parents-4
<srcschema>
<element>
Enfants children-4
<attribute>
<compute-string>
<dbindex>
<default>
<element>
<help>
<join>
<key>
<sysfilter>
<translateddefault>
Description description-4
Il existe quatre types d'élément <element>
dans Adobe Campaign.
- Racine
<element>
: définit le nom SQL de la table qui correspond au schéma. - Structure
<element>
: définit un groupe d’éléments<element>
ou<attribute>
. - Lien
<element>
: définit un lien. Ces éléments doivent inclure l’attribut « @type=link ». - XML
<element>
: définit un champ de type Texte « mData ». Cet élément doit inclure l’attribut « @type=xml ».
Description des attributs attribute-description-4
-
_operation (string): définit le type d'écriture dans la base.
Cet attribut est principalement utilisé lors d'une extension de schéma usine.
Les valeurs accessibles sont:
- "none" : Réconciliation seule. Signifie qu'Adobe Campaign va retrouver l'élément sans le mettre à jour ou générer une erreur s'il n'existe pas.
- "insertOrUpdate" : Mise à jour avec insertion. Signifie qu'Adobe Campaign va mettre à jour l'élément ou le créer s'il n'existe pas.
- "insert" : Insertion. Signifie qu'Adobe Campaign va insérer l'élément sans vérifier s'il existe.
- "update" : Mise à jour. Signifie qu'Adobe Campaign va mettre à jour l'élément ou générer une erreur s'il n'existe pas.
- "delete" : Suppression. Signifie qu'Adobe Campaign va retrouver et supprimer l'élément.
-
advanced (boolean): quand cette option est activée (@advanced="true"), elle permet de masquer l'élément dans la liste des champs disponibles et accessibles pour la configuration d'une liste dans un formulaire.
-
aggregate (string) : vous permet de copier la définition d’un
<element>
via un autre schéma. Cet attribut reçoit une déclaration de schéma sous la forme d’un « namespace:name ». -
applicableIf (string): condition d'applicabilité de l'élément. Cet attribut reçoit une expression XTK.
-
autopk (boolean): si cette option est activée (autopk="true"), alors une clé unique est automatiquement définie. Cette option ne peut être utilisée que sur l'élément principal du schéma. Attention, Adobe Campaign donne seulement la garantie que la clef générée est unique. Le fait que les valeurs des clefs soient consécutives et incrémentales n'est pas assuré.
-
dataPolicy (string): permet de préciser des contraintes de validation sur les valeurs permises dans le champ SQL, les valeurs pour cet attribut sont :
- "none" : pas de valeur
- "smartCase": premières lettres en majuscule
- "lowerCase": tout en minuscule
- "upperCase": tout en majuscule
- "email" : adresse email
- "phone": numéro de téléphone
- "identifier": nom d'identifiant
- "resIdentifier": nom de fichier
-
dbEnum (string): reçoit le nom interne d'une énumération "fermée". Les valeurs de l'énumération doivent être définies dans le
<srcschema>
. -
defOnDuplicate (boolean): si cet attribut est activé, lors de la duplication d'un enregistrement, la valeur par défaut (définie dans "@default") est réappliquée automatiquement à l'enregistrement.
-
default (string): permet de définir le comportement de l'élément (appel à une fonction, valeur par défaut). Cet attribut reçoit une expression XTK.
-
desc (string): permet d'insérer une description de l'élément. Cette description est utilisée pour comprendre l’élément et son utilisation. Vous pouvez l’afficher dans le formulaire.
-
displayAsField (boolean) : si cet attribut est activé, un
<element>
de type « link » s’affiche sous forme de champ dans l’arborescence des schémas (onglet « Structure »). De cette façon, il est possible d'afficher un lien en tant que champ local et de modifier son comportement pendant une requête. Lorsque l'élément est trouvé dans le SELECT d'une requête, la valeur de la cible du lien est utilisée. Lorsque l’élément est trouvé dans le WHERE d’une requête, la clé sous-jacente du lien est utilisée. -
edit (string): cet attribut précise le type d'input qui sera utilisé dans le formulaire associé à l'élément du schéma en cours de définition.
-
enum (string): reçoit le nom de l'énumération associé au champ. L'énumération peut être insérée dans le même schéma ou bien dans un schéma distant. L'énumération définie une liste fermée de valeurs.
-
expr (string) : cet attribut définit un champ calculé dont la définition n’est pas stockée dans la table. Il reçoit un Xpath ou une expression XTK.
-
externalJoin (boolean): jointure externe dans un élément de type "link".
-
feature (string): définit un champ de caractéristiques. Les champs de caractéristiques sont utilisés pour étendre les données d'une table existante, mais avec un stockage déporté dans une table annexe. Les valeurs acceptées sont :
- "shared" : le contenu est stocké dans une table partagée par type de données
- "dedicated" : le contenu est stocké dans une table dédiée
Les tables SQL de caractéristiques sont construites automatiquement en fonction du type de la caractéristique :
- dédié :
Ft_[name_of_the_schema_containing_the_characteristic]_[name_of_the_characteristic]
- shared:
Ft_[type_of_key_of_the_schema_containing_the_characteristic]_[type_of_the_characteristic]
Deux types de champs de caractéristiques sont disponibles : les champs simples où une seule valeur est autorisée sur la caractéristique et les champs à choix multiples où la caractéristique est associée à un élément de collection qui peut donc contenir plusieurs valeurs.
Lorsque une caractéristique est définie dans un schéma, ce schéma doit comporter une clef principale basé sur un seul champ (clef composite non autorisée).
-
featureDate (boolean): attribut associé au champ de caractéristiques "feature", si sa valeur est "true", il permet de connaître la date de la dernière mise à jour de la valeur.
-
filterPath (string) : cet attribut reçoit un Xpath et permet de définir un filtre sur un champ.
-
folderLink (string): cet attribut reçoit le nom du lien qui permet de retrouver les dossiers dans lesquels sont stockés les entités.
-
folderModel (string): définit le type de dossier permettant le stockage des entités. Cet attribut n'est défini que si "@folderLink" est présent.
-
folderProcess (string): définit le lien dans lequel est stocké les instances des modèles des entités. Cet attribut n'est défini que si "@folderLink" est présent.
-
fullLoad (boolean): cet attribut force l'affichage de tous les enregistrements d'une table lors de la sélection du champ dans un formulaire.
-
img (string): reçoit le chemin d'une image associée a l'élément. La valeur de cet attribut est de la forme "namespace:nom de l'image". Exemple : img="cus:monImage.jpg". Physiquement l'image doit être importée sur le serveur applicatif.
-
integrity (string): intégrité référentielle de l'occurrence de la table source envers la table cible.
Les valeurs accessibles sont:
- "define" : Adobe Campaign ne supprime pas l'entité si elle est référencée à partir du lien
- "normal" : la suppression de l'occurrence source initialise les clés du lien sur l'occurrence cible (mode par défaut), ce type d'intégrité initiliase toutes les clés étrangères
- "own" : la suppression de l'occurrence source entraîne la suppression de l'occurrence cible
- "owncopy" : similaire à "own" (en cas de suppression) ou duplique les occurrences (en cas de duplication)
- "neutral" : ne fait rien
-
label (string): libellé de l'élément.
-
labelSingular (string): libellé au singulier de l'élément ; utilisé dans certaines parties de l'interface.
-
length (string): nombre de caractères maximal autorisés pour une valeur du champ SQL de type "STRING".
-
localizable (boolean): s'il est activé, cet attribut indique à l'outil de collecte de récupérer la valeur de l'attribut "@label" pour traduction (usage interne).
-
name (MNTOKEN): nom interne de l'élément qui correspondra au nom de la table. La valeur de l'attribut "@name" doit être courte, de préférence en anglais et elle doit respecter les contraintes de nommage liées au XML.
Lors de l'écriture du schéma en base, des préfixes sont automatiquement rajoutées par Adobe Campaign au nom du champ.
- "i" : préfixe pour le type 'entier'.
- "d" : préfixe pour le type 'double'.
- "s" : préfixe pour le type chaine de caractère.
- "ts" : préfixe pour le type 'date'.
Pour définir de manière autonome le nom de la table, il faut utiliser l'attribut "@sqltable" dans la définition de l'élément principal du schéma.
-
noDbIndex (boolean): permet de préciser que l'élément ne sera pas indexé.
-
ordered (boolean): si l'attribut est activé (ordered="true"), Adobe Campaign maintient l'ordre de déclaration des éléments dans un élément de collection XML.
-
pkSequence (string): reçoit le nom de la séquence à utiliser pour le calcul d'une clef auto-incrémentale. Cet attribut n'est utilisable que si une clef autoincrémentale est définie sur l'élément racine du schéma.
-
pkgStatus (string): durant l'export de package, les valeurs seront prises en compte ou non en fonction de la valeur de cet attribut :
- "always" : l'élément sera toujours présent
- "never" : l'élément ne sera jamais présent
- "default (ou rien)" : l'élement est exporté sauf si c'est l'élément par défaut ou bien si ce n'est pas un champ interne qui ne serait pas compatible entre instances
-
ref (string) : cet attribut définit une référence vers un élément <element> partagé par plusieurs schémas (factorisation des définitions). La définition n'est pas recopiée dans le schéma courant.
-
required (boolean): si cet attribut est activé (@required="true"), le champ est mis en avant dans l'interface. Le label du champ est affiché en rouge dans un formulaire.
-
revAdvanced (boolean): s'il est activé, cet attribut précise que le lien inverse est de type "advanced".
-
revCardinality (string) : cet attribut définit la cardinalité d'un lien entre deux tables. Il est utilisé dans un
<element>
de type "link".Les valeurs possibles sont les suivantes :
- "single" : Lien simple de type 1-1
- "unbound" : Lien de collection de type 1-N
Par défaut, si l'attribut n'est pas précisé lors de la création du lien, la cardinalité est de type 1-N.
-
revDesc (string): cet attribut reçoit une description associée au lien inverse.
-
revExternalJoin (boolean): s'il est activé, cet attribut permet de forcer la jointure externe sur le lien inverse.
-
revIntegrity (string): cet attribut définit l'intégrité sur le schéma cible. Les mêmes valeurs que l'attribut "@integrity" sont autorisés. Par défaut, Adobe Campaign donne la valeur "normal" à cet attribut.
-
revLabel (string): libellé du lien inverse.
-
revLink (string) : nom du lien inverse. Si la valeur est "NONE", aucun lien inverse ne sera créé dans le schéma destination.
-
revTarget (string): cible du lien inverse.
-
sql (boolean): si cet attribut est activé (@sql="true"), il force le stockage de l'élément en SQL même lorsque l'élément a la propriété xml="true".
-
sqlname (string): nom du champ lors de la création de la table. Si "@sqlname" n'est pas précisé la valeur de l'attribut "@name" est pris par défaut. Lors de l'écriture du schéma en table des préfixes seront automatiquement rajoutés en fonction du type du champ.
-
sqltable (string): pour l'élément principal du schéma, cet attribut surcharge le nom de la table SQL généré par défaut. Si "@sqltable" n'est pas précisé le nom par défaut est de la forme: espace de noms (avec la première lettre en majuscule) et la valeur du "@name" du SrcSchema.
-
tableSpace (string) : cet attribut permet de spécifier un nouveau tablespace de stockage de données pour une table (valable sur l’élément
<element>
racine). -
tableSpaceIndex (string) : cet attribut permet de spécifier un nouveau tablespace de stockage des index pour une table (valable sur l'élément
<element>
racine). -
target (MNTOKEN): reçoit le nom du schéma cible lors de la création d'un lien entre tables. Cet attribut n'est actif que si l'élément est de type "link".
-
template (string) : cet attribut définit une référence à un élément
<element>
partagé par plusieurs schémas. La définition est automatiquement copiée dans le schéma actuel. -
translatedDefault (string): si un attribut "@default" est présent, l'attribut "@translatedDefault" permet de redéfinir une expression, correspondante de l'expression définie dans "@default", qui sera collectée par l'outil de traduction (usage interne).
-
translatedExpr (string): si un attribut "@expr" est présent, l'attribut "@translatedExpr" permet de redéfinir une expression, correspondante de l'expression définie dans "@expr", qui sera collectée par l'outil de traduction (usage interne).
-
type (MNTOKEN): définit le type des données stockées dans l'élément.
Liste des types disponibles :
- ANY
- bin
- blob
- boolean
- byte
- CDATA
- datetime
- datetimetz
- datetimenotz
- date
- double
- enum
- float
- html
- int64
- link
- long
- memo
- MNTOKEN
- percent
- primarykey
- short
- string
- time
- timespan
- uuid
-
unbound (boolean): si l'attribut est activé (unbound="true"), le lien est déclaré comme élément de collection pour une cardinalité 1-N.
-
userEnum (string): reçoit le nom interne d'une énumération "ouverte". Les valeurs de l'énumération peuvent être définies par l'utilisateur dans l'interface.
-
xml (boolean): si cette option est activée, l'ensemble des valeurs définies dans l'élément seront stockées en XML dans un champ "mData" de type TEXT. En conséquence, il n'y a pas de filtrage ni de tri sur ces champs.
-
xmlChildren (booléen) : force le stockage pour chaque enfant (
<element> or <attribute> ) of the <element> element in an XML document. </element> </attribute> </element>