Skip to main content
Documentatie
Documentatie
Adaptive Planning
Laatst bijgewerkt: 2023-06-23
Planning-dimensielaadprogramma's maken

Planning-dimensielaadprogramma's maken

Metadata loaders synchronize hierarchical information from source systems into the hierarchies of your planning model. Your hierarchies should already exist in your source system before you attempt to synchronize.
De aanvragen van het laadprogramma voor Planning-dimensie zijn beperkt tot het bijwerken van maximaal 10.000 dimensiewaarden in een hiërarchische dimensie of 40000 dimensiewaarden in een platte dimensie. Deze limieten zijn niet van toepassing op het maken van nieuwe dimensiewaarden binnen een aanvraag van een lader.
Met de planningsdimensielader kunt u metagegevens over dimensiewaarden uit het faseringsgebied toewijzen aan:
Adaptive Planning
. Het belangrijkste voordeel van de planningsdimensielader is dat u dimensiewaarden in bulk kunt importeren, in plaats van ze één voor één te maken in Modellering > Modelbeheer > Dimensies. Nadat u een lader hebt gemaakt, kunt u deze handmatig uitvoeren of plannen voor uitvoering als onderdeel van een integratietaak.

Volg deze stroom om een planningsdimensielader te maken:
  1. Gegevensbroninstellingen invoeren
  2. Kolomtoewijzing configureren
  3. Bedrijfsregels maken
  4. Voorbeeld van lader-uitvoer weergeven
  5. De lader uitvoeren of plannen

Voordat u begint

De planningsdimensielader vereist faseringsgegevens van een import van een bestaande gegevensbron.

Gegevensbroninstellingen invoeren

Met de instellingen voor gegevensbron kunt u kiezen welke brontabel u wilt gebruiken voor faseringsgegevens, selecteren naar welke planningsdimensie u wilt laden en of nieuwe dimensiewaarden automatisch moeten worden gemaakt.
  1. Navigeer naar
    Integratie > Integraties ontwerpen
    .
  2. Klik op
    Nieuwe lader maken
    in het gedeelte Laders van de componentenbibliotheek.
  3. Selecteer
    Planningsdimensielader
     als ladertype. Voer een naam in voor de lader.
  4. Klik op
    Maken
    .
Best practice: Sla regelmatig op terwijl u uw lader maakt en bewerkt door op
Opslaan
te klikken in het deelvenster Acties. U kunt niet-opgeslagen wijzigingen ongedaan maken door op
Sluiten
 en vervolgens op
Nee
 te klikken.
Voer de algemene eigenschappen van planningsdimensielader in:
  • Brontabel:
     selecteer de brontabel in de vervolgkeuzelijst. De brontabellen in de lijst behoren tot alle tabellen die beschikbaar zijn in het faseringsgebied waartoe u toegang hebt.
  • Planningsdimensie:
     kies een dimensie uit alle dimensies waarin de bron moet worden geladen. De vermelde dimensies zijn afkomstig uit Modellering > Modelbeheer > Dimensies.
  • Dimensiewaarde maken indien niet gevonden in Planning:
     schakel het selectievakje in om automatisch nieuwe dimensiewaarden te maken die zijn gevonden in het bronsysteem, maar niet zijn gevonden in Modellering > Modelbeheer > Dimensies. Als deze optie niet is ingeschakeld, worden alleen updates van bestaande dimensiewaarden uitgevoerd en worden er geen nieuwe dimensies gemaakt.
    • Als voor de dimensie die u laadt Op basis van gegevensimport automatisch dimensiewaarden maken niet is ingeschakeld in Modellering > Modelbeheer > Dimensies wordt u gewaarschuwd.
  • Logboekniveau:
     kies het type details dat wordt vastgelegd bij het uitvoeren van de lader.
    • Fout
      :
       alleen ernstige fouten registreren.
    • Info
      :
       basisgegevens vastleggen, zoals wanneer het laadprogramma is bijgewerkt.
    • Uitgebreid
      :
       biedt gedetailleerde informatie over alle fasen en acties. Dit niveau wordt voornamelijk gebruikt voor foutopsporing of audits, omdat het meer logboekgegevens kan opleveren dan voor normaal gebruik praktisch is.

Kolomtoewijzing configureren

