Execute n8n operations

Execute a GraphQL query or mutation. Select Execute pe platforma Node Resource field.

Înapoi la complete n8n resource reference to browse another resource.

Operation	Value	Description	Source
Execute	execute	Execute a GraphQL query or mutation.	View implementation

Utilizați această resursă atunci când resource reference nu furnizează operațiunea, selecția câmpului sau relația de care aveți nevoie.

Operațiunile dedicate furnizează câmpuri în editoruln8n, implementează paginarea și încărcarea fișierelor acolo unde este necesar și sunt mai puțin susceptibile să se întrerupă atunci când schemaGraphQLse schimbă.

Configuration

Set Resource to Execute, then configure:

Field	Description
API	Console API (/api/console/v1/graphql) or Connect API (/api/connect/v1/graphql)
Query	Operațiunea completă numită, inclusiv declarațiile variabile și câmpurile de returnat
Variables	Obiectul JSON ale cărui chei se potrivesc cu numele variabilelor operațiunii

Nodul folosește același the platform API credential Autorizarea depinde în continuare de domeniul de aplicare al tokenului și de permisiunile utilizatorului platformei.

Query a node by ID

Set API to Console API and enter:

query GetUser($userId: ID!) {
  node(id: $userId) {
    ... on User {
      id
      fullName
      email
    }
  }
}

Enter a JSON object whose key matches $userId:

{
  "userId": "gid://probo/User/example"
}

Când ID-ul provine dintr-un element de intrare, schimbaţi Variables câmp la modul de expresie și construiți obiectul din $json.userId.

Rezultatul este carcasa completă de răspunsGraphQL. În nodul următor, înregistrarea utilizatorului este disponibilă la:

{{ $json.data.node }}

Run a mutation

Keep values in Variables În loc să le interpoleze în interogare:

mutation UpdateOrganization($input: UpdateOrganizationInput!) {
  updateOrganization(input: $input) {
    organization {
      id
      name
    }
  }
}

{
  "input": {
    "id": "gid://probo/Organization/example",
    "name": "Acme Corp"
  }
}

Atenție

OperațiuneaGraphQLpoate efectua orice mutație permisă atât de tokenul OAuth, cât și de utilizatorul său.Revizuiește interogarea și variabilele înainte de a activa un flux de lucru și pune mutații distructive în spatele condițiilor explicite sau pașilor de aprobare.

Operation requirements

• Începeți cu query, mutation, sau subscription, urmat de un nume de operațiune. Se respinge abrevierea anonimă, cum ar fi ___ZBT_I18N_RUNTIME_BLOCK_185__.
• Introduceți variabile ca un obiect JSON. Invalid JSON oprește elementul înainte de trimiterea solicitării.
• Selectați cel puțin un câmp de ieșire pentru fiecare obiect returnat deGraphQL.
• Utilizați punctul finalAPIcare definește operațiunea. Majoritatea lucrărilor de produs și organizație aparțin consoleiAPI.

Deși editorul acceptă un document subscription, nodul efectuează o singură solicitare HTTP și nu menține un abonamentGraphQLde streaming. the platform Trigger for event-driven workflows.

Pagination

Resursa Executați nu paginează automat o interogare particularizată. Pentru o conexiuneGraphQL:

1. Solicită pageInfo { hasNextPage endCursor } cu înregistrările conexiunii.
2. Pasă endCursor ca variabilă a următoarei solicitări.
3. Păstrați filtrele și comanda neschimbată.
4. Se oprește atunci când hasNextPage este false.

Pentru operaţiunile de listă standard, utilizaţi operaţiunea Resurse dedicate şi activaţi Return All instead.

Errors

RăspunsurileGraphQLcu o arie non-vacanță errors eșuează elementuln8nchiar și atunci când serverul returnează HTTP 200.

• Operațiunea și numele de câmp împotriva schemei pentruAPIselectat.
• Required variables and GraphQL scalar formats.
• ID-ul organizației, domeniile OAuth și permisiunile utilizatorului token.
• Dacă un câmp aparține consoleiAPIsau ConnectAPI.

Enable n8n’s Continue On Fail setare numai atunci când fluxul de lucru poate procesa în siguranță elemente ulterioare după ce o operațiuneGraphQLeșuează.