Print Schedule

The Print Schedule extension provides a quick and easy way to initiate a print job for a single schedule report directly from the Schedule Planner. Managers with access to reporting must have the preselected report included in their report profile to use this functionality.

Note: This business process is an extension model that is developed outside the normal release schedule to meet specific customer needs. To request one of these models, you must submit a Salesforce Service Request to UKG. After the model is delivered to your tenant, you can edit it to meet your needs.

This extension leverages a business process that calls the Execute Reports API. Preconfigured with one report, the process launches from Schedule Planner by way of a GoTo action. Schedule Planner selections for employees, or location, and date range are automatically passed as report parameters. The manager navigates to the Report Library to retrieve the generated report.

Schedule report types that can be attached to the process include:

Employee based

  • This report type can be printed for individual or multiple employees, but not for locations or Hyperfinds.

  • Employee selection is performed using the employee checkbox. If a Hyperfind is chosen in Schedule Planner, it is ignored.

  • Example: Employee Schedule - Weekly report.

Location based

  • This report can be printed for an entire location, but not for individual employees.

  • Employee selection is always based on the manager's All Home Locations. If an employee or location is chosen in Schedule Planner, it is ignored.

  • If the report needs to be executed for a different location, the manager changes the location on the Business Process Library page.

  • Example: Location Schedule - Weekly report.

Use case

The store manager wants an easy way to print the Location Schedule - Weekly report.

  1. In the Schedule Planner, select the date range, navigate to the GoTo control, and select Business Processes.



  2. From the Business Process Library select Print Schedule.



  3. Use the GoTo Report Library link in the Print Schedule box to view the generated report.



Configure Print Schedule

  1. Configure access: Edit the manager's function access profile (FAP) to include the following:
    Note: See the Function Access Profiles topic.
    1. Select Main Menu > Administration > Application Setup > Access Profiles > Function Access Profiles.
    2. Select the manager's profile. Click Tap Edit.
    3. Click Tap Manager — Department Manager.
    4. Click Tap Reports.
    5. Run reports: In Access Scope, select Allowed so that managers can run reports.
    6. Click Tap Save.
  2. Configure report profile: Edit the manager's report profile to include the schedule report attached to the business process.
    Note: See the Data Access Profiles overview topic.
    1. Select Main Menu > Administration > Application Setup > Access Profiles > Data Access Profiles.
    2. Select the manager's profile. Click Tap Edit.
    3. Select the report that is attached to the business process.
    4. Click Tap Save.
      Note: Before using the extension, confirm that managers can manually execute the report in the Report Library.
  3. Configure workflow notification: To create a workflow notification:
    Note: See the Configure Notifications for Business Processes topic.
    1. Select Main Menu > Administration > Application Setup > Event/Notification > Workflow Notifications.
    2. Click Tap New.
    3. In the Select Notification Type box, select Generic notification and click tap OK.
    4. Give the notification a Name; for example, Print Schedule Status.
    5. (Optional) Add a description.
    6. Select the Recipient List will be supplied at runtime or Send to employee boxes, as appropriate.
    7. Enter the Subject line, as appropriate.
    8. Enter the Long Message, such as:

      Print Schedule Status:

      URL: <URL of Report Library Page for specific tenant>

    9. Complete the Control center fields. For example:
      FieldLabelValue
      1Report:<reportLabel>
      2Hyperfind & Locations:<dataSource>
      3Selected Time Period:<timeFrame>
      4Status:<executionStatus>
      5Message:<executionMessage>
    10. Click Tap Save.
  4. Migrate the business process model to the tenant: Migrate the Print Schedule Process model to the customer tenant using Setup Data Manager (SDM).
    1. Log in to the tenant to which you are migrating the process model.
    2. Go to Main Menu > Administration > Setup Data Manager.
    3. Select the Source tenant where the Process Model resides and select the template to copy. It is a .zip file.
    4. In the Source column, a message states: Source: Import from <filename>.zip.
    5. Click Tap Review and Publish. The Publish Summary panel appears.
    6. Review the Publish Summary panel. It lists the items that were extracted from the migration file. If you approve, click tap Publish with Comment or just Publish.
    7. Click Tap Go to Publish History at the bottom of the panel to view the status of the data transfer. The Publish History page contains a table that lists the items you have published. If there were errors during the transfer, the button under the Errors column for that row is black.
    8. To view details, click tap the appropriate row and click tap View Selected.
    9. On the History for publish run page, click tap Show all to view the setup data that you published, and the errors that occurred, if any, listed by item type and name.
  5. Configure the variables decision table:

    Edit the decision table: PrintSchedule_Variables

    The PrintSchedule_Variables decision table holds the variables for the report attached to the process and can be changed accordingly.

    Example: Attach the Location Schedule - Weekly report to the process.

    1. Go to Main Menu > Administration > Application Setup > Business Process Setup > Process Models. Select the Print Schedule process and click tap Edit. The process model enters edit mode.
    2. Select the Decision Tables section.
    3. Click Tap on decision table PrintSchedule_Variables.

      The decision table contains two columns — dt_input and dt_output.

    4. Click Tap Decision Table Editor to add or update the rows in the table.

      PrintSchedule Variables table

      [dt_input]

      [dt_output]

      1

      =="ReportName"

      "location_schedule_weekly"

      2

      =="ReportType"

      "location"

      3

      =="Message"

      "Report Started"

      4

      =="MessageInvalidReportType"

      "Incorrect report type provided".

      5

      ==MessageAPIFailure"

      "Please contact system administrator."

      6

      =="OutputFormat"

      "NULL"

      7

      =="ReportLibraryUrl"

      "<tenant specific URL of the Report library>"

    5. Click Tap Save and close.

    PrintSchedule_Variables decision table parameter information.

    PrintSchedule Variables parameter information

    Validation type

    Value type

    Description

    Default values

    1

    ReportName

    String

    Name of the report

    2

    ReportType

    String

    Employee or location

    3

    OutputFormat

    String

    Report format (PDF, XLSX, Interactive (Desktop), CSV).

    If set to NULL, report default output format is used.

    NULL

    4

    MessageAPIFailure

    String

    API failure message.

    Please contact system administrator.

    5

    Message

    String

    Report initiation message.

    Report initiated.

    6

    MessageInvalidReportType

    String

    Incorrect report type provided.

    Incorrect report type provided.

    7

    ReportLibraryUrl

    String

    Report Library Page URL of application.

    Go to Main Menu > Dataviews & Reports > Report Library.

    Copy the URL from Report Library Page.

    NULL

    Note:

    • The values used in the Decision Table are all case sensitive.

    • Deploy only the main process; do not deploy the subprocesses.

    • Do not open the subprocesses from main process; open them separately.

  6. Deploy Process Model:
    Note: Process models must be redeployed every time changes are made to an existing model. Re-deployment is not required for decision table changes.

    Follow these steps to deploy the process model. For detailed information, see the online help topic Deploy Business Process Models.

    1. From the Main Menu, go to Application Setup > Business Process Setup > Process Models.
    2. Select the process and click tap Deploy
    3. On the Business Process page, configure the required parameters and deployment dates.
    4. Select Validation from the Template Categories.
    5. Click Tap Save and then Return.

APIs

API details

APIs for the Print Schedule business process

API name

Section

Type

Resource path

Location

Description

Run Report by Name

Platform

POST

/v1/platform/reports/{reportName}/execute

Generate report API

To run report

Retrieve Published Reports

Platform

GET

/v1/platform/reports

Get Report Label

To fetch report label and default output format