Mappingsyntax und Beispiele

Sie finden Informationen zur Verwendung der XML-Tags in den aufgeführten Beschreibungen und Beispielen sowie in den kommentierten Zeilen der Alfabet-Import-Konfiguration. Zur Vermeidung von Redundanzen werden die Tags normalerweise nur bei der ersten Verwendung verknüpft.

Mappingdefinition

Die Alfabet-Import-Konfiguration regelt den Datenaustausch zwischen ARIS und Alfabet. In der Konfiguration ist das allgemeine Mapping für Modelle, Kanten und Hinterlegungen zwischen ARIS und Alfabet-Objekten definiert, und wie Alfabet-Objekte in ARIS zugeordnet werden.

Wenn Sie die zu verwendenden Attribute der Objekttypen ändern oder andere Attribute übertragen möchten, passen Sie bitte beide Konfigurationsdateien an.

Generell werden Alfabet-Tabellen ARIS-Objekten zugeordnet. Alfabet-Tabellen werden unter Verwendung der XML-Eigenschaft table zugeordnet. Der Import einer ganzen Tabelle bzw. der Import/die Verbindung eines einzelnen Alfabet-Objekts erfolgen mit Hilfe der folgenden Importdefinition.

Table-Element

<table name="VALUENODE" arisgroupname="Values" condition="Stereotype" aristype="OT_FUNC_INST">

name

Name der Alfabet-Tabelle, z. B. VALUENODE.

arisgroupname

Name der ARISDatenbankgruppe.

Wenn die gesamte Tabelle importiert wird, gibt arisgroupname den Namen der Untergruppe an, die für den Inhalt der Tabelle angelegt wird.

Wenn arisgroupname leer oder nicht angegeben ist, wird keine Untergruppe erstellt.

condition

Definiert ein bedingtes Mapping basierend auf dem Wert einer Eigenschaft. Wenn der Wert angegeben ist und einem der Werte der unten aufgeführten condition-Elemente entspricht, wird er gemäß der Definition des condition-Elements und NICHT gemäß der Definition des table-Elements zugeordnet.

aristype

API-Name eines Objekt-, Modell- oder Symboltyps.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

<condition value="Initiative" arisgroupname="Initiatives" aristype="ST_INITIATIVE" />

condition

Definiert ein bedingtes Mapping basierend auf dem Wert einer Eigenschaft. Wenn der Wert angegeben ist und einem der Werte der unten aufgeführten condition-Elemente entspricht, wird er gemäß der Definition des condition-Elements und NICHT gemäß der Definition des table-Elements zugeordnet.

value

Eigenschaftswert der festlegt, dass diese Bedingung angewendet werden soll.

arisgroupname

Überschreibt optional den standardmäßigen Gruppennamen des <table>-Elements bei Elementen, die diese Bedingung erfüllen.

aristype

ARIS-API-Name des zu verwendenden ARIS-Objekts. Wenn hier ein ARIS-Symboltyp festgelegt ist, wird der Objekttyp von dem Symbol abgeleitet. Außerdem wird das Standardsymbol des importierten Elements auf diesen Symboltyp festgelegt.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

<condition value="Vision" arisgroupname="Visions" aristype="ST_VISION" />

<condition value="Business Requirement" arisgroupname="Business Requirements" aristype="ST_REQUIREMENT" />

<condition value="Architecture Requirement" arisgroupname="Architecture Requirements" aristype="ST_REQUIREMENT" />

All XML properties

name

name

Name der Alfabet-Tabelle, z. B. VALUENODE.

arisgroupname

arisgroupname

Name der ARISDatenbankgruppe.

Wenn die gesamte Tabelle importiert wird, gibt arisgroupname den Namen der Untergruppe an, die für den Inhalt der Tabelle angelegt wird.

Wenn arisgroupname leer oder nicht angegeben ist, wird keine Untergruppe erstellt.

aristype

aristype

API-Name eines Objekt-, Modell- oder Symboltyps.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

overview-model (optional)

overview-model

Legt optional ein overview-Modell an und platziert eine Ausprägung jedes Tabellenobjekts, das diese Bedingung erfüllt, im Modell.

check-master (optional)

check-master

Prüft das Vorhandensein der festgelegten Alfabet-Eigenschaft, z. B. ARIS_GUID, die für ein Alfabet-Objekt mit der ARIS-GUID des entsprechenden ARIS-Objekts gepflegt wird. Wenn die GUID in der ARIS-Datenbank enthalten ist, wird das zugehörige ARIS-Objekt anstelle des Alfabet-Objekts als Master verwendet, z. B:

check-master="ARIS_GUID"

Die Attribute und Eigenschaften des Masterobjekts werden durch den Import nicht überschrieben und ein Master wird nicht entfernt, wenn das Objekt in Alfabet gelöscht wurde.

condition (optional)

condition

Definiert ein bedingtes Mapping basierend auf dem Wert einer Eigenschaft. Wenn der Wert angegeben ist und einem der Werte der unten aufgeführten condition-Elemente entspricht, wird er gemäß der Definition des condition-Elements und NICHT gemäß der Definition des table-Elements zugeordnet.

value

value

Eigenschaftswert der festlegt, dass diese Bedingung angewendet werden soll.

aristype

aristype

ARIS-API-Name des zu verwendenden ARIS-Objekts. Wenn hier ein ARIS-Symboltyp festgelegt ist, wird der Objekttyp von dem Symbol abgeleitet. Außerdem wird das Standardsymbol des importierten Elements auf diesen Symboltyp festgelegt.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

arisgroupname

arisgroupname

Überschreibt optional den standardmäßigen Gruppennamen des <table>-Elements bei Elementen, die diese Bedingung erfüllen.

overview-model (optional)

overview-model

Legt optional ein overview-Modell an und platziert eine Ausprägung jedes Tabellenobjekts, das diese Bedingung erfüllt, im Modell.

'assign'-Unterelement eines 'table'-Elements

Erstellt eine Hinterlegung für sämtliche Objekte, die aus dieser Tabelle importiert werden.

Sämtliche XML-Eigenschaften

type

type

Legt ein hinterlegtes Modell pro importiertes Objekt an. Kann nicht als untergeordnetes Element table verwendet werden.

Modell

model

API-Name für den Modelltyp des zu hinterlegenden ARIS-Modells, z. B. MT_APPL_SYS_TYPE_DGM.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

child-symbol

child-symbol

API-Name für den Symboltyp des im hinterlegten Modell verwendeten ARIS-Objekts, z. B. ST_APPL_SYST_TYPE.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Nicht verwendet, wenn es sich bei dem referenzierten Element um das Modell selbst handelt.

add-parent

add-parent

Fügt dem hinterlegten Modell eine Ausprägung des übergeordneten Objekts hinzu.

Die Standardeinstellung ist false.

Wenn Sie true angeben, wird dem hinterlegten Modell eine Ausprägung des übergeordneten Objekts hinzugefügt. Aus diesem Grund ist das parent-symbol-Attribut zwingend erforderlich.

parent-symbol

parent-symbol

API-Name für den Symboltyp des im hinterlegten Modell verwendeten übergeordneten ARIS-Objekts, z. B. ST_APPL_SYS_TYPE.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Nur erforderlich, wenn das add-parent-Attribut auf true gesetzt ist.

'attr'-Unterelement

Ordnet einen Alfabet-Eigenschaftswert zu, z. B. String oder Date. Die Eigenschaften Reference oder ReferenceArray sind hier nicht zulässig.

<attr alfabet="StartDate" condition="Status" value="Evaluation" aris="AT_EVALUATION_START" />

attr XML-Eigenschaft

Definiert die Behandlung von Attributen.

Wenn mindestens ein attr-Unterelement angegeben ist, wird dadurch die Liste der in ARIS importierten Attribute auf die hier angegebenen attr-Elemente beschränkt.

alfabet

Name der Alfabet-Eigenschaft.

condition

Anhand des Werts zu prüfende Eigenschaft. Das Attribut wird nur dann importiert, wenn der Wert der Eigenschaft dem vorgegebenen Wert entspricht.

value

Wert, der anhand des Werts der condition-XML-Eigenschaft für den bedingten Import von Attributen geprüft wird.

aris XML-Eigenschaft

API-Name des ARIS-Attributs.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Leerstring (""): nicht verbunden/ignoriert.

<attr alfabet="EndDate" condition="Status" value="Evaluation" aris="AT_EVALUATION_END" />

<attr alfabet="StartDate" condition="Status" value="Pilot" aris="AT_TO_BE_PHASED_IN_START" />

<attr alfabet="EndDate" condition="Status" value="Pilot" aris="AT_TO_BE_PHASED_IN_END" />

In this case, the value of the "StartDate" property is written to the aris attribute "AT_EVALUATION_START" only if the alfabet property "Status" has the value "Evaluation", etc.

When used as a sub-element of the <cxn> element (see below), the property is mapped to an attribute of the connection.

Sämtliche XML-Eigenschaften

attr

attr XML-Eigenschaft

Definiert die Behandlung von Attributen.

Wenn mindestens ein attr-Unterelement angegeben ist, wird dadurch die Liste der in ARIS importierten Attribute auf die hier angegebenen attr-Elemente beschränkt.

alfabet

alfabet

Name der Alfabet-Eigenschaft.

aris

aris XML-Eigenschaft

API-Name des ARIS-Attributs.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Leerstring (""): nicht verbunden/ignoriert.

XML-Eigenschaften für den bedingten Import von Attributen

Bedingung

condition

Anhand des Werts zu prüfende Eigenschaft. Das Attribut wird nur dann importiert, wenn der Wert der Eigenschaft dem vorgegebenen Wert entspricht.

value

value

Wert, der anhand des Werts der condition-XML-Eigenschaft für den bedingten Import von Attributen geprüft wird.

'cxn'-Unterelement

Erstellt eine Kantendefinition und/oder eine Hinterlegung zwischen dem aktuellen Tabellenelement und dem referenzierten Element.

Sämtliche XML-Eigenschaften

Eigenschaft

property XML-Eigenschaft

Name der Alfabet-Eigenschaft. Die Eigenschaft muss vom Typ Reference oder ReferenceArray sein.

Siehe Dokumentation des Alfabet Meta-Modells. Weitere Informationen finden Sie im Alfabet-Referenzhandbuch der ARIS - Alfabet Interoperability Interface. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

cxntype

cxntype

API-Name des ARIS-Kantentyps.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Leerstring (""): nicht verbunden/ignoriert.

Value="-1": keine Kante anlegen. Ist nur zulässig, wenn eine Hinterlegungsdefinition als Unterelement verfügbar ist.

srctotarget

srctotarget

Definiert die Richtung einer Kante.

Wert true:

Vom class-Element zum referenzierten Element.

Wert false:

Vom referenzierten Element zum class-Element.

forceexist (optional)

forceexist

Legt fest, ob der Import das Bestehen des Ziel- oder Quellobjekts eines referenzierten Objekts in der Datenbank erzwingt oder nicht. Wenn der Wert auf true gesetzt ist, wird das Ziel- oder Quellobjekt unter Verwendung der Verbindungsdefinition des referenzierten Objekts angelegt. Nur wenn das Ziel- oder Quellobjekt vorhanden ist, wird eine Kante importiert. Ob das Zielobjekt oder das Quellobjekt vorhanden sein muss, hängt von dem Wert ab, der in der srctotarge-XML-Eigenschaft festgelegt ist.

Der Standardwert ist false.

make-parent-group (optional)

make-parent-group

Legt fest, dass die Gruppe mit dem referenzierten Element die übergeordnete Gruppe des betreffenden Elements wird.

Die übergeordnete Zuordnung muss auf isgroup="true" gesetzt werden.

connected-objtype (optional)

connected-objtype

Dient zum Validieren des Quell-/Zielobjekttyps. Beim Import wird eine Ausnahme ausgelöst, wenn der Typ des vorhandenen Objekts als ungültig identifiziert wird.

overview-model (optional)

overview-model

Legt im overview-Modell eine Ausprägung des Zielobjekts und der entsprechenden Kante an, wenn im table-Element die overview-model-Eigenschaft angegeben ist.

Der Wert entspricht der Symboltypnummer (siehe API-Name).

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

assigned-model (optional)

assigned-model

Legt im hinterlegten Modell eine Ausprägung des Zielobjekts und der entsprechenden Kante an, wenn das table-Element über ein hinterlegtes Unterelement verfügt.

Der Wert entspricht der Symboltypnummer (siehe API-Name).

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

'assign'-Unterelement eines 'cxn'-Elements

Erstellt zusätzlich zu einer Kante, anstelle einer Kante oder im Falle, dass es sich bei dem referenzierten Element um ein von einer zusätzlichen Alfabet-Tabelle abgeleitetes Modell handelt, eine Hinterlegung zu einem Modell.

Sämtliche XML-Eigenschaften

type

type

Typ der Hinterlegung. Mögliche Werte:

all

Weist alle dem übergeordneten Element in einem Modell zu.

each

Weist ein Modell je untergeordnetem Element zu.

Modell

model

API-Name für den Modelltyp des zu hinterlegenden ARIS-Modells, z. B. MT_APPL_SYS_TYPE_DGM.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

child-symbol

child-symbol

API-Name für den Symboltyp des im hinterlegten Modell verwendeten ARIS-Objekts, z. B. ST_APPL_SYST_TYPE.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Nicht verwendet, wenn es sich bei dem referenzierten Element um das Modell selbst handelt.

add-parent

add-parent

Fügt dem hinterlegten Modell eine Ausprägung des übergeordneten Objekts hinzu.

Die Standardeinstellung ist false.

Wenn Sie true angeben, wird dem hinterlegten Modell eine Ausprägung des übergeordneten Objekts hinzugefügt. Aus diesem Grund ist das parent-symbol-Attribut zwingend erforderlich.

parent-symbol

parent-symbol

API-Name für den Symboltyp des im hinterlegten Modell verwendeten übergeordneten ARIS-Objekts, z. B. ST_APPL_SYS_TYPE.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Nur erforderlich, wenn das add-parent-Attribut auf true gesetzt ist.

srctotarget

srctotarget

Legt optional die Richtung der Hinterlegung fest.

Wert true (Standardwert):

vom Tabellenelement zum referenzierten Element.

Wert false:

vom referenzierten Element zum Tabellenelement.

group

group (anhängig von srctotarget)

Legt optional fest, in welcher Datenbankgruppe das hinterlegte Modell erstellt wird. source ist die Gruppe des Tabellenelements, target ist die Gruppe des verbundenen Elements.

Wert source (Standardwert):

