Estrutura e exemplo de arquivo

Observações sobre a estrutura de arquivos XML:

  • O sistema remove os espaços à esquerda nos nomes de atributos.
  • O sistema algumas vezes remove os espaços à esquerda nos valores de atributos.
  • Use minúsculas em todos os elementos e nomes de atributos.
  • O uso de um elemento ou nome de atributo desconhecido provoca a falha da importação.

O exemplo a seguir descreve a maioria dos aspectos da estrutura de um arquivo XML.

<?xml version="1.0"?> <xml> <transactions> <transaction date="1196854268" type="wf_import_document_attributes" vaultname="2008 file vault"> <document aliasset="" pdmweid="0" idattribute="Number" id="89-NOAO-4200-1236" idcfgname=""> <configuration name=""> <attribute name="Cost" value="0.44"/> <attribute name="ArticleID" value="A-012-BB"/> </configuration> </document> </transaction> </transactions> </xml>

onde:

Elemento XML Descrição e atributos
<?XML version="1.0"?> O arquivo precisa começar com este elemento.
<XML> Este elemento amarra o elemento transactions.
<transactions> O arquivo contém somente um elemento transactions.
<transaction …> O arquivo contém vários elementos transactions.
Atributos:
date

O número de segundos decorridos deste 12:00, 1º de janeiro de 1970 precisa ser um número inteiro maior que 0.
type

Indica que a transação contém dados a serem importados em arquivos ou itens no vault.

Vaultname

O nome do vault ao qual esta transação está relacionada. A regra de importação processa as transações com um nome de vault correspondente.
Aliasset

O conjunto de alias a ser usado para procurar os nós de atributo filhos. Os nomes dos atributos no arquivo XML são comparados com a variável mapeada por alias.

Por exemplo, um conjunto de alias contendo a variável X2Number com o atributo NR no arquivo XML é configurado para corresponder à variável de cartão de dados Number.

Um valor em branco corresponde às variáveis de cartão de dados com os nomes de atributos no arquivo XML.
<document …> Contém os critérios para comparar os valores importados com um arquivo ou item no vault. Compara o ID interno exclusivo de um arquivo ou item, ou o valor de uma variável.
Atributos:
Pdmweid

Compara a transação com o DocumentID interno da tabela Documents de um arquivo ou item no banco de dados do vault.

Quando você usa este atributo, [id], [idattribute] e [idcfgname] são ignorados. Para usar outra técnica de comparação, defina o valor como 0 ou omita este atributo.

Idattribute

A variável de cartão de dados ou alias a ser usado para comparar um arquivo ou item no vault.

Id

Valor de variável a ser usado na procura por arquivos ou itens. Procura o valor usando o nome da variável, idattribute, e a configuração opcional, Idcfgname, na tabela de banco de dados VariableValue.

Se forem encontrados vários arquivos ou itens correspondentes, os valores são importados para todos, mas são gravados somente naqueles que passam pela ação de transição de importação.

Idcfgname

O nome da configuração, se houver, com a qual comparar o valor da variável. Se este atributo não tiver um valor, todas as configurações de um arquivo serão consideradas para a comparação.
<configuration …> A configuração do cartão de dados do arquivo a ser atualizada com os valores do atributo. Se este atributo não tiver um valor, todas as configurações serão atualizadas.

Crie vários elementos de configuração para importar diferentes valores para deferentes configurações.

Atributo:
nome
<attribute …>
Atributos:
nome

O nome da variável de cartão de dados a ser atualizada, no formato VariableAlias.Alias ou Variable.VariableName .
value

O valor a ser usado na definição da variável especificada. Não pode exceder 1024 caracteres.