# ServiceNow - Asset management

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

## Action: Get user details by email address <a href="#servicenow-assetmanagement-action-getuserdetailsbyemailaddress" id="servicenow-assetmanagement-action-getuserdetailsbyemailaddress"></a>

The Nexthink Workflow connector Thinklet **Get user details by email address**, retrieves detailed user data. The Thinklet relies on the [Table sys\_user GET](https://docs.servicenow.com/bundle/washingtondc-api-reference/page/integrate/inbound-rest/concept/c_TableAPI.html#title_table-get-id) API endpoint.

<figure><img src="/files/Dsq0ERpC0KWLSnqTPhlb" alt="image-20240604-123140.png" width="589"><figcaption></figcaption></figure>

### **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 <a href="#servicenow-assetmanagement-action-getuserdetailsbyuserid" id="servicenow-assetmanagement-action-getuserdetailsbyuserid"></a>

The Nexthink Workflow connector Thinklet **Get user details by user ID**, retrieves detailed user data. The Thinklet relies on the [Table sys\_user GET](https://docs.servicenow.com/bundle/washingtondc-api-reference/page/integrate/inbound-rest/concept/c_TableAPI.md#title_table-get-id) API endpoint.

Example of Thinklet setup:

<figure><img src="/files/cEx6qd38lwXLJVgoTDEr" alt="image-20240604-123942.png" width="580"><figcaption></figcaption></figure>

### **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 <a href="#servicenow-assetmanagement-action-getdevicedetailsbydevicename" id="servicenow-assetmanagement-action-getdevicedetailsbydevicename"></a>

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](https://docs.servicenow.com/bundle/washingtondc-api-reference/page/integrate/inbound-rest/concept/c_TableAPI.md#title_table-get-id) API endpoint.

<figure><img src="/files/hQJdyYRsdlAeszZgg8S6" alt="image-20240604-130939.png" width="583"><figcaption></figcaption></figure>

* **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 <a href="#servicenow-assetmanagement-action-getdevicedetailsbydeviceid" id="servicenow-assetmanagement-action-getdevicedetailsbydeviceid"></a>

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](https://docs.servicenow.com/bundle/washingtondc-api-reference/page/integrate/inbound-rest/concept/c_TableAPI.md#title_table-get-id) API endpoint.

<figure><img src="/files/pNDtTGETjyatyVm0sCXN" alt="image-20240604-131025.png" width="593"><figcaption></figcaption></figure>

* **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 <a href="#action-get-hardware-asset-details-by-ci-id" id="action-get-hardware-asset-details-by-ci-id"></a>

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](https://docs.servicenow.com/bundle/washingtondc-api-reference/page/integrate/inbound-rest/concept/c_TableAPI.html#title_table-GET-id) API endpoint.

Example of Thinklet setup:

<figure><img src="/files/DHcIiGLZ3LCqhDveSDzr" alt="" width="563"><figcaption></figcaption></figure>

**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`)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nexthink.com/platform/~/changes/Sh4xqs4GDClkDKT9Hvux/user-guide/workflows/creating-workflows/designer/configuring-connector-thinklet/servicenow-asset-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.