Skip to content
Contact us

The job dialog

The switch at the top right of the dialog, Show the job as, chooses between:

  • Wizard — fill in the job one step at a time, with Back and Next at the bottom. Save is there on every step: an unfinished job may be saved and completed later.
  • Form — every field on one page, for reading or changing a job quickly.

The choice is remembered for you. A step that has something to fix carries a mark, so a mistake two steps back is easy to find.

Advanced Settings

Advanced Settings, the switch at the top of every step but Run, shows: priority, scheduled date, recurrence and the retention schedule, the notifications, the date, size and file type filters, empty folders, the rules for adding and overwriting files, the metadata mapping, and the .url link option. They always apply — hiding them only keeps the form simple. A hidden value is never cleared and still applies when the job runs. Under the switch, a line names the advanced settings of the step on screen — in the Form, of every section — so you know what it hides there. An Import job's defaults steps say the same.

Only the steps that apply to the job are shown: a Discovery job has no destination, and a job without MetaVox has no metadata step.

StepWhat it holds
RunOnly while the job is Running or Canceling: what the run under way has reported so far. Once it has finished, Run History, beside Wizard and Form, opens the run.
JobDisable job beside the heading; Title, Job Group, Tags, Job Description, My note about this Job (saved with the job, also while it runs) and Job Status; in Advanced Settings also Notifications — Job start, Job finish, First warning and First error, all ticked on a new job — Priority, Scheduled Date, Recurrence and Retention schedule.
ActionThe Mode: Discovery, Test Migration or Migration, and in Advanced Settings, for a Test Migration or Migration from SharePoint Online or a file share into Nextcloud, Restore, which copies the files back to the source — a Test Migration only reports what it would change. See Restore: files back from Nextcloud to SharePoint Online or a file share
SourceSource Type and its address, Include Subfolders, the version history settings and, in Advanced Settings, the file filters, empty folders, metadata warnings and the .url link option.
DestinationDestination Type, the Team Folder or user, Destination Folder and, in Advanced Settings, the rules for adding and overwriting files. Only for Test Migration and Migration.
MetadataWhich SharePoint columns and views follow the files into MetaVox and, in Advanced Settings, the metadata mapping. Only with MetaVox installed, a SharePoint or OneDrive source and a Team Folder destination.
SMART MigrationWhile the job runs: the Task Name, the SessionLogId and the Windows process ID on the SMART Migration server.

An Import job has two more steps, Import from and Job defaults, and its Action, Source, Destination and Metadata steps are the defaults it gives the jobs it creates. See Import jobs

Read more: Notifications when a job runs

The fields of each step are described in:

Save stores the job and closes the dialog. The footer beside it says whether the job is Validated or Not validated — this job cannot run, and who last modified it.

Run History, beside Wizard and Form and under the Run section's heading, opens the job's runs on the Run History tab. With changes in the dialog that are not saved, it asks first: Save saves the job and then opens its runs, Don't save drops the changes, and Cancel stays in the dialog.

When the definition is incomplete, saving asks first: the job is saved with the status Hold, whatever the form shows, and once it validates you can set it to Ready. If Ready was picked, a warning says each time that the job is not validated and cannot be Ready. Copy link in the footer gives a link that goes straight to this job's row in the Jobs table.

While SMART Migration is working on a job — Running, or Canceling until the server confirms the stop — the dialog is read-only, in the wizard or the form as you chose. The Run step leads with what the run has reported so far, and the SMART Migration step names the process doing the work:

FieldWhat it is
Job IDThe job's own ID, which every Run History row it produces refers back to.
SMART Migration Task NameThe name of the task in the scheduler on the SMART Migration server that runs the job, such as Job Thread 1.
SMART Migration SessionLogIdFinds the session on the SMART Migration server's dashboard with Find job session criteria, for technical tracking and analysis. A session that ended successfully keeps no log on the server; its log is on the run's Log tab.
Job Process ID on SMART Migration ServerThe Windows process ID of the process running the job (FlowJob.Exe), as shown on the Details tab of Task Manager on the SMART Migration server.

A job you have open is held back from SMART Migration: the server does not start it while the dialog is open, and for at most two minutes after the browser went away without closing it. If the dialog was left too long and the job started, the dialog says so and shows the job as it runs.

The dialog's title line holds the job's name alone, so a long name stays on one line; its buttons sit on the line below, before Wizard and Form. Once the job has run, they offer Run History, which closes the dialog and opens the details of the job's latest run on the Run History tab, with the list filtered to the job's own runs, and Reports, which opens the job's folder in Nextcloud Files in a new tab. See Reports and run folders in Nextcloud Files

See also