Met kolomtoewijzing kunt u kolommen uit de gegevensbron toewijzen aan dimensiewaarden die beschikbaar zijn in Modellering > Modelbeheer > Dimensies.
Als er meerdere kolommen moeten worden toegewezen, kunt u het filter
Weergeven
gebruiken om het volgende te selecteren:
  • Alle
    : toont alle Planning-kolommen.
  • Vereist
    : toont alle vereiste Planning-kolommen.
  • Niet-toegewezen
    : toont alle niet-toegewezen Planning-kolommen.
  • Toegewezen
    : toont alle toegewezen Planning-kolommen.
U kunt het veld
Zoeken
gebruiken om kolommen te zoeken. Voer een volledige of gedeeltelijke naam in om naar te zoeken en klik op het vergrootglas. Alle faseringskolommen die overeenkomen met de zoekopdracht worden in de resultaten weergegeven.
Kolommen toewijzen
  1. Klik op
    Kolomtoewijzing
    .
    Het tabblad Kolomtoewijzing bevat:
    • Status:
      geeft aan of een Planning-kolom is toegewezen. Een vinkje Toegewezen kolom geeft een toegewezen kolom aan. Een uitroepteken Niet-toegewezen kolom geeft een niet-toegewezen kolom aan.
    • Planning-kolom:
      geeft alle Planning-kolommen weer die beschikbaar zijn voor toewijzing op een blad. De lijst met Planning-kolommen bevat een set verplichte planningskolommen, gevolgd door alle andere Planning-kolommen. Verplichte Planning-kolommen zijn vetgedrukt met een asterisk en bevatten een waardekolom. Niet-verplichte kolommen bevatten de korte naam en omschrijving.
    • Bronkolom:
       geeft de kolommen in de faseringstabel weer die zijn gekozen in de gegevensbroninstellingen.
  2. Selecteer een niet-toegewezen kolom en klik op de vervolgkeuzelijst. In de vervolgkeuzelijst wordt een lijst weergegeven met kolommen waaraan u kunt toewijzen. Terwijl u de kolommen toewijst, verandert de statusindicator van rood IntegrationMappingUnmapped.png in groen IntegrationMappingMapped.png.
When
Data import automatically creates dimension values
 is enabled, you can map attributes by code. The attribute name automatically becomes the code.
Zie Voorbeeld: dimensiewaarden laden uit spreadsheetgegevensbronnen voor een voorbeeld van hoe dimensiewaarden en hun bovenliggende waarden worden toegewezen aan Planning.
Namen van planningsdimensiewaarden wijzigen bij laden
De naam van een planningsdimensiewaarde bij het laden wijzigen:
  1. Selecteer de bronkolom die de dimensiewaarde in de bron op unieke wijze identificeert.
  2. Wijs de ID-kolom toe aan de dimensiewaarde-ID.
  3. Wijs de naam toe aan de naam van de dimensiewaarde.
Toewijzing van kolommen ongedaan maken
Als u de toewijzing van kolommen ongedaan wilt maken, klikt u op
Toewijzing ongedaan maken
en kiest u:
  • Alle ongedaan maken
    :
     de toewijzing van alle kolommen wordt ongedaan gemaakt.
  • Toewijzing van selectie ongedaan maken
    :
     hiermee wordt de toewijzing van alleen de geselecteerde kolommen ongedaan gemaakt.
Als u de toewijzing van een kolom ongedaan maakt, wordt het toewijzingsstatuspictogram rood IntegrationMappingUnmapped.png.
Toewijzingskenmerken die zijn gekoppeld aan lijstdimensies
U kunt kenmerken aan een lijstdimensie koppelen door kolommen uit een gegevensbronimport toe te wijzen.
Het koppelen van kenmerken aan dimensies is alleen mogelijk voor lijstdimensies. U kunt geen kenmerken koppelen aan hiërarchische dimensies.
Binnen
Adaptive Planning
 kunt u naar
Modelbeheer
 >
Dimensies
 gaan en op een dimensie klikken om de details weer te geven om te zien of het een lijstdimensie is.
Selecteer in Instellingen gegevensbron een lijstdimensie als
Planningsdimensie
.
Kenmerken zijn beschikbaar als kolommen in kolomtoewijzing omdat de dimensie een lijstdimensie is.
Omdat lijstdimensies niet hiërarchisch zijn, is ParentId geen optie voor de bronkolom.

