CLP - Transformasjon av styret – Support Center

I denne Connected Learning Path skal vi lage en kjede som illustrerer hvordan du kan bruke Handlebars Connector til å analysere data fra et HTTP-svar og lage variabler som kan brukes i hele kjeden.

Primært læringsmål	Styrets kommandofunksjoner
Sekundære læringsmål	Workiva Chains Connector
Forutsetninger	Konfigurer Handlebars Connector tilkobling. Konfigurer Workiva Chains Connector tilkobling.
Støttemal	CLP \| Styrets konfigurasjon

Trinn 1: Opprett en kjede

Legg til en ny Chain.
Gi kjedet et navn CLP | Håndtakskonfigurasjon.
Opprett en Chain-variabel. Skriv inn følgende verdier for variabelnavn og -verdi:
- Variabelnavn: cv-AllStations
- Variabelverdi: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/station_information.json
Redd kjeden.

Trinn 2: Hent JSON-data

Dette trinnet bruker HTTP Connector til å hente Citibike-relaterte data i JSON-format fra et sted på nettet.

Legg til en GET -kommando fra HTTP Connector til noden Start.

Konfigurer kommandoen ved hjelp av følgende verdier:

Navn	GET - Alle stasjoner
Brukernavn	<la stå tomt&gt
Passord	<la stå tomt&gt
CA-sertifikat	<la stå tomt&gt
Sertifikat	<la stå tomt&gt
Sertifikatets private nøkkel	<la stå tomt&gt
Vis svar	Kontrollert
URL	cv-AllStations Kjedevariabel
Forespørselsstreng	<la stå tomt&gt
Innholdstype	application/json
Svar	<la stå tomt&gt

Lagre kommandoen.

Trinn 3: Iterere gjennom JSON-dataene

Bruk kommandoen Handlebars - Render Text template til å iterere gjennom CitiBike-stasjonsdataene for å få et format som gir dataene for hver enkelt stasjon kombinert.

Legg til kommandoen Handlebars - Render Text Template på Chain-lerretet.
Koble kommandoen GET - All Stations til kommandoen Handlebars - Render Text Template.
Dobbeltklikk på kommandoen for å redigere den.
1. Gi kommandoen et navn: RTT - Parsing JSON Response.
2. Legg til en JSON Variabel og gi den navnet citibikeData.
3. For feltet Value bruker du variabelen Response fra kommandoen Get - All Stations.
4. Fyll ut malfeltet med følgende verdi:
```
{{#hver citibikeData.data.stasjoner}}  {{@index}} | {{navn}} | {{kapasitet}} {{/each}}
```
  Dette gjør det mulig for kommandoen å iterere gjennom JSON-svaret ved hjelp av en rotsti til data.stations for å oppgi tekstverdier fra hver nøkkel: ("name", "capacity"). I tillegg legges det til en -indeks -verdi for hver rad som behandles.
Lagre kommandoen.

Trinn 4: Templatisering av kjøretidsvariabler

Bruk kommandoen Handlebars - Render Text Template til å templatisere variabler. Dette gjør det mulig for kjeden å gjengi en tekstmal som gir kontekst for ulike komponenter i kjeden basert på kjøretiden.

Legg til kommandoen Handlebars - Render Text Template på Chain-lerretet.
Koble kommandoen GET - All Stations til kommandoen Handlebars - Render Text Template.
Dobbeltklikk på kommandoen for å redigere den med følgende verdier:
1. Gi kommandoen et navn: RTT - Templatizing Variables.
2. Legg til og fyll ut følgende informasjon for variabler seksjonen:
  Verdi feltene vil bli fylt ut fra Runtime rullegardinmenyen i den venstre variabelruten.
  - Variabel 1
    - Variabelnavn: Kjede-Env
    - Verdi: <Chain.Enviroment> (Runtime Variable)
  - Variabel 2
    - Variabelnavn: Chain-Exec-Time
    - Verdi: <Chain.ExecutionDateTime> (Runtime Variable)
  - Variabel 3
    - Variabelnavn: System-RunTime-Month
    - Verdi: <System.DateTime> (Runtime Variable)
      1. Klikk på kjøretidsvariabelen <System.DateTime> for å transformere variabelen.
      2. På Select Transformation, velg Parse Date/Time, og klikk på "+".
      3. I det første verdifeltet velger du "ISO Extended (Platform Standard)".
      4. I feltet Output date format skriver du inn "%m".
      5. I feltet Input date timezone velger du "UTC (Etc/UTC)".
      6. I feltet Tidssone for utdatadato velger du "UTC (Etc/UTC)".
      7. Klikk på Godta.
  - Variabel 4
    - Variabelnavn: System-RunTime-Year
    - Verdi: <System.DateTime> (Runtime Variable)
      1. Klikk på <System.DateTime> runtime-variabelen for å transformere variabelen
      2. I Select Transformation, velg Parse Date/Time, og klikk på "+".
      3. I det første verdifeltet velger du "ISO Extended (Platform Standard)".
      4. I feltet Output date format skriver du inn "%Y".
      5. I feltet Input date timezone velger du "UTC (Etc/UTC)".
      6. I feltet Tidssone for utdatadato velger du "UTC (Etc/UTC)".
      7. Klikk på Godta.
