DokumentationWorkflowsApps og tjenester
GraphQL node
Sender en GraphQL-forespørgsel eller -mutation med variabler til et endpoint og returnerer `data` / `errors`. En tynd specialisering af HTTP-blokken. Se opsætning, input og output, testforløb og løsning af typiske fejl.
8 min. læsningOpdateret
Hvad noden gør
Sender en GraphQL-forespørgsel eller -mutation med variabler til et endpoint og returnerer `data` / `errors`. En tynd specialisering af HTTP-blokken.
Brug GraphQL som et klart afgrænset trin i et anymize-workflow.
- Behandler 1 input.
- Leverer 1 output til efterfølgende trin.
- Kører som et normalt trin i forløbet.
Opsæt noden
- 01Åbn et workflow, og tilføj GraphQL fra nodekataloget.
- 02Udfyld de påkrævede felter, og knyt værdier fra tidligere trin.
- 03Kør noden med et lille testsæt, og kontrollér outputtet.
- 04Forbind det vellykkede output, og aktivér først efter en samlet test.
Handlinger og tilstande
GraphQL har én klart afgrænset opgave. Indstillingerne vises, når du vælger noden.
Indstillinger
| Felt | Betydning | Område |
|---|---|---|
| Endpoint-URL | Indstil værdien i nodepanelet. | Standard |
| Forespørgsel / Mutation | Indstil værdien i nodepanelet. | Standard |
| Variabler (JSON) | Indstil værdien i nodepanelet. | Standard |
| Godkendelse | Valg: Ingen, Bearer-token, API-nøgle (header), Basic Auth | Standard |
| Adgangsdata fra workflow-secret | Vælg workflow-secret'et med token, API-nøgle eller Basic Auth-adgangskode. Klarteksten kommer aldrig ind i workflow-JSON'en. | Beskyttet |
| Navn på nøglefelt | Indstil værdien i nodepanelet. | Standard |
| Brugernavn | Indstil værdien i nodepanelet. | Standard |
| Headers | Indstil værdien i nodepanelet. | Standard |
| Kør én gang pr. element | Fra (standard): noden kører én gang for hele inputtet. Til: får den flere elementer (f.eks. fra „Del liste op“), kører den én gang PR. element, og {{ $json }} er så præcis dette element. Sådan arbejder du en filliste igennem post for post. | Standard |
| Hvis et element fejler | „Spring over“ skriver et `error`-felt for det fejlede element og fortsætter med resten i stedet for at miste hele kørslen på én ulæselig fil. | Standard |
| Pause mellem elementer (millisekunder) | Ventetid før hver kørsel undtagen den første. 1000 = 1 sekund pr. element. Nyttigt, hvis modparten ellers begrænser dig. Maksimalt 300000 (5 minutter). | Standard |
Input og output
| Input | Betydning | Type |
|---|---|---|
| Standard | Modtager hele resultatet fra det forrige trin. | JSON |
| Output | Betydning | Type |
|---|---|---|
| response | Indstil værdien i nodepanelet. | json |
| status | Indstil værdien i nodepanelet. | number |
| ok | Indstil værdien i nodepanelet. | boolean |
Noden kan behandle lister element for element. Fejlhåndtering og pause findes under avancerede indstillinger.
Eksempel og testkørsel
Eksempel på testkørsel: start med et lille og genkendeligt datasæt. Kontrollér outputtet, og brug kun felter, der faktisk findes.
Eksempel på testkørsel
{
"input": "value"
}Adgang og sikkerhed
Gennemgå hvilke data der kommer ind i trinnet, og hvad outputtet indeholder.
Gem nøgler og loginoplysninger i den beskyttede forbindelsesstyring. Indsæt dem aldrig i almindelige felter, testdata eller beskrivelser.
Løs typiske fejl
- Intet output: kontrollér den seneste kørsel og felterne fra den forrige node.
- Tom variabel: åbn outputtet fra det forrige trin, og brug et felt fra de faktiske testdata.
- Listen behandles kun én gang: aktivér kørsel pr. element.