CLP - Waarden van een controleblad gebruiken – Centrum wsparcia

Om waarden in een Control Sheet te gebruiken voor Chain workflows, moeten deze waarden systematisch gelezen en toegepast worden in Opdrachten. In dit Aangesloten Leerpad zullen we onderzoeken hoe u waarden van een Control Sheet kunt lezen en gebruiken en een Command Group kunt gebruiken om efficiënt door meerdere rijen te itereren.

Primaire zakelijke gebruikssituatie	Rapportageworkflows orkestreren vanaf een centrale locatie Workflowbeheer voor eindgebruikers vereenvoudigen
Primair leerdoel	Leer hoe u waarden uit een controleblad in een Ketting kunt gebruiken
Secundaire leerdoelen	Leer hoe u voorwaardelijke commando's, JSON Iterators en de Handlebars Connector kunt gebruiken
Vereisten	Voltooi de CLP \| Een controleblad maken en lezen Configureer de volgende Connectors: - JSON - Stuur
Ondersteunende sjabloon	CLP \| Waarden van een controleblad gebruiken

Stap 1: Bestaande ketting bewerken

Navigeer naar Chain Builder en zoek de Chain CLP | Lezen van een controleblad
Klik op de potloodknop om de ketting te bewerken
Klik op Keteninstellingen in de rechterbovenhoek
- Hernoem de ketting: CLP | Waarden van een controleblad gebruiken
Red de Ketting

Stap 2: Het controleblad omzetten naar JSON

Om de waarden in een controleblad effectief te gebruiken, zullen we de uitvoer van de opdracht Get Sheet Data converteren van CSV-formaat naar JSON. Deze conversie maakt sleutelwaardeparen tussen de kopteksten in het controleblad en de overeenkomstige waarden in de rijen onder elke koptekst, waardoor efficiënte iteratie mogelijk is.

Voeg een CSV to JSON opdracht van de JSON Connector toe aan het Chain canvas
Verbind de opdracht Haal bladgegevens met de opdracht CSV naar JSON
Dubbelklik op de opdracht om deze te configureren
- Geef het commando een naam: Control Sheet omzetten naar JSON
- Klik op het veld Input File
  - Klik in het paneel Een variabele selecteren op de pijl omlaag om Bladgegevens ophalen uit te vouwen
  - Selecteer de uitgang Data
- Laat het scheidingstekenveld staan als Komma (,)
- De opdracht opslaan

Stap 3: Een commandogroep toevoegen

Voeg een Command Group toe aan de Chain om iteratie over elke rij in het controleblad mogelijk te maken. Hierdoor kunnen we elke rij van het controleblad door de reeks opdrachten voor de groep duwen.

Voeg een Commandogroep toe aan het Chain canvas
Verbind de opdracht Controleblad omzetten naar JSON met het gedeelte In van de opdrachtgroep
Dubbelklik op de Commandogroep om deze te configureren
- Geef de groep een naam: Control Sheet Iterator
- Navigeer naar het tabblad Iterators
  - Schakel de optie Iteraties in en klik op het veld Iteraties
    - Klik in het paneel Select a Variable op de pijl omlaag om Convert Control Sheet to JSON uit te vouwen
    - Selecteer de JSON uitvoer
- De opdracht opslaan

Nu het commando geconfigureerd is, zal het elke rij van het controleblad doorlopen en voor elke regel een uitvoer geven.

Stap 4: Een voorwaardelijk commando toevoegen

Binnen een controleblad kunnen gebruikers bepalen of ze willen dat een bepaalde rij binnen een workflow wordt uitgevoerd. Dit wordt gebruikt via de kolom ActiveFlag. We zullen een Voorwaardelijk commando gebruiken om te bepalen of de workflow voor elke rij in het controleblad moet doorgaan.

