UiPath Documentation
functions
latest
false
Guia do usuário de funções
  • Visão geral
    • Sobre funções
    • Licenciamento
  • Funções do JavaScript
  • Funções do Python
  • Implantar e executar
Importante :
Este conteúdo foi traduzido com auxílio de tradução automática. A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.

Declarar uma vinculação de recurso

Declare um recurso do Orchestrator ou Integration Service em Bindings.json, verifique se ele é resolvido durante uma execução local e torne-o remapeável entre tenants.

bindings.json é mantido manualmente: uipath init cria o arquivo com a estrutura necessária quando ele está ausente e deixa um arquivo existente intacto. Declare uma associação para cada recurso de plataforma que sua função alcança, para que o recurso possa ser remapeado quando o pacote for executado em outro tenant. Para o mecanismo de resolução por trás disso, consulte Vinculações de recursos.

Pré-requisitos​

  • Um projeto de função do Python criado com uipath new.
  • Uma sessão autenticada, estabelecida com uipath auth.
  • O recurso já existe no tenant em que você desenvolve.
  • O UiPath CLI ()uip é instalado para a pesquisa de conexão na etapa 1.

Declarar uma associação de conexão​

  1. Recupere o ID de conexão do Integration Service:

    uip is connections list uipath-microsoft-outlook365
    uip is connections list uipath-microsoft-outlook365
    
  2. Abra bindings.json na raiz do projeto.

  3. Adicione uma entrada à matriz resources, usando o ID de conexão para key e ConnectionId.defaultValue:

    {
      "resource": "connection",
      "key": "<connection-id>",
      "value": {
        "ConnectionId": {
          "defaultValue": "<connection-id>",
          "isExpression": false,
          "displayName": "Microsoft Outlook 365 Connection"
        },
        "Connector": {
          "defaultValue": "uipath-microsoft-outlook365",
          "isExpression": false,
          "displayName": "Connector"
        }
      },
      "metadata": {
        "Connector": "uipath-microsoft-outlook365",
        "UseConnectionService": "True",
        "BindingsVersion": "2.2"
      }
    }
    {
      "resource": "connection",
      "key": "<connection-id>",
      "value": {
        "ConnectionId": {
          "defaultValue": "<connection-id>",
          "isExpression": false,
          "displayName": "Microsoft Outlook 365 Connection"
        },
        "Connector": {
          "defaultValue": "uipath-microsoft-outlook365",
          "isExpression": false,
          "displayName": "Connector"
        }
      },
      "metadata": {
        "Connector": "uipath-microsoft-outlook365",
        "UseConnectionService": "True",
        "BindingsVersion": "2.2"
      }
    }
    
  4. Declare o mesmo ID como uma constante de nível de módulo em sua função e passe-o para a chamada do SDK:

    OUTLOOK_CONNECTION_KEY = "<connection-id>"
    
    conn = sdk.connections.retrieve(OUTLOOK_CONNECTION_KEY)
    OUTLOOK_CONNECTION_KEY = "<connection-id>"
    
    conn = sdk.connections.retrieve(OUTLOOK_CONNECTION_KEY)
    
  5. Execute a função localmente:

    uipath run main -f input.json
    uipath run main -f input.json
    

Resultado​

O log de execução contém uma linha por associação declarada:

No resource overwrite matched for connection key='connection.<connection-id>' on retrieve
No resource overwrite matched for connection key='connection.<connection-id>' on retrieve

Esta linha confirma que a pesquisa de substituição foi executada e retornou ao ID do tempo de design, que é o resultado esperado localmente porque não existe nenhum mapeamento de tenant. Se a linha nomear um ID diferente daquele em bindings.json, a constante de código e a associação desalinhadas.

Observação:

A declaração de associações para outros tipos de recursos segue o mesmo padrão com um value formato diferente. Ativos, buckets, filas, processos, aplicativos e índices usam name e folderPath em vez de ConnectionId, e seu key une os dois com um ponto.

Tornar a associação remapeável entre tenants​

  1. Registre o projeto da função em uma solução:

    uip solution project add ./my-solution/my-function
    uip solution project add ./my-solution/my-function
    
  2. Sincronize a lista de recursos da solução a partir das associações declaradas do projeto:

    uip solution resource refresh
    uip solution resource refresh
    
  3. Revise a lista de recursos resultante:

    uip solution resource list --source local
    uip solution resource list --source local
    

Resultado​

Cada associação declarada aparece na lista de recursos locais da solução. A implantação mapeia cada entrada para um recurso no tenant de destino, para que o mesmo pacote seja executado na própria conexão desse tenant. Para empacotar e publicar a solução, consulte uip solution pack.

AVISO:

Uma associação que não é mapeada no tenant de destino não gera falha no trabalho. A chamada retorna ao identificador de tempo de design; portanto, verifique se cada associação aparece no mapeamento de recursos do tenant de destino antes de promover uma solução.

Próximas Etapas​

  • Pré-requisitos​
  • Declarar uma associação de conexão​
  • Resultado​
  • Tornar a associação remapeável entre tenants​
  • Resultado​
  • Próximas Etapas​

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte(opens in new window)

Quer aprender? Academia UiPath(opens in new window)

Tem perguntas? Fórum do UiPath(opens in new window)

Fique por dentro das novidades