Schnittstellendienst Marktintelligenz für Import ausführen

Marktintelligenz (MI)-Schnittstellendienste werden mithilfe des Makros RunInterfaceService ausgeführt. Als Teil des Importprozesses werden die Felder für Artikel, Ort, Startdatum, Enddatum, Enddatum und Wert für die Marktintelligenz importiert, die auf der Registerkarte Marktintelligenz ausgewählt ist.

Der Schnittstellendienst kann auch manuell mithilfe der Option Szenario importieren ausgeführt werden.

Während der Makroausführung wird die folgende Fehlermeldung für Fehler in der bzw. den Importdatei(en) angezeigt:

Import [Makro] mit Fehlern abgeschlossen. Details finden Sie im Auditprotokoll.

Hinweis: Wenn mehrere Dateien importiert werden (CSV oder Excel), werden die Dateien als eine einzige Dateitransaktion betrachtet.

Wenn der Parameter Bei Fehler alle ablehnen auf "Aus" gesetzt ist, wird ein Fehlerprotokoll erstellt und mit der entsprechenden Auditprotokollmeldung verknüpft. Sie können die Auditprotokolldatei mithilfe der Option Protokolldatei herunterladen. Die Datei enthält alle Zeilen, die verworfen werden, sowie eine zusätzliche Spalte mit den Fehlerdetails. Wenn mehrere Dateien importiert werden, ist dieser Kommentar enthalten, um die Datei anzugeben, in der der Fehler aufgetreten ist:

Dateinamenfehler gefunden in Zeile: [Zeile]; [Fehlerdetails]

Das Format der Protokolldatei: [Datum]-[Benutzer]-[Schnittstellendienst].CSV

Wenn der Parameter Bei Fehler alle ablehnen auf "An" gesetzt ist und eine Zeile fehlschlägt, wird kein MI-Ereignis importiert.

Die Zeilen in den Importdateien werden nacheinander verarbeitet.

Die Zeilen in der Importdatei können gruppiert werden, um ein einzelnes MI-Ereignis zu erstellen, wenn die folgenden Regeln eingehalten werden:

Die Zeilen müssen über dieselbe Referenz verfügen.
Die Zeilen müssen denselben Artikel und Ort enthalten.
Die Zeilen in der Importdatei müssen in einer zusammenhängenden Reihenfolge angeordnet werden (müssen nicht nach Datum angeordnet sein).
Beim Import mittels der Datenbank werden die Daten auf Basis der logischen Reihenfolge der Tabelle importiert. Um das Anordnen innerhalb der importierten Tabelle zu vereinfachen, muss die Quelle auf Abfrage gesetzt werden, damit die Option Anordnen nach verwendet werden kann.
Hinweis: Dies kann nur erreicht werden, wenn die Abfrage wie folgt festgelegt wird:
```
SELECT A as ColumnA,B as ColumnB,C as ColumnC, ROW_NUMBER() OVER (ORDER BY A) as ColumnRowNumber FROM TABLE  
```
Start- und Enddatum in jeder Zeile müssen dem Start- und Enddatum eines einzelnen Zeitraums entsprechen und zu derselben Ebene gehören. So müssen zum Beispiel alle Start- und Enddaten einen Monat definieren. Eine Mischung von Monaten und Wochen ist nicht zulässig.
Die Zeilen müssen nicht zu zusammenhängenden Zeiträumen gehören. Für nicht definierte Zeiträume wird während der Erstellung des einzelnen MI-Ereignisses ein Nullwert berücksichtigt.
Für einen Zeitraum können zwei Zeilen dasselbe Start- und Enddatum haben. In diesem Szenario werden die Werte für diesen Zeitraum summiert.
Wenn die Zeilen Kommentarinformationen enthalten, wird ein Kommentar für die MI auf Basis des Kommentars in der ersten Zeile erstellt. Die übrigen Kommentare für das Ereignis werden nicht berücksichtigt.
Die Zeilen werden gruppiert und zusammen im Rahmen des Importvorgangs bis zur nächsten Referenz verarbeitet.
Hinweis: In der Importdatei kann eine andere Instanz derselben Referenz vorhanden sein. Wenn es eine Unterbrechung zwischen den Zeilen mit dieser Referenz gibt, werden für diese Zeilen separate MI-Ereignisse erstellt.
Das MI-Ereignis wird auf Basis aller zugeordneten Felder erstellt, außer:
- Startperiode: Wird ermittelt, indem das früheste Startdatum und Enddatum in den verknüpften Zeilen der importierten Datei einem Zeitraum in SCP zugeordnet werden.
- Anzahl Perioden: Bestimmt durch die Anzahl der Perioden, in denen die verknüpften Zeilen enthalten sind. Dieser Wert kann größer als die Anzahl der Zeilen sein, um einen verpassten Zeitraum zu berücksichtigen.
- Kennzahl "Anteil pro Periode" ist auf "Import" gesetzt.

