Import-Regeln für Listen

Import-Regeln für Listen#

Sie können benutzerdefinierte Listen in XML-Dateien exportieren und benutzerdefinierte Listen aus XML-Dateien importieren. Es gibt einige Regeln für den Importvorgang, wenn bereits vorhandene Listen importiert werden.

XML-Format#

Die folgende Auflistung zeigt einen XML-Export für eine kaskadierte Optionsliste mit zwei Hauptoptionen (EMEA und Amerika).

<?xml version='1.0' encoding='UTF-8'?>
<ns2:trackplusExchange xmlns:ns2="http://www.trackplus.com/exporter/" version="4.0.0">
    <entityExchange entityId="1002" type="TListBean">
        <entityAttribute name="name"><![CDATA[Customer List]]></entityAttribute>
        <entityAttribute name="repositoryType"><![CDATA[2]]></entityAttribute>
        <entityAttribute name="objectID"><![CDATA[1002]]></entityAttribute>
        <entityAttribute name="description"><![CDATA[A list with customers]]></entityAttribute>
        <entityAttribute name="listType"><![CDATA[3]]></entityAttribute>
        <entityAttribute name="owner"><![CDATA[1]]></entityAttribute>
        <entityAttribute name="deleted"><![CDATA[N]]></entityAttribute>
        <subEntityRelation parentAttributeName="list" type="TOptionBean">
            <trackEntity entityId="1004" type="TOptionBean">
                <entityAttribute name="label"><![CDATA[Americas]]></entityAttribute>
                <entityAttribute name="CSSSTyle"><![CDATA[]]></entityAttribute>
                <entityAttribute name="symbol"/>
                <entityAttribute name="objectID"><![CDATA[1004]]></entityAttribute>
                <entityAttribute name="isDefault"><![CDATA[N]]></entityAttribute>
                <entityAttribute name="sortOrder"><![CDATA[2]]></entityAttribute>
                <entityAttribute name="list"><![CDATA[1002]]></entityAttribute>
                <entityAttribute name="deleted"><![CDATA[N]]></entityAttribute>
            </trackEntity>
            <trackEntity entityId="1009" type="TOptionBean">
                <entityAttribute name="label"><![CDATA[EMEA]]></entityAttribute>
                <entityAttribute name="CSSSTyle"><![CDATA[]]></entityAttribute>
                <entityAttribute name="symbol"/>
                <entityAttribute name="objectID"><![CDATA[1009]]></entityAttribute>
                <entityAttribute name="isDefault"><![CDATA[N]]></entityAttribute>
                <entityAttribute name="sortOrder"><![CDATA[3]]></entityAttribute>
                <entityAttribute name="list"><![CDATA[1002]]></entityAttribute>
                <entityAttribute name="deleted"><![CDATA[N]]></entityAttribute>
            </trackEntity>
        </subEntityRelation>
        <subEntityRelation parentAttributeName="parentList" type="TListBean">
            <trackEntity entityId="1003" type="TListBean">
                <entityAttribute name="parentList"><![CDATA[1002]]></entityAttribute>
                <entityAttribute name="objectID"><![CDATA[1003]]></entityAttribute>
                <entityAttribute name="listType"><![CDATA[4]]></entityAttribute>
                <entityAttribute name="name"><![CDATA[Configure child 1]]></entityAttribute>
                <entityAttribute name="deleted"><![CDATA[N]]></entityAttribute>
                <entityAttribute name="childNumber"><![CDATA[1]]></entityAttribute>
                <subEntityRelation parentAttributeName="list" type="TOptionBean">
                    <trackEntity entityId="1007" type="TOptionBean">
                        <entityAttribute name="label"><![CDATA[GE]]></entityAttribute>
                        <entityAttribute name="CSSSTyle"><![CDATA[]]></entityAttribute>
                        <entityAttribute name="symbol"/>
                        <entityAttribute name="objectID"><![CDATA[1007]]></entityAttribute>
                        <entityAttribute name="isDefault"><![CDATA[N]]></entityAttribute>
                        <entityAttribute name="parentOption"><![CDATA[1004]]></entityAttribute>
                        <entityAttribute name="sortOrder"><![CDATA[1]]></entityAttribute>
                        <entityAttribute name="list"><![CDATA[1003]]></entityAttribute>
                        <entityAttribute name="deleted"><![CDATA[N]]></entityAttribute>
                        <referredDependency dependencyId="1004" dependencyEntityType="TOptionBean"
                            attributeName="parentOption"/>
                    </trackEntity>
                    <trackEntity entityId="1008" type="TOptionBean">
                        <entityAttribute name="label"><![CDATA[Honeywell]]></entityAttribute>
                        <entityAttribute name="CSSSTyle"><![CDATA[]]></entityAttribute>
                        <entityAttribute name="symbol"/>
                        <entityAttribute name="objectID"><![CDATA[1008]]></entityAttribute>
                        <entityAttribute name="isDefault"><![CDATA[N]]></entityAttribute>
                        <entityAttribute name="parentOption"><![CDATA[1004]]></entityAttribute>
                        <entityAttribute name="sortOrder"><![CDATA[2]]></entityAttribute>
                        <entityAttribute name="list"><![CDATA[1003]]></entityAttribute>
                        <entityAttribute name="deleted"><![CDATA[N]]></entityAttribute>
                        <referredDependency dependencyId="1004" dependencyEntityType="TOptionBean"
                            attributeName="parentOption"/>
                    </trackEntity>
                </subEntityRelation>
            </trackEntity>
        </subEntityRelation>
    </entityExchange>
