elemento attributo

Modello di contenuto

attribute:==help

Attributi

_operation (stringa), advanced (booleano), applyIf (stringa), autoIncrement (booleano), membersTo (stringa), dataPolicy (stringa), dbEnum (stringa), defOnDuplicate (booleano), default (stringa), desc (stringa), enum (stringa), expr (stringa), feature (stringa), feature (stringa), featureDate (booleano) img (stringa), inout (stringa), label (stringa), length (stringa), localizable (booleano), name (MNTOKEN), notNull (booleano), pkgStatus (stringa), ref (stringa), Required (booleano), sqlDefault (stringa), sqlname (stringa), sqltable (stringa), target (mltable) NTOKEN), template (stringa), translateDefault (stringa), translateExpr (stringa), type (MNTOKEN), user (booleano), userEnum (stringa), visibleIf (stringa), xml (booleano)

Genitori

<element>

Bambini

<help>

Descrizione

<attribute> consentono di definire un campo nel database.

Utilizzo e contesto di utilizzo

<attribute> gli elementi devono essere dichiarati in un <element> elemento.

La sequenza in cui gli elementi <attribute> sono definiti in un <srcschema> non influenza la sequenza di creazione del campo nel database. La sequenza di creazione sarà in ordine alfabetico.

Descrizione attributo

  • _operation (stringa): definisce il tipo di scrittura nel database.

    Questo attributo è utilizzato principalmente per estendere gli schemi out-of-the-box.

    I valori accessibili sono:

    • "none": solo riconciliazione. Ciò significa che Adobe Campaign recupererà l'elemento senza aggiornarlo o generando un errore in caso contrario.
    • "insertOrUpdate": aggiornamento con inserimento. Ciò significa che Adobe Campaign aggiornerà l'elemento o lo creerà se non esiste.
    • "insert": inserimento. Ciò significa che Adobe Campaign inserirà l'elemento senza verificarne l'esistenza.
    • "update": update. Ciò significa che Adobe Campaign aggiornerà l'elemento o genererà un errore se non esiste.
    • "delete": eliminazione. Ciò significa che Adobe Campaign recupererà ed eliminerà gli elementi.
  • advanced (booleano): quando questa opzione è attivata (@advanced="true"), consente di nascondere l'attributo nell'elenco dei campi disponibili, accessibili per configurare un elenco in un modulo.

  • applyIf (stringa): questo attributo consente di rendere facoltativi i campi. L'elemento <attribute> verrà preso in considerazione durante l'aggiornamento del database quando il vincolo viene rispettato. "applyIf" riceve un'espressione XTK.

  • autoIncrement (booleano): se questa opzione è attivata, il campo diventa un contatore. Questo consente di incrementare un valore (per la maggior parte ID). (uso esterno)

  • membersTo (stringa): prende il nome e lo spazio dei nomi della tabella che condivide il campo e compila lo schema in cui è dichiarato l'attributo. (utilizzato solo in un <schema>).

  • dataPolicy (stringa): consente di specificare i vincoli di approvazione per i valori consentiti nel campo SQL o XML. I valori per questo attributo sono:

    • "none": nessun valore
    • "smartCase": lettere maiuscole
    • "lowerCase": Tutte le maiuscole
    • "UpCase": maiuscolo
    • "email": indirizzo e-mail
    • "phone": numero di telefono
    • "identifier": nome identificatore
    • "resIdentifier": nome file
  • dbEnum (stringa): riceve il nome interno di un'enumerazione "chiusa". I valori di enumerazione devono essere definiti in <srcschema>.

  • defOnDuplicate (booleano): se questo attributo è attivato, quando un record viene duplicato, il valore predefinito (definito in @default) viene automaticamente applicato di nuovo al record.

  • default (string): consente di definire il valore del campo predefinito (chiamata a una funzione, valore predefinito). Questo attributo riceve un'espressione XTK.

  • desc (stringa): consente di inserire una descrizione dell'attributo. Questa descrizione viene visualizzata nella barra di stato dell'interfaccia.

  • edit (stringa): questo attributo specifica il tipo di input che verrà utilizzato nel modulo collegato allo schema.

  • enum (stringa): riceve il nome dell'enumerazione collegata al campo. L'enumerazione può essere inserita nello stesso schema o in uno schema remoto.

  • expr (stringa): definisce un'espressione di precalcolo dei campi. Questo attributo riceve un'espressione Xpath o XTK.

  • feature (stringa): definisce un campo delle caratteristiche: Questi campi vengono utilizzati per estendere i dati in una tabella esistente, ma con memorizzazione in una tabella allegata. I valori accettati sono:

    • "shared": il contenuto è memorizzato in una tabella condivisa per tipo di dati
    • "dedicato": il contenuto è memorizzato in una tabella dedicata

    Le tabelle delle caratteristiche SQL vengono create automaticamente in base al tipo di caratteristica:

    • dedicato: 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]

    Esistono due tipi di campi di caratteristiche: campi semplici "oà¹" in cui è autorizzato un singolo valore per la caratteristica, e campi di scelta multipla "oà¹", in cui la caratteristica è collegata a un elemento di raccolta che può contenere più valori.

    Quando una caratteristica è definita in uno schema, questo schema deve avere una chiave principale basata su un singolo campo (le chiavi composite non sono autorizzate).

  • featureDate (booleano): attributo collegato al campo delle caratteristiche "@feature". Se il valore è "true", è possibile verificare l’ultimo aggiornamento del valore.

  • img (stringa): consente di definire un percorso per un’immagine collegata a un campo (namespace + nome immagine) (esempio: img="cus:mypicture.jpg"). Fisicamente, l'immagine deve essere importata nel server dell'applicazione.

  • label (stringa): etichetta collegata al campo, destinata principalmente all'utente nell'interfaccia. Consente di evitare i vincoli di denominazione.

  • length (stringa): max numero di caratteri per un valore del campo SQL di tipo "stringa". Se l'attributo "@length" non è specificato, Adobe Campaign crea automaticamente un campo per 255 caratteri.

  • localizzabile (booleano): se è attivato, questo attributo indica allo strumento di raccolta di recuperare il valore dell'attributo "@label" per la traduzione (uso interno).

  • name (MNTOKEN): nome dell'attributo che corrisponderà al nome del campo nella tabella. Il valore dell'attributo "@name" deve essere breve, preferibilmente in inglese, e conforme ai vincoli di denominazione XML.

    Quando lo schema viene scritto nel database, i prefissi vengono aggiunti automaticamente al nome del campo da Adobe Campaign:

    • "i": prefisso per il tipo 'integer'.
    • "d": per il tipo 'double'.
    • "s": per il tipo di stringa del carattere.
    • "t": per il tipo 'date'.

    Per definire completamente il nome del campo nella tabella, utilizzate l'opzione "@sqlname" quando definite un attributo.

  • notNull (booleano): consente di ridefinire comportamento di Adobe Campaign per quanto riguarda la gestione dei record NULL nel database. Per impostazione predefinita, i campi numerici non sono null e i campi stringa e tipo data possono essere null.

  • pkgStatus (stringa): durante le esportazioni del pacchetto, i valori vengono presi in considerazione a seconda del valore di "@pkgStatus":

    • "always": always present
    • "never": never
    • "default (or nothing)": il valore viene esportato tranne se è il valore predefinito o se non è un campo interno che non sarebbe compatibile con altre istanze.
  • ref (stringa): questo attributo definisce un riferimento a un <attribute> elemento condiviso da più schemi (factoring di definizione). La definizione non viene copiata nello schema corrente.

  • obbligatorio (booleano): se questo attributo è attivato (@requirements="true"), il campo è evidenziato nell'interfaccia. L'etichetta del campo sarà rossa nei moduli.

  • sql (booleano): se questo attributo è attivato (@sql="true"), forza l'archiviazione dell'attributo SQL, anche quando l'elemento che contiene l'attributo ha la proprietà xml="true".

  • sqlDefault (stringa): questo attributo consente di definire il valore predefinito preso in considerazione per l'aggiornamento del database se l'attributo @notNull è attivato. Se questo attributo viene aggiunto dopo la creazione dell'attributo, il comportamento dello schema non verrà modificato nemmeno per i nuovi record. Per modificare lo schema e aggiornare il valore dei nuovi record, è necessario eliminare e creare nuovamente l'attributo.

  • sqlname (stringa): del campo durante la creazione della tabella. Se @sqlname non è specificato, per impostazione predefinita viene utilizzato il valore dell'attributo "@name". Quando lo schema viene scritto nel database, i prefissi vengono aggiunti automaticamente a seconda del tipo di campo.

  • template (stringa): questo attributo definisce un riferimento a un <attribute> elemento condiviso da più schemi. La definizione viene copiata automaticamente nello schema corrente.

  • translateDefault (stringa): se viene trovato un attributo "@default", l'attributo "@translateDefault" consentirà di ridefinire un'espressione che corrisponda a quella definita in @default, che verrà raccolta dallo strumento di traduzione (uso interno).

  • translateExpr (stringa): se è presente un attributo "@expr", l'attributo "@translateExpr" consente di ridefinire un'espressione che corrisponda a quella definita in @expr, da raccogliere con lo strumento di traduzione (uso interno).

  • type (MNTOKEN): tipo di campo.

    I tipi di campo sono generici. A seconda del tipo di database installato, Adobe Campaign modifica il tipo definito in un valore specifico per il database installato durante l'aggiornamento della struttura.

    Elenco dei tipi disponibili:

    • QUALSIASI
    • bin
    • blob
    • boolean
    • byte
    • CDATA
    • datetime
    • datetimetz
    • datetimenotz
    • date
    • double
    • enum
    • float
    • html
    • int64
    • link
    • long
    • promemoria
    • MNTOKEN
    • percentuale
    • primarykey
    • short
    • string
    • orario
    • periodo
    • uuid

    Se l'attributo "@type" viene lasciato vuoto, per impostazione predefinita Adobe Campaign collegherà al campo una stringa di caratteri (STRING) con una lunghezza pari a 100.

    Se il campo è di tipo STRING e il nome del campo non è specificato dalla presenza dell'attributo "@sqlname", il nome del campo nel database sarà automaticamente preceduto da un nome 's'. Questa modalità operativa sarà simile a quella dei campi INTEGER (i), DOUBLE (d) e DATES (ts).

  • userEnum (stringa): riceve il nome interno di un'enumerazione "open". I valori dell'enumerazione possono essere definiti dall'utente nell'interfaccia.

  • visibleIf (stringa): definisce una condizione sotto forma di espressione XTK per mostrare o nascondere l'attributo.

    IMPORTANTE

    L'attributo è nascosto, ma è comunque possibile accedervi.

  • xml (booleano): se questa opzione è attivata, i valori del campo non hanno un campo SQL collegato. Adobe Campaign crea un campo di tipo Testo "mData" per la memorizzazione dei record. Ciò significa che non è possibile filtrare o ordinare i campi.

