Applies To

SharePoint Online

Description:

NITRO Studio components provide a variety of features for configuring business process flows in SharePoint. Sometimes an error can occur during execution due to various reasons like invalid configurations or data, intermittent connectivity or Office 365 issues, NITRO issues etc.

NITRO Custom Actions component has a feature to log details of error and related data in a list in the site. This data can be used by administrators to investigate the issue and correct the configurations. For NITRO issues, these can be submitted by administrators to Crow Canyon for further investigation and fixes as required. This feature will be added to other NITRO components in upcoming releases.

This article describes the process of submitting these errors and investigation thereafter. When an error is detected by NITRO, logged-in user is shown an option to report the error.  Site administrator will get a notification along with link to the details of the error.

Summary of steps:

1. Install NITRO Extensions setup
2. Report Error to Administrator
3. Report Error to Crow Canyon

Detailed Steps:

1. Install NITRO Extensions setup

Step 1: Navigate to root site of the site collection -> Crow Canyon NITRO Studio app -> click on NITRO Applications as shown below:

Please go to Updates tab in NITRO Applications -> click on NITRO Extensions as shown below

Select the required NITRO site and click Ok to finish the setup as shown below.

Once the above setup is completed, a new list “NITROErrorLog” will be created in the site. This list has columns to capture the error details. It also has preconfigured actions for the administrator. To access the list, please go to site contents -> NITROErrorLog

Step 2: Go to site settings -> site Administration -> Crow Canyon NITRO Apps -> Crow Canyon NITRO Workflows app -> Create a new workflow on NITRO Error log list on item added event to notify Administrator.

2. Report Error to Administrator

When any error in encountered during custom action execution, a link to submit the error details is shown to user:

On clicking this link a popup is shown with below options:

– After report is submitted, a message is shown to user. Error details along with optional information is created as an item in the ‘NITROErrorLog’ list.

An email is sent to administrators with details of the error. Administrator can take following actions:

1. Administrators can navigate to the item from the notification (as configured in Step 2 above), review details, and decide the next steps whether to “Send to Crow Canyon” or work on it and “Mark Completed”.
2. If Administrator finds the error as user error or temporary connection error, they can mark it completed.
3. If the error log is having multiple or complex exceptions, then Administrator can escalate the item to Crow Canyon by clicking on “Send to Crow Canyon”. The error details will then be sent to Crow Canyon support email.

These actions can be updated as required.