Automate Joe Onboarding Guide
    • 03 Oct 2022
    • PDF

    Automate Joe Onboarding Guide

    • PDF

    Article summary

    Introduction

    This guide is designed to help you get up and running with SysAid's Automate Joe service orchestration service. You can use it as a check list for the steps you need to take in setting up Automate Joe in your SysAid account.

    Only an admin with SysAid Administrator permissions can set up this integration. For more detailed information, see the Automate Joe Guide.

    To set up Automate Joe in your SysAid

    1. Acquire and install the Automate Joe add-on
    2. Activate the add-on
    3. Set permissions
    4. Deploy Automate Joe agents
    5. Update credentials
    6. Update parameter mappings

    1. Acquire and Install the Automate Joe Add-On

    To install the Automate Joe add-on in your SysAid account, contact your customer success representative.

    2. Activate the Add-On

    1. Navigate to Settings > My Apps page, in the Automate Joe icon, click .
    2. Click the slider.
    3. Click Save Changes.

    For information about Automate Joe licenses, see the Automate Joe Guide.

    3. Set Permissions

    Once Automate Joe is enabled, configure the two additional permissions for admins and/or groups.

    Permission
    Description
    Enable/Disable Automate Joe agents and targets Allows admins to enable or disable Automate Joe agents and targets.
    Modify Automate Joe parameter mapping Allows admins to create/update the parameter mapping for an Automate Joe action processes input/output.

    4. Deploy Automate Joe Agents

    Next, deploy an Automate Joe agent on a computer that has assess to the machines you want to integrate with the relevant Automate Joe process. For more information about the various types of Automate Joe agents, see the Automate Joe Guide.

    To deploy an Automate Joe agent

    1. Navigate to Asset Management > Asset List.
    2. Select the asset you want to deploy an agent on.
    3. In the asset form, select the Embedded Services tab.
    4. Select Enable from the drop-down for the agent(s) you want to deploy.
    5. Click OK.

    5. Update Credentials

    Automate Joe uses SysAid's credentials management to access the various applications and services in your network by automatically and securely syncing them to a secure repository in the Automic Orchestration Server.

    To prepare a credentials set for an Automate Joe process

    1. From the Credentials list, open the credentials you want to use.
    2. Ensure that the user name includes the domain name. For example: "domain\administrator"
    3. Select the Valid for Automate Joe check box.
    4. Click OK.

    You can now select this credentials set in the parameter mapping of an Automate Joe process. It's important that any credentials you select have access and permissions to the service on which you want to execute the automated process.

    6. Parameter mappings

    The new Automate Joe action item control allows you to launch an automation process from an action item in a request, change, or problem template. Once this is configured, the moment an Automate Joe action item is activated, Automate Joe executes the process and completes the action item when the defined process is complete.

    To add an Automate Joe process from an action item

    1. Navigate to Settings > Service Desk Templates.
    2. Select the template you want to configure and navigate to the action item you want to automate.
    3. Click AutomicEmbeddedSettingsfilesAddActionItem.jpg.
    4. Click Edit.
    5. Add the Launch Automation Process field to the Visible fields area.
    6. (Optional) We recommend removing all other fields from this action item.
    7. Click Save.
    8. In the action item, click AutomicEmbeddedSettingsfilesAutomateJoeProcess.jpg.
      AutomicEmbeddedSettingsfilesActionItemProcessControl.jpg
    9. If it's the first time accessing the Automate Joe Parameter Mapping screen, click Reload Processes to populate the list of available processes.
    10. From the Automation Process drop-down list, select the process you want to configure.
    11. Provide parameter mapping for this process.
    12. Select if you want the parameter to be populated from an SR field, an action item field, credential set, Automate Joe agent, group field, or a manual Velocity command.
      AutomicEmbeddedSettingsfilesDataSource.png
    13. In the Set Value column, select a field, or type input with the variable name of the field you want to populate.
    14. Select Get Text if you want to output the field value's caption instead of the its key.
    15. Click OK.
      GuideAJSetupfilesAJParameterMapping2.png
    16. Back in the workflow template, click OK.