Struktura pliku XML i przykład

Uwagi na temat struktury plików XML:

  • System obcina początkowe spacje w nazwach atrybutów.
  • System czasami obcina początkowe spacje w wartościach atrybutów.
  • Należy używać małych liter dla wszystkich elementów i nazw atrybutów.
  • Użycie nieznanego elementu lub nazwy atrybutu powoduje niepowodzenie importu.

Poniższy przykład zawiera większość elementów struktury pliku XML.

<?xml version="1.0"?> <xml> <transactions> <transaction date="1196854268" type="wf_import_document_attributes" vaultname="przechowalnia plików 2008"> <document aliasset="" pdmweid="0" idattribute="Numer" id="89-NOAO-4200-1236" idcfgname=""> <configuration name=""> <attribute name="Koszt" value="0.44"/> <attribute name="ID artykułu" value="A-012-BB"/> </configuration> </document> </transaction> </transactions> </xml>

gdzie:

Element XML Opis i atrybuty
<?XML version="1.0"?> Plik musi rozpoczynać się od tego elementu.
<XML> Ten element opakowuje element transactions.
<transactions> Plik zawiera tylko jeden element transactions.
<transaction …> Plik może zawierać wiele elementów transaction.
Atrybuty:
date

Liczba sekund, które upłynęły od godziny 00:00 1 stycznia 1970 roku. Musi być liczbą całkowitą większą niż 0.
type

Oznacza, że transakcja zawiera dane, które należy zaimportować do plików lub elementów w przechowalni.

vaultname

Nazwa przechowalni, z którą jest powiązana dana transakcja. Reguła importu przetwarza transakcje z pasującą nazwą przechowalni.
aliasset

Zestaw aliasów, który ma być używany do wyszukiwania węzłów potomków atrybutów. Nazwy atrybutów w pliku XML są porównywane ze zmiennymi mającymi zmapowane aliasy.

Na przykład zestaw aliasów zawierający zmienną X2Numer z atrybutem NR w pliku XML jest skonfigurowany tak, aby odpowiadał zmiennej karty danych Numer.

Pusta wartość powoduje dopasowanie do zmiennych karty danych mających nazwy atrybutów w pliku XML.
<document …> Zawiera kryteria do porównywania importowanych wartości z plikiem lub elementem w przechowalni. Określa porównanie z unikatowym wewnętrznym identyfikatorem pliku lub elementu albo wartością zmiennej.
Atrybuty:
pdmweid

Porównuje transakcję z wewnętrznym atrybutem ID dokumentu z tabeli Dokumenty pliku lub elementu w bazie danych przechowalni.

W przypadku użycia tego atrybutu atrybuty [id], [idattribute] i [idcfgname] są ignorowane. Aby użyć innej techniki porównywania, należy ustawić wartość 0 lub pominąć ten atrybut.

idattribute

Zmienna karty danych lub jej alias, które mają zostać użyte do porównania z plikiem lub elementem w przechowalni.

Id

Wartość zmiennej, która ma zostać użyta przy wyszukiwaniu plików lub elementów. Wyszukuje wartość przy użyciu nazwy zmiennej idattribute i opcjonalnej konfiguracji idcfgname w tabeli bazy danych WartośćZmiennej.

Jeżeli pasuje wiele plików lub elementów, wartości są importowane dla wszystkich, ale zapisywane tylko dla tych, które przechodzą przez działanie przejścia importu.

idcfgname

Nazwa konfiguracji, o ile występuje, z którą należy porównać wartość zmiennej. Kiedy ten atrybut nie ma wartości, przy porównywaniu są uwzględniane wszystkie konfiguracje pliku.
<configuration …> Konfiguracja karty danych pliku, która ma zostać zaktualizowana wartościami atrybutów. Kiedy ten atrybut nie ma wartości, aktualizowane są wszystkie konfiguracje.

Aby zaimportować różne wartości do różnych konfiguracji, należy utworzyć wiele elementów konfiguracji.

Atrybut:
name
<attribute …>
Atrybuty:
name

Nazwa zmiennej karty danych, która ma zostać zaktualizowana, w formie AliasZmiennej.Alias lub Zmienna.NazwaZmiennej .
value

Wartość, która ma zostać użyta podczas konfigurowania określonej zmiennej. Nie może przekraczać 1024 znaków.