Bei Zeilen mit einer eindeutigen Referenz und mit einem Start- und Enddatum, das einem einzelnen Zeitraum (beliebiger Ebene) in SCP entspricht, wird ein MI-Ereignis für diesen Zeitraum erstellt. Das MI-Ereignis wird auf Basis aller zugeordneten Felder erstellt, außer:

Startperiode: Wird ermittelt, indem das Start- und Enddatum in der importierten Datei einem Zeitraum in SCP zugeordnet werden.
"Anzahl Perioden" ist auf 1 gesetzt.
Kennzahl "Anteil pro Periode" ist auf "Import" gesetzt.

Bei Zeilen mit einer eindeutigen Referenz und mit einem Start- und Enddatum, die nicht einem einzelnen Zeitraum (beliebiger Ebene) in SCP entsprechen, wird ein MI-Ereignis erstellt. Für dieses Ereignis:

Die Startperiode wird durch den Basiszeitraum angegeben, zu dem das Startdatum gehört.
Der letzte Zeitraum wird durch den Basiszeitraum angegeben, zu dem das Enddatum gehört.
Wenn Start- und Enddatum innerhalb eines Basiszeitraums liegen, gilt der Wert für den einzelnen Zeitraum.
Wenn Start- und Enddatum zu mehr als einem Basiszeitraum gehören, werden die Werte gleichmäßig auf Tage verteilt. Diese Werte werden später auf Basis der Anzahl der Tage, während denen das Ereignis in jedem Zeitraum vorhanden ist, in die Basiskalenderebene verdichtet.
Das Ereignis wird auf Basis aller zugeordneten Felder erstellt, außer:
- Startperiode: Wird ermittelt, indem der Basiszeitraum identifiziert wird, der dem Startdatum in der Importdatei entspricht.
- "Anzahl Perioden" ist als Anzahl von Zeiträumen zwischen Start- und Enddatum auf der Basisperiodenebene festgelegt.
- Kennzahl "Anteil pro Periode" ist auf "Import" gesetzt.

Hinweis: Die Zeilen ohne Referenz werden als separate MI-Ereignisse berücksichtigt.

Wenn Start- und Enddatum mit mehr als einer Ebene übereinstimmen, werden MI-Ereignisse für die niedrigste verfügbare Ebene erstellt, die mit diesen Daten übereinstimmt. Wenn das MI-Ereignis für mehrere Zeilen erstellt werden soll, wird das MI-Ereignis auf einer gemeinsamen Ebene hinzugefügt. Wenn z. B. die niedrigste Ebene für eine Zeile "Teilwoche" lautet und die niedrigste Ebene für eine andere Zeile "Woche" lautet, wird das MI-Ereignis auf der Wochenebene hinzugefügt.

Marktintelligenz kann auf den Teleskopebenen importiert werden, wenn:

Die Zeiträume innerhalb des Zyklus vorhanden sind.
Alle importierten Zeilen auf derselben Teleskopebene vorhanden sind.

Die MI-Verteilung wird auf Basis der Zuordnungswerte für Verteilungskennzahl und Verteilungskennzahl für Periodenverteilung verwenden auf Basisartikel, -orte und -perioden (falls zutreffend) verteilt. Mögliche Szenarien:

