> For the complete documentation index, see [llms.txt](https://learn.capstorm.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.capstorm.com/copystorm-director/reference/copystorm-director-gui/job-editor.md).

# Job Editor

The Job Editor tab is used to create a new job and corresponding tasks. The Job Editor table can also be used to view the history, status, and log data for each task.

## Step 1: Create a New Job

Before creating a new job, click on the “Clear Editor” button. The most important data to enter is:

* Job name — a unique, human-readable name for the job.
* Description — a detailed description of the purpose of the job.

The two check boxes control job behavior:

* If the “Active” box is not checked the tasks in the job will not be ran by CopyStorm/JobRunner.
* If the “Deleted” box is checked the job will be considered deleted but still kept in the CopyStorm/Director database.

After entering a name and description, the next step is to enter credentials for both the Salesforce instance and the CopyStorm database associated with the job.

![](https://4094748065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F762n2rpeqXwJ3ygR1d80%2Fuploads%2Fgit-blob-423b3cfdd5f0d00b9cc1db8decd28c03991da1d9%2F416d6abb-CredentialsEditor.png?alt=media)

## Step 2: Define Tasks and Schedules

A CopyStorm/Director job may have multiple tasks, each of which are scheduled to run at different times. In the following screenshot a single CopyStorm task has been created:

![](https://4094748065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F762n2rpeqXwJ3ygR1d80%2Fuploads%2Fgit-blob-a9c0587105a0ca62963b31e410f3a0ee3a1b06a4%2F4753a4e1-Director-Job-Edit-CopyStorm-1024x536.png?alt=media)

The “Log Retention” is an optional input that allows specification for the number of log files to kept for a specific task. If the input is left blank, all logs are kept.

The run schedule for a task is set using the Schedule Editor. Click on the “Actions…” button to launch this editor.

Parameters on the left of the dialog control when a task should run. For help on the format click on the [CRON](https://en.wikipedia.org/wiki/Cron) link in the help part of the dialog. As you enter scheduling constraints the system will display the computed schedule on the right-hand side of the dialog. Note that nothing is saved unless you click on the “Update Task” button.

![](https://4094748065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F762n2rpeqXwJ3ygR1d80%2Fuploads%2Fgit-blob-fd84fb70458ce9027897c3e70838fcbc2a99dc52%2F6a29fab1-ExampleSchedule-800x577.png?alt=media)

Adding a CopyStorm/Medic task follows the same procedure with one extra required parameter. The extra parameter is used to specify the CopyStorm/Medic tool to run.

![](https://4094748065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F762n2rpeqXwJ3ygR1d80%2Fuploads%2Fgit-blob-c9eed9ffa2f65eaff86e94b04593e809e2b6a64a%2F96c5abae-Director-Job-Edit-CopyStorm-Medic-1024x471.png?alt=media)

A variety of actions are available for a Task — to see the list of actions click on the “Actions…” button next to the task. Task actions include:

* “Show Schedule” shows a read-only version of the schedule for the next 10 runs of the job.
* “Edit Schedule” displays the Schedule Editor for the task.
* “Run CopyStorm GUI” launches the CopyStorm application using the configuration file associated with the task.
* “Start Task” starts the task as a background job. The background job will continue to run if the CopyStorm/Director application is closed.
* “Stop Running Task” stops the background process running this task. This option is disabled if the task is not running.
* “Delete Task” removes the task from the job.

## Step 3: Review Job History

The History tab displays the results of each task execution. The date range of tasks displayed can be changed using the “History From … thru” editor:

![](https://4094748065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F762n2rpeqXwJ3ygR1d80%2Fuploads%2Fgit-blob-b0af4feb1ae29c2c3a301516bf2acd2a9ee8465b%2Fb31f539a-job_history_director.png?alt=media)