Skip to main content
Documentatie
Documentatie
Adaptive Planning
Laatst bijgewerkt: 2023-06-23
Planning-koppelingslaadprogramma maken

Planning-koppelingslaadprogramma maken

Met de planningskoppelingslader kunt u metagegevens over gebruikersdimensie- en niveaukoppelingen uit het faseringsgebied toewijzen aan:
Adaptive Planning
. Met koppelingen worden niveaus en aangepaste dimensies gekoppeld aan gebruikers. Niveau-eigendom is een type gebruikerskoppeling waarmee gebruikers aan niveaus worden gekoppeld. In tegenstelling tot reguliere niveaukoppelingen zijn er bij niveau-eigendom ook andere rechten. Zie.
Nadat u een lader hebt gemaakt, kunt u deze handmatig uitvoeren of plannen voor uitvoering als onderdeel van een integratietaak. Zie Integratietaken maken.

Prerequisites

  • De planningskoppelingslader vereist faseringsgegevens van een import van een bestaande gegevensbron.
  • Vereiste machtigingen: Model, Integratiegebruiker, Gegevensontwerper

Basisstappen

  1. Gegevensbroninstellingen invoeren
  2. Kolomtoewijzing configureren
  3. Bedrijfsregels maken
  4. Voorbeeld van lader-uitvoer weergeven
  5. De lader uitvoeren of plannen

Navigatie

Compass.png From the nav menu, go to
Integration
Design Integrations

Gegevensbroninstellingen invoeren

Met de gegevensbroninstellingen kunt u de brontabel die u wilt gebruiken uit de faseringsgegevens voor integratie kiezen en selecteren welke koppelingen u wilt laden.
  1. Selecteer
    Nieuw laadprogramma maken
    in het deelvenster
    Laadprogramma's
     van de componentenbibliotheek.
  2. Selecteer
    Planning
    Koppelingslaadprogramma
    als type laadprogramma. Voer een naam in voor de lader.
  3. Klik op
    Maken
    .
  4. Voer de gegevens van de
    Algemene eigenschappen
     van de koppelingslader in op het
    Tabblad Gegevensbroninstellingen
    :
    • 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.
    • Toewijzingsprofiel
      : u kunt een koppeling naar een toewijzingsprofiel maken als onderdeel van het proces voor het maken van de lader. Selecteer het toewijzingsprofiel in de vervolgkeuzelijst. De toewijzingsprofielen in de lijst zijn de profielen waartoe u toegang hebt. Zie de sectie toewijzingsprofiel van het Planning-gegevenslaadprogramma. Dit toewijzingsprofiel en eventuele toewijzingen die zijn geladen als onderdeel van laders voor metagegevens, wijzen de planningsniveaus en dimensies toe. Zie Planningsgegevensladers maken. Voorbeeld: als de koppelingslader de niveaukolomwaarde 999999 heeft (of voor Workday een WID), bepaalt het toewijzingsprofiel naar welk planningsniveau dat verwijst.
    • Niveau of dimensie
      : selecteer een niveau voor eigendomsniveau of niveaukoppeling. Selecteer een dimensie om dimensiekoppelingen te laden.
    • Kenmerk:
       (optioneel) selecteer een Adaptive Planning-kenmerk voor het niveau of de dimensie. Hiermee kunt u koppelingen voor niveau- of dimensiekenmerken toewijzen en laden.
    • Modus
      : selecteer
      Bijwerken
       om koppelingen of eigendomstoewijzingen op een subset van niveaus te wijzigen. Hiermee wordt het niveau bijgewerkt, niet de gebruiker. Voor updates van het niveau zijn alle gebruikers vereist die aan dat niveau in de payload zijn gekoppeld. Selecteer
      Alles vervangen
       om alle gebruikers binnen de koppelingen die in de nettolading worden vermeld, te verwijderen en te vervangen.
      • Als u Adaptive Planning gebruikt met Workday Human Capital Management of Workday Financials, wordt
        Modus
         automatisch gevuld met
        Bijwerken
        .
      • Als u Adaptive Planning niet gebruikt met Workday Human Capital Management of Workday Financials, wordt
        Modus
         automatisch gevuld met
        Alles vervangen
        .
    • Doorgaan met waarschuwingen
      : schakel dit selectievakje in om de lader met waarschuwingen te blijven uitvoeren. Als u dit selectievakje uitgeschakeld laat, stopt de lader wanneer er een waarschuwing wordt weergegeven. Als u dit selectievakje inschakelt, slaat de lader niet-toegewezen dimensies of niveaus over en wordt er een waarschuwing in de logboeken gemaakt, terwijl de lader de verwerking kan voortzetten.
    • Logboekniveau:
       kies het type details dat u wilt vastleggen bij het uitvoeren van de lader.
      • Uit
        : geen fouten geregistreerd.
      • Fout
        : alleen ernstige fouten registreren.
      • Info
        : basisgegevens vastleggen, zoals wanneer de lader is bijgewerkt.
      • Uitgebreid
        : gedetailleerde informatie over alle fasen en acties. Wordt voornamelijk gebruikt voor foutopsporing of audits.

