|
Klassieke bestandstypen zijn vanaf januari 2021 niet meer beschikbaar voor gebruik. U kunt uw klassieke bestanden omzetten of een PDF downloaden. Meer informatie

Workiva-ondersteuningscentrum

CLP - Stuur Transformatie

CLP - Stuur Transformatie

  • Laatst bijgewerkt op

In dit Aangesloten Leerpad zullen we een Keten maken die illustreert hoe u de Handlebars Connector kunt gebruiken om gegevens uit een HTTP-respons te parsen en variabelen te templateren die in een Keten gebruikt kunnen worden.

Primair leerdoel Commandomogelijkheden stuur
Secundaire leerdoelen Workiva Kettingen Aansluiting
Vereisten Configureer Aansluiting stuur aansluiting.
Configureer Workiva Chains Connector verbinding.
Ondersteunende sjabloon CLP | Configuratie stuur

Stap 1: Maak een ketting

  1. Voeg een nieuwe Ketting toe.
  2. Geef de Chain CLP | Handlebars Configuration een naam.
  3. Maak een Chain-variabele. Voer de volgende waarden in voor de naam en waarde van de variabele:
    • Variabele Naam: cv-AllStations
    • Variabele Waarde: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/station_information.json
  4. Red de ketting.

Stap 2: JSON-gegevens ophalen

Deze stap gebruikt de HTTP Connector om Citibike-gerelateerde gegevens in JSON-formaat op te halen van een weblocatie.

  1. Voeg een opdracht GET van de HTTP Connector toe aan het knooppunt Start.

  2. Configureer de opdracht met de volgende waarden:

    Naam GET - Alle stations
    Gebruikersnaam <laat leeg&gt
    Wachtwoord <laat leeg&gt
    CA-certificaat <laat leeg&gt
    Certificaat <laat leeg&gt
    Certificaat Privé Sleutel <laat leeg&gt
    Antwoord tonen Gecontroleerd
    URL cv-AllStations Kettingvariabele
    Querystring <laat leeg&gt
    Type inhoud toepassing/json
    Reactie <laat leeg&gt
  3. Sla de opdracht op.
    image (79).png

Stap 3: Iterate door de JSON-gegevens