</ns2:trackplusExchange>

DIe folgende Tabelle beschreibt die Entity-Attribute der XML-Datei.

Eigenschaft

Beschreibung

entityId

Nur eine Zahl; Sie können hier eine beliebige Zahl eingeben, sie wird vom Importprozess nicht verwendet.

type

TListBean für die Liste, und TOptionBean für einen Eintrag in dieser Liste.

repositoryType

„0“=privat, „1“=Bereich, „2“=öffentlich.

objectID

Eine Zahl. Bei einer Liste (TListBean) wird sie vom Importprozess nicht verwendet. Bei einer Option (TOptionBean) wird sie als Bezeichner verwendet, falls Sie andere Eigenschaften dieser Option durch einen Import ändern möchten.

listType

„1“ für eine einfache, einstufige Liste von Optionen.

name

Der Name der Liste. Der Name ist in der Benutzeroberfläche der Verwaltung sichtbar.

owner

Der Primärschlüssel des Eigentümers dieser Liste aus der Tabelle TPERSON. „1“ ist der Benutzer „admin“.

deleted

„Y“ oder „N“; markiert diesen Eintrag als veraltet und Sie können diese Option nicht mehr auswählen. Sie wird jedoch weiterhin in den Einträgen angezeigt, in denen sie verwendet wurde.

CSSStyle

Ein optionaler CSS-Stil, der auf eine Zeile im Elementnavigator angewendet wird, wenn ein Element eine Eigenschaft mit dieser Option hat.

symbol

Ein optionales Symbol, das im Elementnavigator angezeigt werden kann.

isDefault

Markiert diese Option als Standard.

sortOrder

Legt die Reihenfolge fest, in der die Optionen in den Komponenten der Auswahlbenutzeroberfläche angezeigt werden.

label

Die Beschriftung der Option, wie sie der Endbenutzer sehen wird. Bitte beachten Sie, dass Sie die Optionsbezeichnungen später mit dem Lokalisierungseditor lokalisieren können.

list

Die objectID der Liste, zu der diese Option gehört. Sie wird beim Importvorgang nicht verwendet.

Die folgende Auflistung zeigt ein minimiertes Beispiel für eine Listendefinition, die in Allegra importiert werden kann.

<?xml version='1.0' encoding='UTF-8'?>
<ns2:trackplusExchange xmlns:ns2="http://www.trackplus.com/exporter/"
version="4.0.0">
    <entityExchange entityId="1008" type="TListBean">
        <entityAttribute name="repositoryType">2</entityAttribute>
        <entityAttribute name="objectID">1008</entityAttribute>
        <entityAttribute name="listType">1</entityAttribute>
        <entityAttribute name="name">Simple global list</entityAttribute>
        <entityAttribute name="owner">1</entityAttribute>
        <entityAttribute name="deleted">N</entityAttribute>
        <subEntityRelation parentAttributeName="list" type="TOptionBean">
            <trackEntity entityId="1023" type="TOptionBean">
                <entityAttribute name="label">Entry A slg</entityAttribute>
                <entityAttribute name="list">1008</entityAttribute>
            </trackEntity>
            <trackEntity entityId="1024" type="TOptionBean">
                <entityAttribute name="label">Entry BN slg</entityAttribute>
                <entityAttribute name="list">1008</entityAttribute>
            </trackEntity>
        </subEntityRelation>
    </entityExchange>
</ns2:trackplusExchange>

Import-Regeln#

Es wird davon ausgegangen, dass in der Datenbank bereits eine Liste vorhanden ist, wenn alle folgenden Eigenschaften übereinstimmen:

  • Der Name der Liste

  • Der Repository-Typ

  • Der Listentyp

  • Der Bereich, falls vorhanden

  • Die Kennung der übergeordneten Liste, falls vorhanden

Eine Option ist als bereits vorhanden anzusehen, wenn alle folgenden Eigenschaften übereinstimmen:

  • Das Label

  • Die Liste, zu der es gehört

  • Die übergeordnete Option bei kaskadierten Listen

Wenn Sie den Listennamen ändern, wird beim Import eine neue Liste erstellt.

Wenn Sie die Bezeichnung einer Option ändern und den Listennamen beibehalten, wird der Liste eine neue Option hinzugefügt.

Wenn Sie die Option „Untergeordnete Elemente löschen“ markieren, wird jedes untergeordnete Element der Liste, das nicht in der XML-Datei enthalten ist, während des Importvorgangs aus der ursprünglichen Liste entfernt.

Wenn Sie die Option „Vorhandene überschreiben“ markieren, werden Eigenschaften, die nicht zur Identifikation verwendet werden, während des Importvorgangs überschrieben. Auf diese Weise können Sie Beschreibungen, Symbole und CSS ändern, jedoch nicht den Namen oder die Bezeichnung einer Liste oder Option.

Inhalt