Solicitações de ativos

Exemplos de solicitação de API e opções de filtro para recuperar e gerenciar ativos do Orchestrator

Observação:

Os ativos de texto do tipo Global e Por robô são compatíveis com até 1.000.000 caracteres.

Importante:

• As consultas $filter retornarão o resultado de um filtro personalizado que usa os parâmetros Nome e Descrição em uma função contains .
• Solicitações de ativos que expandem os valores que o UiPath Robot (GET "https://{yourDomain}/odata/Assets/UiPath.Server.Configuration.OData.GetFiltered?%24expand=UserValues") primeiro recupera UserValues, que depois se transformam em RobotValues.

Recuperação de um ativo específico

A chamada abaixo permite exibir todas as informações disponíveis para o ativo com o nome DocAPITest e o ID 455 .

Obter

https://{yourDomain}/odata/Assets/UiPath.Server.Configuration.OData.GetRobotAsset(robotId='455',assetName='DocAPITest')

Cabeçalhos de solicitação.

Chave	Valor
Autorização	O portador

Código de resposta

200 OK

Corpo da Resposta

{
    "@odata.context": "https://{yourDomain}/odata/$metadata#UiPath.Application.Dto.Assets.RobotAssetDto",
    "Name": "DocAPITest",
    "ValueType": "Text",
    "StringValue": "An asset added through an API call",
    "BoolValue": false,
    "IntValue": 0,
    "CredentialUsername": "",
    "CredentialPassword": ""
}

Recuperação de ativos por robô

Para executar uma solicitação GET para o endpoint /odata/Assets/UiPath.Server.Configuration.OData.GetRobotAssetByRobotId() , você precisa fornecer o robotId e o assetName no URL. Observe que apenas o nome de usuário é retornado para ativos de credencial por robô, como você pode ver no exemplo abaixo.

Obter

https://{yourDomain}/odata/Assets/UiPath.Server.Configuration.OData.GetRobotAssetByRobotId(robotId=193,assetName='Testing')

Cabeçalhos de solicitação.

Chave	Valor
Autorização	O portador

Código de resposta

200 OK

Corpo da Resposta

{
  "@odata.context": "https://{yourDomain}/odata/$metadata#UiPath.Application.Dto.Assets.RobotAssetDto",
  "Name": "Testing",
  "ValueType": "Credential",
  "StringValue": "",
  "BoolValue": false,
  "IntValue": 0,
  "CredentialUsername": "DocBot",
  "CredentialPassword": ""
}

Adicionando um ativo

O exemplo a seguir permite criar um novo ativo global, do tipo texto.

Postar

https://{yourDomain}/odata/Assets

Cabeçalhos de solicitação.

Chave	Valor
Autorização	O portador

Corpo da Solicitação

{
    "Name": "DocAPITest",
    "ValueScope": "Global",
    "ValueType": "Text", 
    "StringValue": "An asset added through an API call"
}

Código de resposta

200 OK

Corpo da Resposta

{
    "@odata.context": "https://{yourDomain}/odata/$metadata#Assets/$entity",
    "Name": "DocAPITest",
    "CanBeDeleted": true,
    "ValueScope": "Global",
    "ValueType": "Text",
    "Value": "An asset added through an API call",
    "StringValue": "An asset added through an API call",
    "BoolValue": false,
    "IntValue": 0,
    "CredentialUsername": "",
    "CredentialPassword": "",
    "Id": 455,
    "KeyValueList": []
}