Schnittstellendienste definieren

So definieren Sie einen Schnittstellendienst:

Hinweis: Weitere Informationen zur Definition eines Schnittstellendienstes auf Basis eines vorhandenen oder zur Bearbeitung eines Schnittstellendienstes finden Sie unter Schnittstellendienste bearbeiten.
  1. Wählen Sie den Pfad Konfiguration > Allgemein > Schnittstellendienste.
  2. Klicken Sie auf Neu.
  3. Geben Sie im Fenster Neuer Schnittstellendienst folgende Daten ein:
    Schnittstellentyp
    Wählen Sie den Schnittstellentyp aus. Es gibt die folgenden Optionen:
    • Advanced Planning
    • CSV
    • Datenbank
    • EXCEL
    Dateneinheit
    Wählen Sie die Dateneinheit aus, die der Schnittstelle zugeordnet werden muss. Es gibt die folgenden Dateneinheiten:
    • Kalender
    • Codeliste
    • Szenario - Ansicht
      Hinweis: Wenn Sie diese Option auswählen, müssen Sie das Importverhalten festlegen.
    • Transaktionsdaten
    Schnittstellenrichtung
    Abhängig davon, was Sie vorher ausgewählt haben, geben Sie je nach Bedarf Export, Import oder Import oder Export an.
    Spalte pro Kennzahl
    Wenn dieses Kontrollkästchen markiert ist, wird jede Kennzahl in der Schnittstelle in einer neuen Spalte angezeigt. Sie können diesen Dimensionen neue Zeilen und Kennzahlen in der Registerkarte Zuordnungen hinzufügen:
    • Artikel
    • Ort
    • Kalenderperiode

    Wenn dieses Kontrollkästchen nicht markiert (deaktiviert) ist, ist die Liste der Dimensionen in der Registerkarte Zuordnungen auf fünf Spalten mit den folgenden Dimensionen festgelegt:

    • Artikel
    • Ort
    • Kalenderperiode
    • Kennzahl
    • Wert
    Hinweis: Sie können dieses Feld nur anzeigen, wenn für alle Schnittstellentypen als Dateneinheit Szenario - Wert festgelegt ist.
  4. Klicken Sie auf OK. Die Liste wird durch eine Detailmaske ersetzt, in denen sich die Werte der Felder Schnittstellentyp und Dateneinheit nach Ihrer Auswahl richten.
  5. Legen Sie je nach der ausgewählten Dateneinheit die folgenden Daten fest:
    Modul
    Das Modul, mit dem der Schnittstellendienst verknüpft ist. Wählen Sie das entsprechende Modul aus.
    Zielcodeliste
    Der Name der Datenquelle, die als Teil des Schnittstellendienstes verwendet wird.
  6. Geben Sie die folgenden Daten ein:
    Name
    Geben Sie den Namen des Interpolationsschnittstellendienstes an.
    Anzeigename
    Geben Sie den Namen an, der in der Anwendung angezeigt werden soll. Dieses Feld ist optional.
    System
    Dieses Feld dient nur der Information und kann nicht geändert werden.
    Datenquelle
    Der Name der Datenquelle, die als Teil des Schnittstellendienstes verwendet wird.
  7. Geben Sie auf Basis des von Ihnen ausgewählten Schnittstellentyps die folgenden erforderlichen Daten an:
    Wenn Sie CSV auswählen:
    Option Beschreibung
    Dateien Der Name der CSV-Datei, die als Teil des Schnittstellendienstes verwendet wird.
    Feldnamen in Kopfzeile

    Markieren Sie dieses Kontrollkästchen, um eine der folgenden Möglichkeiten anzuzeigen:

    • Die erste Zeile der Importdatei enthält Feldbezeichnungen und kann übersprungen werden.
    • Die erste Zeile der Exportdatei muss Feldköpfe enthalten.
    Kalenderperiode - Definition Zeigt an, ob Kalenderperioden mithilfe des im Kalenderformat definierten Zeitraumstartdatums, des Zeitraumenddatums oder des Zeitraumnamens, z. B. GJ10 M03, exportiert werden.
    Wenn Sie "Datenbank" auswählen und als Quelle die vorgegebene Tabellenauswahl verwenden, geben Sie folgende Daten ein:
    Option Beschreibung
    Tabellen Der Name der Tabelle, die als Teil des Schnittstellendienstes verwendet wird.
    Importfilter

    Legen Sie einen Filter für die über den Schnittstellendienst weitergeleiteten Daten fest, sonst gelten alle Datensätze der ausgewählten Quelltabelle. Der Text muss im Format eines Standard-SQL-WHERE-Befehls angegeben werden, wobei das Schlüsselwort WHERE implizit ist.

    Um Daten mithilfe von Dimensionen zu filtern, können Sie auch die folgenden Variablen verwenden:

    • %cycle%: Zyklusname
    • %cycleperiod%: Bezeichnung der Zyklusperiode
    • %cycleperiod-Startdate%: Startdatum des laufenden Zyklusperioden-Zeitraums (bei Zyklus.Periodizität) im erforderlichen Datumsformat. Dies ist nicht das Datum, an dem die Zyklusperiode gestartet wird.
    • %cycleperiod-Enddate%: Enddatum des laufenden Zyklusperioden-Zeitraums (bei Zyklus.Periodizität) im erforderlichen Datumsformat. Dies ist nicht das Datum, an dem die Zyklusperiode abgeschlossen wird, oder das Ende des Zyklusperiodenhorizonts.
    • %horizon-start%: Startdatum des Zyklusperiodenhorizonts im verlangten Datumsformat; d. h. die erste (älteste) Basisperiode in der aktuellen Zyklusperiode.
    • %horizon-end%: Enddatum des Zyklusperiodenhorizonts im verlangten Datumsformat; d. h. die letzte (neueste) Basisperiode in der aktuellen Zyklusperiode.
    • %scenario%: Name des Szenarios

    Beispiele:

    CHAN_ID <> 'SUMME' UND End_date > %CyclePeriod-StartDate% oder PROD_GROUP = %scenario% UND PERIODE >= %horizon-start% UND PERIODE <= %horizon-end%
    Wenn Sie den Pfad Datenbank > Quelle > Abfrage auswählen:
    Option Beschreibung
    Abfrage Geben Sie eine SQL-Anweisung ein und klicken Sie dann auf Prüfen, um den Abfragetext zu prüfen.
    Hinweis:  Wenn die Abfrage erfolgreich geprüft wurde, werden die zurückgemeldeten Felder zur Verwendung in den Registern Zuordnungen und Import-/Exportkennzahlen gespeichert, wodurch Sie die Felder zum Zuordnen auswählen können.

    Ansonsten müssen Sie der Datenquelle für diese Schnittstelle manuell Felder hinzufügen.

  8. Für alle Schnittstellentypen:
    Kalenderperiode - Definition
    Zeigt an, ob Kalenderperioden mithilfe des im Kalenderformat definierten Zeitraumstartdatums, des Zeitraumenddatums oder des Zeitraumnamens, z. B. GJ10 M03, exportiert werden.
  9. Markieren Sie das Kontrollkästchen Ungeänderte Szenarienwerte löschen, um die Szenarienwerte, die nach dem Import der Daten auf Basis des Kennzahlfilters nicht geändert wurden, zurückzusetzen.
    Hinweis:  Wenn der Kennzahlfilter angegeben ist, werden alle nicht geänderten Werte für die Kennzahlen im Filter zurückgesetzt. Ist der Kennzahlfilter nicht angegeben, werden alle nicht geänderten Werte für Kennzahlen, die beim Import aktualisiert wurden, zurückgesetzt.
  10. Die Registerkarte Zuordnungen enthält eine Liste der zuzuordnenden Dimensionen sowie, falls relevant, der Moduleinstellungen. Ändern Sie auf dieser Registerkarte die verbundenen Feldbezeichnungen nach Bedarf.
  11. Die Registerkarte Import-/Exportkennzahlen enthält eine Liste der Kennzahlen (Zeilen), die als Quelle oder Ziel für die Übertragung und die entsprechende ID im Schnittstellendienst fungieren. Verwenden Sie in dieser Registerkarte die Schaltfläche Neu, um Kennzahlen zu erfassen, die als Filter für den Schnittstellendienst fungieren, der nur die hier definierten Kennzahlen im- oder exportiert.
  12. Für den Schnittstellentyp "Datenbank" listet die zusätzliche Registerkarte Exportkonstanten die zu exportierenden, gültigen Konstantendaten auf. Ändern Sie auf dieser Registerkarte die verbundenen Feldbezeichnungen und -werte nach Bedarf. Die in dieser Registerkarte angegebenen Exportkonstanten können für den Export mehrerer Szenarien mit einer einzigen Schnittstellendefinition unter Verwendung der Importfilter-Variablen verwendet werden. Wenn die Exportkonstante zum Beispiel die Variable %scenario% verwendet, kann diese Variable eine einzige Schnittstellendefinition verwenden, um mehrere Szenarien zu exportieren.

    Um Daten mithilfe von Dimensionen zu filtern, können Sie auch die folgenden Variablen verwenden:

    • %cycle%: Zyklusname
    • %cycleperiod%: Bezeichnung der Zyklusperiode
    • %cycleperiod-Startdate%: Startdatum des laufenden Zyklusperioden-Zeitraums (bei Zyklus.Periodizität) im erforderlichen Datumsformat. Dies ist nicht das Datum, an dem die Zyklusperiode gestartet wird.
    • %cycleperiod-Enddate%: Enddatum des laufenden Zyklusperioden-Zeitraums (bei Zyklus.Periodizität) im erforderlichen Datumsformat. Dies ist nicht das Datum, an dem die Zyklusperiode abgeschlossen wird, oder das Ende des Zyklusperiodenhorizonts.
    • %horizon-start%: Startdatum des Zyklusperiodenhorizonts im verlangten Datumsformat; d. h. die erste (älteste) Basisperiode in der aktuellen Zyklusperiode.
    • %horizon-end%: Enddatum des Zyklusperiodenhorizonts im verlangten Datumsformat; d. h. die letzte (neueste) Basisperiode in der aktuellen Zyklusperiode.
    • %scenario%: Name des Szenarios
  13. Klicken Sie auf Einsenden.
Verwandte Themen