Kolomtoewijzing configureren

Met kolomtoewijzing kunt u kolommen uit de gegevensbron toewijzen aan de koppelingen die beschikbaar zijn in
Modellering > Modelbeheer > Niveaus
 of
Modellering > Modelbeheer > Dimensies
. U moet
Gebruiker-
 en
Planning-kolommen
 toewijzen.
Als u een Workday-klant bent die een Gebruikerssynchronisatie uitvoert in deze omgeving, moet de kolom Gebruiker worden toegewezen aan de bronkolom die WID's bevat. Als u Gebruikerssynchronisatie niet hebt uitgevoerd of geen Workday-klant bent, moet de gebruikerskolom worden toegewezen aan de bronkolom die gebruikersnamen of e-mailadressen bevat.
Als er meerdere
Planning-kolommen
 moeten worden toegewezen, gebruikt u het filter
Weergeven
om het volgende te selecteren:
  • Alle:
     toont alle gebruikers.
  • Vereist
    :
    toont alle vereiste Planning-kolommen, zoals Gebruiker en Niveau.
  • 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 het tabblad
    Kolomtoewijzing
    . Het tabblad Kolomtoewijzing bevat de volgende kolommen:
    • Status
      : 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. Verplichte Planning-kolommen worden aangegeven met vetgedrukte tekst en een asterisk.
    • 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.
Kolommen voor niveau-eigendom toewijzen
Als u alleen eigendom op niveau wilt laden, wijst u geen ID toe voor de koppelingscode voor het niveau in de
bronkolom
. Niveau-eigendom in
Beheer
 >
Koppelingen
 wordt verkregen door de koppelingscode leeg te laten.
Kolommen toewijzen voor niveau- en dimensiekoppeling
Als u niveau- en dimensiekoppelingen wilt laden, wijst u een ID, zoals
Ref-ID
, aan de koppelingscode toe in de
bronkolom.
U kunt niveau-eigendom en niveaukoppeling niet in één lader laden. Maak één lader voor niveau-eigendom en een afzonderlijke lader voor niveaukoppeling.
Toewijzingskolommen voor kenmerkkoppeling
Als u niveau- of dimensiekenmerken met koppelingen wilt laden, wijst u deze toe in de
bronkolom
. Kenmerken worden onder aan de toewijzingen weergegeven, onder Koppelingsnaam.
Toewijzing van kolommen ongedaan maken
U kunt de toewijzing van kolommen ongedaan maken om de faseringsgegevens te negeren die u niet wilt laden. U kunt de toewijzing van kolommen ook één voor één ongedaan maken nadat de lader is uitgevoerd om te achterhalen welke kolommen fouten in de logboeken genereren.
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 geselecteerde ongedaan maken
    : hiermee wordt alleen de toewijzing van de geselecteerde kolommen ongedaan gemaakt.
Als u de toewijzing van een kolom ongedaan maakt, wordt het statuspictogram gewijzigd in een uitroepteken IntegrationMappingUnmapped.png.

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.
Het tabblad
Bedrijfsregels
 bevat een tekstgebied voor het invoeren van SQL:
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. Zie Referentie: SQL-expressies.
  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 werken zoals u wilt. U kunt de uitvoer ook als een XML-bestand downloaden om de eigendomskoppelingen op gebruikersniveau handmatig te verifiëren aan de hand van uw vereisten voordat u ze laadt.
Klik op
Voorbeeld van uitvoer van lader
 in het deelvenster Acties.
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 gebruikerskoppelingswaarden 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 koppelingswaarden en de grootte van het bestand.
Validatiefouten corrigeren
Wanneer de uitvoer van de voorbeeldlader of het handmatig laden wordt uitgevoerd, worden de brongegevens op fouten gevalideerd. Voorbeelden van validaties bevatten controles in de volgende gevallen:
  • De bron-ID-waarde voor de gebruiker of niveau- en dimensiewaarde ontbreekt (is leeg) in de gegevens.
  • De bron-ID is niet toegewezen.

De lader uitvoeren

Nadat een Planning-koppelingslaadprogramma 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 planningskoppelingslader, 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 Planning-koppelingslaadprogramma 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.