Cockpit: BIS-Datenmodell-Vergleiche

1                     Themenübersicht

Die BIS-Datenmodelle definieren das Format von Import- und Exportdateien, und sind daher eine Grundlage des Datenaustausches über den BIS. Bei der Realisierung eines Datenaustausches müssen auch mögliche Änderungen an BIS-Datenmodellen in Betracht gezogen werden. Beispielswiese ist die Erweiterung eines Business Objects um ein neues Attribut eine Änderung des jeweiligen BIS-Datenmodells.

Die Erkennung von Änderungen basiert auf dem Vergleich der BIS-Datenmodelle zu verschiedenen Zeitpunkten. Hierzu führt der Benutzer auf einem bestimmten System und einer OLTP-Datenbank zu verschiedenen Zeiten einen Vergleichslauf durch. Änderungen an BIS-Datenmodellen, die zwischen den Vergleichsläufen aufgetreten sind, können in der Anwendung „BIS-Datenmodell-Vergleichsergebnis abfragen“ angezeigt werden.

Beispiel:

Um Änderungen an BIS-Datenmodellen zwischen zwei Semiramis-Releases zu erkennen, muss ein Vergleichslauf vor der Aktualisierung des Systems, sowie ein weiterer Vergleichslauf nach der Aktualisierung durchgeführt werden. Nach dem zweiten Vergleichslauf können eventuelle Änderungen angezeigt werden.

Der Vergleich bezieht sich auf den Zustand der BIS-Datenmodelle auf dem System und einer OLTP-Datenbank, auf dem die Vergleichsläufe durchgeführt werden. Als Änderung erkennt die Anwendung hinzugekommene oder entfernte Attribute. Da die Vergleichsläufe grundsätzlich auf jedem Semiramis-System durchgeführt werden können, schließt die Analyse auch Attribute, die in Adaptierungen hinzugefügt wurden, sowie Weitere Felder ein.

In einem Vergleichslauf werden alle Business Entitys analysiert, auch solche, bei denen der Import oder Export über den BIS nicht offiziell unterstützt ist. Die relevanten Business Entitys, die vom BIS offiziell unterstützt werden, sind in der Dokumentation „Export- und Import-Schnittstellen“ aufgeführt Der Vergleichslauf bezieht auch Business Entitys ein, die aus einer Adaptierung stammen.

Die Vergleichsläufe sollten auf einem Entwicklungs- oder Testsystem durchgeführt werden. Beachten Sie, dass das System die Vergleichsläufe nicht automatisch startet. Die Anzeige der Änderungen ist daher nur so aktuell wie der letzte Vergleichslauf.

Die Anwendung zeigt an, dass an bestimmten Business Entitys Änderungen aufgetreten sind. Eine genauere Analyse ist für die zuletzt festgestellte Änderung eines BIS-Datenmodells möglich. Hierzu stellt die Anwendung XML-Schema-Dateien bereit, die das BIS-Datenmodell vor und nach der Änderung beschreiben. Der Benutzer kann diese beiden Dateien mit externen Werkzeigen vergleichen.

2                     Zielgruppe

  • Entwickler
  • Technische Berater

3                     Begriffsbestimmung

Controller

Der Controller ist eine Java-Klasse, die den Import bzw. Export eines Business Entitys realisiert. Die zugehörigen Schnittstellen sind „com.cisag.pgm.bi.ImportController“ und „com.cisag.pgm.bi.ExportController“. Der Controller liefert das für den Import bzw. den Export zu verwendende Datenmodell und bestimmt damit die Menge der für das Business Entity zur Verfügung stehenden Objekte, Attribute und Beziehungen. Das Datenmodell kann dabei für den Import und für den Export unterschiedlich sein. Für einfache Business Entitys kann der Import bzw. der Export auch ohne vorhandenen Controller und somit generisch erfolgen.

Extensible Markup Language (XML)

Mit XML können strukturierte Daten in einer Text-Datei gespeichert werden. Die Beschreibungssprache ermöglicht die Definition, Übertragung, Überprüfung und Interpretation von Daten zwischen Applikationen und eignet sich besonders für den strukturierten Datenaustausch. Bei XML-Dokumenten erfolgt eine Trennung von Inhalt, Struktur und Information zur Darstellung. XML wird vom W3C als Standard koordiniert und definiert.

Filter

Das BIS-Datenmodell zu einem Business Entity kann sehr umfangreich sein. Ein Filter ist ein Ausschnitt des BIS-Datenmodells zu einem Business Entity. Er definiert, welche Objekte, Attribute und Beziehungen eines Business Entitys bei einem Import- bzw. beim Exportvorgang berücksichtigt werden sollen.

World Wide Web Consortium (W3C)

Das World Wide Web Consortium wurde gegründet, um alle Möglichkeiten des Webs zu erschließen. Dazu werden einheitliche Technologien (Spezifikationen, Richtlinien, Software und Tools) entwickelt, die den Fortschritt des Webs fördern und seine Interoperabilität sicherstellen.

XML-Schema (XSD)

Ein XML-Schema (XML-Schema-Definition, XSD) ist eine formale Spezifikation der Regeln eines XML-Dokuments, das anzeigt, welche Elemente in einem Dokument in welchen Kombinationen zulässig sind.

