CLP - Omvandling av styrstänger – Supportcenter

I denna Connected Learning Path kommer vi att skapa en kedja som illustrerar hur man utnyttjar Handlebars Connector för att analysera data från ett HTTP-svar och skapa mallar för variabler som kan användas i hela kedjan.

Primärt lärandemål	Styrstångens kommandofunktioner
Sekundära inlärningsmål	Workiva Anslutning för kedjor
Förkunskapskrav	Konfigurera Styrstång Connector anslutning. Konfigurera Workiva Chains Connector anslutning.
Mall för support	CLP \| Konfiguration av styrstänger

Steg 1: Skapa en kedja

Lägg till en ny Kedja.
Namnge kedjan CLP | Konfiguration av styrstång.
Skapa en Chain-variabel. Ange följande värden för variabelns namn och värde:
- Variabelns namn: cv-AllStations
- Variabelvärde: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/station_information.json
Rädda kedjan.

Steg 2: Hämta JSON-data

I det här steget används HTTP Connector för att hämta Citibike-relaterade data i JSON-format från en webbplats.

Lägg till ett GET -kommando från HTTP Connector till Start -noden.

Konfigurera kommandot med hjälp av följande värden:

Namn	GET - Alla stationer
Användarens namn	<leave>
Lösenord	<leave>
CA-certifikat	<leave>
Certifikat	<leave>
Certifikat Privat nyckel	<leave>
Visa svar	Markerad
URL	cv-AllStations Kedja Variabel
Frågesträng	<leave>
Typ av innehåll	applikation/json
Svar	<leave>

Spara kommandot.

Steg 3: Iterera genom JSON-data

Använd Handlebars - Render Text-mallen Command för att iterera genom CitiBike-stationsdata för att skapa ett format som ger varje enskild stationsdata kombinerad.

Lägg till Handlebars - Render Text Template Command till Chain canvas.
Anslut GET - Alla stationer Command till Handtag - Rendera textmall Command.
Dubbelklicka på kommandot för att redigera det.
1. Namnge kommandot: RTT - Parsning av JSON-svar.
2. Lägg till en JSON Variabel och namnge den citibikeData.
3. För fältet Value används variabeln Response från kommandot Get - All Stations .
4. Fyll i mallfältet med följande värde:
```
{{#varje citibikeData.data.stationer}}  {{@index}} | {{namn}} | {{kapacitet}} {{/each}}
```
  Detta gör det möjligt för kommandot att iterera genom JSON-svaret med hjälp av en rotsökväg på data.stations för att tillhandahålla textvärden från varje nyckel: ("name", "capacity"). Dessutom lägger den till ett index värde för varje rad som bearbetas.
Spara kommandot.

Steg 4: Templatisering av variabler för exekvering

Använd kommandot Handlebars - Render Text Template för att tematisera variabler. Detta gör det möjligt för kedjan att rendera en textmall som ger sammanhang för olika komponenter i kedjan baserat på dess körtid.

Lägg till Handlebars - Render Text Template Command till Chain canvas.
Anslut GET - Alla stationer Command till Handtag - Rendera textmall Command.
Dubbelklicka på kommandot för att redigera det med hjälp av följande värden:
1. Namnge kommandot: RTT - Templatisering av variabler.
2. Lägg till och fyll i följande information för variabler avsnitt:
  Fälten Värde kommer att fyllas i från rullgardinsmenyn Runtime i den vänstra variabelrutan.
  - Variabel 1
    - Variabelns namn: Kedja-Env
    - Värde: <Chain.Enviroment> (Runtime Variable)
  - Variabel 2
    - Variabelns namn: Tid för kedjeexekvering
    - Värde: <Chain.ExecutionDateTime> (Runtidsvariabel)
  - Variabel 3
    - Namn på variabel: System-drifttid-månad
    - Värde: <System.DateTime> (Variabel för exekvering)
      1. Klicka på runtime-variabeln <System.DateTime> för att transformera variabeln.
      2. På Välj Transformation, välj Parse Date/Time, och klicka på "+".
      3. I det första värdefältet väljer du "ISO Extended (Platform Standard)".
      4. I fältet Format för utdatadatum skriver du "%m".
      5. I fältet Tidszon för inmatningsdatumväljer du "UTC (Etc/UTC)".
      6. I fältet Tidszon för utdatadatumväljer du "UTC (Etc/UTC)".
      7. Klicka på Godkänn.
  - Variabel 4
    - Variabelns namn: System-RunTime-Year
    - Värde: <System.DateTime> (Runtime Variable)
      1. Klicka på exekveringsvariabeln <System.DateTime> för att omvandla variabeln
      2. I Select Transformation, välj Parse Date/Time, och klicka på "+".
      3. I det första värdefältet väljer du "ISO Extended (Platform Standard)".
      4. I fältet Output date formatskriver du in "%Y".
      5. I fältet Tidszon för inmatningsdatumväljer du "UTC (Etc/UTC)".
      6. I fältet Tidszon för utdatadatumväljer du "UTC (Etc/UTC)".
      7. Klicka på Godkänn.