Gebruik de opdracht Handlebars - Render Text template om de CitiBike-stationgegevens te doorlopen en een indeling te maken die alle individuele stationsgegevens gecombineerd weergeeft.

  1. Voeg het commando Handlebars - Render Text Template toe aan het canvas Chain.
  2. Verbind de opdracht GET - All Stations met de opdracht Handlebars - Render Text Template.
  3. Dubbelklik op de opdracht om deze te bewerken.
    1. Geef het commando een naam: RTT - JSON-antwoord parsen.
    2. Voeg een JSON Variabele toe en geef deze de naam citibikeData.
    3. Gebruik voor het veld Value de variabele Response van de opdracht Get - All Stations.

    4. Vul het sjabloonveld met de volgende waarde in:

      {{#each citibikeData.data.stations}}  {{@index}} | {{naam}} | {{capaciteit}} {{/each}}

      Hierdoor kan de opdracht het JSON-antwoord doorlopen, waarbij een rootpad van data.stations wordt gebruikt om tekstwaarden van elke sleutel te leveren: ("naam", "capaciteit"). Bovendien zal het een index waarde toevoegen voor elke rij die verwerkt wordt.

  4. Sla de opdracht op.
    image (80).png

Stap 4: Runtime-variabelen templatiseren

Gebruik de opdracht Handlebars - Render Text Template om variabelen te templatiseren. Hierdoor kan de Chain een tekstsjabloon weergeven dat context geeft aan verschillende onderdelen van de Chain, gebaseerd op de runtime.

  1. Voeg het commando Handlebars - Render Text Template toe aan het Chain canvas.
  2. Verbind de opdracht GET - All Stations met de opdracht Handlebars - Render Text Template.
  3. Dubbelklik op de opdracht om deze te bewerken met de volgende waarden:
    1. Geef het commando een naam: RTT - Variabelen indelen.
    2. Voeg de volgende informatie toe en vul deze in voor de sectie variabelen:
      De velden Waarde worden ingevuld vanuit de Runtime vervolgkeuzelijst van het linkervariabelenpaneel.
      • Variabele 1
        • Variabele Naam: Keten-Env
        • Waarde: <Chain.Enviroment> (Runtime Variabele)
      • Variabele 2
        • Variabele Naam: Keten-Exec-Tijd
        • Waarde: <Chain.ExecutionDateTime> (Runtimevariabele)
      • Variabele 3
        • Variabele Naam: System-RunTime-Month
        • Waarde: <System.DateTime> (Runtimevariabele)
          1. Klik op de <System.DateTime> runtime variabele om de variabele te transformeren.
          2. Op selecteert u Transformatie, kiest u Datum/tijd parseren en klikt u op "+".
          3. Kies in het eerste waardeveld "ISO Extended (Platform Standard)".
          4. Voer in het veld Uitvoer datum formaat "%m" in.
          5. Kies in het veld Invoer datum tijdzone"UTC (Etc/UTC)".
          6. Kies in het veld Tijdzone uitgangsdatum"UTC (Etc/UTC)".
          7. Klik op accepteren .
      • Variabele 4
        • Variabele Naam: System-RunTime-Year
        • Waarde: <System.DateTime> (Runtimevariabele)
          1. Klik op de <System.DateTime> runtime variabele om de variabele te transformeren
          2. In Selecteer Transformatie, kies Datum/tijd parseren, en klik op de "+".
          3. Kies in het eerste waardeveld "ISO Extended (Platform Standard)".
          4. In het veld Uitvoer datum formaat, voert u "%Y" in.
          5. Kies in het veld Invoer datum tijdzone"UTC (Etc/UTC)".
          6. Kies in het veld Tijdzone uitgangsdatum"UTC (Etc/UTC)".
          7. Klik op accepteren .
    3. Vul het sjabloonveld met de volgende waarden in:
      • Ketenomgeving: {{Chain-Env}}
      • Datum uitvoering keten: {{Chain-Exec-Time}}
      • System Runtime Maand-jaar: {{System-RunTime-Month}}-{System-RunTime-Year}}
  4. Sla de opdracht op.
    2023-08-16_12-49-57.gif

Stap 5: Werkruimtevariabelen aanpassen - Werkruimten verkrijgen

Gebruik Handlebars - Render Text Template om onderdelen van een Workspace te templatiseren. Hierdoor kan de Chain een tekstsjabloon renderen dat context verschaft van verschillende componenten van de Workspace waarin de Chain zich bevindt.

  1. Voeg het Get Workspaces commando van de Workiva Chains connector toe aan het Chain canvas.
  2. Verbind de opdracht GET - All Stations met de opdracht Get Workspaces.
  3. Dubbelklik op de opdracht om deze te bewerken en bevestig dat de verbinding correct is.
  4. Sla de opdracht op.
    image (48).png

Stap 6: Werkruimtevariabelen templatiseren - RTT - WerkruimteID

  1. Voeg het commando Handlebars - Render Text Template toe aan het Chain canvas.
  2. Verbind de opdracht Get Workspaces met de opdracht Handlebars - Render Text Template.
  3. Dubbelklik op de opdracht om deze te bewerken.
    • Geef de opdracht de naam RTT - WorkspaceID.

    • Voer de volgende waarde in het veld Template in:

      {{#each workspaces}} {{#if (equal name "<(chain.workspace)>") }} {{id}}{{/if}}{{/each}}
  4. Selecteer de variabele <Chain.Workspace> in de sectie runtimevariabelen in het linkerpaneel
  5. Voer in het veld JSON Variables de volgende informatie in:
    • Variabele Naam: werkruimten
    • Variabele Waarde:: <Werkruimten&gt
  6. Vouw de variabele Get Workspaces uit in het variabelenpaneel aan de linkerkant en selecteer Workspaces.
  7. Sla de opdracht op.
    image (49).png

Stap 7: Werkruimtevariabelen aanpassen - Omgevingen ophalen

  1. Voeg het commando Get Environments van de Workiva Chains Connector toe aan het Chain canvas.
  2. Verbind de opdracht RTT - WorkspaceID met de opdracht Get Environments.
  3. Dubbelklik op de opdracht om deze te bewerken en voer de variabele Rendered Text van de opdracht RTT-WorkspaceID in het veld Workspace ID in.
  4. Sla de opdracht op.
    image (50).png

Stap 8: Werkruimtevariabelen templatiseren - RTT - EnvironmentID

  1. Voeg het commando Handlebars - Render Text Template toe aan het Chain canvas.
  2. Verbind de opdracht Get Environments met de opdracht Handlebars - Render Text Template.

  3. Dubbelklik op deze opdracht om deze te bewerken met de volgende waarden:

    1. Geef de opdracht een naam: RTT - EnvironmentID.

    2. Voer de volgende waarde in het veld Template in:

      {{#each environments}} {{#if (equal name "<(chain.environment)>") }} {{id}}{{/if}}{{/each}}

      De <Chain.Environment> is een Runtime variabele, en is te vinden in het linkerpaneel.

    3. Voer in het veld JSON variabelen de volgende informatie in:
      • Variabele Naam: omgevingen
      • Variabele Waarde: <Omgevingen>
        Deze waarde vindt u in het linker variabelenpaneel onder de opdracht Get Environments.
    4. Sla de opdracht op.
      image (51).png

    Stap 9: De oefening testen

    1. Publiceer de keten.
    2. Klik op Uitvoeren en selecteer vervolgens Keten uitvoeren.
    3. Zodra de uitvoering van de Chain voltooid is:
      Bevestig dat alle knooppunten met succes zijn uitgevoerd door op de uitgevoerde RTT - Parsing JSON Response Command te klikken en te controleren of de eerste paar regels van de uitvoer als volgt zijn:
      image (52).png

    4. Klik op de uitgevoerde opdracht RTT - Templatizing Variables en controleer of de weergegeven tekst correct is op het tabblad "Logs".
      image (53).png

      Opmerking: Deze waarden veranderen afhankelijk van de omgeving waarin de Chain wordt uitgevoerd en het moment waarop deze wordt uitgevoerd.
    5. Klik op het knooppunt RTT - Environment ID en selecteer het tabblad Outputs.
    6. Controleer of er een waarde is ingevuld voor de weergegeven tekstvariabele (ook dit resultaat is afhankelijk van uw Omgeving).
      2023-08-10_16-56-22.gif

    Meer leren

    Om meer te leren over datatransformatie met behulp van Chains, kunt u Connected Learning Paths - Inleiding Transformatie raadplegen

In dit Aangesloten Leerpad zullen we een Keten maken die illustreert hoe u de Handlebars Connector kunt gebruiken om ...