Een Voorwaardelijk commando Chain Event toevoegen aan het Chain canvas
Verbind de groep Start binnen de Controleblad Iterator Groep met de Voorwaardelijke opdracht
Dubbelklik op de opdracht om deze te configureren
- Noem het commando: Actieve vlag?
- Laat de voorwaarde als EN en klik op de knop + REGEL
- Controleer nogmaals of het gegevenstype is ingesteld op String en wijzig de bewerking om te testen van Is Blank in =
- Klik in het open veld aan de linkerkant van de opdracht (de te testen waarde)
  - Klik in het paneel Select a Variable op de pijl omlaag om Group Iterator uit te vouwen
  - Selecteer <> JSON Bestandsinterval
  - Klik op de groene JSON File Iteration pil om de variabele te transformeren
    - Klik op Selecteer een transformatie en kies Haal waarde uit JSON
    - Druk op het groene + teken
    - Typ in het waardeveld de kop ActiveFlag precies zoals hij in het controleblad staat en druk op enter
    - Selecteer een andere transformatie en kies Kleine letters
    - Druk op het groene + teken
    - Klik op Accepteren

- Terug in de opdracht Conditioneel typt u aan de rechterkant (de te vergelijken waarde) het woord true
  - Zorg ervoor dat dit in kleine letters is, aangezien de variabele transformatie die eerder is toegepast de waarde van de actieve vlag volledig in kleine letters maakt.
De opdracht opslaan

Stap 5: Voer de uitgangen naar een opdracht

Op dit punt is de iterator van het controleblad ingesteld om waarden te geven aan elke opdracht die bestaat in het groepsbegin van de opdrachtgroep. We gebruiken een Handlebars-commando als plaatshouder om de opgehaalde waarden weer te geven, die ook iteratief kunnen worden gebruikt in latere commando's.

Voeg een Render Text Template opdracht van de Connector van het stuur toe aan het canvas Chain
De vlag Actief aansluiten? Commando naar het commando Tekstsjabloon weergeven
Dubbelklik op de opdracht om deze te configureren
- Geef de opdracht een naam: Besturingsbladwaarden vastleggen
- Typ in het veld Template de volgende informatie:
  - Bovenste rij: Informatie controleblad
  - Tweede rij: Bestandsnaam: <JSON Bestandsinterval&gt
    - Vervang de <JSON File Iteration> in het paneel Selecteer een variabele, klik op de pijl omlaag om Group Iterator uit te vouwen
    - Selecteer <> JSON Bestandsinterval

- - - Klik op de groene JSON File Iteration pil om de variabele te transformeren
      - Klik op Selecteer een transformatie en kies Haal waarde uit JSON
      - Druk op het groene + teken
      - Typ in het waardeveld FileName precies zoals het in het controleblad staat en druk op enter
      - Klik op Accepteren

- Herhaal de stappen voor de derde, vierde en vijfde rij
  - Vervang de plaatshouder <JSON File Iteration> door de variabele uit het controleblad.
    - Tabel ID: <JSON Bestandsinterval&gt
      - Volg dezelfde stappen als eerder, maar gebruik TableID in plaats van FileName.
    - Spreadsheet ID: <JSON Bestandsinterval&gt
      - Volg dezelfde stappen als eerder, maar gebruik SpreadsheetID in plaats van FileName.
    - Bestandslocatie: <JSON Bestandsinterval&gt
      - Volg dezelfde stappen als eerder, maar gebruik FileLocation in plaats van FileName.
De opdracht opslaan

Opmerking: Volg de beschreven stappen om een koptekst te extraheren en de bijbehorende rijwaarden uit een controleblad op te halen.

Stap 6: De oefening testen

Nu de Chain compleet is, kunt u het resultaat testen.

Publiceer de keten
Klik op Uitvoeren en selecteer vervolgens Keten uitvoeren
Zodra de ketting is voltooid, klikt u op de opdracht Capture Control Sheet Values om het succes te verifiëren
- Laat de ketting volledig doorlopen voordat u op de Command klikt
Er zal een veld zijn dat Waarde 1 aangeeft
- Als u op dit veld klikt, ziet u dat het Commando drie verschillende waarden heeft verwerkt; deze waarden zijn de drie rijen gegevens van het controleblad
Klik op het veld Log voor elke individuele waarde en controleer of deze overeenkomt met de waarden in het controleblad