1 Themenübersicht
Die Übertragungsliste ist eine Protokollfunktion für die Historie von betriebswirtschaftlichen Größen und zeichnet auf, ob eine Business Entity Instanz angelegt, gelöscht oder verändert wurde. Die Übertragungsliste zeichnet im Unterschied zum Änderungsjournal nicht auf, welche Inhalte eine Business Object Instanz hat bzw. welche dieser Inhalte wie verändert worden sind. Bei der Aufzeichnung der Übertragungsliste bestimmt der CisTransferListController, welche Änderungen in der Übertragungsliste aufgezeichnet werden. Die Übertragungsliste kann nur für Business Entitys aufgezeichnet werden, deren Primärschlüssel aus einer oder zwei GUIDs besteht. Zeitabhängigkeit wird in der Übertragungsliste nicht beachtet. Die Übertragungsliste überwacht die Änderungen der Business Entitys erst nach der Aktivierung. Weiterhin werden Änderungen mit OQL Update, Insert oder Delete nicht von der Übertragungsliste aufgezeichnet. In vielen Fällen ist es daher notwendig, dass unabhängig von der Übertragungsliste ein vollständiger Datenabgleich z.B. mit dem Fremdsystem manuell ausgeführt werden kann.
Die Anwendung „Cockpit: Übertragungslisteneinträge“ ermöglicht die aufgezeichneten Daten der Übertragungsliste abzufragen. Dadurch haben Sie einen Überblick über die Daten, die noch nicht übertagen worden sind.
2 Zielgruppe
- Entwickler
- Technische Berater
3 Begriffsbestimmung
Änderungsjournal
Das Änderungsjournal zeichnet Ereignisse im Lebenszyklus eines Business Entity auf. Beim Speichern eines zugehörigen Business Object werden folgende Information optional protokolliert: Zeitpunkt und Benutzer der Änderungen, alte und neue Werte geänderter Attribute.
Business Entity
Die Beschreibung einer betriebswirtschaftlichen Größe, wie beispielsweise eines Artikels, erfolgt durch viele Business Objects. Der Umgang mit vielen Business Objects ist sehr mühsam, weshalb diese nach bestimmten Kriterien zusammengefasst wurden. Ein dominierendes, übergeordnetes Business Object aus der Menge der zu einer Gruppe gehörenden Business Objects wird als Business Entity bezeichnet. Ein Business Entity ist also eine betriebswirtschaftliche Größe, die den Umgang mit Business Objects erleichtert und sie benutzergerecht darstellt. So wird zum Beispiel ein Artikel als ein Business Entity bezeichnet; tatsächlich besteht es aus einer Menge von Business Objects, unter anderem eines für die Basisdaten, eines für die Vertriebsdaten und eines für die lieferantenspezifischen Beschaffungsdaten.
Übertragungsliste
Die Übertragungsliste zeichnet im Unterschied zum Änderungsjournal nur auf, dass eine Business Entity Instanz seit der letzten Verarbeitung dieser Instanz verändert wurde. Die Übertragungsliste kann insbesondere beim Datenaustausch mit Fremdsystemen verwendet werden.
4 Anwendungsbeschreibung
Die Anwendung „Cockpit: Übertragungslisteneinträge“ ist eine Abfrageanwendung. Sie besteht aus Abfrage- und einem Arbeitsbereich und bietet einen Überblick über die aufgezeichneten Daten der Übertragungsliste, die für die registrierten Business Entitys protokolliert wurden. Bitte beachten Sie, dass ein CisTransferListController die Aufzeichnung der Übertragungsliste für ein oder mehrere Business Entitys steuert und für die Registrierung der Business Entitys zuständig ist. Die näheren Informationen finden Sie im Abschnitt „Aufzeichnung der Übertragungsliste“ in der Dokumentation „Änderungsjournal“.
4.1 Abfragebereich
Im Abfragebereich werden Abfragefelder abgelegt. In der Regel sind die wichtigsten Abfragefelder bereits vorhanden. Die Anzahl der Abfragefelder und deren Platzierung kann jedoch variieren.
Der Abfragebereich ist für alle Ansichten des Arbeitsbereichs gleich. Welche Abfragefelder angezeigt werden, können Sie selbst bestimmen. Dazu wählen Sie aus einem Felder-Vorrat die gewünschten Abfragefelder aus.
Nutzen Sie bei der Dateneingabe in Abfragefeldern die zugehörigen Wertehilfen und Direkthilfen. Darüber erfahren Sie, welche Daten abgefragt werden können.
4.2 Arbeitsbereich
Im Arbeitsbereich der Anwendung „Cockpit: Übertragungslisteneinträge“ wird die Ergebnisliste mit den gefundenen aufgezeichneten Daten der Übertragungsliste dargestellt.
4.2.1 Ansicht des Arbeitsbereichs
Um einen Protokolleintrag auf verschiedene Weise mit unterschiedlichen Informationen betrachten zu können, können mehrere Ansichten erstellt werden. Die Ansicht „Standard“ ist bereits vorhanden. Sie zeigt die wichtigsten Eigenschaften eines Protokolleintrags in einer Zeile an.
4.2.2 Listenspalten
Nachfolgend sind alle wesentlichen Listenspalten aufgeführt.
| Spalte | Erläuterung |
| Sequenznummer | Sequenznummer, mit der die Einträge in der Übertragungsliste aufgezeichnet sind. |
| Erzeugungszeitpunkt | Erzeugungszeitpunkt des Eintrages in der Übertragungsliste. |
| Typ | Typ des Eintrages in der Übertragungsliste. Die Typen sind durch „Registrierungen“ in der Softwareentwicklung automatisch erweiterbar. Deshalb finden Sie nachfolgend nur einen Auszug der möglichen Typen:
· Workflow · Dimensionsexport in das BI · Stammdatenexport zum Rechnungswesen · Sortiments-Aktualisierungsprozess · Dimensionsexport in das Controlling · Aktualisierung der phonetischen Werte · Subtyp |
| Subtyp | Die Identifizierung einer Übertragungsliste, die durch eine App hinzugefügt wurde, erfolgt mithilfe des Subtyps. Nur in diesem speziellen Fall identifizieren der Typ und der Subtyp die Übertragungsliste: Die Spalte „Typ“ enthält den Wert „100“ und die Spalte „Subtyp“ den Wert, der die App vorgibt. Anderenfalls ist die Spalte „Subtyp“ leer. |
| Business Entity | Vollqualifizierter Name des zu überwachenden geänderten Business Entitys. |
| Instanz | Der Instance String einer Business-Entity-Instanz wird angezeigt. Der Instance String setzt sich zusammen aus dem Business Key und optional der Bezeichnung eines Business Objects. Falls sich der Instance String einer Business-Entity-Instanz nicht mehr ermitteln lässt, wird deren GUID angezeigt. |
4.3 Anwendungsbezogene Aktion „Eintrag der Übertragungsliste löschen“
Durch die Aktion werden ein oder mehrere Einträge der Übertragungsliste gelöscht. Sie benötigen die Fähigkeit „Einträge der Übertragungsliste löschen“, damit diese Aktion aktiv wird.
Nach Wählen dieser Aktion erscheint ein Dialog, mit dem Sie die Einstellungen für das Löschen der Einträge der Übertragungsliste, das entweder sofort oder als Verarbeitungsauftrag läuft, festlegen können. Der Dialog ist in zwei Karteireiter unterteilt. Die Karteireiter „Allgemein“ und „Hintergrundeinstellungen sind im Dokument „Bedienungsleitfaden“ erklärt und werden hier nicht weiter erläutert.
Nach dem Betätigen des Buttons „Sofort“ oder „Im Hintergrund“ wird das Löschen durch die Hintergrund-Anwendung „Einträge der Übertragungsliste löschen“ durchgeführt.
5 Customizing
Für die Anwendung „Cockpit: Übertragungslisteneinträge“ sind in der Anwendung „Customizing“ keine Einstellungen festzulegen.
6 Business Entitys
Für die Anwendung „Cockpit: Übertragungslisteneinträge“ ist das nachfolgende Business Entity relevant, das Sie beispielsweise verwenden, um
- Berechtigungen zu vergeben und
- Aktivitätsdefinitionen einzurichten.
Übertragungsliste
com.cisag.sys.kernel.obj.TransferList
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 Dokumentation „Berechtigungen“ nachlesen.
7.1 Spezielle Fähigkeiten
Für die Anwendung „Cockpit: Übertragungslisteneinträge“ besteht folgende spezielle Fähigkeit die sich auf die Aktion „Eintrag der Übertragungsliste löschen“ bezieht. Für diese Fähigkeit können Sie in der Anwendung „Berechtigungsrollen“ Berechtigungen vergeben:
Einträge der Übertragungsliste löschen
com.cisag.sys.tools.modificationjournal.DeleteTransferList
Falls diese Fähigkeit erlaubt ist, können Sie die Einträge der Übertragungsliste löschen.
7.2 Organisations-Zuordnungen
Für die Anwendung „Cockpit: Übertragungslisteneinträge“ ist eine Organisations-Zuordnung nicht erforderlich.
7.3 Berechtigungen für Geschäftspartner
Die Anwendung „Cockpit: Übertragungslisteneinträge“ ist für Benutzer vom Typ „Geschäftspartner“ nicht freigegeben.
8 Vorgehensweise: Eintrag der Übertragungsliste löschen
Voraussetzung
Die Fähigkeit „Eintrag der Übertragungsliste löschen“ ist erlaubt.
Anleitung
- Öffnen Sie die Anwendung „Cockpit: Übertragungslisteneinträge“.
- Geben Sie nach Bedarf Suchmerkmale in die Felder des Abfragebereiches ein.
- Drücken Sie in der Standard-Symbolleiste „Aktualisieren“.
- Die Anwendung zeigt die den Suchmerkmalen entsprechenden Einträge im Arbeitsbereich an.
- Markieren Sie in der Liste einen Übertragungslisteneintrag, den Sie löschen möchten.
- Wählen Sie in der Standard-Symbolleiste die Aktion „Eintrag der Übertragungsliste löschen“ unterhalb des Aktionen-Buttons.
- Tragen Sie in die Felder des Karteireiters „Hintergrundeinstellungen“ die gewünschten Werte ein. Erläuterungen zu diesen Feldern entnehmen Sie bitte dem Bedienungsleitfaden.
- Wählen Sie „Im Hintergrund“.
- Das Dialog-Fenster wird geschlossen und das System legt einen Verarbeitungsauftrag an, der gemäß den Hintergrundeinstellungen abgearbeitet wird.
Hinweis:
Sie können auch im Schritt 7 „Sofort“ auswählen. In diesem Fall wird die Aktion sofort ausgeführt.