ServiceNow - Asset management

This page outlines actions to select when configuring Thinklets with ServiceNow - Asset Management.

Action: Get user details by email address

The Nexthink Workflow connector Thinklet Get user details by email address, retrieves detailed user data. The Thinklet relies on the Table sys_user GET API endpoint.

Parameters

• User email address

Outputs

• User ID (UserID)

• User name (UserName): ServiceNow username

• Enable MFA (EnableMultifactorAauthn): Enable multifactor authentication

• VIP (VIPUser)

• Password needs reset (PasswordNeedsReset)

Action: Get user details by user ID

The Nexthink Workflow connector Thinklet Get user details by user ID, retrieves detailed user data. The Thinklet relies on the Table sys_user GET API endpoint.

Example of Thinklet setup:

Parameters

• ServiceNow user ID

Outputs

• User email address (UserEmailAddress)

• User name (UserName): ServiceNow username

• Enable MFA (EnableMultifactorAauthn): Enable multifactor authentication

• VIP (VIPUser)

• Password needs reset (PasswordNeedsReset)

Action: Get device details by device name

The Nexthink Workflow connector Thinklet Get device details by device name, retrieves detailed device data. The Thinklet relies on the Table cmdb_ci_computer GET API endpoint.

• Parameters: Configure the data used as parameters for this action. Hover over the tooltip icon for more information on how the parameter is mapped and what data is required.

  • Device ID

• Outputs: View the outputs of the Connector Thinklet.

  • Computer ID (ComputerID): ServiceNow computer ID

  • Purchase date (PurchaseDate)

  • Warranty expiration date (WarrantyExpirationDate)

  • Owned by ID (OwnedByID)

  • Assigned to ID (AssignedToID)

  • Managed by ID (ManagedByID)

  • Asset ID (AssetID)

  • Life cycle stage (LifeCycleStage): Defective, Deploy, End of Life, Inventory, Missing, Operational, Purchase

Action: Get device details by device ID

The Nexthink Workflow connector Thinklet Get device details by device ID, retrieves detailed device data. The Thinklet relies on the Table cmdb_ci_computer GET API endpoint.

• Parameters: Configure the data used as parameters for this action. Hover over the tooltip icon for more information on how the parameter is mapped and what data is required.

  • Device ID

• Outputs: View the outputs of the Connector Thinklet.

  • Computer name (ComputerName): ServiceNow computer name

  • Purchase date (PurchaseDate)

  • Warranty expiration date (WarrantyExpirationDate)

  • Owned by ID (OwnedByID)

  • Assigned to ID (AssignedToID)

  • Managed by ID (ManagedByID)

  • Asset ID (AssetID)

  • Life cycle stage (LifeCycleStage): Defective, Deploy, End of Life, Inventory, Missing, Operational, Purchase

Action: Get hardware asset details by CI ID

The Nexthink Workflow connector Thinklet Get hardware asset details by CI ID, retrieves detailed hardware asset data. This data can be integrated into a workflow to, for instance, verify the status of an asset and initiate actions exclusively for those in an "In use" state. The Thinklet relies on the Table alm_hardware GET API endpoint.

Example of Thinklet setup:

Parameters

• Configuration Item ID (ConfigurationItemID)

Outputs

• State (State) - Hardware asset state (1 - “In use”, 2 - “On order", 3 - "In maintenance", 6 - "In stock", 7 - "Retired", 8 - "Missing", 9 - "In transit", 11 - "Build")

• Substate (Substate) - Current substate of the asset dependent on State

• Display name (DisplayName)

• Hardware asset ID (HardwareAssetID)

• Serial number (SerialNumber)