1 Themenübersicht
In diesem Dokument werden die Vorgehensweisen für den Umgang mit der Anwendung „Daten importieren“ bezogen auf Filterdaten beschrieben. Diese Vorgehensweisen enthalten allgemeine Anleitungsschritte, z. B. welche Reihenfolgen beim Import der Filterdaten einzuhalten sind. Sie werden außerdem über mögliche Voraussetzungen und Auswirkungen informiert.
Die Beschreibung der Anwendung „Daten importieren“, die unter anderem auch Feld- und Button-Beschreibungen enthält, finden Sie in der Dokumentation Daten importieren.
2 Begriffsbestimmung
Extensible Markup Language (XML)
Mit XML können strukturierte Daten in einer Textdatei 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.
Text durch Trennzeichen getrennt (CSV)
CSV (comma separated values) ist ein Dateiformat, in dem die Werte der einzelnen Spalten durch ein Trennzeichen getrennt werden. Zeilen werden durch Zeilenumbrüche getrennt. Dieses Trennzeichen muss bekannt sein, um die Datei importieren zu können. Übliche Trennzeichen sind beispielsweise das einfache Komma und das Semikolon. In diesem Format gespeicherte Daten können in zahlreichen Anwendungsprogrammen verwendet und bearbeitet werden. Durch die einfache, nicht hierarchische Struktur von CSV ist dieses Datenformat zur Abbildung komplexer Datenstrukturen nicht geeignet.
Unicode-Text durch Tabulator getrennt (XLS)
Dieses Dateiformat ist ähnlich wie CSV, jedoch ist als Trennzeichen der Tabulator und als Zeichencodierung Unicode festgelegt. Dateien in diesem Format können unter anderem von Microsoft Excel verwendet werden. Um dieses Dateiformat in Excel zu speichern, müssen Sie in Excel ggf. das Dateiformat angeben.
3 Allgemeines
Neben den von Semiramis im BIS unterstützten betriebswirtschaftlichen Business Entitys können auch Filter aus Dateien importiert und in Dateien exportiert werden. Ein Filter enthält dabei insbesondere die Attributauswahl.
Verwenden Sie den Import und Export von Filtern für folgende Zwecke:
- Übertragen von Filtern zwischen verschiedenen Systemen oder OLTP-Datenbanken,
- Sichern von Filtern zur späteren Wiederverwendung der aktuellen Attributauswahl auf demselben oder einem anderen System bzw. OLTP-Datenbank.
- Weitergabe eines Filters um die Reproduktion von Fehlern zu ermöglichen, die nur mit bestimmten Filtern auftreten.
Hinweis:
Wenn Sie Filter für ein bestimmtes Business Entity zwischen OLTP-Datenbanken übertragen möchten, kann es vorkommen, dass sich die BIS-Datenmodelle des Business Entitys auf den Systemen bzw. OLTP-Datenbanken unterscheiden. Dies ist insbesondere bei Business-Object-Erweiterungen (Entwicklungsobjekt-Typ „Extension“) und „Weiteren Feldern“ der Fall.
Die Attributauswahl für diese Attribute kann nur übertragen werden, wenn die jeweiligen Attribute auf beiden Systemen bzw. OLTP-Datenbanken existieren. Attribute, die nur im Zielsystem bzw. in der Ziel-OLTP-Datenbank vorhanden sind, werden beim Import eines Filters auf „nicht ausgewählt“ gesetzt. Attribute, die im Zielsystem bzw. in der Ziel-Datenbank nicht vorhanden sind, werden ignoriert.
4 Vorgehensweisen
Der Import und Export von Filtern erfolgt mit dem BIS. Führen Sie dazu einen Import bzw. Export für das Business Entity „com.cisag.sys.tools.bi.obj.FilterDefinition“ aus.
Der Import bzw. Export findet für die Filter der OLTP-Datenbank statt, auf der Sie angemeldet sind. Beim Export können Sie auf dem Karteireiter „Eingrenzung“ den oder die Filter auswählen, die sie exportieren möchten.
Hinweis: Beachten Sie, dass beim Import von Filtern aus einer Datei gleichnamige vorhandene Filter standardmäßig überschrieben werden.
5 Übersicht: Felder des Business Entitys
Im Folgenden werden die Pflichtfelder (P) und die Key-Attribute (K) der einzelnen Business Objects aufgeführt. Die Identifikations- und Pflichtfelder sind Änderungen unterworfen und können durch Anpassungen auch erweitert werden.
Das BIS-Datenmodell für Filter enthält folgende Attribute:
Feldname/Key-Attribut (K) | Bedeutung |
guid (K) | GUID des Filters. Darf nicht verändert werden. Für den Export bzw. Import ist dieses Feld nicht erforderlich. |
name (K) (P) | Name des Filters. Pflichtfeld. |
description (P) | Bezeichnung des Filters. Pflichtfeld. |
object | Business Entity des Filters. Darf nicht verändert werden. |
nlsMode | Spracheinstellung. Gibt an, ob mehrsprachige Attribute mit diesem Filter einsprachig oder mehrsprachig importiert bzw. exportiert werden. Die Möglichen Werte sind:
· „Einsprachig“ · „Mehrsprachig“ |
dateTimeMode | Zeitformat. Gibt an, wie Zeitattribute serialisiert werden. Die möglichen Werte sind
· „Kompakte Form“ · „Normalisierte Form“. |
filter | Attributauswahl des Filters in codierter Form. Darf nicht verändert werden. |