Datenbankgruppe, in der das Quelltabellenelement der Hinterlegung gespeichert ist.

Wert target:

Datenbankgruppe, in der das verbundene Tabellenelement der Hinterlegung gespeichert ist.

'foreignattr'-Unterelement eines 'cxn'-Elements

Fügt dem importierten ARIS-Element Attribute aus einer zusätzlichen Alfabet-Tabelle hinzu.

Sämtliche XML-Eigenschaften

table

table

Name der zusätzlichen Alfabet-Tabelle.

Eigenschaft

property

Name der Eigenschaft der zusätzlichen Tabelle, die auf das aktuelle Tabellenelement verweist, z. B. Owner.

In Beispiel 3 der Mappingbeispiele wird das <foreignattr>-Element, das eine Liste mit attr-Elementen ist, akzeptiert. Diese Liste definiert die zu importierenden Attribute.

Beispiel 1

Dieses Beispiel zeigt, wie eine Tabelle mit einer Objektdefinition verbunden wird und wie (Wert-)Eigenschaften mit ARIS-Attributen verbunden werden. Zudem ist es möglich, ein overview-Modell anzulegen und eine Ausprägung jedes Objekts aus dieser Tabelle im Modell zu platzieren. Eine Reference- oder ReferenceArray-Eigenschaft kann mit einer Kante, einer Hinterlegung oder einer Kante plus Hinterlegung verbunden werden. Eine Werteigenschaft kann mit einer Kante, einer Hinterlegung oder beidem gleichzeitig verbunden werden. Werteigenschaften können einer angelegten Kante statt dem Objekt selbst zugeordnet werden.

<table name="APPLICATIONGROUP" arisgroupname="Application groups" aristype="OT_APPL_SYS_CLS" isgroup="true" overview-model="MT_APPL_SYS_TYPE_DGM,ST_APPL_SYS_CLS">

<attr alfabet="name" aris="AT_NAME" />

<attr alfabet="description" aris="AT_DESC" />

<attr alfabet="a_size" aris="" /> <!-- not mapped-->

...

<cxn property="belongsto" cxntype="CT_CAN_SUBS_2" srctotarget="false" />

<!-- overview-model="ST_APPL_SYS_CLS" means: show in overview model with its CXN and the given symbol -->

<!-- an attr element within a cxn element maps an attribute from the Alfabet table to the cxn -->

<cxn property="belongsto" cxntype="CT_CAN_SUBS_2" srctotarget="false" connected-objtype="OT_APPL_SYS_CLS" overview-model="ST_APPL_SYS_CLS" ordernum="1" >

<attr alfabet="refstr" aris="AT_EXTERNAL_ID" />

</cxn>

<cxn property="applications" cxntype="CT_BELONGS_TO_CLS" srctotarget="true" >

<!-- "each" would mean 1 assignment per child, all=assign them all to the parent in one model -->

<!-- add-parent: assignment contains occ of the parent. This needs: parent-symbol="ST_APPL_SYS_CLS" -->

<assign type="all" model="MT_APPL_SYS_TYPE_DGM" add-parent="true" parent-symbol="ST_APPL_SYS_CLS" child-symbol="ST_APPL_SYS_TYPE" />

</cxn>

<cxn property="processes" /> <!-- not mapped-->

</table>

Beispiel 2

Dieses Beispiel zeigt das Mapping zu einem Objekt mit einem hinterlegten Modell. Zudem wird im Zielmodell eine Objektausprägung angelegt.

<table name="BUSINESSPROCESS" arisgroupname="Business processes" aristype="OT_FUNC" isgroup="true" overview-model="MT_VAL_ADD_CHN_DGM,ST_VAL_ADD_CHN_SML_2" check-master="ARIS_GUID" >

<!-- "each" would mean 1 assignment per child, all=assign them all to the parent in one model -->

<!-- add-parent: assignment contains occ of the parent. This needs: parent-symbol="ST_APPL_SYS_CLS" -->

<assign type="each" model="MT_FUNC_ALLOC_DGM" add-parent="true" parent-symbol="ST_VAL_ADD_CHN_SML_2" child-symbol="ST_FUNC" />

<attr alfabet="name" aris="AT_NAME" />

<attr alfabet="shortname" aris="AT_REM" />

...

<cxn property="belongsto" srctotarget="false" cxntype="CT_IS_PRCS_ORNT_SUPER" overview-model="ST_VAL_ADD_CHN_SML_2" /> <!-- BusinessProcess–>

<createocc property="model" symbol="ST_VAL_ADD_CHN_SML_2" forceexist="false" /> <!-- creates occ in the model if the model exists -->

<cxn property="executingorganizations" srctotarget="false" cxntype="CT_EXEC_1" forceexist="true" assigned-model="ST_ORG_UNIT_2" />

<cxn property="applications" srctotarget="false" cxntype="CT_CAN_SUPP_1" forceexist="true" assigned-model="ST_APPL_SYS_TYPE"/>

...

</table>

Beispiel 3

Im folgenden Beispiel wird die foreignattr-Eigenschaft, die eine Liste mit attr-Eigenschaften ist, akzeptiert. Diese Liste definiert die zu importierenden Attribute. In diesem Beispiel wird die Verwendung von Fremdattributen und Attribut-Bedingungen verdeutlicht. Fremdattribute werden aus der zusätzlichen Alfabet-Tabelle eingelesen.

<table name="APPLICATION" arisgroupname="Application" aristype="OT_APPL_SYS_TYPE" isgroup="false" overview-model="MT_APPL_SYS_TYPE_DGM,ST_APPL_SYS_TYPE">

<foreignattr table="TIMESTATUS" property="Owner"> <!-- Select * from TIMESTATUS where Owner = '<our AlfabetID>'. Will be written after processing "normal" attr-Elements, so will probably overwrite them -->

property

Name der Eigenschaft der zusätzlichen Tabelle, die auf das aktuelle Tabellenelement verweist, z. B. Owner.

<attr alfabet="StartDate" condition="Status" value="Evaluation" aris="AT_EVALUATION_START" />

<attr alfabet="EndDate" condition="Status" value="Evaluation" aris="AT_EVALUATION_END" />

<attr alfabet="StartDate" condition="Status" value="Pilot" aris="AT_TO_BE_PHASED_IN_START" />

<attr alfabet="EndDate" condition="Status" value="Pilot" aris="AT_TO_BE_PHASED_IN_END" />

<attr alfabet="StartDate" condition="Status" value="Production" aris="AT_STANDARD_START" />

<attr alfabet="EndDate" condition="Status" value="Production" aris="AT_STANDARD_END" />

<attr alfabet="StartDate" condition="Status" value="Limited Production" aris="" /> <!-- tbd -->

<attr alfabet="EndDate" condition="Status" value="Limited Production" aris="" />

<attr alfabet="StartDate" condition="Status" value="Retired - Shut Down" aris="AT_TO_BE_PHASED_OUT_START" />

<attr alfabet="EndDate" condition="Status" value="Retired - Shut Down" aris="AT_TO_BE_PHASED_OUT_END" />

</foreignattr>

<attr alfabet="Name" aris="AT_NAME" />

<attr alfabet="ObjectState" aris="AT_REM" />

<attr alfabet="Description" aris="AT_DESC" />

...

<cxn property="NextVersion" cxntype="CT_IS_PRED_OF" srctotarget="true" forceexist="true" connected-objtype="OT_APPL_SYS_TYPE" overview-model="ST_APPL_SYS_TYPE"/>

<cxn property="ApplicationGroups" cxntype="CT_BELONGS_TO_CLS" srctotarget="true" forceexist="true" connected-objtype="OT_APPL_SYS_CLS" />

<cxn property="ICTObject" cxntype="CT_GENERAL" srctotarget="false" forceexist="true" connected-objtype="OT_APPL_SYS_TYPE" overview-model="ST_APPL_SYS_TYPE"/>

<cxn property="Products" />

...

</table>

Standardmäßige Alfabet-Import-Konfiguration

Diese Datei definiert sämtliche Objekte, die Alfabet-Objekten zugeordnet werden sollen. Zudem werden die zu importierenden und zu synchronisierenden Objekte sowie die Anmeldung für den Datenaustausch definiert.

ARIS-Benutzer greifen direkt oder indirekt auf Alfabet zu. Je nach Aktion werden unterschiedliche Authentifikationsarten verwendet:

  • Das Mapping einzelner Alfabet-Objekte, der Massenimport von Objekten oder das Synchronisieren von Daten erfordern Lesezugriff über die Alfabet REST API-Version 2.

    Schnittstelle zu Alfabet über die Daten ausgetauscht werden.

    Deshalb muss RESTful API sowohl in ARIS als auch in Alfabet aktiviert und konfiguriert werden. Weitere Informationen finden Sie im Alfabet-Referenzhandbuch der ARIS - Alfabet Interoperability Interface. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

    Die URL zur Schnittstelle geben Sie beim Verbinden der ARIS-Datenbank mit Alfabet ein. Benutzer benötigen dazu Lesezugriff in Alfabet.

    Falls Sie derzeit noch die Alfabet REST API-Version 1 verwenden, wird die in der Alfabet-Import-Konfiguration angegebene Anmeldung zur Authentifizierung verwendet. Im Eigenschaftsdialog Alfabet-Integration der entsprechenden Datenbank können Sie außerdem die Benutzeranmeldedaten, die Web-Service-URL und die Benutzeroberflächen-URL festlegen. Die Zugriffsrechte der konfigurierten Anmeldung definieren somit, welche Alfabet-Objekte für ARIS-Benutzer mit Zugriff auf die Aktionen sichtbar sind.

    Sie können jede ARIS-Datenbank mit einem Alfabet-System verbinden. Wenn Sie den Alfabet-Import konfiguriert haben, können die Benutzer Objekte aus den verbundenen ARIS- und Alfabet-Datenbanken verwenden und zum anderen System wechseln. Um eine Datenbank mit einem Alfabet-System zu verbinden, gehen Sie wie folgt vor:

    1. Klicken Sie auf Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Datenbanken.

    2. Gewählte Elemente Markieren Sie die Datenbank und klicken Sie auf Eigenschaften Eigenschaften > Alfabet-Konfiguration. Die Leiste Alfabet-Integrationseinstellungen der Datenbank '...' wird geöffnet.

    3. Geben Sie im Feld Web-Service-URL die URL zur Alfabet-Web-Anwendung ein. Die URL wird für den Zugriff auf den Alfabet Web-Service (Alfabet RESTful API) verwendet. Die Web-Service-URL wird für den Datenaustausch benötigt.

    4. Geben Sie im Feld Benutzeroberflächen-URL die URL ein, die für den Zugriff auf die Alfabet-Benutzeroberfläche verwendet werden soll. Diese URL wird benötigt, damit Benutzer aus ARIS heraus zu Alfabet-Objekten navigieren können.

    5. Geben Sie in den Feldern Benutzername und API-Kennwort/-Token: die erforderlichen Benutzerzugangsdaten ein.

      Weitere Informationen zu Kennwort, Token und Autorisierung finden Sie im Handbuch Alfabet Interface for RESTful Web Services. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

      Warnung

      Aus Sicherheitsgründen empfehlen wir die Verwendung der Alfabet RESTful API-Version 2. Aktivieren Sie Alfabet REST API v1 (not recommended) nicht. Software AG empfiehlt dringend, so bald wie möglich auf Alfabet RESTful API-Version 2 umzusteigen.

    6. Wählen Sie die erforderlichen Synchronisierungsoptionen für Objekte und Kanten aus, deren zugeordnete Objekte oder Kanten nicht mehr in Alfabet vorhanden sind. Die ausgewählten Aktionen werden während der Datensynchronisation automatisch ausgeführt.

      Objekte

      Nichts ändern

      Zugeordnete Objekte, die nicht mehr in Alfabet vorhanden sind, bleiben unverändert in der ARIS-Datenbank bestehen.

      Mapping löschen

      Löscht Verknüpfungen aus ARIS-Objekten, deren verbundene Objekte in Alfabet nicht mehr existieren.

      Diese Aktion kann nicht rückgängig gemacht werden.

      Objekte als gelöscht kennzeichnen

      Ermittelt alle ARIS-Objekte, deren zugeordnete Alfabet-Objekte nicht mehr verfügbar sind.

      Für diese Objekte ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

      Objekte löschen

      Löscht ARIS-Objekte, deren verbundene Objekte in Alfabet nicht mehr existieren.

      Dieser Vorgang kann nicht rückgängig gemacht werden.

      Kanten

      Nichts ändern

      Wurden Kanten zwischen den Alfabet-Objekten in Alfabet geändert oder gelöscht, bleiben diese Kanten in der ARIS-Datenbank unverändert.

      Mapping löschen

      Löscht Zuordnungen aus ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

      Dieser Vorgang kann nicht rückgängig gemacht werden.

      Kanten als gelöscht kennzeichnen

      Ermittelt alle ARIS-Kanten, deren zugeordnete Alfabet-Kanten nicht mehr in Alfabet verfügbar sind.

      Für diese Kanten ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

      Kanten löschen

      Löscht ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

      Dieser Vorgang kann nicht rückgängig gemacht werden.

    7. Klicken Sie auf Verbindung testen, um die eingegebenen Werte überprüfen zu lassen.

    8. War der Test erfolgreich, klicken Sie auf Speichern, um den Dialog zu schließen.

    Die Datenbank ist mit dem Alfabet-System verbunden.

    Warnung

    Beim Zugriff auf das Alfabet RESTful API werden die Anmeldedaten mit dem HTTP-Header übermittelt. Stellen Sie deshalb sicher, dass die Übertragung verschlüsselt erfolgt.

  • Zum Öffnen des Alfabet-Objekts benötigen Benutzer Lesezugriff im Alfabet Web User Interface. Benutzer müssen sich bei Alfabet selbst anmelden.

  • Zum Anlegen von Alfabet-Objekten benötigen Benutzer Schreibzugriff im Alfabet Web User Interface. Benutzer müssen sich bei Alfabet selbst anmelden.

Standardmäßig steht die Alfabet-Integration für Objekte des Typs Anwendungssystemtyp zur Verfügung. Falls Sie weitere ARIS-Objekttypen definieren wollen, müssen Sie zusätzliche <object>…</object> Einträge anlegen. Verwenden Sie die Mapping-Definition als Leitfaden für die Eingabe der Attributtypen.

Stellen Sie sicher, dass für jeden Objekttyp die definierten Attributtypen zur Verfügung stehen.

Benutzereinstellungen

Definiert die Anmeldung zur Alfabet RESTful API für den Datenaustausch.

