RunInterfaceService (export) op cyclusperiodeniveau

De macro RunInterfaceService (export) wordt gebruikt om een interfaceservice uit te voeren waarmee kalendergegevens worden geëxporteerd in de context van een cyclusperiode. Deze macro wordt uitgevoerd op cyclusperiodeniveau.

De volgende tabel toont de parameters die worden gebruikt om de macro RunInterfaceService (export) uit te voeren:


Parameter	Omschrijving
Naam interfaceservice	De naam van de interfaceservice die wordt uitgevoerd.
Richting	De richting van de gegevensstroom. NB: Deze waarde wordt ingesteld op 'Exporteren' wanneer de macro wordt aangemaakt.
Kalendertype	De periode waarvoor de gegevens worden geëxporteerd. De waarden kunnen zijn: Bucket: De periode die is opgegeven in de parameters 'Periodelabel' en de parameters [Periodelabel], [Aantal perioden] en [Horizonniveau] gebruikt. Huidige bucket: De huidige planningsperiode die alleen de parameters [Aantal perioden] en [Horizonniveau] gebruikt. Beginbucket: De eerste (oudste) periode in de horizon van de cyclusperiode en kan worden gebruikt om alle buckets op te halen. De parameters [Aantal perioden] en [Horizonniveau] worden gebruikt. NB: Als de waarde niet is opgegeven, wordt de beginbucketperiode meegenomen.
Periodelabel	De beginperiode voor het exporteren van de gegevens. Deze ondersteunt knooppunten voor rollende perioden. NB: Dit veld is alleen van toepassing als het kalendertype is ingesteld op Bucket. Als de waarde niet is opgegeven, wordt de huidige planningsperiode meegenomen.
Aantal perioden	Het aantal perioden van het horizonniveau dat moet worden geëxporteerd. Als het horizonniveau niet gelijk is aan het kalenderniveau voor het opslaan van plannen of als de optie Telescopisch is ingeschakeld, worden alle basisbuckets binnen het opgegeven bereik van de geselecteerde perioden geëxporteerd. De waarden kunnen zijn: Null: Alle basisperioden tot het einde van de horizon van de cyclusperiode worden geëxporteerd. 0: Alle basisbuckets die behoren tot de periode die is opgegeven in Periodelabel, worden geëxporteerd als het kalendertype is ingesteld op 'Bucket'. >=1: Alle basisperioden die behoren tot de parameter [Aantal perioden] van horizonniveaubuckets, worden geëxporteerd vanaf de opgegeven beginperiode.
Horizonniveau	Het kalenderniveau dat moet worden gebruikt door de parameter [Aantal perioden] voor export. NB: Als deze waarde niet is opgegeven, wordt het aantal perioden gebaseerd op het kalenderniveau voor het opslaan van scenariowaarden.

De waarde van het veld Opdracht moet worden opgegeven in de volgende opmaak: RunInterfaceService (Naam Interfaceservice, Richting, [Kalendertype], [Periodelabel], [Aantal perioden], [Horizonniveau]).

NB: De optionele parameters worden opgegeven in [ ].

Tabel 1. Voorbeeld
Behoefte	Parameter
Basiskalenderperioden exporteren van de huidige planningsperiode naar de horizon van de cyclusperiode op het kalenderniveau om scenariowaarden op te slaan (er zijn geen telescopische perioden gedefinieerd).	RunInterfaceService("Mijn AP-kalender","Exporteren","Huidige bucket","")
U kunt basiskalenderperioden exporteren die beginnen vanaf de huidige planningsperiode die betrekking heeft op 6 buckets op het kalenderniveau om scenariowaarden op te slaan.	RunInterfaceService("Mijn AP-kalender","Exporteren","Huidige bucket","6")
U kunt basiskalenderperioden uit de periode BJ14 M12 exporteren die overeenkomen met 10 perioden op het kalenderniveau om scenariowaarden op te slaan.	RunInterfaceService("Mijn AP-kalender","Exporteren","Bucket","BJ14 M12","10")
Basiskalenderperioden exporteren vanaf de periode BJ14 M12 die overeenkomt met 10 maanden.	RunInterfaceService("Mijn AP-kalender","Exporteren","Bucket","BJ14 M12","10", "Maanden")
Exporteer 1 maand van telescopische basisbuckets van kalendergegevens uit de huidige planningsperiode. Bijvoorbeeld: "BJ14 M12", waarvoor de optie Telescopisch is ingeschakeld voor de cyclus. Cycluskalenderniveau voor het opslaan van plannen = Weken, telescopische perioden voor cyclus = 7 dagen, met toekomstige horizon = 8 weken. Resultaat is 1 maand van telescopische basisbuckets, dat wil zeggen 7 dagelijkse buckets, 3 wekelijkse buckets.	RunInterfaceService("Scenariobestand exporteren","Exporteren","Huidige bucket","1","Maanden").

