Run, schedule and monitor Writeback

Writeback tables run on Writeback workflows: a workflow groups the tables of one destination and starts them together, by hand or on a schedule. Use the Workflows view to reach a destination's workflows, run one, switch its schedule and follow its runs, without leaving Writeback.

Open the Workflows view

  1. Open WriteBack from the sidebar and click Workflows in the header. While Writeback is open, press Alt+4.
  2. To go straight to one destination, right-click it in the tree and choose Show Workflows.

The view has two lists on the left. Destination lists the destinations of Writeback; Workflows lists the workflows of the selected one. Drag the divider between the lists to change the split; the split is remembered.

Add a workflow

Adding a destination creates its first workflow for you: one named after the destination, with (Standard) after the name. Imported tables start on it. To add another:

  1. Select the destination under Destination.
  2. Click Add Workflow. It is disabled until a destination is selected. Its tooltip reads Select a destination first, or Create workflow for this destination once you pick one.
  3. The Register Workflow window opens with the destination already chosen. Fill it in and save, as described in Create and edit a workflow.

A destination can hold several workflows. Splitting its tables between them lets each group run on its own schedule. When you close the window, the Writeback tree and this list refresh.

Run a workflow now

Hover a workflow card to show its buttons.

  1. Click the play button (tooltip Run now).
  2. In the Run Workflow window, check the date and time, then click Start.
  3. Follow the run in the Runs view below, or in Job runs.

Run now appears only with Execute WriteBack Workflow Objects, and only when the workflow has at least one table. If the workflow cannot start yet, the button is disabled and pointing at it reads Can’t run yet and explains what is missing. See Run a workflow by hand.

Turn a schedule on or off

On the card, the power button turns the workflow's schedule on or off; its tooltip reads Turn schedule on or Turn schedule off. While the schedule is on, the card shows how often the workflow runs, such as Every day.

Warning

A schedule belongs to the whole workflow. Turning it off stops every table in that workflow from starting on its schedule. A table you run by hand still runs.

Read a workflow's runs

Select a workflow card and the right side shows its runs. The header above the runs names the destination and the selected workflow, and drops a (Standard) suffix from the workflow's name.

Move tables to another workflow

At the top of the left panel, switch the mode from Runs to Transfer to move tables between the workflows of one destination. Only fully mapped tables move, only within the same destination, and only into a workflow you may modify. The steps are on Transfer tables between workflows.

Permissions

ToYou need
Open the Workflows view, with the button or Alt+4View WriteBack Workflow Objects
Use Add WorkflowAdd WriteBack Workflows
Use Run nowExecute WriteBack Workflow Objects
Turn a schedule on or off, or edit a workflowModify WriteBack Workflows
Delete a workflowRemove WriteBack Workflows

Without Modify WriteBack Workflows, the pencil shows as View and the power button is disabled. Running a single table by hand uses Execute/Abort WriteBack Objects; see Synchronize a table and read the Sync Log.

Limits and edge cases

Questions, answered

Why is my destination missing from the Workflows view?

Only destinations with at least one imported table are listed. Import a table first, see Import destination tables. Until a destination qualifies, the view reads No destinations ready.

Can a destination have more than one workflow?

Yes. Select the destination and click Add Workflow. Splitting a destination's tables across workflows lets each group keep its own schedule, and you can move tables between the workflows later, see Transfer tables between workflows.

Why does my new workflow run on a schedule?

New workflows start with their schedule on. To stop it, click the power button on the card; to change when it runs, click Edit and open Schedule Settings. For what a schedule needs before it starts a run, see Schedules and when a workflow starts.

Can I turn the schedule off for one table only?

No. A schedule belongs to the whole workflow, so turning it off stops every table in that workflow from starting on its schedule. To give some tables different timing, create another workflow for the destination and move those tables to it, see Transfer tables between workflows. A table you run by hand runs whenever you ask, see Synchronize a table and read the Sync Log.

Is a Writeback workflow the same as the workflows on the Workflows screen?

Yes. It is an ordinary workflow of the Writeback type: it also appears on the Workflows screen, and its runs appear in Job runs. This view narrows the same workflows to one destination.

Does the Runs view show every run of the destination?

No. It shows the runs of the selected workflow only. Select another workflow to switch; to read the runs of all workflows together, open Job runs on the Workflows screen.

Why can't I run my workflow yet?

A Writeback workflow runs the tables assigned to it. A workflow with no tables has nothing to run, so no Run now button shows; put a table on it from the table's General step, see Configure a Writeback table. If its tables are not mapped yet, Run now is disabled; point at it to read Can’t run yet and the fix, then map a table on Map columns.

Does a run keep going when I leave the page?

Yes. Once a run starts, it continues whether or not the page is open, and a scheduled run needs no page open at all. Open the view later, or follow the run in Job runs.