Managing Remote Actions

The Remote Actions Administration page lets you view, create, and edit your remote actions.

Accessing Remote Actions Administration page

To access the Remote Actions administration page:

1. Select Remote Actions from the main menu.

2. Click on Manage remote actions in the navigation panel.

Understanding the remote actions list

From the Remote Actions Administration page, view all available remote actions organized by:

• Name: The name of the remote action.

• Origin: An indication of where the remote action originates from:

  • Custom: A remote action created within the Remote Actions module.

  • Installed from Library: A remote action installed from the Nexthink Library module. You can configure the following fields:

    • Description

    • Triggering

    • Input Parameter Description

    • Input Parameter Value

    • Output Parameter Description

    • Custom Value

    • All fields in the Schedule tab Refer to the Nexthink Library documentation for more information on how to install a remote action.

  • Copied from library: A remote action copied from the Nexthink Library module. You can fully edit copied remote actions to fit your needs. Refer to the Nexthink Library documentation for more information on how to create a copy of a remote action.

• Tags: Displays the list of tags assigned to each remote action.

• Platforms: The platform for which a remote action was designed.

• Triggers: The trigger method used to configure a remote action with the following options:

  • Manual: Trigger the remote action manually from the web interface, e.g., through Investigations or Device View.

  • API: Trigger the execution on selected devices via API​.

  • Schedule: Trigger the execution using an NQL query on a recurring basis at a scheduled time.

You can search for a specific remote action by name using the search box at the top right of the table.

Refer to the Creating and configuring remote actions documentation for more information about creating custom remote actions and configuring library remote actions.

Using the action menu for remote actions

Select a relevant remote action and click on the action menu on the right side of the table to see the following options:

• Execute: Trigger remote action.

• Details: Open the execution details page.

• Configure: Change the configuration of a library remote action.

• Edit: Edit a selected remote action.

• Manage tags: Create, assign, and edit remote action tags.

• Share: Grant permissions to other users to view or edit a remote action. Refer to the Sharing a remote action section.

• Copy NQL ID: Copy the NQL ID of a remote action for use by the API.

• Export: Export a remote action to a JSON file.

• Delete: Remove a remote action from the system.

Executing remote actions from the Manage remote actions page

To execute a remote action directly from the Remote Actions administration page:

1. From Remote Actions > Manage remote actions, hover over the remote action you want to run to reveal the action menu.

2. Select Execute. The Execution action window opens, displaying:

   1. Name: The name of the remote action.

   2. Description: A short description of the remote action.

   3. Platforms: The platform(s) the remote action supports, for example, Windows and macOS.

   4. Device name: A searchable drop-down field to select a target device.

3. In the Device name field, search for and select the target device.

4. Click Execute to trigger the remote action on the selected device.

Only remote actions with a Manual trigger type can be executed from the Manage remote actions page.

After submitting the request, the Execution request window appears with a success message. From this window, you can navigate directly to the Investigations module to view results.

Tagging remote actions

Tagging allows you to efficiently organize remote actions, facilitating quick and easy navigation through your data.

Open the Tags right-side panel to:

• Search for a specific tag at the top of the panel.

• Select one or more tags to filter the remote actions table.

To add one or more tags to a monitor, from the Remote actions > Manage remote actions page:

1. Hover over a remote action to display the action menu and choose Manage tags.

2. From the Manage tags pop-up you can:

   • Type in a new tag or choose an existing one to add it to the remote action.

   • Open the action menu of a specific tag item to Delete tag or change the tag color.

     • Deleting a tag only removes it from the remote action it is associated with.

3. Alternatively, select multiple remote actions to Manage tags in bulks.

Remote action can have a maximum of 10 tags associated with it.

Sharing a remote action

Share a remote action with profiles and grant them appropriate permissions to view dashboards, make edits or execute remote actions. For example, you can share the Get Battery Status remote action with the Service desk profile that contains permissions to execute and view the remote action dashboard. Only users with the Manage All Remote Actions feature permission enabled can see the Share option. Refer to the Getting started with Remote Actions documentation for more information.

• Hover over a remote action to reveal the action menu and select Share. The Share remote action modal opens.

• In the Add profile text field, type in the user profiles you wish to share the remote action with.

• From the Select permissions drop-down menu, select the appropriate permissions for the profile. The choices are:

  • View dashboards: Access the remote action dashboards from the navigation panel and the remote actions table on the Overview page.

  • Edit: Edit a remote action.

  • Execute: Execute a remote action.

• Click on Clear all to disable all permissions.

• Click on the Grant permissions button to share the remote action.

Importing a remote action

To import remote actions—in JSON—from your local device:

1. Click the Import button in the top-right corner of the Remote actions > Manage remote actions page.

2. Choose or drag multiple JSON files from your hard drive to import them into the system.

   • All imported items from local devices are listed as custom.

To import a remote action from Nexthink Library:

• Click on the action menu located next to the Import button.

• Select Nexthink library. The system redirects you to the library page with remote actions to download.

• Import the downloaded file.

Querying remote actions with NQL

Refer to Remote Actions NQL capabilities for more information.