ARIS-Benutzer greifen direkt oder indirekt auf Alfabet zu. Je nach Aktion werden unterschiedliche Authentifikationsarten verwendet:

  • Das Mapping einzelner Alfabet-Objekte, der Massenimport von Objekten oder das Synchronisieren von Daten erfordern Lesezugriff über die Alfabet REST API-Version 2.

    Schnittstelle zu Alfabet über die Daten ausgetauscht werden.

    Deshalb muss RESTful API sowohl in ARIS als auch in Alfabet aktiviert und konfiguriert werden. Weitere Informationen finden Sie im Alfabet-Referenzhandbuch der ARIS - Alfabet Interoperability Interface. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

    Die URL zur Schnittstelle geben Sie beim Verbinden der ARIS-Datenbank mit Alfabet ein. Benutzer benötigen dazu Lesezugriff in Alfabet.

    Falls Sie derzeit noch die Alfabet REST API-Version 1 verwenden, wird die in der Alfabet-Import-Konfiguration angegebene Anmeldung zur Authentifizierung verwendet. Im Eigenschaftsdialog Alfabet-Integration der entsprechenden Datenbank können Sie außerdem die Benutzeranmeldedaten, die Web-Service-URL und die Benutzeroberflächen-URL festlegen. Die Zugriffsrechte der konfigurierten Anmeldung definieren somit, welche Alfabet-Objekte für ARIS-Benutzer mit Zugriff auf die Aktionen sichtbar sind.

    Sie können jede ARIS-Datenbank mit einem Alfabet-System verbinden. Wenn Sie den Alfabet-Import konfiguriert haben, können die Benutzer Objekte aus den verbundenen ARIS- und Alfabet-Datenbanken verwenden und zum anderen System wechseln. Um eine Datenbank mit einem Alfabet-System zu verbinden, gehen Sie wie folgt vor:

    1. Klicken Sie auf Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Datenbanken.

    2. Gewählte Elemente Markieren Sie die Datenbank und klicken Sie auf Eigenschaften Eigenschaften > Alfabet-Konfiguration. Die Leiste Alfabet-Integrationseinstellungen der Datenbank '...' wird geöffnet.

    3. Geben Sie im Feld Web-Service-URL die URL zur Alfabet-Web-Anwendung ein. Die URL wird für den Zugriff auf den Alfabet Web-Service (Alfabet RESTful API) verwendet. Die Web-Service-URL wird für den Datenaustausch benötigt.

    4. Geben Sie im Feld Benutzeroberflächen-URL die URL ein, die für den Zugriff auf die Alfabet-Benutzeroberfläche verwendet werden soll. Diese URL wird benötigt, damit Benutzer aus ARIS heraus zu Alfabet-Objekten navigieren können.

    5. Geben Sie in den Feldern Benutzername und API-Kennwort/-Token: die erforderlichen Benutzerzugangsdaten ein.

      Weitere Informationen zu Kennwort, Token und Autorisierung finden Sie im Handbuch Alfabet Interface for RESTful Web Services. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

      Warnung

      Aus Sicherheitsgründen empfehlen wir die Verwendung der Alfabet RESTful API-Version 2. Aktivieren Sie Alfabet REST API v1 (not recommended) nicht. Software AG empfiehlt dringend, so bald wie möglich auf Alfabet RESTful API-Version 2 umzusteigen.

    6. Wählen Sie die erforderlichen Synchronisierungsoptionen für Objekte und Kanten aus, deren zugeordnete Objekte oder Kanten nicht mehr in Alfabet vorhanden sind. Die ausgewählten Aktionen werden während der Datensynchronisation automatisch ausgeführt.

      Objekte

      Nichts ändern

      Zugeordnete Objekte, die nicht mehr in Alfabet vorhanden sind, bleiben unverändert in der ARIS-Datenbank bestehen.

      Mapping löschen

      Löscht Verknüpfungen aus ARIS-Objekten, deren verbundene Objekte in Alfabet nicht mehr existieren.

      Diese Aktion kann nicht rückgängig gemacht werden.

      Objekte als gelöscht kennzeichnen

      Ermittelt alle ARIS-Objekte, deren zugeordnete Alfabet-Objekte nicht mehr verfügbar sind.

      Für diese Objekte ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

      Objekte löschen

      Löscht ARIS-Objekte, deren verbundene Objekte in Alfabet nicht mehr existieren.

      Dieser Vorgang kann nicht rückgängig gemacht werden.

      Kanten

      Nichts ändern

      Wurden Kanten zwischen den Alfabet-Objekten in Alfabet geändert oder gelöscht, bleiben diese Kanten in der ARIS-Datenbank unverändert.

      Mapping löschen

      Löscht Zuordnungen aus ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

      Dieser Vorgang kann nicht rückgängig gemacht werden.

      Kanten als gelöscht kennzeichnen

      Ermittelt alle ARIS-Kanten, deren zugeordnete Alfabet-Kanten nicht mehr in Alfabet verfügbar sind.

      Für diese Kanten ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

      Kanten löschen

      Löscht ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

      Dieser Vorgang kann nicht rückgängig gemacht werden.

    7. Klicken Sie auf Verbindung testen, um die eingegebenen Werte überprüfen zu lassen.

    8. War der Test erfolgreich, klicken Sie auf Speichern, um den Dialog zu schließen.

    Die Datenbank ist mit dem Alfabet-System verbunden.

    Warnung

    Beim Zugriff auf das Alfabet RESTful API werden die Anmeldedaten mit dem HTTP-Header übermittelt. Stellen Sie deshalb sicher, dass die Übertragung verschlüsselt erfolgt.

  • Zum Öffnen des Alfabet-Objekts benötigen Benutzer Lesezugriff im Alfabet Web User Interface. Benutzer müssen sich bei Alfabet selbst anmelden.

  • Zum Anlegen von Alfabet-Objekten benötigen Benutzer Schreibzugriff im Alfabet Web User Interface. Benutzer müssen sich bei Alfabet selbst anmelden.

Schnittstelle zu Alfabet über die Daten ausgetauscht werden.

Deshalb muss RESTful API sowohl in ARIS als auch in Alfabet aktiviert und konfiguriert werden. Weitere Informationen finden Sie im Alfabet-Referenzhandbuch der ARIS - Alfabet Interoperability Interface. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

Die URL zur Schnittstelle geben Sie beim Verbinden der ARIS-Datenbank mit Alfabet ein. Benutzer benötigen dazu Lesezugriff in Alfabet.

ARIS-Benutzer greifen direkt oder indirekt auf Alfabet zu. Je nach Aktion werden unterschiedliche Authentifikationsarten verwendet:

  • Das Mapping einzelner Alfabet-Objekte, der Massenimport von Objekten oder das Synchronisieren von Daten erfordern Lesezugriff über die Alfabet REST API-Version 2.

    Falls Sie derzeit noch die Alfabet REST API-Version 1 verwenden, wird die in der Alfabet-Import-Konfiguration angegebene Anmeldung zur Authentifizierung verwendet. Im Eigenschaftsdialog Alfabet-Integration der entsprechenden Datenbank können Sie außerdem die Benutzeranmeldedaten, die Web-Service-URL und die Benutzeroberflächen-URL festlegen. Die Zugriffsrechte der konfigurierten Anmeldung definieren somit, welche Alfabet-Objekte für ARIS-Benutzer mit Zugriff auf die Aktionen sichtbar sind.

    Sie können jede ARIS-Datenbank mit einem Alfabet-System verbinden. Wenn Sie den Alfabet-Import konfiguriert haben, können die Benutzer Objekte aus den verbundenen ARIS- und Alfabet-Datenbanken verwenden und zum anderen System wechseln. Um eine Datenbank mit einem Alfabet-System zu verbinden, gehen Sie wie folgt vor:

    1. Klicken Sie auf Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Datenbanken.

    2. Gewählte Elemente Markieren Sie die Datenbank und klicken Sie auf Eigenschaften Eigenschaften > Alfabet-Konfiguration. Die Leiste Alfabet-Integrationseinstellungen der Datenbank '...' wird geöffnet.

    3. Geben Sie im Feld Web-Service-URL die URL zur Alfabet-Web-Anwendung ein. Die URL wird für den Zugriff auf den Alfabet Web-Service (Alfabet RESTful API) verwendet. Die Web-Service-URL wird für den Datenaustausch benötigt.

    4. Geben Sie im Feld Benutzeroberflächen-URL die URL ein, die für den Zugriff auf die Alfabet-Benutzeroberfläche verwendet werden soll. Diese URL wird benötigt, damit Benutzer aus ARIS heraus zu Alfabet-Objekten navigieren können.

    5. Geben Sie in den Feldern Benutzername und API-Kennwort/-Token: die erforderlichen Benutzerzugangsdaten ein.

      Weitere Informationen zu Kennwort, Token und Autorisierung finden Sie im Handbuch Alfabet Interface for RESTful Web Services. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

      Warnung

      Aus Sicherheitsgründen empfehlen wir die Verwendung der Alfabet RESTful API-Version 2. Aktivieren Sie Alfabet REST API v1 (not recommended) nicht. Software AG empfiehlt dringend, so bald wie möglich auf Alfabet RESTful API-Version 2 umzusteigen.

    6. Wählen Sie die erforderlichen Synchronisierungsoptionen für Objekte und Kanten aus, deren zugeordnete Objekte oder Kanten nicht mehr in Alfabet vorhanden sind. Die ausgewählten Aktionen werden während der Datensynchronisation automatisch ausgeführt.

      Objekte

      Nichts ändern

      Zugeordnete Objekte, die nicht mehr in Alfabet vorhanden sind, bleiben unverändert in der ARIS-Datenbank bestehen.

      Mapping löschen

      Löscht Verknüpfungen aus ARIS-Objekten, deren verbundene Objekte in Alfabet nicht mehr existieren.

      Diese Aktion kann nicht rückgängig gemacht werden.

      Objekte als gelöscht kennzeichnen

      Ermittelt alle ARIS-Objekte, deren zugeordnete Alfabet-Objekte nicht mehr verfügbar sind.

      Für diese Objekte ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

      Objekte löschen

      Löscht ARIS-Objekte, deren verbundene Objekte in Alfabet nicht mehr existieren.

      Dieser Vorgang kann nicht rückgängig gemacht werden.

      Kanten

      Nichts ändern

      Wurden Kanten zwischen den Alfabet-Objekten in Alfabet geändert oder gelöscht, bleiben diese Kanten in der ARIS-Datenbank unverändert.

      Mapping löschen

      Löscht Zuordnungen aus ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

      Dieser Vorgang kann nicht rückgängig gemacht werden.

      Kanten als gelöscht kennzeichnen

      Ermittelt alle ARIS-Kanten, deren zugeordnete Alfabet-Kanten nicht mehr in Alfabet verfügbar sind.

      Für diese Kanten ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

      Kanten löschen

      Löscht ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

      Dieser Vorgang kann nicht rückgängig gemacht werden.

    7. Klicken Sie auf Verbindung testen, um die eingegebenen Werte überprüfen zu lassen.

    8. War der Test erfolgreich, klicken Sie auf Speichern, um den Dialog zu schließen.

    Die Datenbank ist mit dem Alfabet-System verbunden.

    Warnung

    Beim Zugriff auf das Alfabet RESTful API werden die Anmeldedaten mit dem HTTP-Header übermittelt. Stellen Sie deshalb sicher, dass die Übertragung verschlüsselt erfolgt.

  • Zum Öffnen des Alfabet-Objekts benötigen Benutzer Lesezugriff im Alfabet Web User Interface. Benutzer müssen sich bei Alfabet selbst anmelden.

  • Zum Anlegen von Alfabet-Objekten benötigen Benutzer Schreibzugriff im Alfabet Web User Interface. Benutzer müssen sich bei Alfabet selbst anmelden.

<user name="" token="T66JADHPYTWW3A7U2ACUFYUZZU7BPCFL" accessmode="httpclient"/>

user

Steuert die Anmeldung bei der Alfabet RESTful API für den Datenaustausch. Es müssen Benutzername, Token und Zugriffsmodus angegeben werden. Im Eigenschaftsdialog Alfabet-Integration der entsprechenden Datenbank können Sie außerdem die Benutzeranmeldedaten, die Web-Service-URL und die Benutzeroberflächen-URL festlegen.

Schnittstelle zu Alfabet über die Daten ausgetauscht werden.

Deshalb muss RESTful API sowohl in ARIS als auch in Alfabet aktiviert und konfiguriert werden. Weitere Informationen finden Sie im Alfabet-Referenzhandbuch der ARIS - Alfabet Interoperability Interface. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

Die URL zur Schnittstelle geben Sie beim Verbinden der ARIS-Datenbank mit Alfabet ein. Benutzer benötigen dazu Lesezugriff in Alfabet.

