Mass Maintenance

Troubleshooting

This topic contains the following sections:

Download Data as a Finish Process

As part of the Finish process,Mass Maintenance can be configured to download the data posted by a Mass Maintenance request to tables in a database (often dgSAP). The data should download when a user clicks Finish for the Post role on the Request (Roles) page.

If the data is not being downloaded, use the Request Role (Finish Download) page to run the process manually to assist while troubleshooting.

To run the process manually:

  1. Select Troubleshooting > Request Role (Finish Download) on the Navigation pane.

  2. Click Finish Download for a request; a confirmation message displays.

    NOTE: The value in the REQUEST ID field on the Request page identifies the request.

  3. Click Ok.

The data should download to the designated tables.

Refer to Register Tables for Download as a Finish Process for more information.

Troubleshoot Data Download Using a Data Services Job

A Role Processor can troubleshoot issues related to the data download during the Final Finish process using a Data Services job.

Refer to Register Tables for Download through Data Services for general information.

To troubleshoot Data Services jobs, select Mass Maintenance > Troubleshooting > Data Services Job Executor in the Navigation pane.

On the Data Services Job Executor page, a user can:

  • Click the Execution Logs icon for a job name and request ID to view the job status.
  • Click the Execute icon to run the job again.
  • Click the Global Variables icon to enter Global Variables, name/value pairs that can be passed into the execution job, similarly to how variables are passed into a function. For example, if a job must download data for a specific company code, configure the Data Services job to take in a global variable called "$CompanyCode" with a company code value. Only data pertaining to that company code’s value is passed in to the job and only data for that company code is downloaded during the final finish process.

Troubleshoot Issues with External Roles

Mass Maintenance generates a spreadsheet with request data and sends it to a user designated as an external contact for an External Data role. The user updates the spreadsheet and mails it to an external data email account configured in Mass Maintenance.

To troubleshoot issues with sending data to and receiving data from an External Data role, use the Roles (Execute) page.

To troubleshoot issues with sending spreadsheets to External Data roles:

  1. Select Troubleshooting > Roles (Execute) on the Navigation pane.

    NOTE: Only ROLE IDs from External Data role types display.

    NOTE: The value in the REQUEST ID field on the Request page identifies the request.

  2. Click the Process External Role icon for a request.

NOTE: Mass Maintenance generates a spreadsheet and sends it to the user designated as the external contact for the External Data role. The user receives an email and a notification that the spreadsheet is available. When the process is complete, the STATUS updates to EmailSent.

To troubleshoot issues with processing spreadsheets sent from External Data roles:

  1. Select Troubleshooting > Roles (Execute) on the Navigation pane.

    NOTE: Only ROLE IDs from External Data role types display.

    NOTE: The value in the REQUEST ID field on the Request page identifies the request.

  2. Click the Process Inbound File icon for a request.

NOTE: If the External Data role has sent a spreadsheet to the external data email account, Mass Maintenance will process the spreadsheet and finish the role, then notify the next role in the workflow.

Refer to Use External Data Roles in Request Processing for more information.