Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Periodic jobs functionality allows you to automate recurring tasks, such as invoicing or running macros.

You can add only optional periodic jobs.

  1. Go to the (blue star) Configuration menu → Integration → Periodic Jobs.
    💡 For details on managing periodic jobs, see the https://help.xtm.cloud/xtrf/home-portal/configuration-menu/en/periodic-jobs.html article.

    1 - Add a job.png
  2. Click the Add button on top of the Periodic Jobs table. You will be directed to the Add page.

    PJ2.png
  3. Select the periodic job’s Type

Type

:

Description

Client Invoicing

→ filters

Filters and selects the tasks that will be automatically added to new Client Invoices within the configured time frame. To learn more about this periodic job, see the

Automatic Client Invoicing article

Automate client invoicing guide.

Filter Subscription

→ pulls

Pulls data from a browsing view with any filter combination applied to it and sends the filtered data to the list of

email

e-mail subscribers.

Macro Subscription

→ runs

Runs a macro and sends the results to a specified Home Portal user.

Overdue Invoices Reminder

→ sends

Sends notifications to a specified Home Portal user and, optionally, to the invoice signatory and the PM responsible for the jobs related to the overdue invoices.

Report Subscription

→ pulls

Pulls data from reports and sends it to the list of

email

e-mail subscribers.

Time Control Synchronization Job

→ aggregates

Aggregates the work logs of selected groups for the selected time period and sends the summary to the recipients.

Vendor Invoicing


(info)

Filters and selects the jobs that will be automatically added to new Vendor Invoices within the configured time frame.

Info

The Text Message Delivery Check and WeLocalize Synchronization periodic jobs are deprecated.

  1. Provide a name for the new periodic job.

  2. Click the Save button. You will be directed to the Periodic Job page.

    PJ3.pngImage Modified
  3. In the Job Configuration section, select or

provide
  1. enter the

desired
  1. required settings.
    (blue star)This section’s content depends on the periodic job type.

Field name

Description

Data to be Sent

Scope of the periodic job.

View

By selecting a specific view, you can filter the data on which the periodic job will be executed.

The available options depend on the Data to be Sent field value.

Recipient

Subscribers

Home Portal users who will receive the results of the periodic job.

Reports and Subscribers

Select particular reports from the list and people to send them to.

Invoicing details:

  • Invoice Type.

  • Invoice Status.

  • Invoice Signatory.

  • Vendor Invoice Responsible.

  • Invoice Items Mode.

  • Payment Terms.

Periodic jobs related to invoicing allow the automatic creation of client or vendor invoices. You can pre-configure some of the invoice settings.

Macro

Select a macro that will be run automatically by a Macro Subscription type periodic job.

The available options depend on the Data to be Sent field value.

File Name Expression

You can use the following tags to generate unique file names for periodic job results exported to a .csv file:

  • currentDate.day.

  • currentDate.year.

  • currentDate.month.

  • currentDate.hour.

  • currentDate.minute.

  • view.name.

Example:

Expression for a periodic job with the selected view ‘Projects from last 30 days’:

${view.name} ${currentDate.year} ${currentDate.month} ${currentDate.day} ${currentDate.hour} ${currentDate.minute}.csv.

Result name:

‘Projects from last 30 days 2021 8 11 18 54.csv’.

XTRF Macro Executed as a Post-action

Select a macro that will be run automatically after this periodic job is executed.

  1. In the Execution Configuration section, decide when and how often the job has to be executed:

    Execution configuration.pngImage Modified
    1. With the radio button, select one of the options:

      • Daily

      • Days per Week

      • Days per Month

      • Advanced

    2. (For Daily and Days per Week options) From the Type drop-down list, select whether the job will be executed Once per day or Periodically.

    3. Use the fields below to specify the

desired
    1. required schedule.

    2. (For Advanced) Provide the appropriate Cron Expression.

  1. In the Periodic Job Statistics section, you can check

    Statistics.pngImage Modified
    1. The Number of Executions

    2. Last Execution Time

    3. Available logs for this job.

  2. Click the Save button to confirm the changes.