ARIS-Benutzer greifen direkt oder indirekt auf Alfabet zu. Je nach Aktion werden unterschiedliche Authentifikationsarten verwendet:

  • Das Mapping einzelner Alfabet-Objekte, der Massenimport von Objekten oder das Synchronisieren von Daten erfordern Lesezugriff über die Alfabet REST API-Version 2.

    Falls Sie derzeit noch die Alfabet REST API-Version 1 verwenden, wird die in der Alfabet-Import-Konfiguration angegebene Anmeldung zur Authentifizierung verwendet. Im Eigenschaftsdialog Alfabet-Integration der entsprechenden Datenbank können Sie außerdem die Benutzeranmeldedaten, die Web-Service-URL und die Benutzeroberflächen-URL festlegen. Die Zugriffsrechte der konfigurierten Anmeldung definieren somit, welche Alfabet-Objekte für ARIS-Benutzer mit Zugriff auf die Aktionen sichtbar sind.

    Sie können jede ARIS-Datenbank mit einem Alfabet-System verbinden. Wenn Sie den Alfabet-Import konfiguriert haben, können die Benutzer Objekte aus den verbundenen ARIS- und Alfabet-Datenbanken verwenden und zum anderen System wechseln. Um eine Datenbank mit einem Alfabet-System zu verbinden, gehen Sie wie folgt vor:

    1. Klicken Sie auf Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Datenbanken.

    2. Gewählte Elemente Markieren Sie die Datenbank und klicken Sie auf Eigenschaften Eigenschaften > Alfabet-Konfiguration. Die Leiste Alfabet-Integrationseinstellungen der Datenbank '...' wird geöffnet.

    3. Geben Sie im Feld Web-Service-URL die URL zur Alfabet-Web-Anwendung ein. Die URL wird für den Zugriff auf den Alfabet Web-Service (Alfabet RESTful API) verwendet. Die Web-Service-URL wird für den Datenaustausch benötigt.

    4. Geben Sie im Feld Benutzeroberflächen-URL die URL ein, die für den Zugriff auf die Alfabet-Benutzeroberfläche verwendet werden soll. Diese URL wird benötigt, damit Benutzer aus ARIS heraus zu Alfabet-Objekten navigieren können.

    5. Geben Sie in den Feldern Benutzername und API-Kennwort/-Token: die erforderlichen Benutzerzugangsdaten ein.

      Weitere Informationen zu Kennwort, Token und Autorisierung finden Sie im Handbuch Alfabet Interface for RESTful Web Services. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

      Warnung

      Aus Sicherheitsgründen empfehlen wir die Verwendung der Alfabet RESTful API-Version 2. Aktivieren Sie Alfabet REST API v1 (not recommended) nicht. Software AG empfiehlt dringend, so bald wie möglich auf Alfabet RESTful API-Version 2 umzusteigen.

    6. Wählen Sie die erforderlichen Synchronisierungsoptionen für Objekte und Kanten aus, deren zugeordnete Objekte oder Kanten nicht mehr in Alfabet vorhanden sind. Die ausgewählten Aktionen werden während der Datensynchronisation automatisch ausgeführt.

      Objekte

      Nichts ändern

      Zugeordnete Objekte, die nicht mehr in Alfabet vorhanden sind, bleiben unverändert in der ARIS-Datenbank bestehen.

      Mapping löschen

      Löscht Verknüpfungen aus ARIS-Objekten, deren verbundene Objekte in Alfabet nicht mehr existieren.

      Diese Aktion kann nicht rückgängig gemacht werden.

      Objekte als gelöscht kennzeichnen

      Ermittelt alle ARIS-Objekte, deren zugeordnete Alfabet-Objekte nicht mehr verfügbar sind.

      Für diese Objekte ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

      Objekte löschen

      Löscht ARIS-Objekte, deren verbundene Objekte in Alfabet nicht mehr existieren.

      Dieser Vorgang kann nicht rückgängig gemacht werden.

      Kanten

      Nichts ändern

      Wurden Kanten zwischen den Alfabet-Objekten in Alfabet geändert oder gelöscht, bleiben diese Kanten in der ARIS-Datenbank unverändert.

      Mapping löschen

      Löscht Zuordnungen aus ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

      Dieser Vorgang kann nicht rückgängig gemacht werden.

      Kanten als gelöscht kennzeichnen

      Ermittelt alle ARIS-Kanten, deren zugeordnete Alfabet-Kanten nicht mehr in Alfabet verfügbar sind.

      Für diese Kanten ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

      Kanten löschen

      Löscht ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

      Dieser Vorgang kann nicht rückgängig gemacht werden.

    7. Klicken Sie auf Verbindung testen, um die eingegebenen Werte überprüfen zu lassen.

    8. War der Test erfolgreich, klicken Sie auf Speichern, um den Dialog zu schließen.

    Die Datenbank ist mit dem Alfabet-System verbunden.

    Warnung

    Beim Zugriff auf das Alfabet RESTful API werden die Anmeldedaten mit dem HTTP-Header übermittelt. Stellen Sie deshalb sicher, dass die Übertragung verschlüsselt erfolgt.

  • Zum Öffnen des Alfabet-Objekts benötigen Benutzer Lesezugriff im Alfabet Web User Interface. Benutzer müssen sich bei Alfabet selbst anmelden.

  • Zum Anlegen von Alfabet-Objekten benötigen Benutzer Schreibzugriff im Alfabet Web User Interface. Benutzer müssen sich bei Alfabet selbst anmelden.

Sie können jede ARIS-Datenbank mit einem Alfabet-System verbinden. Wenn Sie den Alfabet-Import konfiguriert haben, können die Benutzer Objekte aus den verbundenen ARIS- und Alfabet-Datenbanken verwenden und zum anderen System wechseln. Um eine Datenbank mit einem Alfabet-System zu verbinden, gehen Sie wie folgt vor:

  1. Klicken Sie auf Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Datenbanken.

  2. Gewählte Elemente Markieren Sie die Datenbank und klicken Sie auf Eigenschaften Eigenschaften > Alfabet-Konfiguration. Die Leiste Alfabet-Integrationseinstellungen der Datenbank '...' wird geöffnet.

  3. Geben Sie im Feld Web-Service-URL die URL zur Alfabet-Web-Anwendung ein. Die URL wird für den Zugriff auf den Alfabet Web-Service (Alfabet RESTful API) verwendet. Die Web-Service-URL wird für den Datenaustausch benötigt.

  4. Geben Sie im Feld Benutzeroberflächen-URL die URL ein, die für den Zugriff auf die Alfabet-Benutzeroberfläche verwendet werden soll. Diese URL wird benötigt, damit Benutzer aus ARIS heraus zu Alfabet-Objekten navigieren können.

  5. Geben Sie in den Feldern Benutzername und API-Kennwort/-Token: die erforderlichen Benutzerzugangsdaten ein.

    Weitere Informationen zu Kennwort, Token und Autorisierung finden Sie im Handbuch Alfabet Interface for RESTful Web Services. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

    Warnung

    Aus Sicherheitsgründen empfehlen wir die Verwendung der Alfabet RESTful API-Version 2. Aktivieren Sie Alfabet REST API v1 (not recommended) nicht. Software AG empfiehlt dringend, so bald wie möglich auf Alfabet RESTful API-Version 2 umzusteigen.

  6. Wählen Sie die erforderlichen Synchronisierungsoptionen für Objekte und Kanten aus, deren zugeordnete Objekte oder Kanten nicht mehr in Alfabet vorhanden sind. Die ausgewählten Aktionen werden während der Datensynchronisation automatisch ausgeführt.

    Objekte

    Nichts ändern

    Zugeordnete Objekte, die nicht mehr in Alfabet vorhanden sind, bleiben unverändert in der ARIS-Datenbank bestehen.

    Mapping löschen

    Löscht Verknüpfungen aus ARIS-Objekten, deren verbundene Objekte in Alfabet nicht mehr existieren.

    Diese Aktion kann nicht rückgängig gemacht werden.

    Objekte als gelöscht kennzeichnen

    Ermittelt alle ARIS-Objekte, deren zugeordnete Alfabet-Objekte nicht mehr verfügbar sind.

    Für diese Objekte ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

    Objekte löschen

    Löscht ARIS-Objekte, deren verbundene Objekte in Alfabet nicht mehr existieren.

    Dieser Vorgang kann nicht rückgängig gemacht werden.

    Kanten

    Nichts ändern

    Wurden Kanten zwischen den Alfabet-Objekten in Alfabet geändert oder gelöscht, bleiben diese Kanten in der ARIS-Datenbank unverändert.

    Mapping löschen

    Löscht Zuordnungen aus ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

    Dieser Vorgang kann nicht rückgängig gemacht werden.

    Kanten als gelöscht kennzeichnen

    Ermittelt alle ARIS-Kanten, deren zugeordnete Alfabet-Kanten nicht mehr in Alfabet verfügbar sind.

    Für diese Kanten ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

    Kanten löschen

    Löscht ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

    Dieser Vorgang kann nicht rückgängig gemacht werden.

  7. Klicken Sie auf Verbindung testen, um die eingegebenen Werte überprüfen zu lassen.

  8. War der Test erfolgreich, klicken Sie auf Speichern, um den Dialog zu schließen.

Die Datenbank ist mit dem Alfabet-System verbunden.

Standardmäßig ist ein Beispieltoken gesetzt. Der Benutzername ist nicht eingetragen. Bei diesem anonymen Zugriff haben standardmäßig alle Benutzer Lese- und Schreibzugriff auf alle Alfabet-Objekte.

Tragen Sie den Schlüssel des Alfabet-Servers als Wert für den Tag token ein. Dieser Wert ist abhängig vom Benutzernamen. Tragen Sie einen Benutzernamen als Wert für den Tag name ein. Damit hat nur dieser Benutzer Zugriff aus die Alfabet-Objekte, für die er berechtigt ist.

  • Wenn kein Benutzername eingetragen ist, tragen Sie als token den Schlüssel des Alfabet-Servers ein, der in der Web-Konfigurationsdatei der Alfabet Web Application definiert wurde. Alle Benutzer haben dadurch lesenden und schreibenden Zugriff auf alle Alfabet-Objekte.

  • Wenn ein Benutzername eingetragen ist, tragen Sie als token den für den eingetragenen Benutzer definierten Schlüssel ein. Dieser Schlüssel wurde in Alfabet Expand generiert. Damit hat nur dieser Benutzer Zugriff aus die Alfabet-Objekte, für die er berechtigt ist.

Weitere Informationen zum Token und der Autorisierung finden Sie im Handbuch Alfabet Interface for RESTful Web Services. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

Beim Zugriff auf das Alfabet RESTful API werden die Anmeldedaten mit dem HTTP-Header übermittelt. Stellen Sie deshalb sicher, dass die Übertragung verschlüsselt erfolgt.

name

Benutzername für Alfabet RESTful API. Wenn die RESTful API des Alfabet-Systems für den anonymen Zugang konfiguriert ist, müssen Sie das entsprechende Token eingeben. Wenn die RESTful API für den Zugang eines Benutzers konfiguriert ist, müssen Sie sowohl den Benutzernamen als auch das Kennwort eingeben. Im Eigenschaftsdialog Alfabet-Integration der entsprechenden Datenbank können Sie außerdem die Benutzeranmeldedaten, die Web-Service-URL und die Benutzeroberflächen-URL festlegen.

Schnittstelle zu Alfabet über die Daten ausgetauscht werden.

Deshalb muss RESTful API sowohl in ARIS als auch in Alfabet aktiviert und konfiguriert werden. Weitere Informationen finden Sie im Alfabet-Referenzhandbuch der ARIS - Alfabet Interoperability Interface. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

Die URL zur Schnittstelle geben Sie beim Verbinden der ARIS-Datenbank mit Alfabet ein. Benutzer benötigen dazu Lesezugriff in Alfabet.

ARIS-Benutzer greifen direkt oder indirekt auf Alfabet zu. Je nach Aktion werden unterschiedliche Authentifikationsarten verwendet:

  • Das Mapping einzelner Alfabet-Objekte, der Massenimport von Objekten oder das Synchronisieren von Daten erfordern Lesezugriff über die Alfabet REST API-Version 2.

    Falls Sie derzeit noch die Alfabet REST API-Version 1 verwenden, wird die in der Alfabet-Import-Konfiguration angegebene Anmeldung zur Authentifizierung verwendet. Im Eigenschaftsdialog Alfabet-Integration der entsprechenden Datenbank können Sie außerdem die Benutzeranmeldedaten, die Web-Service-URL und die Benutzeroberflächen-URL festlegen. Die Zugriffsrechte der konfigurierten Anmeldung definieren somit, welche Alfabet-Objekte für ARIS-Benutzer mit Zugriff auf die Aktionen sichtbar sind.

    Sie können jede ARIS-Datenbank mit einem Alfabet-System verbinden. Wenn Sie den Alfabet-Import konfiguriert haben, können die Benutzer Objekte aus den verbundenen ARIS- und Alfabet-Datenbanken verwenden und zum anderen System wechseln. Um eine Datenbank mit einem Alfabet-System zu verbinden, gehen Sie wie folgt vor:

    1. Klicken Sie auf Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Datenbanken.

    2. Gewählte Elemente Markieren Sie die Datenbank und klicken Sie auf Eigenschaften Eigenschaften > Alfabet-Konfiguration. Die Leiste Alfabet-Integrationseinstellungen der Datenbank '...' wird geöffnet.

    3. Geben Sie im Feld Web-Service-URL die URL zur Alfabet-Web-Anwendung ein. Die URL wird für den Zugriff auf den Alfabet Web-Service (Alfabet RESTful API) verwendet. Die Web-Service-URL wird für den Datenaustausch benötigt.

    4. Geben Sie im Feld Benutzeroberflächen-URL die URL ein, die für den Zugriff auf die Alfabet-Benutzeroberfläche verwendet werden soll. Diese URL wird benötigt, damit Benutzer aus ARIS heraus zu Alfabet-Objekten navigieren können.

    5. Geben Sie in den Feldern Benutzername und API-Kennwort/-Token: die erforderlichen Benutzerzugangsdaten ein.

      Weitere Informationen zu Kennwort, Token und Autorisierung finden Sie im Handbuch Alfabet Interface for RESTful Web Services. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

      Warnung

      Aus Sicherheitsgründen empfehlen wir die Verwendung der Alfabet RESTful API-Version 2. Aktivieren Sie Alfabet REST API v1 (not recommended) nicht. Software AG empfiehlt dringend, so bald wie möglich auf Alfabet RESTful API-Version 2 umzusteigen.

    6. Wählen Sie die erforderlichen Synchronisierungsoptionen für Objekte und Kanten aus, deren zugeordnete Objekte oder Kanten nicht mehr in Alfabet vorhanden sind. Die ausgewählten Aktionen werden während der Datensynchronisation automatisch ausgeführt.

      Objekte

      Nichts ändern

      Zugeordnete Objekte, die nicht mehr in Alfabet vorhanden sind, bleiben unverändert in der ARIS-Datenbank bestehen.

      Mapping löschen

      Löscht Verknüpfungen aus ARIS-Objekten, deren verbundene Objekte in Alfabet nicht mehr existieren.

      Diese Aktion kann nicht rückgängig gemacht werden.

      Objekte als gelöscht kennzeichnen

      Ermittelt alle ARIS-Objekte, deren zugeordnete Alfabet-Objekte nicht mehr verfügbar sind.

      Für diese Objekte ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

      Objekte löschen

      Löscht ARIS-Objekte, deren verbundene Objekte in Alfabet nicht mehr existieren.

      Dieser Vorgang kann nicht rückgängig gemacht werden.

      Kanten

      Nichts ändern

      Wurden Kanten zwischen den Alfabet-Objekten in Alfabet geändert oder gelöscht, bleiben diese Kanten in der ARIS-Datenbank unverändert.

      Mapping löschen

      Löscht Zuordnungen aus ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

      Dieser Vorgang kann nicht rückgängig gemacht werden.

      Kanten als gelöscht kennzeichnen

      Ermittelt alle ARIS-Kanten, deren zugeordnete Alfabet-Kanten nicht mehr in Alfabet verfügbar sind.

      Für diese Kanten ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

      Kanten löschen

      Löscht ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

      Dieser Vorgang kann nicht rückgängig gemacht werden.

    7. Klicken Sie auf Verbindung testen, um die eingegebenen Werte überprüfen zu lassen.

    8. War der Test erfolgreich, klicken Sie auf Speichern, um den Dialog zu schließen.

    Die Datenbank ist mit dem Alfabet-System verbunden.

    Warnung

    Beim Zugriff auf das Alfabet RESTful API werden die Anmeldedaten mit dem HTTP-Header übermittelt. Stellen Sie deshalb sicher, dass die Übertragung verschlüsselt erfolgt.

  • Zum Öffnen des Alfabet-Objekts benötigen Benutzer Lesezugriff im Alfabet Web User Interface. Benutzer müssen sich bei Alfabet selbst anmelden.

  • Zum Anlegen von Alfabet-Objekten benötigen Benutzer Schreibzugriff im Alfabet Web User Interface. Benutzer müssen sich bei Alfabet selbst anmelden.

