Sobre a edição de esquema about-schema-edition

A Adobe Campaign emprega esquemas de dados para:

Para obter uma melhor compreensão das tabelas integradas do Campaign e sua interação, consulte nesta seção.

Extensão ou criação de esquemas extending-or-creating-schemas

Para adicionar um campo, índice ou outro elemento a um dos esquemas de dados principais no Campaign, como a tabela de recipients (nms:recipient), é necessário estender esse esquema. Para obter mais informações, consulte Extensão de um schema seção.

Para adicionar um tipo de dados totalmente novo que não existe pronto para uso no Adobe Campaign (uma tabela de contratos, por exemplo), você pode criar um esquema personalizado diretamente. Para obter mais informações, consulte Esquemas de dados seção.

Depois de estender ou criar um esquema para trabalhar, a prática recomendada é definir seus elementos de conteúdo XML na mesma ordem em que aparecem abaixo.

Enumerações enumerations

As enumerações são definidas primeiro, antes do elemento principal do esquema. Eles permitem exibir valores em uma lista para restringir as opções que o usuário tem para um determinado campo.

Exemplo:

<enumeration basetype="byte" name="exTransactionTypeEnum" default="store">
<value label="Website" name="web" value="0"/>
<value label="Call Center" name="phone" value="1"/>
<value label="In Store" name="store" value="2"/>
</enumeration>

Ao definir campos, é possível usar essa enumeração da seguinte maneira:

<attribute desc="Type of Transaction" label="Transaction Type" name="transactionType"
type="string" enum="exTransactionTypeEnum"/>

Para saber mais sobre enumerações, consulte o Enumerações e <enumeration> element seções.

Índice index

Os índices são os primeiros elementos declarados no elemento principal do esquema.

Eles podem ser exclusivos ou não e fazer referência a um ou mais campos.

Exemplos:

<dbindex name="email" unique="true">
  <keyfield xpath="@email"/>
</dbindex>

<dbindex name="lastNameAndZip">
  <keyfield xpath="@lastName"/>
  <keyfield xpath="location/@zipCode"/>
</dbindex>

A variável xpath O atributo aponta para o campo no esquema que você deseja indexar.

Para obter mais informações sobre índices, consulte Campos indexados seção.

Chaves keys

Cada tabela deve ter pelo menos uma chave e, com frequência, é estabelecida automaticamente no elemento principal do esquema usando o @autopk=true atributo definido como "true".

A chave primária também pode ser definida usando o interno atributo.

Exemplo:

<key name="householdId" internal="true">
  <keyfield xpath="@householdId"/>
</key>

Neste exemplo, em vez de permitir que @autopk atributo criar uma chave primária padrão chamada "id" estamos especificando nossa própria chave primária "householdId".

Para saber mais sobre as teclas, consulte o Gerenciamento de chaves seção.

Atributos (Campos) attributes--fields-

Os atributos permitem definir os campos que compõem seu objeto de dados. Você pode usar o Insert botão na barra de ferramentas da edição do esquema para soltar modelos de atributos vazios no XML onde o cursor está. Para obter mais informações, consulte Esquemas de dados seção.

A lista completa de atributos está disponível no <attribute> element seção. Estes são alguns dos atributos usados com mais frequência:

Para obter mais informações sobre cada atributo, consulte a Descrição do atributo seção.

Exemplos examples

Exemplo de definição de um valor padrão:

<attribute name="transactionDate" label="Transaction Date" type="datetime" default="GetDate()"/>

Exemplo de uso de um atributo comum como modelo para um campo também marcado como obrigatório:

<attribute name="mobile" label="Mobile" template="nms:common:phone" required="true" />

Exemplo de um campo calculado que está oculto usando o @advanced atributo:

<attribute name="domain" label="Email domain" desc="Domain of recipient email address" expr="GetEmailDomain([@email])" advanced="true" />

Exemplo de um campo XML também armazenado em um campo SQL e que tem um @dataPolicy atributo.

<attribute name="secondaryEmail" label="Secondary email address" length="100" xml="true" sql="true" dataPolicy="email" />

Links links

Os links são alguns dos últimos elementos no elemento principal do esquema. Elas definem como todos os diferentes esquemas na sua instância se relacionam entre si.

Os links são declarados no esquema que contém a variável chave estrangeira da tabela à qual está vinculado.

Há três tipos de cardinalidade: 1-1, 1-N e N-N. É o tipo 1-N usado por padrão.

Exemplos examples-1

Um exemplo de um link 1-N entre a tabela do recipient (schema pronto para uso) e uma tabela de transações personalizadas:

<element label="Recipient" name="lnkRecipient" revLink="lnkTransactions" target="nms:recipient" type="link"/>

Um exemplo de um link 1-1 entre um schema personalizado "Car" (no namespace "cus") e a tabela de recipients:

<element label="Car" name="lnkCar" revCardinality="single" revLink="recipient" target="cus:car" type="link"/>

Exemplo de uma associação externa entre a tabela de recipients e uma tabela de endereços com base no endereço de email e não em uma chave primária:

<element name="emailInfo" label="Email Info" revLink="recipient" target="nms:address" type="link" externalJoin="true">
  <join xpath-dst="@address" xpath-src="@email"/>
</element>

Aqui, "xpath-dst" corresponde à chave primária no esquema de destino e "xpath-src" corresponde à chave externa no esquema de origem.

Trilha de auditoria audit-trail

Um elemento útil que você pode querer incluir na parte inferior do esquema é um elemento de rastreamento (Trilha de auditoria).

Use o exemplo abaixo para incluir campos relacionados à data de criação, ao usuário que criou os dados, à data e ao autor da última modificação para todos os dados na tabela:

<element aggregate="xtk:common:auditTrail" name="auditTrail"/>

Atualização da estrutura do banco de dados updating-the-database-structure

Depois que as alterações forem concluídas e salvas, qualquer alteração que possa afetar a estrutura SQL precisará ser aplicada ao banco de dados. Para fazer isso, use o assistente de atualização de banco de dados.

Para obter mais informações, consulte a seção Atualização da estrutura do banco de dados.