Jobs
Jobs let you automate tasks in AppStudio. A job is a sequence of actions that runs either on a schedule or when triggered manually. Use jobs to move data between systems, generate files, transform content, or run any repeatable workflow.
When to use this
- You need to sync data between AppStudio and an external system on a regular basis
- You want to generate reports or files automatically
- You have a multi-step workflow that should run without manual intervention
- You need to transform or convert data (JSON, XML, Excel, PDF)
How it works
A job consists of one or more actions that execute in order. Each action performs a specific operation — like making an HTTP request, transforming data, or generating a file. When a job runs, it creates a job run that tracks the status and results of each action.
Jobs can run:
- Manually — you trigger the run from the job dashboard
- On a schedule — the job runs automatically at a configured interval
The Jobs dashboard
Navigate to Jobs from your subscription's main navigation. The dashboard shows:
- Latest — recently run or updated jobs
- Favorites — jobs you've starred for quick access
Click All to see every job in your subscription.
Viewing all jobs
The jobs list shows each job with:
| Column | Description |
|---|---|
| Name | The job's name |
| Latest run | When the job last ran, and whether it succeeded or failed |
| Next scheduled run | When the job is set to run next (if scheduled) |
| Running | Whether the job is currently executing |
You can switch between a row view and a tile view, and search jobs by name.
TIP
Star frequently used jobs to add them to your Favorites on the dashboard.
Creating a job
- Navigate to Jobs.
- Click Create Job.
- Enter a name for the job.
- Click Save.
You're taken to the job's dashboard where you can start adding actions.
Job actions
Actions are the building blocks of a job. Each action performs one operation, and actions run in sequence.
Available action types
| Action type | What it does |
|---|---|
| HTTP Request | Sends an HTTP request to an external API or service |
| JSON Transformation | Transforms JSON data using a mapping |
| JSON Conversion | Converts data to or from JSON format |
| XML Transformation | Transforms XML data using XSLT or similar |
| XML Conversion | Converts data to or from XML format |
| Merging | Combines multiple data sources into one |
| Artifact Management | Manages output files (artifacts) from the job |
| Job Run | Triggers another job as part of this job's workflow |
| Sleep | Pauses execution for a specified duration |
| Raise Error | Deliberately fails the job (useful for conditional error handling) |
| Excel Conversion | Converts data to or from Excel format |
| PDF Management | Generates or manipulates PDF files |
| QR Code Generation | Creates QR codes |
| AI Agent | Runs an AI-powered action |
| Javascript | Executes custom JavaScript code |
Adding an action
- Open a job and go to the Actions section.
- Click Add Action.
- Choose the action type.
- Configure the action's settings.
- Click Save.
Actions run in the order they appear. You can reorder them by dragging.
Running a job
- Open the job you want to run.
- Click Run.
- If the job accepts variables, fill them in.
- Confirm to start the run.
The job executes its actions in sequence. You can monitor progress in real time.
Job runs
Every time a job runs, it creates a job run record. Navigate to a job's Runs section to see the full history.
Each job run shows:
| Field | Description |
|---|---|
| Start date | When the run started |
| End date | When the run completed |
| Duration | How long the run took |
| Status | Successful, Failed, Running, or Scheduled |
| Artifacts | Any files generated during the run (downloadable) |
Click a job run to see the result of each individual action.
Subscribers
You can add subscribers to a job to notify people when it runs or fails. Navigate to the job's Subscribers section to manage who gets notified.
Job settings
Each job has a settings page where you can configure:
- Name — the display name of the job
- Schedule — set up automatic recurring runs
- Variables — define input variables that can be provided when running the job
Tips
TIP
Use the Job Run action type to chain jobs together. This lets you build complex workflows from smaller, reusable jobs.
TIP
Download artifacts from completed job runs to access generated files like reports, exports, or converted documents.
Common mistakes
WARNING
If a job fails, check the individual action results in the job run detail. The failing action will show error details that help you diagnose the problem.
WARNING
Scheduled jobs will continue running even if previous runs have failed. Monitor your job runs regularly to catch recurring failures early.