ServiceNow - Asset management connector thinklet

Configure ServiceNow - Incident management connector thinklets to take specific actions within your workflow.

Action: Get user details by email address

Get user details by email address retrieves detailed user data.

The ServiceNow - Asset management connector thinklet relies on the Table sys_user 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.

  • User email address

• Outputs: View the outputs of the connector thinklet.

  • 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

Get user details by user ID retrieves detailed user data.

The ServiceNow - Asset management connector thinklet relies on the Table sys_user GET API endpoint.

Below is an example of the thinklet setup:

• 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.

  • ServiceNow user ID

• Outputs: View the outputs of the Connector thinklet.

  • 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

Get device details by device name retrieves detailed device data.

The ServiceNow - Asset management connector 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

Get device details by device ID retrieves detailed device data.

The ServiceNow - Asset management connector 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

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 ServiceNow - Asset management connector thinklet relies on the Table alm_hardware GET API endpoint.

Below is an example of the 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)

Refer to the Configuring connector thinklets documentation for more information about connector thinklets.

Action: Set device life cycle stage and status

Set device life cycle stage and status action updates the life cycle stage and status of a CI (Configuration Item) computer. The standard values for life cycle stages are "Defective," "Deploy," "End of Life," "Inventory," "Missing," "Operational," and "Purchase." Each life cycle stage has corresponding allowed status values, such as "In Maintenance" or "In Use." This action should be used according to the locally defined configuration for these fields.

The ServiceNow - Asset management connector thinklet relies on the Table cmdb_ci_computer PUT API endpoint.

Below is an example of the thinklet setup:

• Parameters

  • Computer ID (ComputerID)

  • Life cycle stage (LifeCycleStage)

  • Life cycle stage status (LifeCycleStageStatus)

• Outputs

  • Computer ID (ComputerID) - ServiceNow computer ID

Refer to the Configuring connector thinklets documentation for more information about connector thinklets.