When you act on many records at once, such as exporting orders to CSV, importing products, pushing statements or deleting locations, Pipe17 runs the work in the background as a job. The Jobs page lists every job in your organization with its status and progress. From there you can download a job's file, rerun an export, or cancel a job that hasn't finished. You don't create jobs on this page; they're started by actions elsewhere in Pipe17, and Pipe17 emails you when a job finishes, so you can keep working while it runs.
Where to find Jobs
Go to Monitor > Jobs.
An admin sets these permissions on the Jobs row in Settings > Roles:
| To do this | You need |
|---|---|
| See the Jobs page | Jobs: List and Read |
| Rerun an export job | Jobs: Create |
| Cancel a job | Jobs: Update |
Actions that run as a job, such as an export or a push of all filtered records, also need Jobs Create, plus permission for the records involved. If you're missing a permission, its button is disabled, and hovering over it explains why.
What creates a job
Type is the kind of work. Entity is the records it works on.
| Type | What it does | Entities |
|---|---|---|
| Export | Builds a CSV of the records you filtered or selected. | Orders, shipping requests, fulfillments, products, inventory, purchase orders, transfer orders, arrivals, receipts, returns, exceptions, locations, data lists, users |
| Import | Reads a CSV you uploaded and creates or updates records. | Products, inventory, orders, purchase orders, transfer orders, data lists, users, store assignments |
| Update | Changes many records at once. | Orders, shipping requests, fulfillments, products, inventory, purchase orders, transfer orders, arrivals, receipts, returns, exceptions, shipping methods |
| Delete | Deletes many records at once, including when connection data is removed. | Orders, shipping requests, products, inventory, purchase orders, transfer orders, locations, shipping methods |
| Sync | Pushes records to their integration. | Orders, shipping requests, fulfillments, returns, statements |
| Automation | Runs automation rules on the selected records. | Orders, shipping requests |
| Report | Builds a report file. | Orders, open orders, out-of-stock SKUs on orders, purchase orders, replenishment |
| Prepare | Organization setup run by Pipe17 itself. You don't start it from a page. | Organizations |
When you select only a few records, many of these actions run right away instead of as a job. When you select all results of a filter, they run as a job.
Some entities use system names on this page: Purchases are purchase orders, Transfers are transfer orders, Shipments are shipping requests, and Lookup Objects are data lists. In the Entity column, a multi-word name can show with an underscore, such as Lookup_objects.
Job statuses
| Status | What it means |
|---|---|
| Submitted | Queued. It may be waiting for an earlier job to finish. |
| Processing | Running now. |
| Completed | Finished. For bulk actions, check the result file or email: individual records can still have failed or been skipped. |
| Failed | Stopped with an error. |
| Canceled | Stopped by a user before it finished. Changes the job already made are not undone. |
A completed Sync job means Pipe17 sent the records. Check the records themselves, or Exceptions, to confirm the destination accepted them.
Read the Jobs list
| Column | Shows |
|---|---|
| Job ID | The job's ID. Search matches this value. |
| Status | Submitted, Processing, Completed, Failed or Canceled. |
| Progress | A bar with the percentage done and, when the job reports it, how many records were processed out of the total (for example 106 / 106). |
| Duration | How long the job took, or a remaining-time estimate while it runs. |
| Entity | What the job worked on. |
| Type | Export, Import, Update, Delete, Sync, Automation, Report or Prepare. |
| Created By | The email of the user who started the job. This isn't necessarily who gets the email. |
| Created / Updated | When the job started and when it last changed, in your organization's time zone. |
| Actions | View JSON, plus Rerun Job and Download when they're available. |
| Content Type | The type of the job's file. Hidden by default. |
Job ID and Actions always show. To show, hide or reorder the other columns, use the grid icon to the right of the refresh button.
Progress and duration
- The progress bar is green for Completed and red for Failed. Canceled jobs have no bar.
- Duration is in hours and minutes, such as 1h 5m, measured from Created to Updated. Jobs that finish in under a minute show 0h 1m.
- For a Processing job, Duration shows an estimate such as Remaining ~0h 5m, based on progress so far. It stays blank until the job reports a total and has processed some records, and it can change as the job runs.
- Submitted and Canceled jobs have no Duration.
While any job on the current page is Submitted or Processing, the page refreshes itself every 30 seconds. Click the refresh icon to update it sooner.
Search and filter jobs
| Control | Use it to |
|---|---|
| Search | Find a job by its Job ID. |
| Status, Entity, Type | Show only jobs with the values you pick. |
| Advanced | Build conditions on job fields, such as created or updated dates. |
| Saved Filters | Save the current filters, or apply a saved set. |
If you can't find a job, clear any filters that don't apply and search by its Job ID.
Manage jobs
Download a job's file
Download appears in Actions when a job produced a file, such as an export CSV or a bulk action result file, and the file is still within your organization's download period. That period is counted from the job's Updated time and is set per organization; when it has passed, the button disappears.
To download a file:
- In Monitor > Jobs, find the job.
- In its Actions column, click Download. Scroll the table to the right if needed.
The message Your download will start shortly appears and the download starts.
The completion email also has a link to the file and the date that link expires.
Rerun an export
Rerun Job appears only on Export jobs. It starts a new job with the original export's filters and fields, so you get up-to-date data. The original job is not changed.
To rerun an export:
- In the Actions column of the export, click Rerun Job.
- In the Rerun job export <entity> dialog, enter the Email that should get the result. To notify more people, click Add email address.
- Click Submit.
The message Job in progress. You will be notified via email appears, and a new export job shows in the list. Only the addresses you entered in this dialog get the email, not the recipients of the original export.
Cancel a job
You can cancel only jobs that are Submitted or Processing.
To cancel a job:
- Select the job's checkbox. To cancel several, select only Submitted or Processing jobs.
- Click Cancel Job (Cancel Jobs when more than one is selected).
There's no confirmation step: the message Successfully updated jobs appears and the status changes to Canceled. The button is disabled if any selected job is Completed, Failed or Canceled.
View a job's details
Click View JSON to open the full job record, including its parameters, progress and, for a failed job, the error. The record is read-only (This JSON is immutable.). Use Copy to share it with support.
Job emails
When a job finishes, Pipe17 emails the addresses that were entered when the action was started (for a rerun, the addresses in the Rerun job dialog). Emails come from no-reply@pipe17.com.
- Completed with a file: a link to the file and the date it expires, the job type and entity, the filters used, who started the job, your organization name, and a link that opens Jobs filtered to this job.
- Failed: the error message, the Job ID, the job type and entity, who started the job, and a link to the job.
If no email address was entered, no email is sent. You can always check the job's status on the Jobs page.
Troubleshooting
-
A job stays in Submitted.
It's waiting for an earlier job to finish. Leave it, or cancel it while it's still Submitted. If it doesn't start for a long time, submit a support request with the Job ID.
-
A job stays in Processing, or Remaining doesn't change.
Large jobs can take a while; check that the Progress count and Updated time are moving. If nothing changes for a long time, open View JSON for an error and submit a support request with the Job ID. Don't start the same update or delete again while it runs.
-
A job Failed.
Read the error in the failure email or in View JSON, fix the cause (for example, a column the import didn't recognize), then start the action again. For an export, click Rerun Job.
-
There's no Download button.
The job didn't produce a file, or your organization's download period has passed. Use the file link in the completion email while it's valid, or rerun the export to get a new file.
-
Rerun Job or Cancel Job is disabled.
Rerun needs Jobs Create; Cancel needs Jobs Update. Cancel is also disabled if any selected job is Completed, Failed or Canceled.
-
I didn't get the email.
Check your spam folder for no-reply@pipe17.com, and check that your address was entered when the job started; Created By isn't always a recipient. Search the Jobs page by Job ID to see the result.
Need Help?
If you need additional assistance:
- Use Ask Pippen, our AI agent, located at the top of the platform page.
- Submit a support request with as much relevant detail as possible. Learn how to submit a request.
We're here to help you succeed with your operations.
Comments
0 comments