3. Fyll ut malfeltet med følgende verdier:
  - Kjedemiljø: {{Kjede-Env}}
  - Dato for kjedeutførelse: {{Chain-Exec-Time}}
  - System Runtime Month-year: {{System-RunTime-Month}}-{{System-RunTime-Year}}
Lagre kommandoen.

Trinn 5: Templatisering av arbeidsområdevariabler - Hent arbeidsområder

Bruk Handlebars - Render Text Template til å templatisere komponenter i et arbeidsområde. Dette gjør det mulig for kjeden å gjengi en tekstmal som gir kontekst fra ulike komponenter i arbeidsområdet som kjeden befinner seg i.

Legg til kommandoen Get Workspaces fra Workiva Chains-kontakten i Chain-lerretet.
Koble kommandoen GET - All Stations til kommandoen Get Workspaces.
Dobbeltklikk på kommandoen for å redigere den, og bekreft at tilkoblingen er riktig.
Lagre kommandoen.

Trinn 6: Templatisering av arbeidsområdevariabler - RTT - WorkspaceID

Legg til kommandoen Handlebars - Render Text Template på Chain-lerretet.
Koble kommandoen Get Workspaces til kommandoen Handlebars - Render Text Template.
Dobbeltklikk på kommandoen for å redigere den.
- Gi kommandoen et navn RTT - WorkspaceID.
- Skriv inn følgende verdi i feltet Template:
```
{{#each arbeidsområder}} {{#if (equal name "<(chain.workspace)>") }} {{id}}{{/if}}{{/each}}
```
Velg variabelen <Chain.Workspace> fra seksjonen for kjøretidsvariabler i venstre panel
I feltet JSON Variables skriver du inn følgende informasjon:
- Variabelnavn: workspaces
- Variabelverdi:: <Arbeidsområder>
Utvid variabelen Get Workspaces i variabelpanelet til venstre, og velg Workspaces.
Lagre kommandoen.

Trinn 7: Templatisering av arbeidsområdevariabler - Hent miljøer

Legg til kommandoen Get Environments fra Workiva Chains Connector i Chain-lerretet.
Koble kommandoen RTT - WorkspaceID til kommandoen Get Environments.
Dobbeltklikk på kommandoen for å redigere den, og skriv inn variabelen Rendered Text fra kommandoen RTT-WorkspaceID i feltet Workspace ID.
Lagre kommandoen.

Trinn 8: Templatisering av arbeidsområdevariabler - RTT - EnvironmentID

Legg til kommandoen Handlebars - Render Text Template på Chain-lerretet.
Koble kommandoen Get Environments til kommandoen Handlebars - Render Text Template.
Dobbeltklikk på denne kommandoen for å redigere den med følgende verdier:
1. Gi kommandoen et navn: RTT - EnvironmentID.
2. Skriv inn følgende verdi i feltet Template:
```
{{#each miljøer}} {{#if (equal name "<(chain.environment)>") }} {{id}}{{/if}}{{/each}}
```
  Variabelen <Chain.Environment> er en Runtime -variabel, og du finner den i venstre panel.
3. I feltet JSON-variabler skriver du inn følgende informasjon:
  - Variabelnavn: environments
  - Variabelverdi: <Omgivelser>
    Denne verdien finner du i det venstre variabelpanelet under kommandoen Get Environments.
4. Lagre kommandoen.
Trinn 9: Test øvelsen
1. Publiser the Chain.
2. Klikk på Execute, og velg deretter Run Chain.
3. Når kjeden er ferdig kjørt:
  Bekreft at alle nodene ble kjørt ved å klikke på den utførte RTT - Parsing JSON Response Command og kontrollere at de første linjene i utdataene ser ut som følger:
4. Klikk på den utførte kommandoen RTT - Templatizing Variables, og kontroller at den gjengitte teksten er korrekt i "Logs"-fanen.
  
  Merk: Disse verdiene endres avhengig av både miljøet kjeden kjøres i, og når den kjøres.
5. Klikk på noden RTT - Environment ID, og velg fanen Outputs.
6. Bekreft at en verdi er fylt ut for den gjengitte tekstvariabelen (igjen, dette resultatet vil variere avhengig av miljøet ditt).
Lær mer

Hvis du vil lære mer om datatransformasjon ved hjelp av kjeder, kan du gå til Connected Learning Paths - Transformation Introduction