Sie können jede ARIS-Datenbank mit einem Alfabet-System verbinden. Wenn Sie den Alfabet-Import konfiguriert haben, können die Benutzer Objekte aus den verbundenen ARIS- und Alfabet-Datenbanken verwenden und zum anderen System wechseln. Um eine Datenbank mit einem Alfabet-System zu verbinden, gehen Sie wie folgt vor:

  1. Klicken Sie auf Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Datenbanken.

  2. Gewählte Elemente Markieren Sie die Datenbank und klicken Sie auf Eigenschaften Eigenschaften > Alfabet-Konfiguration. Die Leiste Alfabet-Integrationseinstellungen der Datenbank '...' wird geöffnet.

  3. Geben Sie im Feld Web-Service-URL die URL zur Alfabet-Web-Anwendung ein. Die URL wird für den Zugriff auf den Alfabet Web-Service (Alfabet RESTful API) verwendet. Die Web-Service-URL wird für den Datenaustausch benötigt.

  4. Geben Sie im Feld Benutzeroberflächen-URL die URL ein, die für den Zugriff auf die Alfabet-Benutzeroberfläche verwendet werden soll. Diese URL wird benötigt, damit Benutzer aus ARIS heraus zu Alfabet-Objekten navigieren können.

  5. Geben Sie in den Feldern Benutzername und API-Kennwort/-Token: die erforderlichen Benutzerzugangsdaten ein.

    Weitere Informationen zu Kennwort, Token und Autorisierung finden Sie im Handbuch Alfabet Interface for RESTful Web Services. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

    Warnung

    Aus Sicherheitsgründen empfehlen wir die Verwendung der Alfabet RESTful API-Version 2. Aktivieren Sie Alfabet REST API v1 (not recommended) nicht. Software AG empfiehlt dringend, so bald wie möglich auf Alfabet RESTful API-Version 2 umzusteigen.

  6. Wählen Sie die erforderlichen Synchronisierungsoptionen für Objekte und Kanten aus, deren zugeordnete Objekte oder Kanten nicht mehr in Alfabet vorhanden sind. Die ausgewählten Aktionen werden während der Datensynchronisation automatisch ausgeführt.

    Objekte

    Nichts ändern

    Zugeordnete Objekte, die nicht mehr in Alfabet vorhanden sind, bleiben unverändert in der ARIS-Datenbank bestehen.

    Mapping löschen

    Löscht Verknüpfungen aus ARIS-Objekten, deren verbundene Objekte in Alfabet nicht mehr existieren.

    Diese Aktion kann nicht rückgängig gemacht werden.

    Objekte als gelöscht kennzeichnen

    Ermittelt alle ARIS-Objekte, deren zugeordnete Alfabet-Objekte nicht mehr verfügbar sind.

    Für diese Objekte ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

    Objekte löschen

    Löscht ARIS-Objekte, deren verbundene Objekte in Alfabet nicht mehr existieren.

    Dieser Vorgang kann nicht rückgängig gemacht werden.

    Kanten

    Nichts ändern

    Wurden Kanten zwischen den Alfabet-Objekten in Alfabet geändert oder gelöscht, bleiben diese Kanten in der ARIS-Datenbank unverändert.

    Mapping löschen

    Löscht Zuordnungen aus ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

    Dieser Vorgang kann nicht rückgängig gemacht werden.

    Kanten als gelöscht kennzeichnen

    Ermittelt alle ARIS-Kanten, deren zugeordnete Alfabet-Kanten nicht mehr in Alfabet verfügbar sind.

    Für diese Kanten ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

    Kanten löschen

    Löscht ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

    Dieser Vorgang kann nicht rückgängig gemacht werden.

  7. Klicken Sie auf Verbindung testen, um die eingegebenen Werte überprüfen zu lassen.

  8. War der Test erfolgreich, klicken Sie auf Speichern, um den Dialog zu schließen.

Die Datenbank ist mit dem Alfabet-System verbunden.

token

Benutzertoken. Dieser Wert ist abhängig vom Benutzernamen. Im Eigenschaftsdialog Alfabet-Integration der entsprechenden Datenbank können Sie außerdem die Benutzeranmeldedaten, die Web-Service-URL und die Benutzeroberflächen-URL festlegen.

Sie können jede ARIS-Datenbank mit einem Alfabet-System verbinden. Wenn Sie den Alfabet-Import konfiguriert haben, können die Benutzer Objekte aus den verbundenen ARIS- und Alfabet-Datenbanken verwenden und zum anderen System wechseln. Um eine Datenbank mit einem Alfabet-System zu verbinden, gehen Sie wie folgt vor:

  1. Klicken Sie auf Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Datenbanken.

  2. Gewählte Elemente Markieren Sie die Datenbank und klicken Sie auf Eigenschaften Eigenschaften > Alfabet-Konfiguration. Die Leiste Alfabet-Integrationseinstellungen der Datenbank '...' wird geöffnet.

  3. Geben Sie im Feld Web-Service-URL die URL zur Alfabet-Web-Anwendung ein. Die URL wird für den Zugriff auf den Alfabet Web-Service (Alfabet RESTful API) verwendet. Die Web-Service-URL wird für den Datenaustausch benötigt.

  4. Geben Sie im Feld Benutzeroberflächen-URL die URL ein, die für den Zugriff auf die Alfabet-Benutzeroberfläche verwendet werden soll. Diese URL wird benötigt, damit Benutzer aus ARIS heraus zu Alfabet-Objekten navigieren können.

  5. Geben Sie in den Feldern Benutzername und API-Kennwort/-Token: die erforderlichen Benutzerzugangsdaten ein.

    Weitere Informationen zu Kennwort, Token und Autorisierung finden Sie im Handbuch Alfabet Interface for RESTful Web Services. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

    Warnung

    Aus Sicherheitsgründen empfehlen wir die Verwendung der Alfabet RESTful API-Version 2. Aktivieren Sie Alfabet REST API v1 (not recommended) nicht. Software AG empfiehlt dringend, so bald wie möglich auf Alfabet RESTful API-Version 2 umzusteigen.

  6. Wählen Sie die erforderlichen Synchronisierungsoptionen für Objekte und Kanten aus, deren zugeordnete Objekte oder Kanten nicht mehr in Alfabet vorhanden sind. Die ausgewählten Aktionen werden während der Datensynchronisation automatisch ausgeführt.

    Objekte

    Nichts ändern

    Zugeordnete Objekte, die nicht mehr in Alfabet vorhanden sind, bleiben unverändert in der ARIS-Datenbank bestehen.

    Mapping löschen

    Löscht Verknüpfungen aus ARIS-Objekten, deren verbundene Objekte in Alfabet nicht mehr existieren.

    Diese Aktion kann nicht rückgängig gemacht werden.

    Objekte als gelöscht kennzeichnen

    Ermittelt alle ARIS-Objekte, deren zugeordnete Alfabet-Objekte nicht mehr verfügbar sind.

    Für diese Objekte ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

    Objekte löschen

    Löscht ARIS-Objekte, deren verbundene Objekte in Alfabet nicht mehr existieren.

    Dieser Vorgang kann nicht rückgängig gemacht werden.

    Kanten

    Nichts ändern

    Wurden Kanten zwischen den Alfabet-Objekten in Alfabet geändert oder gelöscht, bleiben diese Kanten in der ARIS-Datenbank unverändert.

    Mapping löschen

    Löscht Zuordnungen aus ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

    Dieser Vorgang kann nicht rückgängig gemacht werden.

    Kanten als gelöscht kennzeichnen

    Ermittelt alle ARIS-Kanten, deren zugeordnete Alfabet-Kanten nicht mehr in Alfabet verfügbar sind.

    Für diese Kanten ist das Attribut Alfabet - Löschkandidat (AT_ALFA_DELETE_CANDIDATE, 4152) auf true gesetzt.

    Kanten löschen

    Löscht ARIS-Kanten, deren verbundene Kanten in Alfabet nicht mehr existieren.

    Dieser Vorgang kann nicht rückgängig gemacht werden.

  7. Klicken Sie auf Verbindung testen, um die eingegebenen Werte überprüfen zu lassen.

  8. War der Test erfolgreich, klicken Sie auf Speichern, um den Dialog zu schließen.

Die Datenbank ist mit dem Alfabet-System verbunden.

Wenn kein Benutzername eingegeben wird (Standardeinstellung) und der Schlüssel für den in der Web-Konfigurationsdatei für die Alfabet-Webanwendung definierten Alfabet-Server als Token eingegeben wird, haben sämtliche Benutzer auf alle Alfabet-Objekte Lese- und Schreibzugriff.

Wenn Sie einen Benutzernamen eingeben, hat nur dieser Benutzer, je nach den gewährten Rechten, Zugriff auf die Alfabet-Objekte.

Weitere Informationen zu Kennwort, Token und Autorisierung finden Sie im Handbuch Alfabet Interface for RESTful Web Services. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

accessmode

Zugriffsmodus des Benutzers. Die Standardeinstellung ist httpclient.

Individuelles Mapping

Im Abschnitt <!-- Single object mapping --> können Sie ARIS-Elemente einzeln mit Alfabet-Elementen verknüpfen.

<!-- Single object mapping -->

<object aristype="OT_APPL_SYS_TYPE" table="APPLICATION" >

object XML-Eigenschaft

Jedes object-Element definiert ein bestimmtes ARIS-Element, das bei der Alfabet-Integration bereitgestellt wird. Deshalb müssen Sie jedes ARIS-Element in einem separaten object-Element definieren.

aristype

API-Name eines Objekt-, Modell- oder Symboltyps.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Definiert den ARIS-Elementtyp, der für die Verbindung von einzelnen Elementen während der Alfabet-Integration bereitgestellt wird. Symboltypen können zur Angabe der Objekttypen verwendet werden. Sie können mehrere ARIS-Elementtypen für dieselbe Alfabet-Tabelle definieren. Sie sollten jeden ARIS-Elementtyp in einem separaten <object>-Eintrag definieren.

Die aristype-Werte müssen genau mit dem Wert in der Datei ARIS - ALFABET-mapping.xml übereinstimmen.

Wenn Sie den standardmäßigen Objekttyp Anwendungssystemtyp (OT_APPL_SYS_TYPE) ändern möchten, stellen Sie sicher, dass für den stattdessen verwendeten Objekttyp alle für die Alfabet-Integration benötigten Attributtypen zur Verfügung stehen.

Standardmäßig sind das die Typen Name (AT_NAME), Description (AT_DESC), Release (AT_REL_3) und ALFABET Link 1 (AT_ALFA_LINK_1). Fügen Sie in diesem Fall auch alle Alfabet-Attribute hinzu.

Natürlich können Sie die zu verwendenden Attribute der Objekttypen ändern oder andere Attribute übertragen. Wenn Sie z. B. für den Release-Stand (Version) nicht den Attributtyp Release-Stand (AT_REL_3) verwenden möchten, passen Sie bitte beide Konfigurationsdateien an.

table

Name der Alfabet-Datenbanktabelle mit den zu verbindenden Elementen, z. B. "APPLICATION".

Der table-Wert muss genau mit dem Wert in der Mapping-Definition übereinstimmen.

<condition property="ObjectState" value="Active" />

condition property

Eigenschaftsname der Alfabet-Tabelle, z. B. ObjectState.

Der festgelegte Wert dieser Alfabet-Klassen-Eigenschaft wird als Filter verwendet. Nur Elemente der Alfabet-Datenbanktabelle des festgelegten Werts können verbunden werden.

Sie geben nur eine Bedingungseigenschaft zum Filtern ein.

Value

Wert der festgelegten Alfabet-Klassen-Eigenschaft, die zum Filtern von Tabellenelementen verwendet werden soll.

In diesem Beispiel ist der ObjectState-Eigenschaftswert Active. Der festgelegte Wert dieser Alfabet-Klassen-Eigenschaft wird als Filter verwendet. Nur Elemente der Alfabet-Datenbanktabelle des festgelegten Werts können verbunden werden.

<attr aris="AT_NAME" />

attr XML-Eigenschaft

Definiert die Behandlung von Attributen.

Wenn mindestens ein attr-Unterelement angegeben ist, wird dadurch die Liste der in ARIS importierten Attribute auf die hier angegebenen attr-Elemente beschränkt.

Das Attribut Name wird beim Austausch von Daten standardmäßig überschrieben.

Wenn Sie ein ARIS-Objekt mit einem Alfabet-Objekt verbinden, wird zukünftig der Name des Alfabet-Objekts verwendet. Der Objektname wird in ARIS überschrieben.

<attr aris="AT_DESC" />

aris

API-Name des ARIS-Attributtyps. Dieser Name wird als Identifizierer für das Attribut aus der Alfabet-Import-Konfiguration verwendet.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Standardmäßig werden die Typen Name (AT_NAME), Beschreibung (AT_DESC), Release-Stand (AT_REL_3) und Alfabet Link 1 (AT_ALFA_LINK_1) verwendet. Natürlich können Sie die zu verwendenden Attribute der Objekttypen ändern oder andere Attribute übertragen. Wenn Sie z. B. für den Release-Stand (Version) nicht den Attributtyp Release-Stand (AT_REL_3) verwenden möchten, ändern Sie bitte beide Konfigurationsdateien.

Wenn Sie den zu importierenden Standard-ARIS-Objekttyp (OT_APPL_SYS_TYPE) ändern möchten, stellen Sie sicher, dass für den stattdessen zu verwendenden Objekttyp alle für die Alfabet-Integration benötigten Attributtypen zur Verfügung stehen.

Das Attribut Beschreibung/Definition wird beim Austausch von Daten standardmäßig überschrieben.

Wenn Sie ein ARIS-Objekt mit einem Alfabet-Objekt verbinden, wird zukünftig die Beschreibung des Alfabet-Objekts verwendet. Das Attribut Beschreibung/Definition wird in ARIS überschrieben.

