Training Save Queries Scripts and Mappings

Training: Save Queries, Scripts, and Data Mappings

What you'll learn: how to save a reusable GraphQL query, a saved script (transform), and a data mapping. You need: Administrator or Developer access type in an application (UI label "Tenant"). Time: 10 minutes.

Saved Queries

A Saved Query stores a GraphQL query you can reuse (in documents, visualizations, or flows).

1. Go to Left menu → Schema & GraphQL → GraphQL API Explorer.

2. Type a query, e.g.:

   query TrainingParts { trainingPart(first: 10) { edges { node { id name serialNumber quantity active } } } }
   

3. Click the run button (▶) to verify — results appear in the Result pane.

4. Click File → Save, give it a Name (e.g. Training Parts Query) → save. It now lists under Schema & GraphQL → Saved Queries.

Tip: the editor auto-indents, so paste compact single-line queries to avoid stray-brace syntax errors.

Saved Scripts (Transforms)

A Saved Script is a reusable transform (JSONata/JS) — versioned and deployable.

1. Go to Left menu → Flows & Scripts → Saved Scripts → +.
2. Enter a Name (e.g. Training Transform), keep Active, accept the Number (0.0.1) → orange +.
3. Open it to edit the transform body in the editor; Save creates a version and Deploy makes it live.

Data Mappings

A Data Mapping defines a reusable field-to-field mapping (e.g. inbound integration payload → a Fuuz model) — versioned and deployable.

1. Go to Left menu → Flows & Scripts → Data Mappings → +.
2. Enter a Name (e.g. Training Mapping), pick a Module → orange +.
3. Open it to define the mapping, then Save and Deploy.

Check your work

Each item appears in its table: Saved Queries lists your query; Saved Scripts and Data Mappings show a version (0.0.1) and an Active flag. Saved Scripts and Data Mappings can be referenced from data flows.

Related training

Training: Explore the GraphQL API · Training: Create a Data Flow · Training: Use the Script Editor