Acessando serviços de plataforma

As funções do Python alcançam recursos do Orchestrator por meio do cliente UiPath(). As credenciais e as referências de recursos são resolvidas no runtime — nenhum segredo é armazenado em seu código ou enviado dentro do pacote.

from uipath.platform import UiPath

sdk = UiPath()

Ativos

Recupere um valor de ativo nomeado (por exemplo, um token de API ou URL base) de uma pasta:

asset = sdk.assets.retrieve("API_BASE_URL", folder_path="Shared")

Buckets

Faça o download e carregue arquivos de buckets de armazenamento do Orchestrator:

sdk.buckets.download(
    name="Invoices",
    blob_file_path="invoice.pdf",
    destination_path="/tmp/invoice.pdf",
    folder_path="Shared",
)

Conexões

Recupere os metadados de uma conexão do Integration Service por ID:

conn = sdk.connections.retrieve("connection-id")

Isso retorna o ID da conexão, o URI de base e a pasta. Ele não chama o conector. Para invocar uma operação de conector — o equivalente de uma atividade do Studio como Get Email By ID — consulte Chamar uma atividade do Integration Service.

O ID de conexão é um valor de tempo de design declarado como uma associação, não uma entrada de função. Consulte Ligações de recursos.

Outros Serviços

O cliente de plataforma também expõe filas, trabalhos, processos, documentos e entidades. Consulte a referênciauipath do SDK para obter as assinaturas completas de superfície e método.

Credenciais e segurança

• Os segredos residem em ativos do Orchestrator, recuperados no runtime — nunca codifique-os ou confirme-os para o projeto.
• Uma função é executada sob a identidade com a qual é invocada; O RBAC no nível da pasta rege quais ativos e recursos ele pode ler.
• As referências de recursos são declaradas em bindings.json e remapeadas para os recursos do tenant de destino no runtime; portanto, um pacote atende a todos os tenants.
• Uma associação não mapeada não gera falha no trabalho: a chamada retorna ao identificador de tempo de design, portanto, uma função implantada em outro lugar pode alcançar o recurso do tenant original.

Próximas Etapas

• Associações de recursos
• Rastreamento e observabilidade
• Empacotamento e publicação