4                     Anwendungsbechreibung

Mit der Anwendung „Cockpit: BIS-Datenmodell-Vergleiche“ erhalten Sie eine Übersicht über alle geänderten BIS-Datenmodelle. Sie können in der Anwendung auch einen Vergleichslauf starten.

Die Anwendung „Cockpit: BIS-Datenmodell-Vergleiche“ besteht aus einem Abfrage- und einem Arbeitsbereich. Im Abfragebereich können Sie Suchmerkmale eingeben; im Arbeitsbereich werden die geänderten BIS-Datenmodelle angezeigt.

4.1               Abfrage- und Arbeitsbereich

Im Abfragebereich werden Abfragefelder abgelegt. In der Regel sind die wichtigsten Abfragefelder bereits vorhanden. Die Anzahl der Abfragefelder und deren Platzierung können jedoch variieren.

Der Abfragebereich ist für alle Ansichten des Arbeitsbereichs gleich. Welche Abfragefelder angezeigt werden, können Sie selbst bestimmen.

Im Arbeitsbereich der Anwendung „Cockpit: BIS-Datenmodell-Vergleiche“ wird die Ergebnisliste mit den gefundenen Änderungen der BIS-Datenmodelle dargestellt.

4.1.1          Ansichten des Arbeitsbereichs

Um das Ergebnis eines BIS-Datenmodell-Vergleiches auf verschiedene Weise mit unterschiedlichen Informationen betrachten zu können, können mehrere Ansichten erstellt werden. Folgende Ansicht ist bereits vorhanden:

  • „Übersicht“: Zeigt die wichtigsten Eigenschaften eines Vergleiches in einer Zeile an.

4.1.2          Abfragefelder und Listenspalten

Nachfolgend sind alle wesentlichen Abfragefelder bzw. Listenspalten aufgeführt. Werden weitere Felder hinzugefügt, dann finden Sie deren Beschreibung in der Direkthilfe.

Feld oder Spalte Erläuterung
Aktueller Vergleichszeitpunkt Zeitpunkt, zu dem zuletzt eine Änderung im BIS-Datenmodell des Business Entitys festgestellt wurde.
Business Entity Technischer Name des Business Entitys, zu dem die Änderungen beim BIS-Datenmodell vorhanden sind.
Business-Entity-Bezeichnung Bezeichnung des Business Entitys, zu dem die Änderungen beim BIS-Datenmodell vorhanden sind.
Richtung Richtung eines BIS-Datenmodells. Die möglichen Werte sind:

·         Import

Das BIS-Datenmodell wird für den Import der Daten verwendet.

·         Export

Das BIS-Datenmodell wird nur für den Export der Daten verwendet.

·         Import und Export

BIS-Datenmodell ist für den Import und Export gleich und wird sowohl für den Import als auch für den Export verwendet.

Falls unterschiedliche BIS-Datenmodelle für den Import und für den Export verwendet werden, werden sie getrennt aufgeführt.

Voriger Vergleichszeitpunkt Vorletzter Zeitpunkt eines Vergleichs des BIS-Datenmodells.

Zu diesem Zeitpunkt hatte das BIS-Datenmodell einen anderen Zustand als zum Zeitpunkt im Feld „Aktueller Vergleichszeitpunkt“.

 

4.2               Anwendungsbezogene Aktionen:

Die folgenden anwendungsbezogenen Aktionen stehen in der Anwendung „Cockpit: BIS-Datenmodell-Vergleiche“ zur Verfügung:

  • BIS-Datenmodelle vergleichen
  • XML-Schemata exportieren

4.2.1          BIS-Datenmodelle vergleichen

Durch die Aktion „BIS-Datenmodelle vergleichen“ wird der aktuelle Zustand der BIS-Datenmodelle analysiert, und mit dem zuletzt analysierten Zustand verglichen. Beachten Sie, dass diese Aktion eine lang laufende und speicherintensive Aktion ist, die Sie auf einem ansonsten unbelasteten Application-Server ausführen sollten. Nach Auslösen dieser Aktion erscheint ein Dialog, mit dem Sie die Einstellungen für den Vergleichslauf, der als Verarbeitungsauftrag läuft, festlegen können. Der Dialog ist in zwei Karteireiter unterteilt. Die Karteireiter „Anwendung“, „Hintergrundeinstellungen“ und „Direkthilfe“ sind im Dokument Bedienungsleitfaden erklärt und werden hier nicht weiter erläutert. Der Dialog enthält folgendes anwendungsspezifisches Feld:

Feld Erläuterung
Bezeichnung Bezeichnung eines Vergleich-Durchlaufes. Sie können die Bezeichnung frei wählen.

4.2.2          XML-Schemata exportieren

Mit dieser Aktion werden für die ausgewählten BIS-Datenmodelle jeweils XML-Schemata für die neue und für die alte Version des BIS-Datenmodells exportiert.

In einem Dialog-Fenster können Sie das Basis-Verzeichnis für die zu exportierenden XML-Schemata angeben.

