RunInterfaceService (Export) auf Szenarienebene

Das Makro RunInterfaceService (Export) wird verwendet, um einen Schnittstellendienst auszuführen, mit dem Plandaten für das aktuelle Szenario exportiert werden. Dieses Makro wird auf Szenarienebene ausgeführt.
Die folgende Tabelle enthält die Parameter, die zum Ausführen des Makros RunInterfaceService (Export) verwendet werden:
Parameter Beschreibung
Schnittstellendienst - Name Der Name des ausgeführten Schnittstellendienstes.
Richtung Die Richtung des Datenflusses. Die Werte müssen auf "Export" gesetzt werden.
Artikelhierarchieknoten Der zu exportierende Artikel.
Hinweis: Wenn kein Wert angegeben ist, werden alle Artikel exportiert.
Ortshierarchieknoten Der Ort des zu exportierenden Artikels.
Hinweis: Wenn kein Wert angegeben ist, werden alle Orte exportiert.
Kalenderart Die Periode, für die die Daten exportiert werden. Mögliche Werte:
  • Zeitraum: Die Periode, die in "Periodenbezeichnung" angegeben ist, und verwendet folgende Parameter: [Periodenbezeichnung], [Anzahl Perioden] und [Horizontebene].
  • Aktueller Zeitraum: Die aktuelle Planungsperiode und verwendet [Anzahl Perioden] und [Horizontebene].
  • Anfangszeitabschnitt: Die erste (älteste) Periode im Zyklusperiodenhorizont und kann zum Abrufen aller Zeiträume verwendet werden. Die [Anzahl Perioden] und [Horizontebene] werden verwendet.
Hinweis: Wenn kein Wert angegeben ist, wird die Periode "Anfangszeitabschnitt" berücksichtigt.
Periodenbezeichnung Die zu exportierende Zyklusperiode. Dies unterstützt die rollierenden Periodenknoten.
Hinweis: 
  • Dieses Feld ist relevant, wenn der Kalendertyp auf "Zeitraum" gesetzt ist.
  • Wenn kein Wert angegeben ist, wird die aktuelle Planungsperiode berücksichtigt.
Anzahl Perioden Die Anzahl der zu exportierenden Perioden der Horizontebene. Wenn die Horizontebene nicht mit der Kalenderebene zum Speichern von Szenarienwerten übereinstimmt oder wenn die Option Teleskopansicht aktiviert ist, werden alle Basiszeiträume innerhalb des angegebenen Bereichs der ausgewählten Perioden exportiert. Mögliche Werte:
  • Null: Alle Basisperioden bis zum Ende des Zyklusperiodenhorizonts werden exportiert.
  • 0: Alle Basiszeiträume, die zu der in der Periodenbezeichnung angegebenen Periode gehören (wenn der Kalendertyp = Zeitraum), werden exportiert.
  • • >=1: Alle Basisperioden, die zu [Anzahl Perioden] der Zeiträume der Horizontebene gehören, werden exportiert, beginnend mit der angegebenen Startperiode.
