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 editorul n8n, implementează paginarea și încărcarea fișierelor acolo unde este necesar și sunt mai puțin susceptibile să se întrerupă atunci când schema GraphQL se 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ăspuns GraphQL. Î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țiunea GraphQL poate 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 cu query, mutation, or subscription, urmată de un nume de operare. abreviere anonimă, cum ar fi { viewer { id } } is rejected.
• 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 de GraphQL.
• Utilizați punctul final API care definește operațiunea. Majoritatea lucrărilor de produs și organizație aparțin consolei API.

Although the editor accepts a subscription document, nodul execută o singură solicitare HTTP şi nu menţine un abonament GraphQL de streaming. the platform Trigger for event-driven workflows.

Pagination

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

1. Request pageInfo { hasNextPage endCursor } cu înregistrările conexiunii.
2. Pass endCursor La următoarea cerere after variable.
3. Păstrați filtrele și comanda neschimbată.
4. Stop when hasNextPage is false.

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

Errors

GraphQL responses with a non-empty errors array eșuează elementul n8n chiar și atunci când serverul returnează HTTP 200. Check:

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

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