TOPdesk - Create or Update Asset
  • 28 Jan 2024
  • 3 Minutes to read
  • Dark
    Light
  • PDF

TOPdesk - Create or Update Asset

  • Dark
    Light
  • PDF

Article Summary

The TOPdesk - Create or Update Asset action creates or updates an asset in TOPdesk Enterprise for each asset that matches the parameters of the selected query or assets selected in one of the asset tables.

See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.

General Settings

  • Enforcement Set name (required) - The name of the Enforcement Set. A default value is added by Axonius. You can change the name according to your needs.
  • Add description - Click to add a description of the Enforcement Set. It is recommended to describe what the Enforcement Set does.
  • Run action on assets matching following query (required) - Select an asset category and a query. The Enforcement Action will be run on the assets that match the query parameters.
  • Action name (required) - The name of the Main action. A default value is added by Axonius. You can change the name according to your needs.
  • Configure Dynamic Values - Toggle on to enter a Dynamic Value statement. See Creating Enforcement Action Dynamic Value Statements to learn more about Dynamic Value statement syntax.

Required Fields

  • Use stored credentials from theTOPdesk adapter (required) - Select this option to use the first connected TOPdesk adapter credentials.
    NOTE
    To use this option, you must successfully configure a TOPdesk adapter connection.
  • Template Name (required) - Enter the name of the TOPdesk asset template.
  • Action Type - Select whether to create a new asset or to update existing assets.
  • Instance Name - The Axonius node to use when connecting to the specified host. For more details, see Connecting Additional Axonius Nodes.

Additional Fields

Connection Parameters

If Use stored credentials from the TOPdesk Enterprise Service Management (ESM)Adapter is disabled, these fields are required:

Host Name or IP Address (optional) – The hostname of the TOPdesk server. Required when there is more than one connection.

  • User Name or Application Name (optional) – Specify the User Name or Application Name. Required when there is more than one connection.
  • Password (optional) - Enter the password for a user account that has the permissions required to create assets.
  • Verify SSL - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.

  • HTTPS proxy - Connect the adapter to a proxy instead of directly connecting it to the domain.

  • Map Axonius fields to TOPdesk fields (optional) - Use the Field Mapping Wizard to map Axonius fields to fields in TOPdesk. In this way you can transfer data found in Axonius into TOPdesk. The wizard shows you which fields exist on the Axonius system, allowing you to map them easily.

    NOTE
  • Tunnel Name - For Axonius-hosted (SaaS) deployments. Select the tunnel through which to connect to perform the action.

  • Use the scheduling options to execute Enforcement Actions on specific dates and times. You can also configure repeat schedules.

    For more details, see Scheduling Enforcement Set Runs.

APIs

Axonius uses the TOPdesk API.

Version Matrix

This adapter has only been tested with the versions marked as supported, but may work with other versions. Please contact Axonius Support if you have a version that is not listed and it is not functioning as expected.

VersionSupportedNotes
Topdesk API v3 and higherYes

For more Enforcement Actions, see Manage CMDB Assets Category.



Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.