Requêtes relatives aux actifs

Remarque : les ressources de texte globales et par robot prennent en charge jusqu'à 1 000 000 de caractères.

Important :

1. Les requêtes $filter renvoient le résultat d'un filtre personnalisé qui utilise les paramètres Nom (Name) et Description dans une fonction contains.
2. Les demandes de ressources qui développent les valeurs du robot (GET "https://{yourDomain}/odata/Assets/UiPath.Server.Configuration.OData.GetFiltered?%24expand=UserValues") récupèrent d'abord UserValues, qu'elles transforment ensuite en RobotValues.

Récupération d'un actif spécifique

L'appel ci-dessous permet d'afficher toutes les informations disponibles de l'actif avec le nom DocAPITest et l'ID 455.

Obtenir

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

En-têtes de requête.

Clé (Key)	Valeur (Value)
Autorisation	Porteur

Codes de réponse

200 OK

Corps de la réponse

{
    "@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": ""
}

Récupération par actifs de Robot

Pour effectuer une requête GET vers le point de terminaison /odata/Assets/UiPath.Server.Configuration.OData.GetRobotAssetByRobotId(), vous devez fournir robotId et assetName dans l'URL. Notez que seul le nom d'utilisateur est renvoyé pour les actifs d'identifiants du Robot, comme vous le voyez dans l'exemple ci-dessous.

Obtenir

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

En-têtes de requête.

Clé (Key)	Valeur (Value)
Autorisation	Porteur

Codes de réponse

200 OK

Corps de la réponse

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

Ajout d'un actif

L'exemple suivant permet de créer un actif global, de type texte.

Publier

https://{yourDomain}/odata/Assets

En-têtes de requête.

Clé (Key)	Valeur (Value)
Autorisation	Porteur

Corps de la requête

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

Codes de réponse

200 OK

Corps de la réponse

{
    "@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": []
}