BeyondERP.Newsletter
Menu

Setup page · System administration

Active periods for batch jobs

A setup page where you define time windows during which batch jobs are allowed to start.

Used by
Batch job manager, Scale unit administrator, Information technology manager
Business process
Administer system features
Menu item
BatchJobActivePeriod
Main table
BatchJobActivePeriod
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page where you define time windows during which batch jobs are allowed to start.
What you do hereUse this page to control when batch jobs run, for example only outside office hours.
ExampleFor example, an administrator can let batch jobs run every hour, but only between 6:00 PM and 8:00 AM.
Active periods for batch jobs page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

Business processAdminister system features
Menu pathSystem administration › Setup › Active periods for batch jobs
Set up firstFeature management (Daylight Saving Time support for batch job active periods) Microsoft Learn
Used next byBatch jobs Microsoft Learn
Related pagesBatch group Microsoft Learn
End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Step by step, with screenshots

Set up Active periods for batch jobs1 screen

Use this page to control when batch jobs run, for example only outside office hours.

  1. Screen 1

    Review the active periods for batch jobs

    Go to System administration > Setup > Active periods for batch jobs

    1. Review the name and the active from and active to times of each period
    2. Select New to add a period when batch jobs should only run at certain times
    Review the active periods for batch jobs (zoomed on the outlined fields)
    Show the full screenReview the active periods for batch jobs
    page title tab to open what to set or check

Steps from Microsoft

  1. Go to System administration > Setup > Active periods for batch jobs.
  2. Enter a name and the start and end of the active period.
  3. Select Save.
  4. Go to System administration > Inquiries > Batch jobs, select a job and select Edit.
  5. In the Active period field, select the active period, and then select Save.

Source: Microsoft Learn

Fields on the page

FieldWhat it means
TimezoneThe time zone the active period follows, including daylight saving time changes.Microsoft Learn

Common errors and fixes

MessageWhat to do
Times on existing active periods changed after DST support was turned onExisting periods are converted to UTC. Set the Timezone on each period; the jobs keep starting at the same times. Microsoft Learn

Test checklist

  1. Create an active period with a start and end time and a Timezone.
  2. On Batch jobs, edit a recurring job and select the period in Active period.
  3. Check that the job starts only inside the period.
  4. After a DST change in that time zone, check that the job still starts at the same local time.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Active periods for batch jobsSet Timezone on each active period to the time zone of the business that owns the jobs, for example 6:00 PM to 8:00 AM local time for out-of-hours jobsWith daylight saving time support, each active period follows the DST changes of its time zone, so jobs keep starting at the same local hour all year. Every period starts in UTC by default.Should active periods follow daylight saving time?Turning on daylight saving time support without warning users: existing periods are converted to UTC, so the times shown can change for users whose time zone isn't UTC, even though the jobs still start at the same times.Test: A job starts only inside its active period

Feature management and licence

Feature to turn onDaylight Saving Time support for batch job active periods (Optional)
Licence or add-inOn this system the page opens for Information technology manager, Scale unit administrator and Batch job manager. Batch job managers and IT administrators maintain active periods. Daylight saving time support is an optional feature that can't be turned off once on.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyShared: the same records are used by every legal entity. Microsoft data model
Can it be undoneOne-way: Warning: Turning on the Daylight Saving Time support for batch job active periods feature can't be undone. The periods themselves can be edited at any time. Microsoft Learn
If you change it laterOnce daylight saving time support for active periods is turned on, it can't be turned off, and existing periods are shown in the UTC time zone. Microsoft Learn
Technical architect

6Technical

Menu itemBatchJobActivePeriod Checked in Dynamics 365
FormBatchJobActivePeriod Checked in Dynamics 365
TableBatchJobActivePeriodShown as “Active periods for batch jobs” in Record infoChecked in Dynamics 365
Who can open itPrivilegesMaintain batch jobs BatchJobMaintainView batch jobs BatchJobViewDutiesMaintain batch jobs BatchJobMaintainMaintain the runtime of scale units. ScaleUnitRuntimeMaintainMaintain system settings SysServerSettingsMaintain
3 security rolesBatch job manager BatchJobManagerScale unit administrator ScaleUnitRuntimeAdminInformation technology manager SysServerITManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itInformation technology manager SysServerITManagerScale unit administrator ScaleUnitRuntimeAdminBatch job manager BatchJobManagerGive people one of these roles. On this system, 3 roles can open this page.Checked in Dynamics 365
Actions on the pageOptions: Personalize, Page options, ShareChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=BatchJobActivePeriod
Data migrationLoad order: Active periods for batch jobs has no data entity in Data management, so it can't be loaded from a file or a configuration template. Create the periods by hand in each environment, then select them on the batch jobs.Checked in Dynamics 365
Table definitionBatchJobActivePeriod columns and relations Microsoft data model
Everyone

8Sources