Configuring and Setting up the Plugin

You must have administrative privileges to configure the plugin. You need to perform the following settings and configurations before you use the plugin:

  • Import the xml plugin in ServiceNow
  • Configure customer

Importing the Plugin

This section describes the detailed steps to import the <.xml> file. You must import the plugin within a specified instance. After the xml file is committed successfully, the project data is available to the users within ServiceNow.

To import the plugin:

  1. Open the required instance and login using the credentials. You must login using Admin user profile.
  2. Type Update Sets in the left pane Search box and click Retrieved Update Sets on the left pane.



  3. Click Import Update Set from XML. The Import XML page displays.



  4. Click Choose File and click Upload.

    Note: After the xml file is imported, it displays the status as "Loaded".

  5. Click the uploaded file. In the following screen, click Preview Update Set.

The plugin is successfully committed, you can view the details. Following is a sample screen.


          

You have successfully imported the plugin.

Note: To uninstall the plugin, refer the Uninstalling the Plugin section.

Uninstalling the Plugin

This section describes the steps to delete and uninstall applications from instances.

Deleting an Application

To delete applications:

  1. Navigate to the System Application > Applications.
  2. In the Develop tab, open the application you want to delete.

  3. Click the Delete button on the top-right corner. The Confirmation popup window displays.

  4. Click Delete to delete the application. Following confirmation window displays.

  5. Enter "delete" in the text box and click OK.

For more details to delete an application, see ServiceNow.

Uninstalling an Application

To uninstall the application:

  1. Navigate to System Application > Applications.

  2. In the Downloads tab, open the Application you want to delete from the list.
  3. Click the name or the icon of the installed application to uninstall.

  4. Click Uninstall. A confirmation windows displays.
  5. Click OK.

  6. A confirmation windows displays. Enter "uninstall" and click OK.


Note: You cannot uninstall applications that are listed under the Develop tab, but you can delete them. Applications downloaded and installed from ServiceNow repository/store can be uninstalled or you can see the "uninstall" related link. For more details to uninstall applications, see ServiceNow.

Creating User

The administrator needs to create users after importing the plugin for the first time.

To create a user:

  1. Open the required instance and login using the credentials.
  2. Under the RISC NETWORKS group in the left pane, type users in the navigation pane.
  3. Click System Security > Users. Following is a sample screen.



  4. Click New to create a new user. The following New record page displays.



  5. Enter the required details and click Submit.

After creating a new user, the administrator needs to provide roles to the user.

Providing Roles to a User

To provide a role to a user:

  1. Open the required instance and login using the credentials.
  2. Under the RISC NETWORKS group in the left pane, type users in the navigation pane.
  3. Click System Security > Users. Following is a sample screen.



  4. Click on the user whom you want to provide the roles. Following is a sample screen. Scroll the following screen to the bottom.



  5. In the Roles tab, click the Edit button.



  6. Select the required roles and click the required arrow. Following is a sample screen.



  7. Click Save.

Note: You must provide the "itil" and "{}x_riscn_risc_netwo.user" role to the user. Optionally, you can add more roles as required.

Connecting to External Systems

Before you configure the RISC Networks credentials, you must have the UserName, Password, Assessment Code, Host API URL, and API Key.

Configuring RISC Networks Credential

The administrator must have the basic configuration details for the customer configurations such as username, password, assessment code, and host API URL for basic authentication to communicate with the RISC Network database.

Note: Users with the ' x_riscn_risc_netwo.user' role can create and update the customer configuration records.

To configure a customer:

  1. Open the required instance and login using the credentials.
  2. Under the RISC NETWORKS group in the left pane, click Customer Configurations.



  3. Enter the UserName, Password, Assessment Code, Host API URL and API Key.The Host API URL is <https://api.riscnetworks.com:443/1_0>. 
  4. Select the Max. No. of Workers required from the list (values can be 1 to 8).
    Note: If you provide the value as one, import will be slower but other ServiceNow related activities will be optimal. Whereas if you provide the value as 8, multiple threads will execute, and more number of workers (threads) will import data faster into ServiceNow. In this case, other activities will be affected.
  5. Click the following as required:
    1. Save Configuration to save the basic configurations.
    2. Sync Data to fetch the RISC Networks data for the configured customer. You are redirected to the Queue page. Refresh the page until the Queue is empty.
    3. Clear All Asset Data to remove the device data. You are redirected to the Queue page. Refresh the page until the Queue is empty.

Testing the Configuration

To test the configuration:

  1. Open the required instance and login using the credentials.
  2. Under the RISC NETWORKS group in the left pane, click Customer Configurations.



  3. Click Sync Data. The data between ServiceNow and RISC Platform is synced.