Leia e revise a documentação do Automation Anywhere

Automation Anywhere Automation 360

Fechar conteúdo

Contents (Conteúdo)

Abrir conteúdo

Criar uma nova função

  • Atualizado: 5/07/2020
    • Automation 360 v.x
    • Gerenciar
    • Espaço de trabalho RPA
    • Documentos de API

Criar uma nova função

Use a API Criar função para criar uma nova função com permissões na Control Room.

Pré-requisitos

Cada permissão requer os seguintes parâmetros:
  • id: O valor numérico que identifica exclusivamente a permissão.
  • ação: A ação que a permissão habilita.
  • Tipo de recurso: O grupo de recursos ao qual a ação pertence.
Todos os 3 parâmetros são necessários para criar a permissão.
Você precisa de permissão administrativa limitada para criar funções.
Exibir funções
Exibir funções de usuário.
Gerenciar funções
Criar e gerenciar funções de usuário
Normalmente, um usuário recebe a permissão de função em conjunto com a permissão de gerenciamento de usuários. Funções e permissões
  • URL: http://<your_control_room_url>/v1/usermanagement/roles

    Substitua o conteúdo entre colchetes pela URL da sua Control Room.

  • Método: POST
  • Use os arquivos de definição Swagger instalados com a Control Room para testar as APIs. Veja as APIs do Swagger disponíveis em: http://<your_control_room_url>/swagger/.
  • Você também pode usar um client REST para concluir esta tarefa.

Procedimento

  1. Adicione um token de autenticação ao cabeçalho da solicitação.
    Use a API de autenticação para gerar um JSON Web Token. Ver API de autenticação.
  2. Selecione POST como método.
    POST http://<your_control_room_url>/v1/usermanagement/roles
  3. No corpo da solicitação, insira um novo nome para a função.
  4. Envie a solicitação.

    A solicitação a seguir cria uma nova função que permite que um usuário crie e gerencie funções e usuários em sua Control Room.

    Corpo da solicitação:
    {
      "name": "Role to manage users and roles",
      "description": "These are limited administrator permission.",
      "permissions": [
        {
          "id": 1,
          "action": "usermanagement",
          "resourceType": "usermanagement"
        },
        {
          "id": 3,
          "action": "createuser",
          "resourceType": "usermanagement"
        },
        {
          "id": 4,
          "action": "updateuser",
          "resourceType": "usermanagement"
        },
        {
          "id": 2,
          "action": "deleteuser",
          "resourceType": "usermanagement"
        },
        {
          "id": 62,
          "action": "rolesview",
          "resourceType": "rolesmanagement"
        },
        {
          "id": 12,
          "action": "rolesmanagement",
          "resourceType": "rolesmanagement"
        }
      ]
    }
  5. Envie a solicitação.
    • No Swagger, clique em Executar.
    • Em um client REST, clique em ENVIAR.
    Corpo da resposta:
    {
      "id": 767,
      "createdBy": 3215,
      "createdOn": "2020-03-19T22:44:21Z",
      "updatedBy": 3215,
      "updatedOn": "2020-03-19T22:44:21Z",
      "tenantId": 1,
      "version": 0,
      "tenantUuid": "e100fbce-008c-04ec-4063-7af0af91fb2f",
      "description": "These are limited administrator permission.",
      "name": "Role to manage users and roles",
      "accessRestriction": null,
      "permissions": [
        {
          "id": 1,
          "createdBy": 0,
          "createdOn": "2019-05-21T03:09:31Z",
          "updatedBy": 0,
          "updatedOn": "2019-05-21T03:09:31Z",
          "tenantId": 1,
          "version": 0,
          "tenantUuid": "e100fbce-008c-04ec-4063-7af0af91fb2f",
          "action": "usermanagement",
          "resourceId": null,
          "resourceType": "usermanagement"
        },
        {
          "id": 2,
          "createdBy": 0,
          "createdOn": "2019-05-21T03:09:31Z",
          "updatedBy": 0,
          "updatedOn": "2019-05-21T03:09:31Z",
          "tenantId": 1,
          "version": 0,
          "tenantUuid": "e100fbce-008c-04ec-4063-7af0af91fb2f",
          "action": "deleteuser",
          "resourceId": null,
          "resourceType": "usermanagement"
        },
        {
          "id": 4,
          "createdBy": 0,
          "createdOn": "2019-05-21T03:09:31Z",
          "updatedBy": 0,
          "updatedOn": "2019-05-21T03:09:31Z",
          "tenantId": 1,
          "version": 0,
          "tenantUuid": "e100fbce-008c-04ec-4063-7af0af91fb2f",
          "action": "updateuser",
          "resourceId": null,
          "resourceType": "usermanagement"
        },
        {
          "id": 12,
          "createdBy": 0,
          "createdOn": "2019-05-21T03:09:31Z",
          "updatedBy": 0,
          "updatedOn": "2019-05-21T03:09:31Z",
          "tenantId": 1,
          "version": 0,
          "tenantUuid": "e100fbce-008c-04ec-4063-7af0af91fb2f",
          "action": "rolesmanagement",
          "resourceId": null,
          "resourceType": "rolesmanagement"
        },
        {
          "id": 62,
          "createdBy": 0,
          "createdOn": "2019-05-21T03:09:31Z",
          "updatedBy": 0,
          "updatedOn": "2019-05-21T03:09:31Z",
          "tenantId": 1,
          "version": 0,
          "tenantUuid": "e100fbce-008c-04ec-4063-7af0af91fb2f",
          "action": "rolesview",
          "resourceId": null,
          "resourceType": "rolesmanagement"
        },
        {
          "id": 3,
          "createdBy": 0,
          "createdOn": "2019-05-21T03:09:31Z",
          "updatedBy": 0,
          "updatedOn": "2019-05-21T03:09:31Z",
          "tenantId": 1,
          "version": 0,
          "tenantUuid": "e100fbce-008c-04ec-4063-7af0af91fb2f",
          "action": "createuser",
          "resourceId": null,
          "resourceType": "usermanagement"
        }
      ],
      "countPrincipals": 0,
      "principals": []
    }
Nota: Você também pode executar solicitações REST a partir de um terminal de comando. A seguir, um exemplo de solicitação curl. Este exemplo está formatado para facilitar a leitura. Substitua o texto entre colchetes, <authentication_token>, pelo seu token de autenticação. Este exemplo foi formatado para facilitar a leitura.
curl -X POST "https://<your_control_room_url>/v1/usermanagement/roles" 
-H "accept: application/json" 
-H "X-Authorization: <token>" 
-H "Content-Type: application/json" -d "{ "name": "Role to manage user and roles", 
"description": "These are limited administrator permission.", 
"permissions": [ {
  "name": "Role to manage users and roles",
  "description": "These are limited administrator permission.",
  "permissions": [
    {
      "id": 1,
      "action": "usermanagement",
      "resourceType": "usermanagement"
    },
    {
      "id": 3,
      "action": "createuser",
      "resourceType": "usermanagement"
    },
    {
      "id": 4,
      "action": "updateuser",
      "resourceType": "usermanagement"
    },
    {
      "id": 2,
      "action": "deleteuser",
      "resourceType": "usermanagement"
    },
    {
      "id": 62,
      "action": "rolesview",
      "resourceType": "rolesmanagement"
    },
    {
      "id": 12,
      "action": "rolesmanagement",
      "resourceType": "rolesmanagement"
    }
  ]
} 
]
}"
Send Feedback (Enviar Feedback)