Download and Upload Mappings

You can download, modify, then upload mappings for loaders to quickly resolve mapping errors. Uploads perform an all or nothing, replace-all action. Only 1 sheet of mappings from the file processes on upload. Additional sheets of mappings will error out and cancel the upload.
  1. Click
    Download Member Mappings
     in the
    Actions
     pane.
  2. Download the .XLSX file. You'll also receive an email or a Workday notification with a download link for the mappings file.
  3. Open the file and look up the staging table values in the mappings sheet causing errors.
    Any cells marked (INVALID) in the
    Planning Code
     or
    Planning Name
     columns indicate this code no longer exists in Workday Adaptive Planning.
  4. Correct the errors and click
    Upload Member Mappings
     to load the file. The
    Read Only
     column doesn't upload.
  5. Run the loader again.
Don't click
Clear Member Mappings
 unless instructed by your implementation partner or Workday Adaptive Planning Support.

Bedrijfsregels maken

U kunt
bedrijfsregels
 gebruiken om SQL-expressies te maken die beperken welke faseringsgegevens beschikbaar zijn voor laden. Alleen records die aan uw filtercriteria voldoen, worden geladen.
Een SQL-filter maken:
  1. Selecteer op het tabblad
    Bedrijfsregels
     de optie
    SQL-filter
    . Klik op
    Bewerken
    .
  2. Voer een SQL-expressie in. U kunt op een item in de lijst Beschikbare kolommen klikken om die kolom in de SQL-expressie te plaatsen in plaats van deze te typen.
  3. Klik op
    Toepassen
     om uw SQL-syntaxis te controleren. Fouten in uw syntaxis maken de rand rond de expressie rood. Plaats de muisaanwijzer op de SQL-editor om informatie over syntaxisfouten te bekijken.
    Voor gedetailleerde hulp bij SQL-syntaxis klikt u op
    online-Help
     in de sectie Opmerkingen van SQL-filter bewerken. U kunt ook naar de SQL-expressiereferentiegaan.
  4. Corrigeer eventuele fouten in uw syntaxis en klik op
    Toepassen
    . Alleen faseringsrijen die overeenkomen met de SQL-expressie worden geïmporteerd wanneer u de lader uitvoert.

Voorbeeld van lader-uitvoer weergeven

U kunt een voorbeeld van de uitvoer van de lader bekijken voordat u een volledige lading uitvoert om te controleren of de toewijzingen zijn zoals u ze nodig hebt. U kunt de uitvoer ook downloaden als een XML-bestand om de dimensiewaarden uit uw gegevensbron handmatig te verifiëren aan de hand van uw vereisten voordat u ze laadt.
  1. Klik op
    Voorbeeld lader-uitvoer weergeven
     in het deelvenster Acties.
  2. (Optioneel) Voer de instellingen voor het voorbeeld van de lader-uitvoer in. Welke gegevens u kunt invoeren, is afhankelijk van de gegevensbron die u voor deze planningsdimensielader hebt gekozen. Als u de instellingen hier wijzigt, worden nieuwe gegevens geïmporteerd in faseringstabellen en -kolommen.
  3. Klik op
    Voorbeeld lader-uitvoer weergeven
    .
De lader wordt uitgevoerd, waarbij alle transformaties en bedrijfsregels worden toegepast als onderdeel van de run. Een statuspop-upvenster toont de stappen die de lader heeft uitgevoerd. Als er dimensiewaarden moeten worden geladen, maakt de lader een XML-bestand en verzendt deze een e-mailmelding met de uitvoer van de lader als een gezipte XML-bijlage.
Met een extra pop-upvenster kunt u de voorbeelduitvoer van de lader downloaden als een gecomprimeerd XML-bestand nadat de lader is voltooid. Het kan even duren voordat het pop-upvenster voor downloaden verschijnt, afhankelijk van het aantal dimensiewaarden en de grootte van het bestand.
Validatiefouten corrigeren
Wanneer dimensiewaarden worden geladen, worden de brongegevens gevalideerd op de volgende fouten:
  • De bron-ID-waarde voor de dimensiewaarde ontbreekt (leeg) in de gegevens.
  • De gegevens bevatten dubbele bron-ID's. Bron-ID's moeten uniek zijn.
  • De naam van een dimensiewaarde ontbreekt (leeg) in de gegevens.
  • De gegevens bevatten dubbele namen van dimensiewaarden.
  • Een ParentId is gelijk aan de bron-ID in de gegevens. In dit geval verwijst de kolom naar zichzelf als de bovenliggende kolom.
  • Bij het importeren van een substructuur wordt de hoofdmap van de substructuur toegewezen aan een bestaand knooppunt in Planning. In dit geval komt de ParentId niet voor in de brongegevens voor een nieuw knooppunt dat is geïntroduceerd in Planning.
  • Een bestaand knooppunt is verplaatst onder een nieuw knooppunt en de markering Nieuw is uitgeschakeld. In dit geval wordt een bestaande dimensiewaarde verplaatst naar een nieuw knooppunt wanneer de lader expliciet de opdracht krijgt geen nieuwe dimensiewaarden te maken.
  • De gegevens hebben een cyclische verwijzing in de hiërarchie. In dit geval verwijst een ParentId naar het eigen onderliggende item als bovenliggend item.