<attr aris="AT_REL_3" />

Das Attribut Release wird beim Austausch von Daten standardmäßig überschrieben.

Wenn Sie ein ARIS-Objekt mit einem Alfabet-Objekt verbinden, wird die Alfabet-Eigenschaft Version aktualisiert.

<link attribute="AT_ALFA_LINK_1" title="AT_ALFA_NAVI1" defaultvalue="Navigate to Application in Alfabet" >

link

Legt ARIS-Link-Attribute als eine Referenz zwischen ARIS und Alfabet an.

attribute

API-Name für den Attributtyp des ARIS-Attributs "link", das für die Navigation zum Alfabet-Objekt verwendet wird. Standardmäßig wird der Attributtyp Alfabet-Link 1 (AT_ALFA_LINK_1) verwendet, um die URL im Alfabet-Objekt zu speichern.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

title

API-Name für den Attributtyp des zu verwendenden ARIS-Attributs link title. Standardmäßig wird der Attributtyp Alfabet Navigation 1 verwendet, um den Text des Link-Titels zu speichern.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Dieser Text wird in der defaultvalue-XML-Eigenschaft eingetragen. Er wird für alle Sprachen angezeigt, die nicht explizit unter der title locale-XML-Eigenschaft angegeben sind. Der Titel ist in ARIS schreibgeschützt und wird während der Verbindung zu Alfabet oder dem ARIS-Alfabet-Synchronisationsreport gepflegt.

defaultvalue

Nicht lokalisierter Standardtext für den Text des Link-Titels.

Dieser Text wird für alle Sprachen angezeigt, die nicht explizit unter der title locale-XML-Eigenschaft angegeben sind. Der Titel ist in ARIS schreibgeschützt und wird während der Verbindung zu Alfabet oder dem ARIS-Alfabet-Synchronisationsreport gepflegt.

<title locale="1033" value="Navigate to Application in Alfabet" />

locale

Locale ID (LCID) der Sprache, in der der Link-Titel übertragen wird.

Standardmäßig werden die Daten in Englisch (1033) übertragen. Wenn Sie sich bei der ARIS-Datenbank z. B. mit Deutsch angemeldet haben, werden die Werte der deutschen Attribute auf Englisch angezeigt.

value

Lokalisierter Titeltext.

</link>

</object>

<dialog-columns alfatype="APPLICATION">

dialog-columns alfatype

Definiert die Alfabet-Tabelle, die im Dialog Alfabet-Objekt wählen zur Verfügung stehen soll.

In diesem Beispiel ist die Alfabet-Tabelle APPLICATION die Quelle. Alle Alfabet-Objekte in dieser Tabelle werden angezeigt.

<column alfabet="Version"/>

column alfabet

Definiert Spalten und Inhalte, die im Dialog Alfabet-Objekt wählen angezeigt werden sollen.

In diesem Beispiel ist Version der Eigenschaftsname, der als Spaltentitel verwendet werden soll. Alle Werte dieser Eigenschaft werden in dieser Spalte angezeigt. Version bezieht sich auf das untergeordnete Element attr der Tabelle APPLICATION, die in der Konfigurationsdatei aufgeführt ist. Sie können alle anderen Eigenschaften verwenden, z. B. Status.

<newlink url="ExternalAccess.aspx?AccessType=ExternalAccess&amp;UserType=Named&amp;View=GraphicView:APP_CaptureApplications_Ex"/>-->

newlink url

Definiert den Link zu Alfabet für das Anlegen von neuen Alfabet-Objekten. Dieser Link Alfabet-Objekt anlegen steht im Dialog Alfabet-Objekt wählen zur Verfügung.

Nehmen Sie an diesem Wert keine Änderungen vor:

"ExternalAccess.aspx?AccessType=ExternalAccess&amp;UserType=Named&amp;View=GraphicView:APP_CaptureApplications_Ex"

Der Wert stellt den statischen Teil des Links dar. Die Verknüpfung setzt sich aus diesem Wert und dem Wert Benutzeroberflächen-URL zusammen, den Sie angegeben haben, als Sie die ARIS-Datenbank mit dem Alfabet-System verbunden haben.

</dialog-columns>

Massenimport aus Alfabet

Im Abschnitt <!-- Bulk mapping --> können Sie die Alfabet-Synchronisation und die Massenimportfunktion konfigurieren.

<sync table="APPLICATION" cxnhandling="ignore" > <!-- values for cxnhandling = ignore, create, createAllowForce-->

sync

Jedes sync-Element definiert eine bestimmte Alfabet-Tabelle, die synchronisiert werden soll. Deshalb muss jede Tabelle in einem eigenen sync-Element definiert werden. Die Alfabet-Synchronisation kann manuell oder mit Hilfe eines zeitgesteuerten Reports gestartet werden. Sämtliche Objekte und Beziehungen, die in ARIS noch nicht verfügbar sind, werden importiert und mit den entsprechenden Alfabet-Elementen verknüpft. Wenn Sie diesen Abschnitt nicht konfigurieren, steht die Funktionalität in ARIS nicht zur Verfügung.

table

Name der Alfabet-Datenbanktabelle mit den zu verbindenden Elementen, z. B. "APPLICATION".

Der table-Wert muss genau mit dem Wert in der Mapping-Definition übereinstimmen.

cxnhandling

Legt die Standardkantenbehandlung von verbundenen Kanten für diese Tabelle fest. Sie können diese Einstellung überschreiben, indem Sie cxn-Unterelemente angeben.

Es gibt drei mögliche Werte:

  • ignore

    Nicht aufgeführte Kanten werden nicht importiert. Wenn kein cxnhandling-Attribut angegeben ist, ist dies die Standardeinstellung.

  • create

    Kanten werden angelegt, wenn vor Import/Synchronisation des eigentlichen Elements das Quell- oder Zielobjekt der Kante bereits vorhanden war.

  • createAllowForce

    Kanten werden basierend auf der Spezifikation in der Datei ARIS-ALFABET-mapping.xml angelegt. Wenn die Verbindung das Bestehen des entsprechenden Ziel- oder Quellobjekts erzwingt, wird die Kante basierend auf der Spezifikation in der Datei ARIS-ALFABET-mapping.xml importiert.

<condition property="ObjectState" value="Active" />

condition property

Eigenschaftsname der Alfabet-Tabelle, z. B. ObjectState.

Der festgelegte Wert dieser Alfabet-Klassen-Eigenschaft wird als Filter verwendet. Nur Elemente der Alfabet-Datenbanktabelle des festgelegten Werts können verbunden werden.

Sie geben nur eine Bedingungseigenschaft zum Filtern ein.

Value

Wert der festgelegten Alfabet-Klassen-Eigenschaft, die zum Filtern von Tabellenelementen verwendet werden soll.

In diesem Beispiel ist der ObjectState-Eigenschaftswert Active. Der festgelegte Wert dieser Alfabet-Klassen-Eigenschaft wird als Filter verwendet. Nur Elemente der Alfabet-Datenbanktabelle des festgelegten Werts können verbunden werden.

<attr aris="AT_NAME" />

attr XML-Eigenschaft

Definiert die Behandlung von Attributen.

Wenn mindestens ein attr-Unterelement angegeben ist, wird dadurch die Liste der in ARIS importierten Attribute auf die hier angegebenen attr-Elemente beschränkt.

Das Attribut Name wird beim Austausch von Daten standardmäßig überschrieben.

Wenn Sie ein ARIS-Objekt mit einem Alfabet-Objekt verbinden, wird zukünftig der Name des Alfabet-Objekts verwendet. Der Objektname wird in ARIS überschrieben.

<attr aris="AT_DESC" />

aris

API-Name des ARIS-Attributtyps. Dieser Name wird als Identifizierer für das Attribut aus der Alfabet-Import-Konfiguration verwendet.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Standardmäßig werden die Typen Name (AT_NAME), Beschreibung (AT_DESC), Release-Stand (AT_REL_3) und Alfabet Link 1 (AT_ALFA_LINK_1) verwendet. Natürlich können Sie die zu verwendenden Attribute der Objekttypen ändern oder andere Attribute übertragen. Wenn Sie z. B. für den Release-Stand (Version) nicht den Attributtyp Release-Stand (AT_REL_3) verwenden möchten, ändern Sie bitte beide Konfigurationsdateien.

Wenn Sie den zu importierenden Standard-ARIS-Objekttyp (OT_APPL_SYS_TYPE) ändern möchten, stellen Sie sicher, dass für den stattdessen zu verwendenden Objekttyp alle für die Alfabet-Integration benötigten Attributtypen zur Verfügung stehen.

Das Attribut Beschreibung/Definition wird beim Austausch von Daten standardmäßig überschrieben.

Wenn Sie ein ARIS-Objekt mit einem Alfabet-Objekt verbinden, wird zukünftig die Beschreibung des Alfabet-Objekts verwendet. Das Attribut Beschreibung/Definition wird in ARIS überschrieben.

<attr aris="AT_REL_3" />

Das Attribut Release wird beim Austausch von Daten standardmäßig überschrieben.

Wenn Sie ein ARIS-Objekt mit einem Alfabet-Objekt verbinden, wird die Alfabet-Eigenschaft Version aktualisiert.

<cxn property="NextVersion" cxnhandling="createAllowForce" />

cxn

Legt genau fest, welche der in der Datei ARIS-ALFABET-mapping.xml verbundenen Beziehungen importiert/synchronisiert werden sollen.

  • Wenn mindestens ein cxn-Unterelement angegeben ist, wird dadurch die Liste der in ARIS importierten Beziehungen auf die hier angegebenen cxn-Elemente beschränkt.

  • Wenn kein cxn-Element angegeben ist, definiert die cxnhandling-XML-Eigenschaft des übergeordneten Elements (object oder sync), ob und wie in der Datei ARIS-ALFABET-mapping.xml definierte Kanten importiert werden.

property

Name der Alfabet-Eigenschaft, die diese Kante definiert. Die Eigenschaft muss vom Typ Reference oder ReferenceArray sein.

Weitere Informationen finden Sie in der Dokumentation des Alfabet-Meta-Modells im Alfabet-Referenzhandbuch.

cxnhandling

Definiert für diese Tabelle, wie die verbundenen Kanten standardmäßig behandelt werden sollen. Sie können diese Einstellung überschreiben, indem Sie cxn-Unterelemente angeben.

Es gibt drei mögliche Werte:

  • ignore

    Die Kante wird nicht importiert.

  • create

    Kanten werden angelegt, wenn vor Import/Synchronisation des eigentlichen Elements das Quell- oder Zielobjekt der Kante bereits vorhanden war.

  • createAllowForce

    Kanten werden basierend auf der Spezifikation in der Datei ARIS-ALFABET-mapping.xml angelegt. Wenn die Verbindung das Bestehen des entsprechenden Ziel- oder Quellobjekts erzwingt, wird die Kante basierend auf der Spezifikation in der Datei ARIS-ALFABET-mapping.xml importiert.

    Wenn kein cxnhandling-Attribut angegeben ist, ist dies die Standardeinstellung.

<link attribute="AT_ALFA_LINK_1" title="AT_ALFA_NAVI1" defaultvalue="Navigate to Application in Alfabet" >

link

Legt ARIS-Link-Attribute als eine Referenz zwischen ARIS und Alfabet an.

attribute

API-Name für den Attributtyp des ARIS-Attributs "link", das für die Navigation zum Alfabet-Objekt verwendet wird. Standardmäßig wird der Attributtyp Alfabet-Link 1 (AT_ALFA_LINK_1) verwendet, um die URL im Alfabet-Objekt zu speichern.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

title

API-Name für den Attributtyp des zu verwendenden ARIS-Attributs link title. Standardmäßig wird der Attributtyp Alfabet Navigation 1 verwendet, um den Text des Link-Titels zu speichern.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Dieser Text wird in der defaultvalue-XML-Eigenschaft eingetragen. Er wird für alle Sprachen angezeigt, die nicht explizit unter der title locale-XML-Eigenschaft angegeben sind. Der Titel ist in ARIS schreibgeschützt und wird während der Verbindung zu Alfabet oder dem ARIS-Alfabet-Synchronisationsreport gepflegt.

defaultvalue

Nicht lokalisierter Standardtext für den Text des Link-Titels.

Dieser Text wird für alle Sprachen angezeigt, die nicht explizit unter der title locale-XML-Eigenschaft angegeben sind. Der Titel ist in ARIS schreibgeschützt und wird während der Verbindung zu Alfabet oder dem ARIS-Alfabet-Synchronisationsreport gepflegt.

<title locale="1033" value="Navigate to Application in Alfabet" />

locale

Locale ID (LCID) der Sprache, in der der Link-Titel übertragen wird.

Standardmäßig werden die Daten in Englisch (1033) übertragen. Wenn Sie sich bei der ARIS-Datenbank z. B. mit Deutsch angemeldet haben, werden die Werte der deutschen Attribute auf Englisch angezeigt.

value

Lokalisierter Titeltext.

</link>

</sync>

Mappingsyntax für Tabellen, die Bebauungseinheiten (PSU) definieren

Alfabet-Tabellen, z. B. BUSINESSSUPPORT, die als Bebauungsmatrix (PSM) importiert werden sollen, werden mit Hilfe der psutable-XML-Eigenschaft abgebildet.

ARIS verarbeitet PSUs automatisch. Deshalb sind eine bestimmte Datenbankgruppenstruktur und definierte Beziehungen erforderlich. Beziehungen werden von den cxn-XML-Eigenschaften zusammen mit deren attr-Unterelementen definiert. Das Kanten-Mapping, das die Eigenschaften xobject und yobject zusammen mit den XML-Eigenschaften cxntype und connected-objtype verwendet, definiert zwei Untergruppenebenen.

Wenn die PSU bereits in ARIS vorhanden ist, wird sie wiederverwendet. Deshalb müssen die referenzierten Objekte xobject und yobject bereits vorhanden sein.

<psutable name="BUSINESSSUPPORT" arisgroupname="Business support" aristype="OT_PROCESS_SUPPORT_UNIT">

psutable XML-Eigenschaft

Jedes psutable-Element definiert eine bestimmte Alfabet-Tabelle, die als Bebauungsmatrix (PSM) importiert werden soll. Daher muss jede Tabelle in einem eigenen psutable-Element definiert werden.

name

Name der Alfabet-Tabelle, die als Bebauungseinheit (PSU) importiert werden soll, z. B. BUSINESSSUPPORT.

arisgroupname XML-Eigenschaft

Name der ARIS-Datenbankuntergruppe, in der die Bebauungseinheit (PSU) angelegt wird.

