Universal Schnittstelle - Grundlagen EXTERNAL_ID |
Um eine Verbindung zwischen Objekten innerhalb von PLANOUT und Objekten in externen Systemen herzustellen, kommt das Attribut „EXTERNAL_ID“ zum Einsatz. Werden Datenobjekte an PLANOUT übertragen, ist dieses Attribut als ein eindeutiger Referenzschlüssel auf das entfernte Objekt zu verstehen, welcher dessen Identifikation ermöglicht.
Der Ablauf von Datenimporten verfolgt dabei stets den gleichen Ablauf. Wird ein Datenobjekt übertragen und ist bisher noch kein Objekt vorhanden, welches die gleiche „EXTERNAL_ID“ aufweist, wird das Objekt neu angelegt. Wird dagegen ein Objekt gefunden, welches die gleiche „EXTERNAL_ID“ aufweist, wird dieses Objekt mit den neu übertragenen Daten aktualisiert.
Darüber hinaus kommt das Attribut „EXTERNAL_ID“ an allen Stellen zum Einsatz, welche eine explizite Identifikation von Objekten erfordern. Soll beispielsweise eine Ressource gelöscht werden, wird anhand der externen ID dessen Identität festgestellt.
<PLANOUT>
<DELETE>
<DELETE_ACTION OBJECT_TYPE="RESOURCE"
EXTERNAL_ID ="Werk Altomünste 1"/>
</DELETE>
</PLANOUT>
Ein weiteres Beispiel für die Verwendung von externen IDs stellt die Referenzierung von Objekten untereinander dar. Das folgende Beispiel zeigt die Verwendung von externen IDs um eine Zuordnung von Ressourcen und Unternehmensstrukturen herzustellen.
<PLANOUT>
<RESOURCE_COMPANIES>
<RESOURCE_COMPANY>
<SHORT_NAME>Werk Wüllershausen</SHORT_NAME>
<EXTERNAL_ID>WERK WÜLLERSHAUSEN 1</EXTERNAL_ID>
</RESOURCE_COMPANY>
</RESOURCE_COMPANIES>
<RESOURCES>
<RESOURCE>
<SHORT_NAME>CRX - 1200 L</SHORT_NAME>
<EXTERNAL_ID>CRX - 1200 L</EXTERNAL_ID>
<COMPANY>WERK WÜLLERSHAUSEN 1</COMPANY>
</RESOURCE>
</RESOURCES>
</PLANOUT>