Esempi

Esempio di valori di enumerazione i cui valori sono memorizzati nel database:

    <enumeration name="myEnum">
       <value name="One" value="1"/>
       <value name="Two" value="2"/>
    </enumeration>

    <element label="Sample" name="Sample">
       <attribute dbEnum="myEnum" length="100" name="Number" required="true" type="string"/>
    </element>     

Dichiarazione di un campo XML con "@datapolicy":

<attribute dataPolicy="phone" desc="Mobile number" label="Mobile"
     length="32" name="mobilePhone" sqlname="sMobilePhone" type="string"/>

Esempio con un "@applyIf": l'attributo "contains" sarà creato solo se il numero di paesi è maggiore di 20.

<attribute length="100" name="Continent" type="string" applicableIf="@country > 20"/>

Esempio con "@feature" di tipo "condiviso":

<attribute name="field1" label="Field 1" type="long" feature="shared"/>
<attribute name="field1" label="Field 1" type="long" feature="shared" sqlname="126" sqltable="Ft_Content_Long"/>

Esempio con "@feature" di tipo "dedicato":

<attribute name="field1" label="Field 1" type="long" feature="dedicated"/>
<attribute name="field1" label="Field 1" type="long" feature="dedicated" sqlname="sField1" sqltable="Ft_recipient_field1"/>

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now