aristype XML-Eigenschaft

API-Name des ARIS-Objekttyps, der für Bebauungseinheiten verwendet werden soll.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Standardmäßig wird in ARIS der Objekttyp Bebauungseinheit (OT_PROCESS_SUPPORT_UNIT) verwendet. Der aristype-Wert muss genau mit dem Wert in der Datei ARIS - ALFABET-mapping.xml übereinstimmen.

<!-- these attributes are mapped as attributes of the PSU object-->

<attr alfabet="CREATION_USER" aris="AT_CREATOR" />

attr XML-Eigenschaft

Definiert die Behandlung von Attributen.

Wenn mindestens ein attr-Unterelement angegeben ist, wird dadurch die Liste der in ARIS importierten Attribute auf die hier angegebenen attr-Elemente beschränkt.

alfabet

Name der Alfabet-Eigenschaft.

aris XML-Eigenschaft

API-Name des ARIS-Attributs.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Leerstring (""): nicht verbunden/ignoriert.

<attr alfabet="LAST_UPDATE_USER" aris="AT_LUSER" />

<attr alfabet="LAST_UPDATE" aris="AT_LAST_CHNG_2" />

<attr alfabet="CREATION_DATE" aris="AT_CREAT_TIME_STMP" />

<cxn property="object" cxntype="CT_BELONGS_TO_PROC_SUPPORT_UNIT" srctotarget="false" connected-objtype="OT_APPL_SYS_TYPE" >

cxn XML-Eigenschaft

Die cxn-XML-Eigenschaften definieren zusammen mit ihren attr-Unterelementen die Beziehung zwischen den Objekten.

In diesem Beispiel definiert die property-XML-Eigenschaft mit dem Wert object in Verbindung mit der cxntype-XML-Eigenschaft mit dem Wert CT_BELONGS_TO_PROC_SUPPORT_UNIT und der connected-objtype-XML-Eigenschaft mit dem Wert OT_APPL_SYS_TYPE die Beziehung zwischen Bebauungseinheiten und Anwendungssystemtypen.

<!-- the following attributes define the connection attributs for connection from the application system type to the PSU object: -->

<attr aris="AT_EXTERNAL_ID" alfabet="refstr" /> <!-- for cxns we do not map refstr/guid by default, so it must be listed here -->

<attr alfabet="StartDate" aris="AT_PHASE_IN_AS_IS" />

<attr alfabet="EndDate" aris="AT_PHASE_OUT_PLAN" />

<attr alfabet="ObjectState" aris="AT_PROC_SUPPORT_STATUS" />

<attr alfabet="Description" aris="AT_DESC" />

<attr alfabet="ID" aris="AT_ID" />

<attr alfabet="Name" aris="AT_CXN_ROLE" />

<attr alfabet="Status" aris="AT_REM" />

</cxn>

<cxn property="xobject" cxntype="CT_CAN_SUPP_1" srctotarget="true" connected-objtype="OT_FUNC" />

Das Kanten-Mapping, das die Eigenschaften xobject und yobject zusammen mit den XML-Eigenschaften cxntype und connected-objtype verwendet, definiert zwei Untergruppenebenen.

<cxn property="yobject" cxntype="CT_CAN_BE_USER" srctotarget="false" connected-objtype="OT_ORG_UNIT" />

Das Kanten-Mapping, das die Eigenschaften xobject und yobject zusammen mit den XML-Eigenschaften cxntype und connected-objtype verwendet, definiert zwei Untergruppenebenen.

<cxn property="deployments" /> <!-- Deployment array. Enabling Deployments, The deployment that is supported by the business support. -->

<cxn property="businessservices" /> <!-- BusinessService. Enabling Business Services, The business services that are used by the business support. -->

<cxn property="aspects" /> <!-- Artifact. The operational aspects that the business support addresses. -->

</psutable>

Mappingsyntax für Tabellen, die Bebauungsmatrizen (PSM) definieren

Alfabet-Modelle werden anders als ARIS-Modelle definiert. Alfabet-Modelle referenzieren nicht immer die in ihnen enthaltenen Objekte. Stattdessen referenzieren die Objekte die Modelle, in denen sie repräsentiert sind. Deshalb müssen in der Importdefinition die Modellelemente festgelegt sein: siehe items-Unterelement.

<table name="BUSINESSPROCESSMODEL" arisgroupname="Business processes" aristype="MT_VAL_ADD_CHN_DGM" cxntypes="CT_IS_PRCS_ORNT_SUPER" isgroup="true">

<items table="BUSINESSPROCESS" property="model" symbol="ST_VAL_ADD_CHN_SML_2">

<attr alfabet="name" aris="AT_NAME" />

<attr alfabet="description" aris="AT_DESC" />

<attr alfabet="id" aris="AT_ID" />

<attr alfabet="version" aris="AT_REL_1" />

<cxn property="aris_guid" arisguid="unique" /> <!-- if used, use as unique ID and fix/check alfabet ID -->

<cxn property="diagrams" /> <!-- what is this? views? []BusinessProcessDiagram -->

<cxn property="documents" /> <!-- cannot be mapped -->

</table>

Element Table

Die Verwendung dieses Elements entspricht der Beschreibung hier. Die overview-model-XML-Eigenschaft kann jedoch in diesem Kontext nicht verwendet werden.

XML-Eigenschaften

name

name

Name der Alfabet-Tabelle, z. B. VALUENODE.

aristype

aristype

API-Name eines ARIS-Modelltyps.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

arisgroupname

arisgroupname

Name der ARISDatenbankgruppe.

Wenn die gesamte Tabelle importiert wird, gibt arisgroupname den Namen der Untergruppe an, die für den Inhalt der Tabelle angelegt wird.

Wenn arisgroupname leer oder nicht angegeben ist, wird keine Untergruppe erstellt.

check-master (optional)

check-master

Prüft das Vorhandensein der festgelegten Alfabet-Eigenschaft, z. B. ARIS_GUID, die für ein Alfabet-Objekt mit der ARIS-GUID des entsprechenden ARIS-Objekts gepflegt wird. Wenn die GUID in der ARIS-Datenbank enthalten ist, wird das zugehörige ARIS-Objekt anstelle des Alfabet-Objekts als Master verwendet, z. B:

check-master="ARIS_GUID"

Die Attribute und Eigenschaften des Masterobjekts werden durch den Import nicht überschrieben und ein Master wird nicht entfernt, wenn das Objekt in Alfabet gelöscht wurde.

condition (optional)

condition

Definiert ein bedingtes Mapping basierend auf dem Wert einer Eigenschaft. Wenn der Wert angegeben ist und einem der Werte der unten aufgeführten condition-Elemente entspricht, wird er gemäß der Definition des condition-Elements und NICHT gemäß der Definition des table-Elements zugeordnet.

cxntypes (optional)

cxntypes

Kommagetrennte Liste der API-Namen, die für die in dem Modell enthaltenen ARIS-Kantentypen angezeigt werden. Diese Namen werden nur angezeigt, wenn die entsprechenden Kanten zwischen den in dem Modell enthaltenen Objekten vorhanden sind.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

'attr'-Unterelement

Ordnet einen Alfabet-Eigenschaftswert zu, z. B. String oder Date. Die Eigenschaften Reference oder ReferenceArray sind hier nicht zulässig.

<attr alfabet="StartDate" condition="Status" value="Evaluation" aris="AT_EVALUATION_START" />

attr XML-Eigenschaft

Definiert die Behandlung von Attributen.

Wenn mindestens ein attr-Unterelement angegeben ist, wird dadurch die Liste der in ARIS importierten Attribute auf die hier angegebenen attr-Elemente beschränkt.

alfabet

Name der Alfabet-Eigenschaft.

condition

Anhand des Werts zu prüfende Eigenschaft. Das Attribut wird nur dann importiert, wenn der Wert der Eigenschaft dem vorgegebenen Wert entspricht.

value

Wert, der anhand des Werts der condition-XML-Eigenschaft für den bedingten Import von Attributen geprüft wird.

aris XML-Eigenschaft

API-Name des ARIS-Attributs.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Leerstring (""): nicht verbunden/ignoriert.

<attr alfabet="EndDate" condition="Status" value="Evaluation" aris="AT_EVALUATION_END" />

<attr alfabet="StartDate" condition="Status" value="Pilot" aris="AT_TO_BE_PHASED_IN_START" />

<attr alfabet="EndDate" condition="Status" value="Pilot" aris="AT_TO_BE_PHASED_IN_END" />

In this case, the value of the "StartDate" property is written to the aris attribute "AT_EVALUATION_START" only if the alfabet property "Status" has the value "Evaluation", etc.

When used as a sub-element of the <cxn> element (see below), the property is mapped to an attribute of the connection.

Sämtliche XML-Eigenschaften

attr

attr XML-Eigenschaft

Definiert die Behandlung von Attributen.

Wenn mindestens ein attr-Unterelement angegeben ist, wird dadurch die Liste der in ARIS importierten Attribute auf die hier angegebenen attr-Elemente beschränkt.

alfabet

alfabet

Name der Alfabet-Eigenschaft.

aris

aris XML-Eigenschaft

API-Name des ARIS-Attributs.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Leerstring (""): nicht verbunden/ignoriert.

XML-Eigenschaften für den bedingten Import von Attributen

Bedingung

condition

Anhand des Werts zu prüfende Eigenschaft. Das Attribut wird nur dann importiert, wenn der Wert der Eigenschaft dem vorgegebenen Wert entspricht.

value

value

Wert, der anhand des Werts der condition-XML-Eigenschaft für den bedingten Import von Attributen geprüft wird.

'items'-Unterelement eines 'table'-Elements

XML-Eigenschaften

table (optional)

table

Tabellenname.

Falls ausgelassen: Die Modellelemente befinden sich in den Modelleigenschaften (cxn).

Falls verwendet: Das Modell stellt keine Referenz auf die in ihm enthaltenen Objekte bereit. Deshalb sind zusätzliche Informationen erforderlich, die angeben, in welcher Tabelle sich diese Objekte befinden. Dies kann eine Liste mit item-Elementen sein, wenn das Modell mehr als eine Tabelle referenziert.

Eigenschaft

property

Eigenschaftsname.

Wenn die 'table'-Eigenschaft verwendet wird: Eigenschaft der Tabelle, die die Kante zum Modell enthält.

Andernfalls: Eigenschaft des Elements, das die Modellelemente enthält.

Symbol

symbol

API-Name für den Symboltyp des im hinterlegten Modell verwendeten ARIS-Objekts, z. B. ST_VAL_ADD_CHN_SML_2.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Mappingsyntax für Tabellen, die Modelle definieren

Alfabet-Modelle werden anders als ARIS-Modelle definiert. Alfabet-Modelle referenzieren nicht immer die in ihnen enthaltenen Objekte. Stattdessen referenzieren die Objekte die Modelle, in denen sie repräsentiert sind. Deshalb müssen in der Importdefinition die Modellelemente festgelegt sein: siehe items-Unterelement.

<table name="BUSINESSPROCESSMODEL" arisgroupname="Business processes" aristype="MT_VAL_ADD_CHN_DGM" cxntypes="CT_IS_PRCS_ORNT_SUPER" isgroup="true">

<items table="BUSINESSPROCESS" property="model" symbol="ST_VAL_ADD_CHN_SML_2">

<attr alfabet="name" aris="AT_NAME" />

<attr alfabet="description" aris="AT_DESC" />

<attr alfabet="id" aris="AT_ID" />

<attr alfabet="version" aris="AT_REL_1" />

<cxn property="aris_guid" arisguid="unique" /> <!-- if used, use as unique ID and fix/check alfabet ID -->

<cxn property="diagrams" /> <!-- what is this? views? []BusinessProcessDiagram -->

<cxn property="documents" /> <!-- cannot be mapped -->

</table>

Element Table

Die Verwendung dieses Elements entspricht der Beschreibung hier. Die overview-model-XML-Eigenschaft kann jedoch in diesem Kontext nicht verwendet werden.

XML-Eigenschaften

name

name

Name der Alfabet-Tabelle, z. B. VALUENODE.

aristype

aristype

API-Name eines ARIS-Modelltyps.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

arisgroupname

arisgroupname

Name der ARISDatenbankgruppe.

Wenn die gesamte Tabelle importiert wird, gibt arisgroupname den Namen der Untergruppe an, die für den Inhalt der Tabelle angelegt wird.

Wenn arisgroupname leer oder nicht angegeben ist, wird keine Untergruppe erstellt.

check-master (optional)

check-master

Prüft das Vorhandensein der festgelegten Alfabet-Eigenschaft, z. B. ARIS_GUID, die für ein Alfabet-Objekt mit der ARIS-GUID des entsprechenden ARIS-Objekts gepflegt wird. Wenn die GUID in der ARIS-Datenbank enthalten ist, wird das zugehörige ARIS-Objekt anstelle des Alfabet-Objekts als Master verwendet, z. B:

check-master="ARIS_GUID"

Die Attribute und Eigenschaften des Masterobjekts werden durch den Import nicht überschrieben und ein Master wird nicht entfernt, wenn das Objekt in Alfabet gelöscht wurde.

condition (optional)

condition

Definiert ein bedingtes Mapping basierend auf dem Wert einer Eigenschaft. Wenn der Wert angegeben ist und einem der Werte der unten aufgeführten condition-Elemente entspricht, wird er gemäß der Definition des condition-Elements und NICHT gemäß der Definition des table-Elements zugeordnet.

cxntypes (optional)

cxntypes

Kommagetrennte Liste der API-Namen, die für die in dem Modell enthaltenen ARIS-Kantentypen angezeigt werden. Diese Namen werden nur angezeigt, wenn die entsprechenden Kanten zwischen den in dem Modell enthaltenen Objekten vorhanden sind.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

'attr'-Unterelement

Ordnet einen Alfabet-Eigenschaftswert zu, z. B. String oder Date. Die Eigenschaften Reference oder ReferenceArray sind hier nicht zulässig.

<attr alfabet="StartDate" condition="Status" value="Evaluation" aris="AT_EVALUATION_START" />

attr XML-Eigenschaft

Definiert die Behandlung von Attributen.

Wenn mindestens ein attr-Unterelement angegeben ist, wird dadurch die Liste der in ARIS importierten Attribute auf die hier angegebenen attr-Elemente beschränkt.

alfabet

Name der Alfabet-Eigenschaft.

condition

Anhand des Werts zu prüfende Eigenschaft. Das Attribut wird nur dann importiert, wenn der Wert der Eigenschaft dem vorgegebenen Wert entspricht.

value