Wenn die Zuordnung Verteilungskennzahl nicht angegeben ist, wird die in der Marktintelligenzdefinition definierte Standardverteilungskennzahl verwendet, um die Werte auf Basisartikel und -orte zu verteilen.
Wenn die Zuordnung Verteilungskennzahl für Periodenverteilung verwenden mit "Ja" ausgefüllt ist, wird die Zuordnung Verteilungskennzahl auch für die Verteilung auf Perioden verwendet.
Hinweis: Die Verteilungskennzahl muss bei Artikel (I, Item), Ort (L, Location) und Periode (P, Period) vorhanden sein.
Wenn die Zuordnung Verteilungskennzahl für Periodenverteilung verwenden mit "Nein" ausgefüllt ist, wird die für den Zyklus definierte Verteilungskennzahl für die Verteilung auf Perioden verwendet.
Hinweis:
- Der Schnittstellendienst "Verteilungskennzahl" muss auf den Ebenen I und L definiert werden.
- Die Verteilungskennzahlen für die Zyklusperiode müssen auf Ebene P definiert werden.
Verteilungskennzahl muss für die Dimension auf Basis der ausgewählten Verteilungsoptionen vorhanden sein. Wenn die Verteilungskennzahl für dieselbe Dimension nicht vorhanden ist, wird der Datensatz abgelehnt und folgende Fehlermeldung angezeigt:
```
Fehler gefunden in Zeile: [Zeile]; [Verteilungskennzahlen müssen auf derselben Dimension basieren wie das zu verteilende Element].
```

Die folgende Tabelle zeigt die gültigen Zuordnungen der Verteilungskennzahl innerhalb des Schnittstellendienstes und die zugehörigen Regeln.


Verteilungskennzahl (Schnittstellendienste)	Verteilungskennzahl für Periodenverteilung verwenden (Schnittstellendienst)	Regeln
Ausgefüllt	Ja	Verwenden Sie die im Schnittstellendienst definierte Verteilungskennzahl für die Verteilung auf Artikel und Orte. Verwenden Sie die im Schnittstellendienst definierte Verteilungskennzahl für die Verteilung auf Perioden. Die Verteilungskennzahl muss auf den Ebenen I, L und P vorhanden sein.
Ausgefüllt	Nein	Verwenden Sie die im Schnittstellendienst definierte Verteilungskennzahl für die Verteilung auf Artikel und Orte. Verwenden Sie die "Periodenverteilungskennzahl" des Zyklus für die Verteilung auf Perioden. Die Verteilungskennzahl muss nur auf den Ebenen I und L vorhanden sein. Die Verteilungskennzahl der Zyklusperiode muss nur auf Ebene P vorhanden sein.
Ausgefüllt	Nicht ausgefüllt	Dies ist ungültig, und es wird eine Fehlermeldung angezeigt. Wenn "Verteilungskennzahl für Periodenverteilung verwenden" nicht angegeben ist, kann die Verteilungskennzahl nicht angegeben werden.
Nicht ausgefüllt	Nicht ausgefüllt	Verwenden Sie die MI-Definition, um die Verteilung auf die Ebenen I, L und P zu bestimmen. Wenn "Verteilungskennzahl für Periodenverteilung verwenden" (in MI-Definition) auf "An" gesetzt ist, muss die Verteilungskennzahl in der MI-Definition auf den Ebenen I, L und P vorhanden sein. Wenn "Verteilungskennzahl für Periodenverteilung verwenden" (in MI-Definition) auf "Aus" gesetzt ist, darf die Verteilungskennzahl in der MI-Definition nur auf den Ebenen I und L vorhanden sein. Der Zyklus der Periodenverteilungskennzahl darf nur in P vorhanden sein.
Nicht ausgefüllt	Ausgefüllt	Dies ist ungültig, und es wird eine Fehlermeldung angezeigt.

Kommentare sind obligatorisch, wenn eine der folgenden Bedingungen erfüllt ist:

Kommentartyp ist angegeben. Folglich müssen Priorität und Zusammenfassung angegeben werden.
Die Option Kommentar erzwingen für die MI-Definition ist auf "An" gesetzt.

Wenn die Kommentarfelder nicht angegeben sind oder der Kommentartyp oder die Priorität ungültig ist, wird der Datensatz abgelehnt und die folgende Fehlermeldung angezeigt:

Fehler gefunden in Zeile: [Zeile]; [Kommentare sind erforderlich, "Kommentartyp", "Priorität", "Zusammenfassung" sind Pflichtfelder].

Hinweis:

Vorhandene MI-Ereignisse werden während des Importprozesses nicht geändert.
Das Löschen von MI-Ereignissen muss extern verwaltet werden.