Marktintelligentie-interfaceservice voor import uitvoeren

Marketintelligentie (MI)-interfaceservices worden uitgevoerd met de macro RunInterfaceService. Als onderdeel van het importproces worden de velden zoals Artikel, Locatie, Startdatum, Einddatum en Waarde geïmporteerd voor de Marktintelligentie die op het tabblad Marktintelligentie is geselecteerd.

De interfaceservice kan ook handmatig worden uitgevoerd met de optie Scenario's importeren.

Tijdens de uitvoering van de macro wordt de volgende foutmelding weergegeven voor fouten in importbestand(en):

importeren [macro] is voltooid met fouten. Zie controlelogbestand voor gegevens.

NB: Als meerdere bestanden worden geïmporteerd (voor CSV of Excel), worden de bestanden als één bestandstransactie beschouwd.

Als de parameter Bij fout alles afkeuren op Uit staat, wordt er een logbestand voor fouten aangemaakt en gekoppeld aan het gerelateerde bericht in het controlelogbestand. U kunt het controlelogbestand downloaden met de optie Logbestand. Het bestand bevat alle rijen die zijn ongedaan gemaakt en een extra kolom met de foutgegevens. Als meerdere bestanden geïmporteerd worden, wordt deze opmerking opgenomen om het bestand aan te geven waarin de fout is opgetreden:

Fouten in bestandsnaam gevonden in rij: [rij]; [foutgegevens]

De opmaak van het logbestand: [datum]-[gebruiker]-[interfaceservice].CSV

Als de parameter Bij fout alles afkeuren op Aan staat en een rij mislukt, wordt er geen MI-gebeurtenis geïmporteerd.

De rijen in de importbestanden worden achtereenvolgens verwerkt.

De rijen in het importbestand kunnen worden gegroepeerd om één MI-gebeurtenis aan te maken als aan de volgende regels wordt voldaan:

De rijen moeten dezelfde referentie hebben.
De rijen moeten hetzelfde artikel en dezelfde locatie bevatten.
De rijen in het importbestand moeten worden gerangschikt in een aaneengesloten volgorde (hoeft niet op datum te zijn).
Bij het importeren met behulp van de database worden de gegevens geïmporteerd op basis van de normale volgorde van de tabel. Om de volgorde in de geïmporteerde tabel te faciliteren moet Bron worden ingesteld op Query, zodat het gebruik van de optie Sorteren op mogelijk is.
NB: Dit kan alleen worden bereikt door de zoekopdracht op te geven als:
```
SELECT A as ColumnA,B as ColumnB,C as ColumnC, ROW_NUMBER() OVER (ORDER BY A) as ColumnRowNumber FROM TABLE  
```
De begin- en einddatum in elke rij moeten overeenkomen met de begin- en einddatum van één bucket en tot hetzelfde niveau behoren. Alle start- en einddatums moeten bijvoorbeeld een maand definiëren. Een combinatie van maanden en weken is niet toegestaan.
De rijen hoeven niet tot aangesloten buckets te behoren. Voor buckets die niet zijn gedefinieerd, wordt bij het aanmaken van de enkele MI-gebeurtenis een waarde van nul meegenomen.
Voor een bucket kunnen twee rijen dezelfde begin- en einddatum hebben. In dit scenario worden de waarden opgeteld voor die bucket.
Als de rijen notitiegegevens bevatten, wordt een notitie voor de MI aangemaakt op basis van de notitie in de eerste rij. De resterende notities voor de gebeurtenis worden niet meegenomen.
De rijen worden gegroepeerd en verwerkt als onderdeel van het importproces tot aan de volgende referentie.
NB: In het importbestand kan een andere instance van dezelfde referentie bestaan. Als er een einde aanwezig is tussen de rijen met deze referentie, worden voor deze rijen aparte MI-gebeurtenissen aangemaakt.
De MI-gebeurtenis wordt aangemaakt op basis van alle gekoppelde velden, behalve:
- Beginperiode: Opgehaald door de vroegste startdatum en einddatum in de gekoppelde rijen van het geïmporteerde bestand af te stemmen met een bucket in SCP.
- Aantal perioden: Wordt bepaald door het aantal perioden van de gekoppelde rijen. Deze waarde kan groter zijn dan het aantal rijen om aan een gemiste bucket te komen.
- Measure periodedeel is ingesteld op importeren.

Voor rijen met een unieke referentie en de startdatum en einddatum die overeenkomen met een enkele bucket (elk niveau) in SCP, wordt een MI-gebeurtenis aangemaakt voor deze bucket. De MI-gebeurtenis wordt aangemaakt op basis van alle gekoppelde velden, behalve:

Beginperiode: Opgehaald door de start- en einddatum in het geïmporteerde bestand te vergelijken met een bucket in SCP.
Aantal perioden ingesteld op 1
Measure periodedeel is ingesteld op importeren.

De beginperiode wordt geïdentificeerd door de basisbucket waartoe de startdatum behoort.
De laatste bucket wordt geïdentificeerd door de basisbucket waartoe de einddatum behoort.
Als de startdatum en einddatum binnen één basisbucket vallen, is de waarde van toepassing op één bucket.
Als de startdatum en einddatum tot meer dan één basisbucket behoren, worden de waarden evenredig verdeeld over de dagen. Deze waarden worden later geaggregeerd naar het basiskalenderniveau op basis van het aantal dagen dat de gebeurtenis in elke bucket aanwezig is.
De gebeurtenis wordt aangemaakt op basis van alle gekoppelde velden, behalve:
- Beginperiode: Verkregen door een identificatie van de basisbucket die overeenkomt met de startdatum in het importbestand.
- Het aantal perioden wordt ingesteld als het aantal buckets de start- en einddatum van de periode.
- Measure periodedeel is ingesteld op importeren.

