Learn
Documentation
Support
Community

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.

image-20240604-123140.png

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

image-20240604-123942.png

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

image-20240604-130939.png

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

image-20240604-131025.png

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

Last updated

Was this helpful?