Das Dialog-Fenster zur Aktion „XML-Schemata exportieren“ enthält folgendes Feld:

Feld Erläuterung
Basis-Verzeichnis Das Verzeichnis, in das die XML-Schemata exportiert werden.

Das jeweils ältere XML-Schema wird in das Unterverzeichnis „oldversion“ des Basis-Verzeichnisses exportiert. Das jüngere XML-Schema wird entsprechend in das Unterverzeichnis „newversion“ exportiert. Dies erleichtert den Vergleich der XML-Schemata in externen Anwendungen.

Der Vorschlagswert ist ein Verzeichnis im Standard-Arbeitsbereich der OLTP-Datenbank, an der Sie an-gemeldet sind. Im Pfad ist der Name des aktuellen Benutzers enthalten.

Die Business Entitys mit Änderungen in ihrem BIS-Datenmodell werden in einer Liste angezeigt. Es werden nur Business Entitys angezeigt, für die tatsächlich eine Änderung ihres BIS-Datenmodells festgestellt wurde. Solange keine Änderungen festgestellt wurden, wird die Liste leer angezeigt, ggf. auch nach mehrfachen Vergleichsläufen.

5                     Customizing

Für die Anwendung „Cockpit: BIS-Datenmodell-Vergleiche“ sind in der Anwendung „Custo­mizing“ keine Einstellungen fest­zulegen.

6                     Business Entitys

Für die Anwendung „Cockpit: BIS-Datenmodell-Vergleiche“ sind die nachfolgenden Business Entitys relevant, die Sie beispielsweise verwenden, um

  • Berechtigungen zu vergeben,
  • Aktivitätsdefinitionen einzurichten oder
  • Daten zu importieren oder zu exportieren.

BIS-Datenmodell-Vergleichsergebnis

com.cisag.sys.tools.bi.obj.ObjectTypeSchemaCompareResult

BIS-Datenmodell-Vergleichslauf

com.cisag.sys.tools.bi.obj.ObjectTypeSchemaCompareRun

BIS-Datenmodell-Version

com.cisag.sys.tools.bi.obj.ObjectTypeSchemaVersion

Die Business Entitys gehören zu keiner Business-Entity-Gruppe.

7                     Berechtigungen

Berechtigungen können sowohl mithilfe der Berechtigungsrollen als auch durch die Zuordnung einer Organisation vergeben werden. Das Berechtigungskonzept können Sie in der Technischen Dokumen­tation Berechtigungen nachlesen.

7.1               Spezielle Fähigkeiten

Für die Anwendung „Cockpit: BIS-Datenmodell-Vergleiche“ bestehen keine speziellen Fähigkeiten.

7.2               Organisations-Zuordnungen

Für die Anwendung „Cockpit: BIS-Datenmodell-Vergleiche“  ist eine Organisations-Zuordnung nicht erforderlich.

7.3               Besonderheiten

Für die Anwendung „Cockpit: BIS-Datenmodell-Vergleiche“  bestehen keine Besonderheiten.

7.4               Berechtigungen für Geschäftspartner

Die Anwendung „Cockpit: BIS-Datenmodell-Vergleiche“  ist für Geschäftspartner nicht freigegeben.

8                     Vorgehensweisen

Als Abfrageanwendung ist einerseits das Suchen nach geänderten BIS-Datenmodellen möglich. Zusätzlich bietet die Anwendung auch die Möglichkeit, der Vergleich der BIS-Datenmodellen durchzuführen. Folgende Vorgehensweisen werden beschrieben:

  • Suchen nach geänderten BIS-Datenmodellen.
  • Ausführen der Hintergrund-Anwendung „BIS-Datenmodelle vergleichen“.

8.1               Anzeigen geänderter BIS-Datenmodelle

  1. Öffnen Sie die Anwendung „Cockpit: BIS-Datenmodell-Vergleiche“.
  2. Erfassen Sie die Suchmerkmale im Abfragebereich.
    • Das System zeigt im Arbeitsbereich alle gefunden Business Entitys an, zu denen die Änderungen bei den BIS-Datenmodellen vorhanden sind und die die Suchmerkmale erfüllen.

8.2               Ausführen der Hintergrund-Anwendung „BIS-Datenmodelle vergleichen“

  1. Öffnen Sie die Anwendung „Cockpit: BIS-Datenmodell-Vergleiche“.
  2. Wählen Sie in der Standard-Symbolleiste „BIS-Datenmodelle vergleichen“.
  3. Tragen Sie in dem Feld „Bezeichnung“ den Wert ein, wenn den Vorschlagwert nicht gewünscht ist.
  4. Tragen Sie in die Felder der Karteireiter „Hintergrundeinstellungen“ die gewünschten Werte ein. Erläuterungen zu diesen Feldern entnehmen Sie bitte dem Bedienungsleitfaden.
  5. Wählen Sie „Im Hintergrund“.
    • Das System legt einen Verarbeitungsauftrag ein, der gemäß den Hintergrundeinstellungen abgearbeitet wird.
      Nach Abschluss des Verarbeitungsauftrages können Sie die geänderten BIS-Datenmodelle in der Anwendung abrufen.

Czy ten artykuł był pomocny?