UiPath Documentation
uipath-cli
latest
false
UiPath CLI user guide

uip rules describe

Syntax and options for `uip rules describe`, which returns the entry points and argument schemas of a deployed business rule's active version.

Note:

uip rules describe is labeled Preview in the command help. Refer to Versioning for what the Preview label means.

uip rules describe returns the entry points of a deployed business rule's active version, with their input and output argument schemas. Use them to map arguments when you bind the rule from a BPMN process, RPA workflow, or case. The rows have the same shape as uip or packages entry-points.

describe reads the rule in the tenant of your current session. To read a rule in another tenant, switch tenants with uip login tenant set first.

Synopsis​

uip rules describe <rule-name> (--folder-path <path> | --folder-key <key>)
uip rules describe <rule-name> (--folder-path <path> | --folder-key <key>)

Arguments​

NameRequiredPurpose
<rule-name>yesBusiness rule name.

Options​

Pass exactly one of --folder-path or --folder-key.

LongValueDescription
--folder-pathstringFolder path, for example Shared.
--folder-keyGUIDFolder key.

Example​

uip rules describe LoanEligibility --folder-path "Shared"
uip rules describe LoanEligibility --folder-path "Shared"

Data shape (--output json)​

{
  "Code": "RulesEntryPoints",
  "Data": [
    {
      "UniqueId": "8a0f5c3e-2d1b-4f6a-9e7c-1b2a3c4d5e6f",
      "Path": "/LoanEligibility.dmn#Decision_Eligibility",
      "DisplayName": "Eligibility",
      "InputArguments": "{\"type\":\"object\",\"properties\":{\"creditScore\":{\"type\":\"number\"}}}",
      "OutputArguments": "{\"type\":\"object\",\"properties\":{\"eligible\":{\"type\":\"boolean\"}}}"
    }
  ]
}
{
  "Code": "RulesEntryPoints",
  "Data": [
    {
      "UniqueId": "8a0f5c3e-2d1b-4f6a-9e7c-1b2a3c4d5e6f",
      "Path": "/LoanEligibility.dmn#Decision_Eligibility",
      "DisplayName": "Eligibility",
      "InputArguments": "{\"type\":\"object\",\"properties\":{\"creditScore\":{\"type\":\"number\"}}}",
      "OutputArguments": "{\"type\":\"object\",\"properties\":{\"eligible\":{\"type\":\"boolean\"}}}"
    }
  ]
}

InputArguments and OutputArguments are JSON schemas serialized as strings.

Exit codes​

Refer to Exit codes for the shared contract. The command exits 1 in these cases:

ConditionErrorCode
The folder holds no rule with this name.not_found
The deployed rule carries no argument contract. Redeploy it from its solution with uip solution publish and uip solution deploy run.configuration_error
Neither or both of --folder-path and --folder-key are passed.invalid_argument

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