Identitätsverwaltung (IMAN) konfigurieren
Die Konfigurationsdatei IMANConfig.xml wird verwendet, um die Identitätsattribute und andere Attribute für einen Typ und eine Quelle für Bündelquellen basierend auf SIM Datentypen zu konfigurieren. Sie ermöglicht es TAL, verschiedene Bündel aus anderen Entwicklungssystemen zu verarbeiten und einzelnen Objekten eine Identität zuzuweisen. Die Attribute werden verwendet, um die IMAN-ID zu generieren. Diese Konfiguration ist erforderlich. Die Datei befindet sich im Verzeichnis INSERVICE_v\InS_SW\Config\Applications\DataProcess\Config\Common\Templates\IMANIntegration.
Servigistics InService stellt das Konfigurator-Dienstprogramm zur Verfügung, um Sie beim Erstellen und Aktualisieren dieser Konfigurationsdatei zu unterstützen. Der Konfigurator stellt eine TAL-Entität mit der Eigenschaft IMAN für diese Aktualisierungen bereit. Die Eigenschaft IMAN ermöglicht es Ihnen, die Ladeprioritäten der Quellen umzubenennen oder zu ändern. Dies wird im Abschnitt Sources der Eigenschaft festgelegt.
Die folgenden Quellen sind schreibgeschützt:
Mithilfe des Plussymbols
können Sie zusätzliche Quellen für Ihre Organisation hinzufügen. Hierdurch wird eine Kopie der PTC Quelle erstellt, und die neue Quelle wird der Datei
IMANConfig.xml hinzugefügt. Beispiel:
Sie können die Quellen-Ladepriorität einer Quelle ändern, indem Sie auf das Symbol neben der Quelle klicken und dann diese Quelle mit Ziehen und Ablegen an die gewünschte Position in der Reihenfolge verschieben:
Beachten Sie, dass Sie alle im Konfigurator vorgenommenen TAL-Änderungen veröffentlichen und den JBoss-Server neu starten müssen, bevor die Änderungen wirksam werden. Weitere Informationen über das Konfigurator-Dienstprogramm finden Sie unter Servigistics InService Bereitstellungskonfigurator-Dienstprogramm verwenden im Servigistics InService Bereitstellungshandbuch.
Nicht alle IMAN-Konfigurationen können im Konfigurator ausgeführt werden. Die folgenden Abschnitte enthalten Details zu dieser Konfiguration.
Quellnamen in IMAN konfigurieren
Das Bündelartefakt PublishInfo.xml enthält einen Parameter Bündel-Quelle, um den Bündelbesitzer zu identifizieren. Wenn diese Eigenschaft nicht vorhanden ist, verwendet TAL standardmäßig die Eigenschaft orgName aus den Rootobjects der Bündelquelle. Nachfolgend sehen Sie ein Beispiel für einen orgName:
In IMANConfig.xml müssen Sie einen Source name und Details zu Attributen, die Geschäftsobjekte identifizieren, für die verschiedenen Datentypen definieren. Diese Attribute können für alle Typen von Geschäftsobjekten die gleichen sein, oder es können pro Objekt auch unterschiedliche verwendet werden. Wenn die Quelle nicht konfiguriert ist, schlägt der TAL-Prozess wahrscheinlich fehl.
Mit der Bündelquellkonfiguration finden Sie ein Objekt normalerweise. Falls es nicht gefunden wird (da dasselbe Objekt bereits durch eine andere Quelle geladen wurde), können Sie konfigurieren, welche Quellen durchsucht werden sollen. Normalerweise geschieht dies, wenn zwei verschiedene Quellen zwei unterschiedliche Sätze identifizierender Attribute aufweisen.
Betrachten wir z.B. ein Szenario, in dem PARTS aus einer Quelle namens SAP geladen wird, deren identifizierende Attribute als orgName und objNumber markiert sind. Jetzt erhalten wir jedoch einen Teil aus einer anderen Quelle namens PTC, deren identifizierendes Attribut URI ist. In diesem Fall sollten Sie kein Teil mit URI finden, da dieselbe Quelle nicht in SAP verfügbar ist. Das System sollte nicht einmal ein neues Teil erstellen. Die Lösung besteht darin, eine überlappende Suche auszuführen.
Im Folgenden wird erläutert, wie Sie eine überlappende Suche konfigurieren:
Wenn für einen bestimmten Type namedas Objekt mithilfe eines identifizierenden Attributs nicht in der Datenbank gefunden wird, wird die Suche mit dem identifizierenden Attribut der Quelle ausgeführt, die in der überlappenden Sequenz bereitgestellt wird. Sie müssen sicherstellen, dass die Quelle, die als überlappende Sequenz erwähnt wird, nur diese Eigenschaften als identifizierende Attribute (die als identifizierendes oder sonstiges Attribut der aktuellen Quelle zur Verfügung stehen) verwendet; andernfalls tritt ein Fehler auf.
Wenn im obigen Fall die IdentifyingAttributes von SAP objNumber und orgName enthalten, handelt es sich um einen gültigen Anwendungsfall. Wenn sie familyCodeenthält, tritt ein Fehler auf, da die Quelle-PTC nicht über dieses Attribut verfügt.
Priorität in IMAN konfigurieren
Der Konfigurator ermöglicht es Ihnen, die primäre Quelle für den Inhalt zu definieren. Wenn Sie zusätzliche Quellen definieren müssen, muss dies in der Datei IMANConfig.xml geschehen. Erstellen Sie in diesem Fall eine Kopie der PTC Quelle, ändern Sie den Namen (name) der Quelle, und aktualisieren Sie die Quell-ID (SourceID) in -1, wie folgt:
<Source SourceID="-1" name="ABC" priority="3">
Jede Bündelquelle wird mit einer Priorität bereitgestellt, um Aktualisierungen an einem Objekt zu aktivieren oder zu deaktivieren. Eine Quelle mit der höchsten Priorität ist berechtigt, beliebige Änderungen am Objekt mit einer Quelle gleicher oder niedrigster Priorität vorzunehmen, das Umgekehrte gilt jedoch nicht. Dies wird mit der Konfigurationsdatei IMANConfig.xml beim Definieren einer Quelle konfiguriert. Prioritätsattribute akzeptieren nur Ganzzahlwerte. Ein höherer Wert bedeutet eine höhere Priorität. Wenn eine Quelle versucht, ein Objekt zu aktualisieren oder zu löschen, das sie nicht besitzt, muss sie die gleiche oder eine höhere Priorität haben als der aktuelle Besitzer; andernfalls wird die Operation ignoriert.
Beispiel: Ein Teil namens PL1 gehört zur Quelle ABC. Aktualisierungen des Teils durch die PTC Quelle sind immer zulässig, da PTC eine höhere Priorität hat als ABC. Wenn jedoch ABC versucht, ein Objekt im Besitz von PTC zu aktualisieren, ist dies nicht zulässig, da die Priorität dieser Quelle niedriger ist als die von PTC.
Im Folgenden finden Sie ein Beispiel für eine IMANConfig.xml-Konfigurationsdatei:
<IMANConfig>
<Source SourceID="4" name="CSV" priority="4">
<Type name="PDFM">
<IdentifyingAttributes>
<Property name="objNumber" primary="true" reference="PDF Code|Document Code"/>
<Property name="orgName" primary="true" reference="$$ORGNAME$$"/>
<Property name="PTC_DD_LANGUAGE" reference="File Name_|Description_"/>
<Property name="SIM.authoringLanguage" reference="$$AUTHORED_DOC_LANGUAGE$$"/>
</IdentifyingAttributes>
<OtherAttributes>
</OtherAttributes>
</Type>
<Type name="IEXML">
<IdentifyingAttributes>
<Property name="objNumber" primary="true" reference="XML Code|Document Code"/>
<Property name="orgName" primary="true" reference="$$ORGNAME$$"/>
<Property name="PTC_DD_LANGUAGE" reference="File Name_|Description_"/>
<Property name="SIM.authoringLanguage" reference="$$AUTHORED_DOC_LANGUAGE$$"/>
</IdentifyingAttributes>
<OtherAttributes>
</OtherAttributes>
</Type>
<Type name="GRAPHIC">
<IdentifyingAttributes>
<Property name="objNumber" primary="true" reference="GRAPHIC Code|Document Code"/>
<Property name="orgName" primary="true" reference="$$ORGNAME$$"/>
<Property name="PTC_DD_LANGUAGE" reference="File Name_|Description_"/>
<Property name="SIM.authoringLanguage" reference="$$AUTHORED_DOC_LANGUAGE$$"/>
</IdentifyingAttributes>
<OtherAttributes>
</OtherAttributes>
</Type>
<Type name="PARTS">
<IdentifyingAttributes>
<Property name="objNumber" reference="Part Code"/>
<Property name="orgName" reference="orgname|$$ORGNAME$$"/>
</IdentifyingAttributes>
<OtherAttributes>
</OtherAttributes>
</Type>
<Type name="PI">
<IdentifyingAttributes>
<Property name="objNumber" reference="concat(Model,'_',SN)"/>
<Property name="orgName" reference="$$ORGNAME$$"/>
</IdentifyingAttributes>
<OtherAttributes>
</OtherAttributes>
</Type>
<Type name="BOM">
<IdentifyingAttributes>
<Property name="objNumber" reference="Object Number"/>
</IdentifyingAttributes>
<OtherAttributes>
</OtherAttributes>
</Type>
<Type name="GROUP">
<IdentifyingAttributes>
<Property name="objNumber" reference="$$Part Code"/>
<Property name="orgName" reference="$$ORGNAME$$"/>
</IdentifyingAttributes>
<OtherAttributes>
</OtherAttributes>
</Type>
<Type name="IS">
<IdentifyingAttributes>
<Property name="objNumber" reference="Parent Entity Code"/>
<Property name="orgName" reference="$$ORGNAME$$"/>
</IdentifyingAttributes>
<OtherAttributes>
</OtherAttributes>
</Type>
<Type>
<IdentifyingAttributes>
<Property name="objNumber" reference="Document Code|Assembly Code"/>
<Property name="orgName" reference="$$ORGNAME$$"/>
</IdentifyingAttributes>
<OtherAttributes>
</OtherAttributes>
</Type>
</Source>
<Source SourceID="3" name="FLW" priority="3">
<Type name="PDFM">
<IdentifyingAttributes>
<Property name="uri"/>
<Property name="PTC_DD_LANGUAGE"/>
<Property name="SIM.authoringLanguage"/>
</IdentifyingAttributes>
<OtherAttributes>
<Property name="objNumber" reference="number"/>
<Property name="orgName"/>
<Property name="SIM.lastUpdated"/>
<Property name="SIM.lastUpdatedSrc"/>
<Property name="SIM.lastUpdatedMeta"/>
<Property name="checksum"/>
<Property name="collectedDate"/>
</OtherAttributes>
</Type>
<Type name="IEXML">
<IdentifyingAttributes>
<Property name="uri"/>
<Property name="PTC_DD_LANGUAGE"/>
<Property name="SIM.authoringLanguage"/>
</IdentifyingAttributes>
<OtherAttributes>
<Property name="objNumber" reference="number"/>
<Property name="orgName"/>
<Property name="SIM.lastUpdated"/>
<Property name="SIM.lastUpdatedSrc"/>
<Property name="SIM.lastUpdatedMeta"/>
<Property name="checksum"/>
<Property name="collectedDate"/>
</OtherAttributes>
</Type>
<Type name="SYMPTOMS">
<IdentifyingAttributes>
<Property name="uri"/>
<Property name="PTC_DD_LANGUAGE"/>
<Property name="SIM.authoringLanguage"/>
</IdentifyingAttributes>
<OtherAttributes>
<Property name="objNumber" reference="number"/>
<Property name="orgName"/>
<Property name="SIM.lastUpdated"/>
<Property name="SIM.lastUpdatedSrc"/>
<Property name="SIM.lastUpdatedMeta"/>
<Property name="checksum"/>
<Property name="collectedDate"/>
</OtherAttributes>
</Type>
<Type CascadeSeq="SAP" name="PARTS">
<IdentifyingAttributes>
<Property name="uri"/>
</IdentifyingAttributes>
<OtherAttributes>
<Property name="objNumber"/>
<Property name="orgName"/>
<Property name="PTC_DD_LANGUAGE_TL"/>
</OtherAttributes>
</Type>
<Type name="IS">
<IdentifyingAttributes>
<Property name="uri"/>
</IdentifyingAttributes>
<OtherAttributes>
<Property name="objNumber"/>
<Property name="orgName"/>
<Property name="PTC_DD_LANGUAGE_TL"/>
</OtherAttributes>
</Type>
<Type name="PS">
<IdentifyingAttributes>
<Property name="uri"/>
</IdentifyingAttributes>
<OtherAttributes>
<Property name="objNumber"/>
<Property name="orgName"/>
<Property name="PTC_DD_LANGUAGE_TL"/>
</OtherAttributes>
</Type>
<Type name="BOM">
<IdentifyingAttributes>
<Property name="objNumber"/>
</IdentifyingAttributes>
<OtherAttributes>
<Property name="uri"/>
</OtherAttributes>
</Type>
<Type name="GRAPHIC">
<IdentifyingAttributes>
<Property name="uri"/>
<Property name="PTC_DD_LANGUAGE"/>
<Property name="SIM.authoringLanguage"/>
</IdentifyingAttributes>
<OtherAttributes>
<Property name="orgName"/>
<Property name="CADName"/>
<Property name="SIM.lastUpdated"/>
<Property name="SIM.lastUpdatedSrc"/>
<Property name="SIM.lastUpdatedMeta"/>
<Property name="checksum"/>
<Property name="collectedDate"/>
</OtherAttributes>
</Type>
<Type name="ILLUSTRATION">
<IdentifyingAttributes>
<Property name="uri"/>
<Property name="PTC_DD_LANGUAGE"/>
<Property name="SIM.authoringLanguage"/>
</IdentifyingAttributes>
<OtherAttributes>
<Property name="orgName"/>
<Property name="CADName"/>
<Property name="SIM.lastUpdated"/>
<Property name="SIM.lastUpdatedSrc"/>
<Property name="SIM.lastUpdatedMeta"/>
<Property name="checksum"/>
<Property name="collectedDate"/>
</OtherAttributes>
</Type>
<Type name="EMBEDDEDIMG">
<IdentifyingAttributes>
<Property name="uri"/>
<Property name="PTC_DD_LANGUAGE"/>
<Property name="SIM.authoringLanguage"/>
</IdentifyingAttributes>
<OtherAttributes>
<Property name="CADName"/>
<Property name="orgName"/>
<Property name="SIM.lastUpdated"/>
<Property name="SIM.lastUpdatedSrc"/>
<Property name="SIM.lastUpdatedMeta"/>
<Property name="checksum"/>
<Property name="collectedDate"/>
</OtherAttributes>
</Type>
<Type name="P2CRELATION">
<IdentifyingAttributes>
<Property name="objNumber"/>
</IdentifyingAttributes>
</Type>
<Type CascadeSeq="CSV" name="GROUP">
<IdentifyingAttributes>
<Property name="uri"/>
</IdentifyingAttributes>
<OtherAttributes>
<Property name="objNumber"/>
<Property name="orgName"/>
</OtherAttributes>
</Type>
<Type CascadeSeq="CSV" name="PARTSLIST">
<IdentifyingAttributes>
<Property name="uri"/>
</IdentifyingAttributes>
<OtherAttributes>
<Property name="objNumber" reference="number"/>
<Property name="orgName"/>
<Property name="PTC_DD_LANGUAGE_TL"/>
</OtherAttributes>
</Type>
<Type>
<IdentifyingAttributes>
<Property name="uri"/>
</IdentifyingAttributes>
<OtherAttributes>
<Property name="objNumber" reference="number"/>
<Property name="orgName"/>
</OtherAttributes>
</Type>
</Source>
<Source SourceID="2" name="KIT" priority="2">
<Type>
<IdentifyingAttributes>
<Property name="objNumber"/>
<Property name="orgName"/>
</IdentifyingAttributes>
<OtherAttributes>
<Property name="uri"/>
</OtherAttributes>
</Type>
</Source>
<Source SourceID="1" name="SAP" priority="1">
<Type>
<IdentifyingAttributes>
<Property name="objNumber" xpath="OBJNUMBER"/>
<Property name="orgName" xpath="ORGNAME"/>
</IdentifyingAttributes>
<OtherAttributes>
<Property name="uri"/>
</OtherAttributes>
</Type>
</Source>
</IMANConfig>