Horizontebene Die Kalenderhorizontebene, die von [Anzahl Perioden] für den Export verwendet wird.
Hinweis: Wenn der Wert nicht angegeben ist, basiert die Anzahl der Perioden auf der Kalenderebene zum Speichern von Szenarienwerten.
Filter Der Filter, der zur Bestimmung der Artikel- und Ortsauswahl verwendet wird. Es werden nur die relevanten Daten der ausgewählten Artikel und Orte exportiert, die den angegebenen Kriterien entsprechen.
Der Wert für das Feld Befehl muss im folgenden Format angegeben werden: RunInterfaceService (Name des Schnittstellendienstes, Richtung, [Artikelhierarchieknoten], [Ortshierarchieknoten], [Kalendertyp], [Periodenbezeichnung], [Anzahl Perioden], [Horizontebene], [Filter]).
Hinweis: Die optionalen Parameter werden in eckigen Klammern [ ] angegeben.
Tabelle 1. Beispiel
Anforderung Parameter
Alle Artikel an allen Orten aus der laufenden Planungsperiode für den Zyklusperiodenhorizont exportieren. RunInterfaceService("Szenariodatei exportieren","Export","","","Aktueller Zeitraum","")
Alle GOO-Artikel an allen Orten für die Dauer der Kalenderperiode "Aktuelles Jahr" auf der Kalenderebene zum Speichern von Szenarienwerten löschen (es sind keine Teleskop-Zeiträume definiert). RunInterfaceService("Szenariendatei exportieren","Export","GOO","","Zeitraum","Aktuelles Jahr","0")
GOO-Artikel an allen Orten für die aktuelle Planungsperiode exportieren. Zum Beispiel "GJ10 M03" für 1 Monatsperiode (wenn Zykluskalenderebene zum Speichern von Szenarienwerten = Monate). RunInterfaceService("Szenariendatei exportieren","Export","GOO","","Aktueller Zeitraum","1").
Alle Artikel an US-Standorten aus der laufenden Zyklusperiode für 52 Wochenperioden (wenn Zykluskalenderebene zum Speichern von Szenarienwerten = Wochen) exportieren. RunInterfaceService("Szenariendatei exportieren","Export","","US","Aktueller Zeitraum","52")
Alle Artikel an allen Orten aus dem Kalenderzeitraum "GJ10 M03" für 9 Monatsperioden exportieren (wenn Zykluskalenderebene zum Speichern von Szenarienwerten = Monate). RunInterfaceService("Szenariendatei exportieren","Export","","","Zeitraum","GJ11 M03","9")
Alle Artikel an allen Orten für alle Perioden im Zyklusperiodenhorizont exportieren; beginnend bei der ersten (ältesten) Historieperiode. RunInterfaceService("Szenariendatei exportieren","Export","","","","")
Alle Artikel an allen Orten für 7 Perioden auf Kalenderebene zum Speichern von Szenarienwerten exportieren; beginnend bei der ersten (ältesten) Periode im Zyklusperiodenhorizont. Wenn der Zyklushorizont als historisch = 6 und zukünftig = 6 angegeben ist. Die Ergebnisse sind 6 Historieperioden und 1 zukünftige Periode im Exportprozess (es sind keine Teleskop-Zeiträume definiert). RunInterfaceService("Szenariendatei exportieren","Export","","","Anfangszeitabschnitt","7")
GOO-Artikel an allen Orten exportieren, wo 0 < [DPLS_FUNITS] für "pconst". Zum Beispiel "GJ10 M03" für 1-Monatsperiode (wenn Zykluskalenderebene zum Speichern von Szenarienwerten = Monate und keine Teleskop-Zeiträume definiert sind). RunInterfaceService("Szenariendatei exportieren","Export","GOO","","Aktueller Zeitraum","1","", "0 < [DPLS_FUNITS]").
Alle Artikel an allen Orten aus dem Kalenderzeitraum "GJ10 M03" für 3 Monate von Wochenperioden exportieren (wenn Zykluskalenderebene zum Speichern von Szenarienwerten = Wochen). RunInterfaceService("Szenariendatei exportieren","Export","","","Zeitraum","GJ10 M03","3", "Monate").
GOO-Artikel an allen Orten für die aktuelle Planungsperiode exportieren. Zum Beispiel "GJ10 M03" für 1 Monat von Wochenperioden (Zykluskalenderebene zum Speichern von Szenarienwerten = Wochen und es sind keine Teleskop-Zeiträume definiert). RunInterfaceService("Szenariendatei exportieren","Export","GOO","","Aktueller Zeitraum","1","Monate").
GOO-Artikel an allen Orten für die aktuelle Planungsperiode exportieren. Zum Beispiel "GJ10 M03" für einen Monat, bei dem die Teleskopansicht für den Zyklus aktiviert ist. Zykluskalenderebene zum Speichern von Szenarienwerten = Wochen, Teleskopperioden für Zyklus = 7 Tage, mit zukünftigem Horizont = 8 Wochen. Das Ergebnis ist ein Monat von Teleskop-, Basiszeiträumen, d. h. 7 Tageszeiträume, 3 Wochenzeiträume. RunInterfaceService("Szenariendatei exportieren","Export","GOO","","Aktueller Zeitraum","1","Monate").

