Projetando automações

Esta página fornece uma visão geral da experiência de design ao criar projetos com base na compatibilidade de projetos selecionada.

Projetos do Windows

A experiência de design difere dependendo das atividades que você usa em seu projeto. Algumas atividades usam a experiência de design disponível em projetos multiplataforma (por exemplo, testes, atividades de automação de TI e algumas atividades do sistema) e outras atividades usam a experiência de design disponível em Projetos do Windows - Legado (por exemplo, atividades do UIAutomation, Mail e Excel).

Projetos multiplataforma

Em projetos multiplataforma e para algumas atividades em projetos com compatibilidade com o Windows, vários editores e construtores estão disponíveis para diferentes tipos de dados. Se a configuração de design Mostrar propriedades da atividade embutidas estiver habilitada, todas as propriedades da atividade estão disponíveis nos cartões de atividade no painel Designer. Por padrão, apenas as propriedades principais ficam visíveis e, se uma atividade tiver propriedades adicionais, você poderá configurá-las selecionando Mostrar opções avançadas. Se a configuração de design Gerar saídas de atividades automaticamente estiver habilitada, o Studio gerará automaticamente variáveis para saídas de atividades. Para saber mais, consulte Gerenciamento de variáveis.

Editores e construtores

Controles de entrada, editores e construtores dedicados estão disponíveis para os tipos de dados mais comuns, para ajudá-lo a configurar atividades sem digitar expressões. Dependendo do tipo de dados, você pode configurar propriedades de atividades diretamente a partir do cartão de atividades no painel do Designer ou abrindo um editor ou construtor em uma janela separada. No perfil do StudioX, o editor ou construtor dedicado é a maneira padrão de configurar uma propriedade, enquanto no perfil do Studio, dependendo do tipo de dados, o padrão é digitar uma expressão na linguagem do projeto (VB ou C#). Verifique o texto do espaço reservado em campos de atividades para obter dicas sobre como configurá-los.

Para alterar a forma como você configura uma propriedade, clique no botão Plus no lado direito da maioria das propriedades de atividades para abrir um menu contendo opções disponíveis para essa propriedade. Você pode selecionar o editor para o tipo de dados, abrir o editor avançado para expressões, selecionar uma variável ou limpar o valor existente.

Por exemplo, quando a entrada para uma propriedade de string está definida como expressões, você pode:

• Digite uma expressão diretamente na propriedade da atividade.
• Clique em para abrir o Expression Editor avançado.
• Selecione > Redefinir para o Construtor de texto para inserir texto diretamente na propriedade da atividade.
• Selecione > Abrir o Construtor de texto para abrir o Construtor de texto avançado.

• Selecione > Usar variável para selecionar uma variável.

  
  

  

  
  

A janela de seleção de variáveis exibe todas as variáveis, argumentos e constantes do projeto, bem como propriedades específicas para cada tipo de dados. A janela pode ser acessada selecionando > Usar variável próximo a um campo de atividade de entrada ou de dentro de outros editores e construtores (como o Text Builder).

Dentro da janela de seleção de variáveis, você pode navegar até a propriedade desejada ou usar a barra de pesquisa para encontrá-la. Um ícone ao lado de cada propriedade indica o tipo (por exemplo, Tt para strings ou 123 para tipos numéricos).

As variáveis que são geradas automaticamente pelo Studio para saídas de atividades são exibidas na atividade na qual foram geradas.

As seções a seguir descrevem alguns dos seletores, editores e construtores disponíveis.

Editor de Expressão

O Expression Editor está disponível para a maioria das propriedades de atividades. Ele inclui a conclusão de código inteligente para variáveis, argumentos, métodos, propriedades, classes, namespaces, constantes ou palavras-chave. As expressões podem ser gravadas em linhas de múltiplos. Você pode criar variáveis ou argumentos usando os atalhos Ctrl + K e Ctrl + M, respectivamente. Dentro do editor, use a combinação das teclas Ctrl + F para abrir a pesquisa e substituir recursos. Botões dedicados permitem que você desfaça ou refaça alterações feitas em suas expressões.

Gerar expressões com o Autopilot™

Você também pode usar a linguagem natural para descrever uma expressão usando recursos de IA generativa do Autopilot™. Em vez de escrever manualmente uma expressão no Editor de expressão, você pode usar o campo gerar expressão para descrever a ação desejada (por exemplo, “Extrair a receita total do relatório de vendas”).

O modelo de IA criará uma expressão com base na descrição fornecida, que será exibida no Editor de Expressão. Você pode então modificar a expressão gerada ou aceitá-la como está. O modelo de IA aprende continuamente com as descrições que você envia, permitindo que ele refine e melhore seu desempenho ao longo do tempo. O modelo também é capaz de usar variáveis e argumentos definidos pelo usuário e reconhece qualquer expressão já utilizada.

Se uma expressão for inválida, você pode selecionar o botão Corrigir, e o Autopilot tentará corrigir a incompatibilidade e fornecer uma expressão válida. Se uma descrição não for válida, um ícone de erro informará você para ajustar suas instruções e tentar novamente.

Construtor de Texto

Componha texto simples com suporte para inserir texto em várias linhas. Para adicionar uma variável ou argumento ao texto, selecione-o na menu suspenso Usar variáveis acima da caixa de texto. Clique em Salvar para salvar o texto. Disponível para propriedades que aceitam entrada de string.

Seletor de data e hora

Selecione uma data no calendário e uma hora do dia (hora e minuto, antes ou depois do meio-dia). Você pode digitar valores ou usar as setas para cima e para baixo para aumentar e diminuir o valor do seletor de hora. Disponível para propriedades que aceitam valores do DateTime. Exemplos de atividades onde estiverem disponíveis: Modificar data.

Editor de duração

Especifique uma duração em horas, minutos, segundos e milissegundos. Você pode digitar valores ou usar as setas para cima e para baixo para aumentá-los e diminuí-los. Disponível para propriedades que aceitam valores do TimeSpan. Exemplos de atividades onde estiverem disponíveis: Atraso.

Navegador de armazenamento em nuvem

Navegue por pastas e caixas de correio de armazenamento na nuvem a partir de aplicativos online e selecione itens a serem usados no projeto. Exemplos de atividades onde estiverem disponíveis: atividades que processam e-mails, arquivos e pastas do Office 365 e do Google Workspace.

Seletor de conexões

Quando você adiciona uma atividade que interage com um aplicativo online usando um conector do Integration Service, você deve selecionar a conexão para a conta a ser usada nessa atividade. Dependendo de as conexões já estarem configuradas ou não no Integration Service para o conector, uma das seguintes opções pode ocorrer:

• Não existe nenhuma conexão - O texto Adicionar nova conexão é exibido na atividade. No menu suspenso Conexão, selecione Adicionar nova conexão para iniciar o processo de autenticação e habilitar as permissões necessárias. Para obter mais informações, consulte a documentação do Integration Service para o conector que você deseja usar.
• Já existem conexões - Selecione uma conexão no menu suspenso Conexão na atividade. A conexão que é definida como padrão é selecionada automaticamente. Para adicionar uma nova conexão, selecione Adicionar nova conexão no menu suspenso.

• Uma conexão é selecionada, mas é inválida - Se uma conexão for selecionada, mas você não puder configurar as outras propriedades na atividade, isso indica que a conexão está interrompida. No menu suspenso Conexão, selecione Gerenciar conexões para ir para o Integration Service e corrigir a conexão.

  
  

  

  
  

Construtor de condição

Defina uma declaração verdadeira ou falsa que uma atividade avalia para determinar como a automação deve continuar. Exemplos de atividades onde estiverem disponíveis: If e While.

Para construir uma condição:

1. Selecione um primeiro valor a ser comparado no campo à esquerda, como por exemplo, uma variável de seu projeto.
2. Selecione um operador no menu suspenso no meio para usar para comparar o primeiro valor. Existem vários operadores que você pode escolher, dependendo do tipo de dados. Vários operadores estão disponíveis: greater than, greater than or equal, less than, less than or equal, equal to, not equal to, is empty, is not empty, is true, is false, starts with, ends with, contains, is numeric, is not numeric.

3. Para alguns operadores, você também deve selecionar no campo à direita um segundo valor com o qual comparar o primeiro valor.

   
   

   

   
   

Para criar uma instrução com várias condições, clique em Adicionar no Condition Builder e forneça as mesmas informações para cada instrução adicional. Quando você adiciona várias instruções, um menu suspenso aparece no topo da janela onde você deve selecionar quando a instrução é verdadeira: selecione All (AND) se a instrução for verdadeira quando todas as condições forem atendidas ou Any (OR) se as instruções forem verdadeiras quando qualquer uma das condições forem atendidas.

Construtor de Coleção

Crie uma coleção de itens do mesmo tipo. Exemplos de atividades onde estiverem disponíveis: Build collection, Append item to collection, Upload files.

Para construir uma coleção, selecione o item e, então, selecione Adicionar entrada para cada entrada que você deseja adicionar.

Construtor de dicionário

Crie uma coleção de pares de chave-valor, onde cada chave é única. Exemplo de atividades onde estiverem disponíveis: Add Log Field.

Para construir um dicionário, selecione a chave, o tipo e o valor e, então, selecione Adicionar entrada para cada entrada que você deseja adicionar.

Construtor de filtros

Crie um filtro complexo com uma ou mais condições. Exemplos de atividades onde estiverem disponíveis: atividades For Each Email.

Para construir um filtro:

1. Selecione o item para filtrar no campo à esquerda. Por exemplo, ao filtrar e-mails, você pode selecionar um campo de e-mail como De ou Corpo.
2. Selecione um operador no menu suspenso no meio para usar para comparar o item. Existem vários operadores que você pode escolher, dependendo do tipo de dados. Por exemplo, ao filtrar e-mails por remetente, você pode selecionar o operador contém ou não contém para o campo De.

3. Selecione no campo à direita o valor com o qual comparar o item selecionado.

   
   

   

   
   

Adição de um gatilho

Você pode configurar como sua automação será executada adicionando um gatilho no tempo do design. Você pode adicionar uma atividade de gatilho por arquivo de fluxo de trabalho como a primeira atividade no fluxo de trabalho. Uma atividade de gatilho só pode ser adicionada no fluxo de trabalho principal ou em fluxos de trabalho marcados como pontos de entrada. Se o arquivo do fluxo de trabalho principal contém um gatilho, você só pode definir outro arquivo como principal se ele também contiver um gatilho.

Os seguintes tipos de gatilhos estão disponíveis:

• Gatilho manual - A automação é executada quando você o aciona manualmente a partir do Orchestrator ou do Assistant.
• Gatilho de tempo - a automação é executada em horários especificados de acordo com uma programação (requer um Unattended Robot).
• Gatilho de evento - a automação é executada quando ocorre um evento especificado (requer um Unattended Robot). Por exemplo, você pode configurar a automação para começar quando um novo item é adicionado a uma fila do Orchestrator.

Após publicar o projeto, você pode gerenciar o gatilho a partir do Orchestrator.

Projetos do Windows - Legado

Em projetos do Windows - Legado e para algumas atividades em projetos com a compatibilidade com o Windows, você configura atividades digitando expressões na linguagem do projeto (VB ou C#), seja no Designer ou no painel Propriedades. Quando você passa o mouse sobre um campo da atividade, um botão Plus é exibido no lado direito do campo. Clicar nesse botão abre um menu com opções que habilitam você a configurar a atividade:

• Para os seguintes tipos de atividades, navegue no recurso associado e selecione dados que correspondam ao tipo da propriedade diretamente a partir desse menu sem ter que digitar expressões:

  • Automação do Excel - Se a Modern Excel Design Experience estiver habilitada, nas atividades filhas da atividade Use Excel File, você pode:

    • Selecione células, intervalos, tabelas, planilhas ou gráficos a partir da planilha de trabalho. Você também pode indicar a linha atual ou a planilha atual em uma iteração.
    • Entrada baseada em referências de células e intervalos, tabela, gráfico ou nomes de planilhas usando a opção Entrada personalizada.
    • Alterne para o Excel para indicar dados diretamente a partir do arquivo usando a opção Indicar no Excel . Essa funcionalidade requer que o Excel Add-in esteja instalado.
  • Automação do PowerPoint - Em atividades filhas da atividade Use PowerPoint Presentation, selecione slides, formas ou layouts a partir do arquivo do PowerPoint.
  • Automação de e-mail - Nas atividades filhas das atividades Use Outlook 365, Use Gmail e Use Desktop Outlook App, selecione dados de e-mails como pastas do Outlook, rótulos do Gmail, o e-mail atual em uma iteração ou campos de mensagens específicos a partir da conta de e-mail.
• Abrir no Advanced Editor - Abra o Expression Editor.
• Criar variável - Crie uma variável.
• Limpar valor - Limpe um valor existente.

• Escolher duração - Selecione um tempo (hora, minuto). Essa opção está disponível para atividades que aceitam valores do TimeSpan como entrada.