By default, the Activity > Jobs page displays a list of the most recent Jobs. The main part of the page contains information about your Jobs (see Viewing Job Details and Understanding Job Details ) and the left column contains some controls for filtering the Jobs displayed (see Filtering Job Activity).
Click the job number in a line item to see detailed information about that Job. See Viewing Job Details.
Filtering Job Activity
You can apply filtering criteria on the Activity > Jobs page.
You can toggle filters on the Jobs displayed as follows:
|Date Range||Jobs run during the range you select.|
|From||Jobs that include the source Endpoint you specify. You can type in a value or click Browse to select from a list.|
|To||Jobs that include the destination Endpoint you select. You can type in a value or click Browse to select from a list.|
|Payload Name||Jobs that include a payload with the name you specify. Partial payload names can be specified in this field in conjunction with the asterisk (*) or question mark (?) wildcard characters.
Use an asterisk (*) to represent any number of characters, and a question mark (?) to represent a single character. For example:
Jobs with the status you select. See Job Status for more information.
|Job||Job with the job number you specify. You can specify partial values and use wildcards in this field.|
As you specify Filter By values, in addition to displaying matching Jobs, CIC displays the filtering criteria as “chips” above the Jobs list.
When you specify one or more values for the Job number filter, the other criteria are disabled and the chips are greyed out.
Close a chip to stop displaying the Jobs matching the chip in the list.
The Job Status can be successful, in progress, or failed due to an issue. If the Job has an issue associated with it, the Job status indicates whether it is a current (unresolved) issue or a resolved issue.
If your configuration allows you to manage your own issues, you can change the status of the issues on the Job Details page. See Updating Job Issue Status.
Note: The statuses described below relate to how the job statuses are currently used to coordinate between Cleo and Cleo Managed Services customers.
|Current||Indicates the issue is current (unresolved). Note that some jobs can be resent from the point of failure after an issue has been resolved.
This category contains four sub-categories: Open, New, Pending, and On Hold.
|Open||Issue has been assigned to Cleo and action is pending from Cleo.|
|New||Issue has not been assigned to anyone yet. This is the initial state for all issues. Once the status changes, it cannot be set to New again.|
|Pending||Issue requires assistance from you, the Cleo customer.|
|On Hold||Issue requires assistance from your Partner.|
|Resolved||Indicates a Resolved issue.|
|Solved||Issue is solved, but not closed.
Depending on your configuration, an issue might be set to "Closed" automatically after 3 days of being marked as Solved. See Closed and Solved Issue Status.
Otherwise, the "Solved" state is like any other.
|Closed||Issue is closed.
Depending on your configuration, an issue might automatically be set to Closed. See Closed and Solved Issue Status.
Updating Job Issue Status
Users who manage their own issues can update the status of an issue from the Issue tab on the Job Details page.
When you update the Job Issue status you can also add a comment at the same time.
A status of "New" is displayed for newly generated issues. Once you change the status, you cannot select "New" again.
Closed and Solved Issue Status
Depending on your configuration, CIC may automatically change an issue status to "Closed" after it has been in a "Solved" status for three days. In this case, "Closed" is not available from the dropdown list. If your configuration does not allow for automatically closing issues, you must explicitly update an issue status to "Closed".
Viewing Job Details
When you click on a Job on the Activity > Jobs page, the Job Detail page appears and displays information about each step in that Job.
Click on a step to drill down into details about that step. By default, the first step in the Job is highlighted and details for that step are displayed.
When you select a Destination Job step that has more than one destination Endpoint, those destinations are listed separately; they are listed on the left side of the page. Click one of those destinations to display details about the job for that destination. The same collection of data (that is, messages, payloads, logs, and so on) is displayed for each of the destinations in a Job step.
Understanding Job Details
Job details contain several types of information:
- Data Flow
For Job steps with Endpoint types other than API, Application Connector, and Database, the Job Detail page shows Data Flow information for the currently selected Job step. Click the name of the Data Flow to display it on the Data Flow edit page.
API, Application Connectors, and Database Endpoints do not use Data Flows.
The Payload tab lists the files transferred as part of the job step in question. Each payload listed is a download link. If there are any EDI messages associated with a payload, a link to the Messages page is displayed on the Payload tab.
The Log tab shows a list of events generated by CIC during the job. (See Job Events.) For each event, the list includes a timestamp, a success/failure icon, name of the event, and an informational message about the event.
In steps where there are API or Application Connector Endpoints, the events listed are expandable. Expanding an event shows the associated request headers and body. You can expand the headers to see those details. The body is displayed automatically if the content-type is 'application/json', 'application/ld+json', 'application/vnd.api+json', 'application/xml', text/csv', 'text/plain', or 'text/xml'.
Whether or not the Jobs page can display it, you can download the request body.
When you click the Transformation step, Auditor log files are displayed on the Log tab as a list of processes you can drill down into. For more information, see Auditor Log data displayed in CIC Cockpit.
The Messages tab shows the EDI messages generated for the job. The Messages tab is typically associated with the Transformation step or the Destination step when the destination is an API endpoint. Each Message listed is a link to the Activity > Messages page.
When a Job has an error associated with it, the Issue tab is displayed for the Job step where the error occurred and the message or log entry that has an error is marked.
The Job Details page shows Retry audit trail information when a retry has been attempted, whether automatic or manual. See Retrying Failed File Transfer Attempts.
For a retried job, the Details page displays the number of times the job has been retried.
In addition, you can click the Retried indicator to see a list of retries showing the timestamp and user associated with each retry.