NB: De rijen zonder referentie worden als aparte MI-gebeurtenissen beschouwd.

Als de startdatum en einddatum overeenkomen met die van 1 niveau, worden MI-gebeurtenissen aangemaakt met het laagste beschikbare niveau dat overeenkomt met die datums. Als de MI-gebeurtenis moet worden aangemaakt voor meerdere rijen, wordt de MI-gebeurtenis toegevoegd op een algemeen niveau. Bijvoorbeeld, als het laagste niveau voor een rij Pt Week is en het laagste niveau voor een andere rij Week is, wordt de MI-gebeurtenis toegevoegd op het weekniveau.

Marktintelligentie kan worden geïmporteerd op de telescopische niveaus als:

De buckets aanwezig zijn in de cyclus.
Alle geïmporteerde rijen aanwezig zijn op hetzelfde telescopische niveau.

De MI-waarde wordt gespreid naar basisartikelen, locaties en perioden (indien van toepassing) op basis van de koppelingwaarden voor Spreiding-measure en Spreiding-measure voor periodespreiding gebruiken. Mogelijke scenario's:

Als de koppeling van de Spreiding-measure niet is opgegeven, wordt de default spreiding-measure die is gedefinieerd in de marktintelligentie-definitie gebruikt om de waarden te spreiden naar basisartikelen en locaties.
Als de koppeling Spreiding-measure voor periodespreiding gebruiken is ingevuld, wordt ook de koppeling van de Spreiding-measure gebruikt voor spreiding naar perioden.
NB: De spreiding-measure moet aanwezig zijn voor het artikel (I), de locatie (L) en Periode (P).
Als in de koppeling Spreiding-measure gebruiken voor de periodespreiding Nee is ingevuld, wordt de Spreiding-measure die voor de cyclus is opgegeven, gebruikt om over de perioden te spreiden.
NB:
- De spreiding-measure van de interfaceservice moet op I- en L-niveau worden gedefinieerd.
- De spreiding-measures voor cyclusperioden moeten op P-niveau worden gedefinieerd.
Spreiding-measure moet aanwezig zijn voor de dimensie op basis van de geselecteerde spreidingsopties. Als de spreiding-measure niet bestaat voor dezelfde dimensie, wordt de record afgekeurd en wordt de volgende foutmelding weergegeven:
```
Fouten gevonden in rij: [rij]; [Spreiding-measures moeten zijn gebaseerd op dezelfde dimensie als het te spreiden element]
```

Deze tabel toont de geldige measure-koppelingen voor de spreiding van interfaceservices en de bijbehorende regels.


Spreiding-measure (Interfaceservices)	Spreiding-measure voor periodespreiding gebruiken (Interfaceservice)	Regels
Gevuld	Ja	Gebruik de spreiding-measure voor interfaceservice om te spreiden naar artikelen en locaties. Gebruik IS spreiding-measure om te spreiden naar perioden. IS spreiding-measure moet aanwezig zijn op I-, L- en P-niveau.
Gevuld	Nee	Gebruik de spreiding-measure voor interfaceservice om te spreiden naar artikelen en locaties. Gebruik de 'periodespreidingsmeasure' van de cyclus om te spreiden naar perioden. IS spreiding-measure is alleen op I- en L-niveau nodig. Spreiding-measure voor cyclusperiode mag alleen aanwezig zijn op P-niveau.
Gevuld	Niet ingevuld	Dit is ongeldig en er wordt een foutmelding weergegeven. Als 'Spreidingsmeasure voor periodespreiding gebruiken' niet is opgegeven, kan de spreidingsmeasure niet worden opgegeven.
Niet ingevuld	Niet ingevuld	Gebruik de MI-definitie om de spreiding te bepalen voor de I-, L- en P-niveaus. Als 'Spreidingsmeasure gebruiken voor periodespreiding' (in MI-definitie) is ingesteld op Aan, moet de spreiding-measure in de MI-definitie aanwezig zijn op de I-, L- en P-niveaus. Als 'Spreiding-measure gebruiken voor periodespreiding' (in MI-definitie) is ingesteld op Uit, moet de spreiding-measure in de MI-definitie alleen aanwezig zijn op de I- en L-niveaus. De cyclus Periodespreiding-measure mag alleen aanwezig zijn op P-niveau.
Niet ingevuld	Gevuld	Dit is ongeldig en er wordt een foutmelding weergegeven.

Notities zijn verplicht als aan een van de volgende condities wordt voldaan:

Notitietype is opgegeven. Dat betekent dat Prioriteit en Overzicht moeten worden opgegeven.
De optie Notitie verplicht toevoegen voor de MI-definitie is ingesteld op Aan.

Als de notitievelden niet zijn opgegeven of als het notitietype of de prioriteit ongeldig is, wordt de record afgekeurd en wordt de volgende foutmelding weergegeven:

Fouten gevonden in rij: [rij]; [Notities zijn vereist, Notitietype, Prioriteit, Overzicht zijn vereiste velden]

NB:

Bestaande MI-gebeurtenissen worden tijdens het importproces niet gewijzigd.
De verwijdering van MI-gebeurtenissen moet extern worden beheerd.