UiPath Documentation
uipath-cli
latest
false
UiPath CLI user guide

uip is activities

Syntax and options for `uip is activities`, which lists the operations a connector exposes in Integration Service and builds local activity metadata and action-script type headers.

uip is activities lists the operations a connector exposes. Activities are the named actions (CreateTicket, ListAllRecords, etc.) that an automation can drive against a connector — they map onto HTTP methods and connector objects. list results are cached per-connector-and-tenant; pass --refresh to re-fetch. The metadata generate and script update verbs work on local files only: metadata generate compiles a minimal-metadata file into activity metadata, and script update writes a type header into an action script from that metadata.

Synopsis​

uip is activities list <connector-key> [--triggers] [--refresh]
uip is activities metadata generate <min-file> [--out <file>]
uip is activities script update <script-file> --metadata <file>
uip is activities list <connector-key> [--triggers] [--refresh]
uip is activities metadata generate <min-file> [--out <file>]
uip is activities script update <script-file> --metadata <file>

Verbs​

VerbPurpose
listList the activities a connector exposes. With --triggers, list trigger activities only.
metadata generateGenerate activity metadata from a minimal-metadata (.min.json) file.
script updateUpdate an action script's type header in place from its activity metadata.

uip is activities list​

List activities for a connector. By default, trigger activities are excluded; pass --triggers to list only triggers.

Arguments​

NameRequiredPurpose
<connector-key>yesConnector key, for example uipath-zoho-desk.

Options​

ShortLongValueDefaultDescription
—--refreshflagoffForce re-fetch from the API, ignoring cache.
—--triggersflagoffList trigger activities only. Switches Code to TriggerActivityList.

Examples​

uip is activities list uipath-zoho-desk

# Trigger activities only
uip is activities list uipath-zoho-desk --triggers

# Just the activity names
uip is activities list uipath-zoho-desk \
    --output-filter '[].Name'
uip is activities list uipath-zoho-desk

# Trigger activities only
uip is activities list uipath-zoho-desk --triggers

# Just the activity names
uip is activities list uipath-zoho-desk \
    --output-filter '[].Name'

Data shape (--output json)​

{
  "Code": "ActivityList",
  "Data": [
    {
      "Name": "CreateTicket",
      "DisplayName": "Create Ticket",
      "Description": "Create a new ticket in Zoho Desk.",
      "ObjectName": "create_ticket",
      "MethodName": "POST",
      "Operation": "N/A",
      "IsCurated": "Yes"
    },
    {
      "Name": "ListAllRecords",
      "DisplayName": "List Records",
      "Description": "Retrieve and list records from Zoho Desk.",
      "ObjectName": "N/A",
      "MethodName": "N/A",
      "Operation": "List",
      "IsCurated": "No"
    }
  ]
}
{
  "Code": "ActivityList",
  "Data": [
    {
      "Name": "CreateTicket",
      "DisplayName": "Create Ticket",
      "Description": "Create a new ticket in Zoho Desk.",
      "ObjectName": "create_ticket",
      "MethodName": "POST",
      "Operation": "N/A",
      "IsCurated": "Yes"
    },
    {
      "Name": "ListAllRecords",
      "DisplayName": "List Records",
      "Description": "Retrieve and list records from Zoho Desk.",
      "ObjectName": "N/A",
      "MethodName": "N/A",
      "Operation": "List",
      "IsCurated": "No"
    }
  ]
}

With --triggers, the response uses Code: "TriggerActivityList" and the same per-row shape.

An empty result still succeeds, with an Instructions message. Without --triggers, a connector whose activities are all triggers returns an empty list and the message points to --triggers.

uip is activities metadata generate​

Generate activity metadata from a minimal-metadata file. The minimal-metadata file (<name>.min.json) is the source you edit; the generated metadata file is derived from it. The command validates the generated metadata before writing it, so a file that fails validation leaves no output behind. To change the generated metadata, edit the minimal-metadata file and run the command again.

Arguments​

NameRequiredPurpose
<min-file>yesPath to the <name>.min.json file. The file must contain an activity block.

Options​

ShortLongValueDefaultDescription
—--outpathinput path with .min.json replaced by .jsonOutput path. Required when <min-file> does not end in .min.json.

Example​

uip is activities metadata generate ./AddUsersToUsergroup.min.json
uip is activities metadata generate ./AddUsersToUsergroup.min.json

Data shape (--output json)​

{
  "Code": "ActivityMetadataGenerated",
  "Data": {
    "Out": "./AddUsersToUsergroup.json",
    "Name": "AddUsersToUsergroup",
    "Fields": 12,
    "PrimaryKey": ["usergroup.id"]
  }
}
{
  "Code": "ActivityMetadataGenerated",
  "Data": {
    "Out": "./AddUsersToUsergroup.json",
    "Name": "AddUsersToUsergroup",
    "Fields": 12,
    "PrimaryKey": ["usergroup.id"]
  }
}
FieldDescription
OutPath of the generated metadata file.
NameActivity name.
FieldsNumber of fields in the generated metadata.
PrimaryKeyPrimary-key field names. Present only when the generated metadata declares a primary key.

A missing or invalid input file, or metadata that fails validation, fails with ErrorCode: "invalid_metadata" and exit code 1.

uip is activities script update​

Update an action script's type header in place from its activity metadata. The type header is a leading /* … */ comment block of type declarations that describes the script's inputs and outputs. If the script already starts with a block comment, the command replaces it; otherwise, it adds the header at the top of the file.

Arguments​

NameRequiredPurpose
<script-file>yesPath to the action script (.js) to update.

Options​

ShortLongValueDefaultDescription
—--metadatapathrequiredPath to the activity metadata JSON the type header is derived from, for example the output of metadata generate.

Example​

uip is activities script update ./AddUsersToUsergroup.js     --metadata ./AddUsersToUsergroup.json
uip is activities script update ./AddUsersToUsergroup.js     --metadata ./AddUsersToUsergroup.json

Data shape (--output json)​

{
  "Code": "ScriptUpdated",
  "Data": { "Script": "./AddUsersToUsergroup.js", "Types": 4 }
}
{
  "Code": "ScriptUpdated",
  "Data": { "Script": "./AddUsersToUsergroup.js", "Types": 4 }
}

Types is the number of type declarations in the header. A missing script or metadata file, or a metadata file that is not valid JSON, fails with ErrorCode: "invalid_metadata" and exit code 1.

To run the updated script against a connection, use uip is resources run script.

See also​

Was this page helpful?

Connect

Need help? Support(opens in new window)

Want to learn? UiPath Academy(opens in new window)

Have questions? UiPath Forum(opens in new window)

Stay updated