De lader uitvoeren

Nadat een planningsdimensielader met alle vereiste configuratie-instellingen is opgeslagen, kan de lader handmatig of als geplande integratietaak worden uitgevoerd.
Wacht ongeveer 15 - 30 minuten tussen elke uitvoering van de planningsdimensielader, zodat de
Adaptive Planning
 tijd heeft om te synchroniseren met uw import. Het synchroniseren van grotere imports duurt langer. De wachttijd is afhankelijk van de modelgrootte en andere factoren.
U kunt rechtstreeks vanuit het bronsysteem importeren of u kunt de lader uitvoeren met behulp van faseringswaarden die al zijn geïmporteerd. Wanneer de lader wordt uitgevoerd, selecteert u welk gedrag u wilt. Kies
Gegevensimport overslaan
om de bestaande faseringstabel voor het laden te gebruiken. Gegevensimport overslaan is niet beschikbaar wanneer u spreadsheets als gegevensbronnen gebruikt.
Als onderdeel van het uitvoeringsproces controleert de lader of de gegevens in de faseringstabel correct zijn toegewezen. Tijdens het laden worden meerdere validaties toegepast. Eventuele fouten die tijdens het laden optreden, geven aan wat er voor een geslaagde import moet worden opgelost.
De planningsdimensielader opnemen in een integratietaak
Elke integratietaak kan een of meer laders bevatten. Een taak kan ook andere integratietaken bevatten, evenals Discovery Metric Loaders en scripted laders.
Best practice: zorg voor afzonderlijke integratietaken voor elke lader.
Als een taak meerdere laders bevat, worden parameters van elke lader weergegeven wanneer de taak wordt uitgevoerd. Als er een algemene/gedeelde parameter wordt gebruikt in de lader(s) binnen een taak, wordt er in de taak slechts één keer om de parameter gevraagd. U kunt ervoor kiezen om parameterprompts te overschrijven.
Voor geplande uitvoeringen van de taak worden de standaardwaarden gebruikt van de parameters die zijn opgeslagen toen de laders werden gemaakt.
Berichten en waarschuwingen oplossen
Zie . voor een uitleg van de berichten die tijdens het laden zijn vastgelegd Reference: Log Messages for Planning Dimension Loaders.

Wijzigingen in een brondimensiewaarde laden

De planningsdimensielader kan de naam van een dimensiewaarde bij het laden wijzigen als er al een toewijzing aan de brondimensiewaarde is gemaakt.
In deze tabel ziet u de toewijzingen die de lader al heeft gemaakt. De brondimensiewaarde VS wordt toegewezen aan de bron-ID-kolom 1001.
Planningsdimensiewaarde
Kolom bron-ID
Brondimensiewaarde
VS
1001
VS
Canada
1002
Canada
Als in het bronsysteem VS wordt gewijzigd in Verenigde Staten, kan de planningsdimensielader deze wijziging toepassen bij het laden, omdat de lader de toewijzing onderhoudt tussen de bron-ID-kolom 1001 en de interne ID van Planning voor de dimensiewaarde VS.
Planningsdimensiewaarde
Kolom bron-ID
Brondimensiewaarde
VS
1001
Verenigde Staten
Canada
1002
Canada
Als u de lader uitvoert, wordt de dimensiewaarde in Planning gewijzigd van VS in Verenigde Staten.