The JobBuilder interface is a single screen with two sections.
The top section is the Setup Area and contains:
- Menu bar
- Tool bar
- Job setup and edit interface
When the Toolbar is disabled, controls can be found under File and Edit in the menu bar.
The bottom section is the Job List and displays:
- The batch's list of jobs and their settings as well as the checkbox to enable or disable a job
Disabling/Enabling a job is the only edit that can be made in the job list.
**Terminology Check**
- Scenario: A saved DemandTools process
- Job: A single scenario or command
- Batch: One or more jobs saved together that may be scheduled
Setup Detail : Toolbar & File and Edit Controls
1. New Batch
- Creates a new batch after saving a batch
- Available in the menu bar under File
2. Open Batch
- Loads a previously saved batch
- Available in the menu bar under File
3. Save Batch
- Saves the batch as a .djb file
- Batches must be saved to be scheduled
- Will overwrite the .djb file every time it is selected
- Available in the menu bar under File
Save Batch As
- Available only in the menu bar under File
- Users can load a previously saved batch, make modifications and save as a new batch with a new name
- Helps avoid overwriting a batch with new settings
- Useful when batches are similar but the order of job execution is different, or one batch includes more jobs
4. Schedule Batch
- Opens the scheduling interface to create/delete a scheduled run for the batch
- Available in the menu bar under Edit (labeled Batch Scheduler)
Batch Scheduler
- Available only in the menu bar under Edit
- Opens the scheduling interface to create/delete a scheduled run for the batch
5. Execute Batch
- Executes the batch starting with the first job
- All subsequent enabled jobs will process in order
- Useful for kicking off multiple jobs with one click without scheduling
- Available in the menu bar under File
6. New Job
- Creates a new job/adds a job to the list
- Available in the menu bar under Edit
7. New Remark
- Click to add a color coded bar with custom text to the job list
- Useful as an organizing tool
- Users tend to use this feature to show jobs grouped by Instance (e.g. Production or Sandbox and module e.g. MassEffect Jobs)
- Available in the menu bar under Edit
8. Edit Scenario
- Only available with the Run DemandTools command
- Opens the scenario in DemandTools for editing
- If Auto Login is NOT enabled, you will need to login to view the scenario
- Useful to ensure the scenario used in the job is the one being modified
9. Start Job
- Starts the selected job(s) in the job list
- Use the keyboard shift or ctrl keys to select multiple jobs to start
- Available in the menu bar under Edit
10. Cut Job
- Cuts the selected job(s) from the job list
- Use the keyboard shift or ctrl keys to select multiple jobs to cut
- Available in the menu bar under Edit
11. Copy Job
- Copies the selected job(s) from the job list
- Use the keyboard shift or ctrl keys to select multiple jobs to copy
- Available in the menu bar under Edit
12. Paste Job
- Pastes copied or cut jobs into the job list
- Available in the menu bar under Edit
13. Delete Job
- Deletes the selected job(s) in the job list
- Use the keyboard shift or ctrl keys to select multiple jobs to delete
- Available in the menu bar under Edit
Delete All Jobs
- Available only in the menu bar under Edit
- Deletes all jobs in the job list
Job Setup
Filename
Specify the program .exe to launch
- The Filename dialog box and selection tool are disabled in the Run DemandTools command
- The DemandTools .exe is predefined in the Settings menu
Salesforce Instance
Specify the Salesforce org in which each job will be processed
- The setup of a registry file must be completed before the instance list can be populated
- Click HERE to learn more about registry files
Parameter
The DemandTools scenario file path and any additional file paths are entered here
- Using the
selection button, choose the DemandTools scenario xml file to run
- The selection button default location is configured in the Settings menu
- This is set for the default DemandTools directory; "...\Documents\DemandToolsData" OR, you can set the location of your choice
- If a job requires multiple parameters (e.g., an export via MassEffect), each parameter may be selected via the selection button OR you can manually enter the parameter(s)
- Each parameter must be surrounded by double quotes (see image)
Priority
- Applicable only to the Run command
- It is possible to change the priority of each job in other commands
- We strongly suggest all jobs run the default, Normal Priority, unless there is a specific reason or knowledge of setting job priorities
Run Mode
- Applicable only to the Run DemandTools and Run Commands
- Can be selected for each job
- Affects the visual performance of the application
Normal
- The application will open to the way it was when last closed down
Minimized
- The application will open and only show in the task bar
Maximized
- The application will open and show on the screen
Delay
- Allows for the specification of milliseconds that DemandTools/the job delays before being started
Wait until end
- Checked (default) - waits for the completion of the previous job before launching the next job in the job list.
- DemandTools will open and close for each job
- Unchecked - simultaneously executes jobs with this option unchecked
- Multiple DemandTools application windows will appear, one for each job.
Scenario/Working Directory
- Applicable only to the Run command
- Can be changed for each job by clicking the selection button
- For the Run DemandTools command this is configured in the Settings menu