Validierungs- und Fehlermeldungen

Die folgende Tabelle listet den Status der Zyklusperiode und die damit verbundenen Validierungsmeldungen auf:
Zyklusperiode – Status Szenario - Status Ausführen möglich? Validierungsmeldung
Ausstehend --- Nein Makro {0} kann nicht ausgeführt werden, da die Zyklusperiode den Status "Ausstehend" hat.
Wird ausgeführt Beliebig Ja ---
Abgeschlossen Beliebig Ja ---
Abgebrochen Beliebig Ja ---
Angehalten Beliebig Ja ---
Archiviert Beliebig Nein Makro {0} kann nicht ausgeführt werden, da die Zyklusperiode den Status "Archiviert" hat.
Die Plandaten werden bei erfolgreicher Validierung und Ausführung des Makros für das aktuelle Szenario exportiert. Wenn die Validierung fehlschlägt, wird das Makro abgebrochen und die entsprechende Fehlermeldung angezeigt. Die folgende Tabelle enthält die Fehlermeldungen, die für die verschiedenen Validierungsfehler angezeigt werden:
Validierungsbedingung/-regeln Fehlermeldung
Überprüfen Sie, ob der weitergegebene Schnittstellendienst gültig ist. Schnittstellendienst "{0}" wurde nicht gefunden.
Wenn die ausgewählte Schnittstellendienst-Dateneinheit auf den aktuellen Makrokontext nicht angewendet werden kann, wird das Makro nicht ausgeführt, d. h. RunInterfaceService für Szenario kann nur Schnittstellen mit Dateneinheit = Szenarienwert ausführen. Schnittstellendienst {0} entspricht nicht der Dateneinheit, die für ein Szenarienmakro erforderlich ist.
Wenn die Richtung nicht der Schnittstellenrichtung des ausgewählten Schnittstellendienstes entspricht, wird das Makro nicht ausgeführt. Der Richtungsparameter {0} entspricht nicht der Richtung des ausgewählten Schnittstellendienstes "{1}".
Wenn die Kalenderebene nicht größer oder gleich der Kalenderebene zum Speichern von Szenarienwerten ist, wird eine Warnmeldung angezeigt und der Importvorgang abgebrochen. Kalenderebene {0} liegt unterhalb der Kalenderebene {1} zum Speichern von Szenarienwerten.
RunInterfaceService im Zyklusperiodenkontext muss einer Zyklusperiode mit dem Status "Wird ausgeführt", "Angehalten", "Abgeschlossen", "Abgebrochen" angehören. RunInterfaceService kann für eine Zyklusperiode mit dem Status {0} nicht ausgeführt werden.
Wenn Sie RunInterfaceService in einem Zyklusperiodenkontext ausführen, muss sich der ausgewählte Schnittstellendienst auf einen Kalender beziehen, der mit dem Kalender der aktuellen Zyklusperiode übereinstimmt. Ansonsten wird das Makro nicht ausgeführt. Der Kalender, auf den im Schnittstellendienst {0} Bezug genommen wird, entspricht nicht dem Kalender der aktuellen Zyklusperiode.
Überprüfen Sie bei Ausführung von RunInterfaceService für den Export, ob die Horizontebene, falls angegeben, gültig ist. Horizontebene {0} wurde nicht gefunden.
Überprüfen Sie bei Ausführung von RunInterfaceService für den Export, ob die Horizontebene (falls angegeben) sich auf der Kalenderebene zum Speichern von Szenarienwerten oder darüber befindet (wenn die Option Teleskopansicht nicht aktiviert ist). Die Horizontebene {0} liegt unterhalb der Kalenderebene {1} zum Speichern von Szenarienwerten.