é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.Cela signifie qu’Adobe Campaign récupérera l’élément sans le mettre à jour ou renverra une erreur s’il n’existe pas.
    • « insertOrUpdate » : mise à jour avec insertion.Cela signifie qu’Adobe Campaign mettra à jour l’élément ou le créera s’il n’existe pas.
    • « insert » : insertion.Cela signifie qu’Adobe Campaign insérera l’élément sans vérifier s’il existe.
    • « update » : mise à jour.Cela signifie qu’Adobe Campaign mettra à jour l’élément ou renverra une erreur s’il n’existe pas.
    • « delete » : suppression.Cela signifie qu’Adobe Campaign retrouvera et supprimera 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 « espace de noms:name ».

  • applicableIf (string) : condition d’application de l’index.Cet attribut reçoit une expression XTK.

  • autopk (boolean) : si cette option est activée (autopk=“true”), 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 ne garantit que l’unicité de la clé générée,et non le fait que les valeurs de clé soient consécutives et incrémentielles.

  • dataPolicy (string) : permet de préciser des contraintes de validation sur les valeurs permises dans le champ SQL.Les valeurs pour cet attribut sont les suivantes :

    • “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ée au champ.L’énumération peut être insérée dans le même schéma ou dans un schéma distant.

  • 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 (string).

  • externalJoin (boolean): jointure externe dans un élément de type “link”.

  • feature (string) : définit un champ de caractéristiques. Ces champs 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 les suivantes :

    • “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 sont stockées 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 type « nom d’espace de noms:image ».Par exemple : img=“cus:myImage.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) : nombrede 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 correspond 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 auto-incré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 à un élément partagé par plusieurs schémas (factorisation des définitions).La définition n’est pas copiée dans le schéma actuel.

  • required (boolean) : si cet attribut est activé (@required=“true”), le champ est mis en évidence dans l’interface.Le libellé du champ est affiché en rouge dans les formulaires.

  • 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 valeurs de l’attribut « @integrity » sont autorisées.Par défaut, Adobe Campaign attribue 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 spécifié, la valeur de l’attribut « @name » est utilisée par défaut.Lors de l’écriture du schéma dans la table, des préfixes seront automatiquement ajouté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 des tables.Cet attribut est uniquement actif pour les éléments 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 ou l’utilisatrice dans l’interface.

  • xml (boolean) : si cette option est activée, l’ensemble des valeurs définies dans l’élément sont stockées en XML dans un champ « mData » de type TEXT.En conséquence, il n’y a ni filtrage ni 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>

recommendation-more-help
campaign-classic-help