Synchronize a table and read the Sync Log

The Settings tab of a Writeback table holds its Sync Log, the record of every run of that table. Use it to start a run by hand and to see what each run wrote, and why a run failed or was skipped.

Run a table by hand

  1. Open WriteBack from the sidebar.
  2. Open the table from the tree: double-click it, or select it and press Enter.
  3. Click Settings.
  4. In the Sync Log header, click Synchronize.
  5. In Synchronize Table, choose the date and time of the run. The picker starts at the current date and time.
  6. Click Synchronize. The button reads Syncing... while the request is sent.

When the request goes through, the window closes and Synchronization started appears. The new run joins the log, and the success confirmation appears only once its entry is visible there.

The date you choose is recorded as the run's Snap Date. To run the table on a schedule instead, see Run, schedule and monitor Writeback.

Starting a run needs Execute/Abort WriteBack Objects. See Writeback permissions for the full list.

Read the Sync Log

The log shows one row per run of this table.

ColumnWhat it shows
Log IDThe identifier of the run.
Snap DateThe date and time the run was recorded for.
StatusThe state of the run. See the statuses below.
NoteExtra detail, such as why a run was skipped.
Start and FinishWhen the run started and ended.
Processed RowsHow many rows the run sent.
Client AddrThe address the run was started from.
ErrorThe text of a failed run.

You can search and filter the log, show or hide columns, and set the page size to 20, 50, 100 or 500 rows; the default is 50 rows a page. An (Empty) filter choice matches blank values. Refresh data reloads the log, and the export downloads it as a file named etl_log_ plus the table's identifier.

While a run is still active, a Syncing badge shows next to the Sync Log heading and the log refreshes by itself every 7 seconds, so Status, Processed Rows and Error stay current. When the run ends, the badge clears.

Until the table has run, the log reads No synchronization logs found.

What the statuses mean

StatusMeaning
PendingThe run is queued and has not started.
RunningThe run is in progress.
FinishedThe run completed.
SkippedThe run sent no rows; the Note column gives the reason.
ErrorThe run failed; read the Error column.
AbortedThe run was stopped before it finished.

Why a run is skipped

The Note of a skipped run starts with Skip Reason:, followed by one or more reasons:

Questions, answered

Why can't I synchronize a table?

The Synchronize button is off while a run of the table is already active. The request is refused when the table is not deployed, while the table's workflow is running, and when the workflow is scheduled to start within the next hour. Wait for the run to finish, save the column mapping, or use the scheduled run.

What does the date in Synchronize Table change?

It is recorded as the run's Snap Date in the log. A run you start by hand ignores the table's synchronize option; a run started by the workflow follows it.

How do I know the run has started?

Synchronization started appears, and the new row joins the log. The log keeps you posted while the run works.

Why does the Sync Log refresh by itself?

While a run is still active, the log refreshes every 7 seconds so the Status, Processed Rows and Error columns stay current. Refresh data reloads the log at any time.

Where do I see how many rows a run sent?

In the Processed Rows column. A skipped run sends no rows; its Note says why.

Why was a run skipped?

Read the Note: it starts with Skip Reason: and lists Synchronize Option Is Disabled, Table Is Not Deployed or Node Already Run. For the first two, map at least one column on Map columns and click Apply. For Node Already Run, start a new run.

Are workflow runs in the Sync Log too?

Yes. Every run of the table is in the log, whether the workflow started it or you did. A workflow run follows the table's synchronize option.

Why did my run fail to start?

When a run cannot be started, you see Failed to synchronize. Please try again. in the Synchronize Table window, or a Failed to synchronize table notice. Click Synchronize again. If it keeps failing, see Writeback troubleshooting.

How do I export the Sync Log?

Use the export on the log toolbar. The file is named etl_log_ plus the table's identifier.