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)

The table below shows the API Service connector details needed when recreating the connector:

Field	Value
Resource Path	/api/now/table/sys_user?sysparm_query=email={{UserEmailAddress}}
Method	GET
Payload
Outputs	EnableMultifactorAauthn $.result[0].enable_multifactor_authn PasswordNeedsReset $.result[0].password_needs_reset UserID $.result[0].sys_id UserName $.result[0].user_name VIPUser $.result[0].vip

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)

The table below shows the API Service connector details needed when recreating the connector:

Field	Value
Resource Path	/api/now/table/sys_user/{{ServiceNowUserID}}
Method	GET
Payload
Outputs	UserEmailAddress $.result.email EnableMultifactorAauthn $.result.enable_multifactor_authn PasswordNeedsReset $.result.password_needs_reset UserName $.result.user_name VIPUser $.result.vip

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

The table below shows the API Service connector details needed when recreating the connector:

Field	Value
Resource Path	/api/now/table/cmdb_ci_computer?sysparm_query=name={{DeviceName}}
Method	GET
Payload
Outputs	AssetID $.result[0].asset.value AssignedToID $.result[0].assigned_to.value LifeCycleStage $.result[0].life_cycle_stage.value ManagedByID $.result[0].managed_by.value OwnedByID $.result[0].owned_by.value PurchaseDate $.result[0].purchase_date ComputerID $.result[0].sys_id WarrantyExpirationDate $.result[0].warranty_expiration

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

The table below shows the API Service connector details needed when recreating the connector:

Field	Value
Resource Path	/api/now/table/cmdb_ci_computer/{{DeviceID}}
Method	GET
Payload
Outputs	AssetID $.result.asset.value AssignedToID $.result.assigned_to.value LifeCycleStage $.result.life_cycle_stage.value ManagedByID $.result.managed_by.value ComputerName $.result.name OwnedByID $.result.owned_by.value PurchaseDate $.result.purchase_date WarrantyExpirationDate $.result.warranty_expiration

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)

The table below shows the API Service connector details needed when recreating the connector:

Field	Value
Resource Path	api/now/table/alm_hardware?sysparm_query=ci.value={{ConfigurationItemID}}&sysparm_limit=1
Method	GET
Payload
Outputs	AssetTag $.result[0].asset_tag DisplayName $.result[0].display_name State $.result[0].install_status SerialNumber $.result[0].serial_number Substate $.result[0].substatus HardwareAssetID $.result[0].sys_id

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

The table below shows the API Service connector details needed when recreating the connector:

Field	Value
Resource Path	api/now/table/cmdb_ci_computer/{{ComputerID}}
Method	GET
Payload	{"life_cycle_stage": "{{LifeCycleStage}}", "life_cycle_stage_status": "{{LifeCycleStageStatus}}"}
Outputs	ComputerID $.result[0].sys_id

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