3. Fyll i mallfältet med följande värden:
  - Kedjans miljö: {{Kedja-Env}}
  - Kedjans exekveringsdatum: {{Kedjans exekveringstid}}
  - System Runtime Månad-år: {{System-RunTime-Month}}-{{System-RunTime-Year}}
Spara kommandot.

Steg 5: Tematisering av variabler för arbetsytor - Hämta arbetsytor

Använd Handlebars - Render Text Template för att skapa mallar för komponenter i en arbetsyta. Detta gör att kedjan kan rendera en textmall som ger sammanhang från olika komponenter i den arbetsyta som kedjan befinner sig i.

Lägg till kommandot Get Workspaces från Workiva Chains-anslutningen i Chain-bilden.
Anslut kommandot GET - All Stations till kommandot Get Workspaces .
Dubbelklicka på kommandot för att redigera det och bekräfta att anslutningen är korrekt.
Spara kommandot.

Steg 6: Tematisering av variabler för arbetsytan - RTT - WorkspaceID

Lägg till Handlebars - Render Text Template Command till Chain canvas.
Anslut Get Workspaces Command till Handlebars - Render Text Template Command.
Dubbelklicka på kommandot för att redigera det.
- Namnge kommandot RTT - WorkspaceID.
- Skriv in följande värde i fältet Template :
```
{{#varje arbetsyta}} {{#if (lika med namn "<(kedja.arbetsyta)>") }} {{id}}{{/if}}{{/each}}
```
Välj variabeln <Chain.Workspace> från avsnittet om körtidsvariabler i den vänstra panelen
I fältet JSON Variables anger du följande information:
- Variabelns namn: workspaces
- Variabelvärde:: <Arbetsområden&gt
Expandera variabeln Get Workspaces i variabelpanelen till vänster och välj Workspaces.
Spara kommandot.

Steg 7: Tematisering av variabler på arbetsytan - Hämta miljöer

Lägg till kommandot Get Environments från Workiva Chains Connector i Canvas för kedjor.
Anslut kommandot RTT - WorkspaceID till kommandot Get Environments .
Dubbelklicka på kommandot för att redigera det och ange variabeln Rendered Text från kommandot RTT-WorkspaceID i fältet Workspace ID.
Spara kommandot.

Steg 8: Tematisering av variabler för arbetsytan - RTT - EnvironmentID

Lägg till Handlebars - Render Text Template Command till Chain canvas.
Anslut kommandot Get Environments till kommandot Handlebars - Render Text Template .
Dubbelklicka på det här kommandot för att redigera det med följande värden:
1. Namnge kommandot: RTT - EnvironmentID.
2. Skriv in följande värde i fältet Template :
```
{{#each miljöer}} {{#if (lika med namn "<(kedja.miljö)>") }} {{id}}{{/if}}{{/each}}
```
  Variabeln <Chain.Environment> är en Runtime variabel och finns i den vänstra panelen.
3. I fältet JSON-variabler anger du följande information:
  - Variabelns namn: miljöer
  - Variabelvärde: <Environments>
    Detta värde finns i den vänstra variabelpanelen under kommandot Get Environments .
4. Spara kommandot.
Steg 9: Testa övningen
1. Publicera kedjan.
2. Klicka på Execute, och välj sedan Run Chain.
3. När kedjan har körts färdigt:
  Bekräfta att alla noder har körts färdigt genom att klicka på den körda RTT - Parsing JSON Response Command och kontrollera att de första raderna i utdata ser ut som följer:
4. Klicka på det utförda kommandot RTT - Templatizing Variables och kontrollera att den återgivna texten är korrekt i fliken "Logs".
  
  Obs: Dessa värden kommer att ändras beroende på både den miljö som kedjan körs i och när den körs.
5. Klicka på noden RTT - Environment ID och välj fliken Outputs .
6. Bekräfta att ett värde har fyllts i för den renderade textvariabeln (återigen kommer detta resultat att variera beroende på din miljö).
Lär dig mer

Om du vill lära dig mer om datatransformation med hjälp av kedjor, kolla in Connected Learning Paths - Transformation Introduction