Skip to main content

Instances

The Instances section in erm4sn allows administrators to configure and manage ServiceNow instances connected to erm4sn. This configuration ensures accurate data retrieval, schema analysis, and system synchronization.

Listing​

  • Click on the circle arrow icon to trigger a manual instance refresh.
  • Click on an instance name to modify its configuration.
  • Click Create New Instance to add a new ServiceNow instance to erm4sn.

alt text

Instance Configuration​

The Instance Configuration page allows you to define key properties for each connected ServiceNow instance.

General Settings​

  1. Enter the Instance Name

    • Provide a descriptive name for the instance, such as "Dev", "Test", or "Prod".

  2. Add a Comment (Optional)

    • Enter additional information about the instance, such as its purpose or specific notes.

  3. Set the Instance Category

    • Define whether the instance is used for Development, Testing, Production etc.

  4. Define the Display Order

    • Specify a numeric value (e.g., 1, 2, 3) to control the order of instances in the list.

  5. View the Instance ID (Read-Only)

    • Displays the internal system-generated ID of the instance.

  6. Set the Documentation Language

    • Define the short key for the labels' display language (e.g., "en" for English).

Data Density​

  1. Enable or Disable Data Density Calculation

    • Toggle Active to enable or disable this feature for the instance.
    • When enabled, erm4sn collects metadata about which tables and columns contain data using ServiceNow’s aggregate functions.

  2. Important Considerations:

    • This feature only queries data statistics and does not access customer data.
    • The REST API user must have admin privileges to retrieve data statistics.
    • It is not recommended to enable this feature on production ServiceNow instances.

  3. Clear Data Density Details

    • Click Clear Data Density Details to remove all stored data density details for the instance.
Update Data Density

The collected data density information is not refreshed automatically. To update the data density details, click the Clear Data Density Details button and then trigger a instance refresh.

REST Credentials​

  1. Enter the ServiceNow Host Name

    • Provide the full ServiceNow instance URL, e.g., https://customer.service-now.com.

  2. Either Select the OAuth Profile

    • Choose an OAuth profile from the preconfigured options in the OAuth settings.

  3. Or Enter the REST API Credentials

    • Username: The REST API user account.
    • Password: The REST API password.

Refresh Interval​

  1. Enable or Disable Auto Refresh

    • Toggle Auto Refresh to automatically update the instance at a scheduled time.

  2. Set the Refresh Schedule:

    • Hour: Define the hour of the day when the refresh should run.
    • Day of Week: Select the specific weekday for the refresh (e.g., "Monday").
    • Day of Month: Specify a particular day of the month if needed.
    • Month: Choose the months when the refresh should occur.

Logs​

  1. View the Instance Refresh Logs
    • Toggle the Show Logs button to display logs from the most recent refresh.

Actions​

  1. Update Configuration

    • Click Update to save the instance settings.

  2. Return Without Saving

    • Click Back to exit without making changes.

  3. Test Connection

    • Click Connection Test to verify that erm4sn can successfully connect to the ServiceNow instance.

  4. Manually Load Schema Data

    • Click Load Schema Data to retrieve the latest schema information immediately.

  5. Clear Instance Data

    • Click Clear... to remove all stored data for this instance in erm4sn.

  6. Delete Instance Configuration

    • Click Delete... to permanently remove the instance configuration and all associated data from erm4sn.
API Access Requirements

The accuracy and completeness of data displayed in erm4sn depend on the access level of the REST API User credentials.
For the best experience, we recommend using a user with the “admin” and “snc_read_only” roles.