Validatie- en foutmeldingen

De volgende tabel toont de status van de cyclusperiode en de bijbehorende validatieberichten:


Status cyclusperiode	Scenariostatus	Uitvoeren mogelijk?	Validatiebericht
In afwachting	Niet van toepassing	Nee	Macro {0} kan niet worden uitgevoerd, omdat Cyclusperiode de status "In afwachting" heeft.
Actief	Willekeurig	Ja	Niet van toepassing
Voltooid	Willekeurig	Ja	Niet van toepassing
Afgebroken	Willekeurig	Ja	Niet van toepassing
Onderbroken	Willekeurig	Ja	Niet van toepassing
Gearchiveerd	Willekeurig	Nee	Macro {0} kan niet worden uitgevoerd, omdat Cyclusperiode de status "Gearchiveerd" heeft

De kalendergegevens worden geëxporteerd in de context van de opgegeven cyclusperiode als de macro succesvol gevalideerd en uitgevoerd is. Als de validatie mislukt, wordt de macro afgebroken en wordt de bijbehorende foutmelding weergegeven. De volgende tabel toont de foutmeldingen die worden weergegeven voor de verschillende validatiefouten:


Validatievoorwaarde/regels	Foutmelding
Controleer of de doorgegeven interfaceservice geldig is.	Interfaceservice "{0}" is niet aanwezig.
Als de richting niet overeenkomt met de interface-richting van de geselecteerde interfaceservice, wordt de macro niet uitgevoerd.	Richtingparameter {0} komt niet overeen met richting van geselecteerde interfaceservice "{1}".
Als het kalenderniveau niet hoger is of gelijk is aan het kalenderniveau voor het opslaan van scenariowaarden, wordt een waarschuwing weergegeven en wordt het importproces afgebroken.	Kalenderniveau {0} ligt onder kalenderniveau {1} voor opslaan van scenariowaarden.
RunInterfaceService in de context van cyclusperiode moet afkomstig zijn van een cyclusperiode met de status Actief, Onderbroken, Voltooid en Afgebroken.	RunInterfaceService kan niet worden uitgevoerd voor een cyclusperiode met de status {0}.
Als de geselecteerde gegevensentiteit van de interfaceservice niet van toepassing is op de huidige macrocontext, wordt de macro niet uitgevoerd, dat wil zeggen: RunInterfaceService kan alleen interfaces voor gegevensentiteit = kalender in de context van een cyclusperiode uitvoeren.	Interfaceservice {0} komt niet overeen met de vereiste gegevensentiteit voor de macro in een cyclusperiode.
Wanneer u RunInterfaceService uitvoert in de context van een cyclusperiode, moet de geselecteerde interfaceservice verwijzen naar een kalender die overeenkomt met de kalender van de huidige cyclusperiode. Als dat niet het geval is, wordt de macro niet uitgevoerd.	Kalender waarnaar verwezen wordt vanuit interfaceservice {0} komt niet overeen met de kalender van de huidige cyclusperiode.
Wanneer RunInterfaceService wordt uitgevoerd voor export, controleer dan of het horizonniveau, indien opgegeven, geldig is.	Horizonniveau {0} is niet aanwezig.
Wanneer RunInterfaceService wordt uitgevoerd voor export, controleer dan of het horizonniveau (indien opgegeven) zich op of boven kalenderniveau bevindt voor het opslaan van plannen (als de optie Telescopisch niet is ingeschakeld).	Horizonniveau {0} ligt onder kalenderniveau {1} voor opslaan van scenariowaarden