Jobs
Use the Jobs tab to schedule background tasks such as log syncs, documentation refreshes, Python automations, and TM1 Git updates.
Jobs table
- Job name – descriptive label (click to edit).
- Status – Active jobs run on the defined schedule; Disabled jobs are paused. Use the toggle on each job to enable/disable.
- Last run / Last result – quick health check for the most recent execution.
- Context menu – run on demand, review history, or delete a job.
Creating a job
Select New job and choose the required job type. Every job shares a few common fields:
| Field | Description |
|---|---|
| Connection | TM1 server used for the job (not shown for Python/Git jobs that do not require TM1). |
| Job name | Auto-generated but editable; use meaningful names for notifications. |
| Scheduled toggle | Enable to run on a cadence; disable for manual execution only. |
| Email notifications | Comma-separated list of recipients. |
| Notification type | Choose Success + Error, Success only, Error only, or No notifications. |
| Include job details | Attach job metadata to notification emails. |
Scheduling options apply to every job:
| Field | Description |
|---|---|
| Schedule | Cron expression that defines when the job runs. Cron uses five fields (minute, hour, day of month, month, day of week). For example, 0 1 * * * runs daily at 1:00 AM, while 30 5 * * 1-5 runs at 5:30 AM on weekdays. |
| Schedule templates | Quick presets (Everyday 1 PM, Every weekday 5:30 AM, Every Saturday at noon, Every hour, Every 30 minutes) that auto-populate the Schedule field with the appropriate cron string. Select a preset or manually enter a custom cron expression to match your scheduling needs. |
Each job type adds extra fields. The log-focused jobs share the same inputs.
| Job type | Additional fields | Purpose |
|---|---|---|
| Documentation update | Connection (required) | Refreshes model documentation for the selected TM1 server. |
| Audit log update | Sync interval (hours), Retain logs (months), Connection (required) | Pulls TM1 audit logs into SPACE on the defined cadence. |
| Server log update | Sync interval (hours), Retain logs (months), Connection (required) | Pulls TM1 server logs into SPACE on the defined cadence. |
| Transaction log update | Sync interval (hours), Retain logs (months), Connection (required) | Pulls TM1 transaction logs into SPACE on the defined cadence. |
| Python script | Script file path, Arguments | Runs a stored Python script with optional parameters. |
| Git update | Git repository, Action (Pull, Push, etc.) | Automates sync tasks for repositories in the SPACE TM1 Git module. |
Configure the fields, test if necessary, then click Create. Jobs can be edited later to adjust schedules, notifications, or parameters.
Related guides
- Connections covers job credentials.
- Content covers cached documentation and logs.
- Python covers scripts.
- Git covers the SPACE TM1 Git module, separate from Python/JupyterLab Git integration.