Wert, der anhand des Werts der condition-XML-Eigenschaft für den bedingten Import von Attributen geprüft wird.

aris XML-Eigenschaft

API-Name des ARIS-Attributs.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Leerstring (""): nicht verbunden/ignoriert.

<attr alfabet="EndDate" condition="Status" value="Evaluation" aris="AT_EVALUATION_END" />

<attr alfabet="StartDate" condition="Status" value="Pilot" aris="AT_TO_BE_PHASED_IN_START" />

<attr alfabet="EndDate" condition="Status" value="Pilot" aris="AT_TO_BE_PHASED_IN_END" />

In this case, the value of the "StartDate" property is written to the aris attribute "AT_EVALUATION_START" only if the alfabet property "Status" has the value "Evaluation", etc.

When used as a sub-element of the <cxn> element (see below), the property is mapped to an attribute of the connection.

Sämtliche XML-Eigenschaften

attr

attr XML-Eigenschaft

Definiert die Behandlung von Attributen.

Wenn mindestens ein attr-Unterelement angegeben ist, wird dadurch die Liste der in ARIS importierten Attribute auf die hier angegebenen attr-Elemente beschränkt.

alfabet

alfabet

Name der Alfabet-Eigenschaft.

aris

aris XML-Eigenschaft

API-Name des ARIS-Attributs.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Leerstring (""): nicht verbunden/ignoriert.

XML-Eigenschaften für den bedingten Import von Attributen

Bedingung

condition

Anhand des Werts zu prüfende Eigenschaft. Das Attribut wird nur dann importiert, wenn der Wert der Eigenschaft dem vorgegebenen Wert entspricht.

value

value

Wert, der anhand des Werts der condition-XML-Eigenschaft für den bedingten Import von Attributen geprüft wird.

'items'-Unterelement eines 'table'-Elements

XML-Eigenschaften

table (optional)

table

Tabellenname.

Falls ausgelassen: Die Modellelemente befinden sich in den Modelleigenschaften (cxn).

Falls verwendet: Das Modell stellt keine Referenz auf die in ihm enthaltenen Objekte bereit. Deshalb sind zusätzliche Informationen erforderlich, die angeben, in welcher Tabelle sich diese Objekte befinden. Dies kann eine Liste mit item-Elementen sein, wenn das Modell mehr als eine Tabelle referenziert.

Eigenschaft

property

Eigenschaftsname.

Wenn die 'table'-Eigenschaft verwendet wird: Eigenschaft der Tabelle, die die Kante zum Modell enthält.

Andernfalls: Eigenschaft des Elements, das die Modellelemente enthält.

Symbol

symbol

API-Name für den Symboltyp des im hinterlegten Modell verwendeten ARIS-Objekts, z. B. ST_VAL_ADD_CHN_SML_2.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Mappingsyntax für Tabellen, die lediglich Kanten definieren

Eine reine Kantentabelle kann daran erkannt werden, dass in ihr keine Eigenschafts-ID definiert ist.

Element table

XML-Eigenschaften

Nur name und aristype sind als Attribute gültig.

name

name

Name der Alfabet-Tabelle, z. B. VALUENODE.

aristype

aristype

Kommagetrennte Liste der API-Namen für ARIS-Kantentypen. Die Kantentypen werden nacheinander ausprobiert, bis ein Typ gefunden wird, der für den Quell- und den Zielobjekttyp gültig ist. Dies ist hilfreich, wenn Quell- und Zielobjekte mehrere Typen umfassen.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Wert -1 (= keine Kante anlegen) ist nur zulässig, wenn eine Hinterlegungsdefinition als Unterelement festgelegt wurde.

'assign'-Unterelement eines table-Elements

Erstellt eine Hinterlegung für sämtliche Kanten, die aus dieser Tabelle importiert werden. Dies kann nur dann durchgeführt werden, wenn es sich bei der Zielreferenz um ein Modell handelt.

XML-Eigenschaften

add-parent

add-parent

Fügt dem hinterlegten Modell eine Ausprägung des übergeordneten Objekts hinzu.

Die Standardeinstellung ist false.

Wenn Sie true angeben, wird dem hinterlegten Modell eine Ausprägung des übergeordneten Objekts hinzugefügt. Aus diesem Grund ist das parent-symbol-Attribut zwingend erforderlich.

parent-symbol

parent-symbol

API-Name für den Symboltyp des im hinterlegten Modell verwendeten übergeordneten ARIS-Objekts, z. B. ST_APPL_SYS_TYPE.

Name für Elemente der ARIS-Methode, die einer bestimmten Typnummer zugeordnet sind. Typnummer und API-Name sind eindeutige Identifizierer für Datenbankelemente, durch die Typen in der ARIS-Methode definiert werden.

Informationen zu API-Namen finden Sie in ARIS (Anwendungsstarter Anwendungsstarter > Administration Administration > Konfiguration Konfiguration > Konventionen > Methode) und in ARIS Architect auf der Registerkarte Administration unterhalb der Ordnerstruktur Methode. Sie erhalten spezifische Informationen aus der Methodenhilfe, wenn Sie ein Element markieren, z. B. ein Objekt, eine Kante oder ein Modell, und die Tastenkombination Strg + F1 in ARIS Architect drücken.

Nur erforderlich, wenn das add-parent-Attribut auf true gesetzt ist.

'attr'-Unterelement

Ordnet Eigenschaften ARIS-Kantenattributen zu. Dies gilt nicht für Importe, die nur Hinterlegungen enthalten. Die Syntax ist dieselbe wie in der allgemeinen Beschreibung (siehe 'attr'-Unterelement).

'cxn'-Unterelement

Definiert die Eigenschaften für Quelle und Ziel der Kante.

Eigenschaft

property XML-Eigenschaft

Name der Alfabet-Eigenschaft. Die Eigenschaft muss vom Typ Reference oder ReferenceArray sein.

Siehe Dokumentation des Alfabet Meta-Modells. Weitere Informationen finden Sie im Alfabet-Referenzhandbuch der ARIS - Alfabet Interoperability Interface. Sie können Dokumente und die Technische Hilfe von der Dokumentations-Website öffnen oder herunterladen. Sie finden die Dokumentation auch im ARIS-Installationspaket, das im ARIS Download Center verfügbar ist.

Rolle

role

Definiert die Rolle des von der Eigenschaft referenzierten Objekts.

Mögliche Werte: source oder target.

forceexist (optional)

forceexist

Legt fest, ob der Import das Bestehen des Ziel- oder Quellobjekts eines referenzierten Objekts in der Datenbank erzwingt oder nicht. Wenn der Wert auf true gesetzt ist, wird das Ziel- oder Quellobjekt unter Verwendung der Verbindungsdefinition des referenzierten Objekts angelegt. Nur wenn das Ziel- oder Quellobjekt vorhanden ist, wird eine Kante importiert. Ob das Zielobjekt oder das Quellobjekt vorhanden sein muss, hängt von dem Wert ab, der in der srctotarge-XML-Eigenschaft festgelegt ist.

Der Standardwert ist false.

Beispiel

<table name="BPINFORMATIONFLOW" aristype="CT_LEADS_TO_1,CT_ACTIV_1,CT_IS_PREDEC_OF_1,CT_LNK_2"

<attr aris="AT_CXN_ROLE" alfabet="name" />

<attr aris="AT_DESC" alfabet="description" />

<attr aris="AT_REM" alfabet="shortname" />

<cxn property="from" role="source" forceexist ="true" > <!-- src must exist / is imported if needed–>

<cxn property="to" role="target" forceexist ="true" > <!-- src must exist / is imported if needed–>

<cxn property="data" /> <!-- not mapped -->

<cxn property="documents" /> <!-- not mapped -->

</table>

Beispiel 1

<table name="APPLICATIONGROUP" arisgroupname="Application groups" aristype="OT_APPL_SYS_CLS" isgroup="true" overview-model="MT_APPL_SYS_TYPE_DGM,ST_APPL_SYS_CLS">

<attr alfabet="name" aris="AT_NAME" />

<attr alfabet="description" aris="AT_DESC" />

<attr alfabet="a_size" aris="" /> <!-- not mapped-->

...

<cxn property="belongsto" cxntype="CT_CAN_SUBS_2" srctotarget="false" />

<!-- overview-model="ST_APPL_SYS_CLS" means: show in overview model with its CXN and the given symbol -->

<!-- an attr element within a cxn element maps an attribute from the Alfabet table to the cxn -->

<cxn property="belongsto" cxntype="CT_CAN_SUBS_2" srctotarget="false" connected-objtype="OT_APPL_SYS_CLS" overview-model="ST_APPL_SYS_CLS" ordernum="1" >

<attr alfabet="refstr" aris="AT_EXTERNAL_ID" />

</cxn>

<cxn property="applications" cxntype="CT_BELONGS_TO_CLS" srctotarget="true" >

<!-- "each" would mean 1 assignment per child, all=assign them all to the parent in one model -->

<!-- add-parent: assignment contains occ of the parent. This needs: parent-symbol="ST_APPL_SYS_CLS" -->

<assign type="all" model="MT_APPL_SYS_TYPE_DGM" add-parent="true" parent-symbol="ST_APPL_SYS_CLS" child-symbol="ST_APPL_SYS_TYPE" />

</cxn>

<cxn property="processes" /> <!-- not mapped-->

</table>

Dieses Beispiel zeigt, wie eine Tabelle mit einer Objektdefinition verbunden wird und wie (Wert-)Eigenschaften mit ARIS-Attributen verbunden werden. Zudem ist es möglich, ein overview-Modell anzulegen und eine Ausprägung jedes Objekts aus dieser Tabelle im Modell zu platzieren. Eine Reference- oder ReferenceArray-Eigenschaft kann mit einer Kante, einer Hinterlegung oder einer Kante plus Hinterlegung verbunden werden. Eine Werteigenschaft kann mit einer Kante, einer Hinterlegung oder beidem gleichzeitig verbunden werden. Werteigenschaften können einer angelegten Kante statt dem Objekt selbst zugeordnet werden.

Beispiel 2

<table name="BUSINESSPROCESS" arisgroupname="Business processes" aristype="OT_FUNC" isgroup="true" overview-model="MT_VAL_ADD_CHN_DGM,ST_VAL_ADD_CHN_SML_2" check-master="ARIS_GUID" >

<!-- "each" would mean 1 assignment per child, all=assign them all to the parent in one model -->

<!-- add-parent: assignment contains occ of the parent. This needs: parent-symbol="ST_APPL_SYS_CLS" -->

<assign type="each" model="MT_FUNC_ALLOC_DGM" add-parent="true" parent-symbol="ST_VAL_ADD_CHN_SML_2" child-symbol="ST_FUNC" />

<attr alfabet="name" aris="AT_NAME" />

<attr alfabet="shortname" aris="AT_REM" />

...

<cxn property="belongsto" srctotarget="false" cxntype="CT_IS_PRCS_ORNT_SUPER" overview-model="ST_VAL_ADD_CHN_SML_2" /> <!-- BusinessProcess–>

<createocc property="model" symbol="ST_VAL_ADD_CHN_SML_2" forceexist="false" /> <!-- creates occ in the model if the model exists -->

<cxn property="executingorganizations" srctotarget="false" cxntype="CT_EXEC_1" forceexist="true" assigned-model="ST_ORG_UNIT_2" />

<cxn property="applications" srctotarget="false" cxntype="CT_CAN_SUPP_1" forceexist="true" assigned-model="ST_APPL_SYS_TYPE"/>

...

</table>

Dieses Beispiel zeigt das Mapping zu einem Objekt mit einem hinterlegten Modell. Zudem wird im Zielmodell eine Objektausprägung angelegt.

Beispiel 3

<table name="APPLICATION" arisgroupname="Application" aristype="OT_APPL_SYS_TYPE" isgroup="false" overview-model="MT_APPL_SYS_TYPE_DGM,ST_APPL_SYS_TYPE">

<foreignattr table="TIMESTATUS" property="Owner"> <!-- Select * from TIMESTATUS where Owner = '<our AlfabetID>'. Will be written after processing "normal" attr-Elements, so will probably overwrite them -->

property

Name der Eigenschaft der zusätzlichen Tabelle, die auf das aktuelle Tabellenelement verweist, z. B. Owner.

<attr alfabet="StartDate" condition="Status" value="Evaluation" aris="AT_EVALUATION_START" />

<attr alfabet="EndDate" condition="Status" value="Evaluation" aris="AT_EVALUATION_END" />

<attr alfabet="StartDate" condition="Status" value="Pilot" aris="AT_TO_BE_PHASED_IN_START" />

<attr alfabet="EndDate" condition="Status" value="Pilot" aris="AT_TO_BE_PHASED_IN_END" />

<attr alfabet="StartDate" condition="Status" value="Production" aris="AT_STANDARD_START" />

<attr alfabet="EndDate" condition="Status" value="Production" aris="AT_STANDARD_END" />

<attr alfabet="StartDate" condition="Status" value="Limited Production" aris="" /> <!-- tbd -->

<attr alfabet="EndDate" condition="Status" value="Limited Production" aris="" />

<attr alfabet="StartDate" condition="Status" value="Retired - Shut Down" aris="AT_TO_BE_PHASED_OUT_START" />

<attr alfabet="EndDate" condition="Status" value="Retired - Shut Down" aris="AT_TO_BE_PHASED_OUT_END" />

</foreignattr>

<attr alfabet="Name" aris="AT_NAME" />

<attr alfabet="ObjectState" aris="AT_REM" />

<attr alfabet="Description" aris="AT_DESC" />

...

<cxn property="NextVersion" cxntype="CT_IS_PRED_OF" srctotarget="true" forceexist="true" connected-objtype="OT_APPL_SYS_TYPE" overview-model="ST_APPL_SYS_TYPE"/>

<cxn property="ApplicationGroups" cxntype="CT_BELONGS_TO_CLS" srctotarget="true" forceexist="true" connected-objtype="OT_APPL_SYS_CLS" />

<cxn property="ICTObject" cxntype="CT_GENERAL" srctotarget="false" forceexist="true" connected-objtype="OT_APPL_SYS_TYPE" overview-model="ST_APPL_SYS_TYPE"/>

<cxn property="Products" />

...

</table>

In diesem Beispiel wird die foreignattr-Eigenschaft, die eine Liste von attr-Eigenschaften ist, verwendet. Diese Liste definiert die zu importierenden Attribute. In diesem Beispiel wird die Verwendung von Fremdattributen und Attribut-Bedingungen verdeutlicht. Fremdattribute werden aus der zusätzlichen Alfabet-Tabelle eingelesen.