---
id: object/page/682
type: object
title: Page 682 "Schedule a Report"
summary: Page 682 "Schedule a Report" in Base Application (System.Threading). 3 public procedures, 2 events. Present since at least BC23, still in BC30, changed in BC26-27.
tier: official
language: en
tags:
  - page
  - base application
versions:
  introduced: null
  last_changed: "27"
  deprecated: null
review:
  state: derived
  by: null
  at: null
  flags: []
generated:
  at: "2026-10-11T00:31:51.816Z"
  pipeline: 0.2.0
  prompts: {}
  input_hash: 6dc6a60142d284e9523ceee0941278d4096a31421ab5ebc161f0c8520ac5f60a
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Modules/System/JobQueue/ScheduleaReport.Page.al
    title: src/Layers/W1/BaseApp/Modules/System/JobQueue/ScheduleaReport.Page.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/ui-how-run-batch-jobs
    title: Run Batch Jobs and XMLports
    date: null
    commit: null
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/ui-how-run-batch-jobs
  objects: []
  features: []
  topics:
    - topic/business-central/get-started/get-productive-in-business-central/run-and-print-reports
  localizations: []
  videos: []
  posts: []
  guidelines: []
object_type: page
object_id: 682
name: Schedule a Report
namespace: System.Threading
app: Base Application
extends: null
first_version: "23"
last_version: "30"
present_in:
  - "23"
  - "24"
  - "25"
  - "26"
  - "27"
  - "28"
  - "29"
  - "30"
changed_in:
  - "26"
  - "27"
source_major: "29"
obsolete: null
countries: []
ms_search_form_ids:
  - docs/learn-smb-docs/business-central/ui-how-run-batch-jobs.md
counts:
  fields: 0
  procedures: 5
  events: 2
  subscribers: 0
  controls: 9
  actions: 0
relations:
  out: 1
  referenced_by: 0
  pages: 0
  extended_by: 1
  event_subscribers: 1
  calls: 2
  called_by: 0
  implements: 0
---

# Page 682 "Schedule a Report"

> Page 682 "Schedule a Report" in Base Application (System.Threading). 3 public procedures, 2 events. Present since at least BC23, still in BC30, changed in BC26-27.

Base Application · System.Threading · BC23-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Modules/System/JobQueue/ScheduleaReport.Page.al) · facts from BC29

## Properties

| Property | Value |
|---|---|
| Caption | Schedule a Report |
| SourceTable | Job Queue Entry |
| PageType | StandardDialog |

## Fields on this page

Layout controls in source order, grouped by the container they sit in. Shows: the table field a control is bound to (or its expression as written); ToolTip: the control's own, else the bound field's (marked).

| Group | Control | Shows | ToolTip |
|---|---|---|---|
| Content | Report ID | [Object ID to Run](../table/472.md#fields) | Specifies the ID of the object that is to be run for this job. You can select an ID that is of the object type that you have specified in the Object Type to Run field. |
|  | Report Name | [Object Caption to Run](../table/472.md#fields) | Specifies the name of the object that is selected in the Object ID to Run field. |
|  | Description | [Description](../table/472.md#fields) | Specifies a description of the job queue entry. You can edit and update the description on the job queue entry card. The description is also displayed in the Job Queue Entries window, but it cannot be updated there. |
|  | Report Request Page Options | [Report Request Page Options](../table/472.md#fields) | Specifies whether options on the report request page have been set for scheduled report job. If the check box is selected, then options have been set for the scheduled report. |
|  | Report Output Type | [Report Output Type](../table/472.md#fields) | Specifies the output of the scheduled report. |
|  | Printer Name | [Printer Name](../table/472.md#fields) | Specifies the printer to use to print the scheduled report. |
|  | Next Run Date Formula | [Next Run Date Formula](../table/472.md#fields) | Specifies the date formula that is used to calculate the next time the recurring job queue entry will run. |
|  | Earliest Start Date/Time | [Earliest Start Date/Time](../table/472.md#fields) | Specifies the earliest date and time when the job queue entry should be run. The format for the date and time must be month/day/year hour:minute, and then AM or PM. For example, 3/10/2021 12:00 AM. |
|  | Expiration Date/Time | [Expiration Date/Time](../table/472.md#fields) | Specifies the date and time when the job queue entry is to expire, after which the job queue entry will not be run. The format for the date and time must be month/day/year hour:minute, and then AM or PM. For example, 3/10/2021 12:00 AM. |

## Events published

- `OnGetReportDescription(var ReportDescription: Text[250]; RequestPageXml: Text; ReportId: Integer; var IsHandled: Boolean; var JobQueueEntry: Record "Job Queue Entry")` (integration)
  - subscribers: [Codeunit 583 "Acc. Sched. Report Caption"](../codeunit/583.md) OnGetReportDescription
- `OnOnQueryClosePageOnBeforeJobQueueEnqueue(var JobQueueEntryRec: Record "Job Queue Entry"; var JobQueueEntry: Record "Job Queue Entry")` (integration)

## Procedures

- `ScheduleAReport(ReportId: Integer; RequestPageXml: Text): Boolean`
- `Schedule(ReportId: Integer; RequestPageXml: Text): Boolean`
- `SetParameters(ReportId: Integer; RequestPageXml: Text)`

## Triggers

OnOpenPage, OnQueryClosePage

## Relations

- source table [Table 472 "Job Queue Entry"](../table/472.md)

## Extended by

- [Page extension 682 "Schedule a Report Ext"](../pageextension/682.md)

## Calls

From the extracted call graph of BC29 (graphify-al on the snapshot checkout): calls whose target is known from a declared type or an `Object::"Name"` argument. Interface dispatch and calls through events are not counted, so the list is not complete.

- [Codeunit 453 "Job Queue - Enqueue"](../codeunit/453.md) (1 call: `OnQueryClosePage → (object)`)
- [Codeunit 9657 "Report Management Helper"](../codeunit/9657.md) (1 call: `OnOpenPage → IsProcessingOnly`)

## Across versions

- Present in: BC23-30
- Changed (declaration) in: BC26-27

## Documented on Microsoft Learn

- [Run Batch Jobs and XMLports](https://learn.microsoft.com/dynamics365/business-central/ui-how-run-batch-jobs)

Source: AL metadata extracted from the code (names, ids, signatures, properties); no code bodies (D10).

## Ask your agent

Procedure bodies are not stored here (D10). The call sections above are our own, per object, from the BC29 call graph. For a procedure body or the calls of one procedure, ask bc-code-atlas (external, by Stefan Maron, MIT; default corpus w1-28), which the bc-observatory plugin connects: `bcatlas_resolve_node(object_type: "page", object_name: "Schedule a Report")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.