Métodos de conector de fila

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 10 min. de leitura

    • Os métodos do conector de Fila permitem criar e gerenciar itens de trabalho para filas no Central de APR.

    Pré-requisitos

    1. Atribua o processo de bot ao projeto de automação usando a opção Atribuir processo de bot na guia Design de Design studio de RPA para desktop para acessar os itens de trabalho. Para obter mais informações, consulte Atribuir processo de bot a um projeto de automação.
    2. Defina a propriedade QueueName seguindo estas etapas:
      1. Em Design studio de RPA para desktop, navegue até Caixa de ferramentas > Central de APR > Fila.
      2. Arraste o conector de Fila em Objetos Globais no Explorador de Projetos.
      3. Clique duas vezes no conector de Fila.
      4. No painel Propriedades, na propriedade QueueName, insira o nome da fila.
        Nota:
        O nome da Fila deve ser o mesmo definido em Central de APR.

    CreateJSONWorkItem

    Cria um item de trabalho para a fila no formato JSON.
    Entrada
    Nome
    Prioridade
    Saída
    WorkItemId
    IsNameExists
    Para criar os pares de chave-valor em um objeto JSON, execute as seguintes ações:
    1. Na barra de método CreateJSONWorkItem, clique no ícone de configurações de método ( ícone de configurações de método).
    2. Insira os critérios conforme fornecidos na tabela.
      Tabela 1. CRIAR CONFIGURAÇÃO DE ITEM
      Campo Descrição
      CONFIGURAÇÃO
      CAMPOS DE ENTRADA
      Tipo O tipo do item de trabalho.

      Por exemplo, para uma fila do sistema de contabilidade, poupança e atual são tipos de contas.

      Para configurar o campo de entrada, consulte Configurar propriedades da porta.
      Fase Atualiza a fase do item de trabalho.

      Campo personalizado para manter diferentes fases da transação.
      ANS Acordo de nível de serviço (ANS) da conclusão do item de trabalho.
      PROPRIEDADES JSON
      ANOTAÇÕES DE CAMINHO JSON
      Nome Par de chave-valor (conteúdo JSON) para o conteúdo da solicitação.
      Para adicionar uma chave, faça o seguinte:
      1. Clique no ícone Adicionar chave ( Ícone Adicionar chave.).
      2. Insira o nome da chave no campo.
      3. Para adicionar mais chaves, repita as etapas anteriores.
      4. Para passar o valor para esses campos, consulte Configurar propriedades da porta.
      Confidencial Conteúdo confidencial que é passado quando o item de trabalho é criado.

      Selecione esta opção como confidencial e os dados serão criptografados e armazenados no campo Conteúdo de solicitação confidencial no novo item de trabalho em Central de APR. Para obter mais informações sobre o formulário de item de trabalho, consulte Formulário de item de trabalho no Central de APR.

      Com essa funcionalidade, você pode passar informações confidenciais por meio de filas.

      Por exemplo, se você quiser que os dados do cliente sejam criptografados na fila, use o campo Confidencial para armazenar detalhes do cliente, como número do cartão de crédito, endereço e assim por diante.
    3. Clique em OK.

    CreateStringWorkItem

    Cria um item de trabalho em uma fila no Central de APR aceitando uma cadeia de caracteres.
    Entrada
    RequestContent
    Nome
    Saída
    WorkItemId
    IsNameExists

    Para especificar critérios adicionais para criar itens de trabalho de cadeia de caracteres, siga as etapas a seguir.

    1. Na barra de método CreateStringWorkItem, clique no ícone de configurações de método ( ícone de configurações de método).
    2. Insira os critérios conforme fornecidos na tabela.
      Tabela 2. CRIAR CONFIGURAÇÃO DE ITEM
      Campo Descrição
      CAMPOS DE ENTRADA
      SensitiveRequestContent Armazena conteúdo confidencial em formato criptografado no novo item de trabalho.

      Para configurar o campo de entrada, consulte Configurar propriedades da porta.

      Com essa funcionalidade, você pode passar informações confidenciais por meio de filas.

      Por exemplo, se você quiser que os dados do cliente sejam criptografados na fila, deverá usar o campo SensitiveRequestContent para armazenar detalhes do cliente, como número do cartão de crédito, endereço e assim por diante.
      Fase Atualiza a fase do item de trabalho.

      Campo personalizado para manter diferentes fases da transação.
      Tipo O tipo do item de trabalho.

      Por exemplo, para uma fila do sistema de contabilidade, poupança e atual são tipos de contas.

      Para configurar o campo de entrada, consulte Configurar propriedades da porta.
      ANS Acordo de nível de serviço (ANS) da conclusão do item de trabalho.
    3. Clique em OK.

    GetWorkItems

    Retorna a contagem e os detalhes dos itens de trabalho criados na fila com base nos critérios especificados. O método já fornece um critério padrão, mas você pode especificar critérios adicionais.

    Entrada
    Limite
    Saída
    TotalContagem

    Para especificar critérios adicionais para identificar e obter itens de trabalho, siga as etapas a seguir.

    1. Clique no ícone de configurações de método ( ícone de configurações de método).
    2. Configure os filtros, conforme necessário. Nenhum filtro é obrigatório.
      Tabela 3. CONFIGURAÇÃO DO ITEM DE TRABALHO
      Campo Descrição
      FILTROS DE ENTRADA
      Nome Nome do item de trabalho. Você pode especificar um dos seguintes filtros:
      • É igual a: o nome do item de trabalho é exatamente igual aos critérios especificados.
      • Contém: o nome do item de trabalho contém os caracteres especificados por você.
      • StartsWith: o nome do item de trabalho começa com os caracteres especificados.
      • Termina com: o nome do item de trabalho começa com os caracteres especificados.
      Tipo Tipo do item de trabalho no formato de cadeia de caracteres. Você pode especificar um dos seguintes filtros:
      • Igual a: o tipo de item de trabalho é exatamente igual aos critérios especificados.
      • Contém: o tipo de item de trabalho que contém caracteres especificados por você.
      • StartsWith: o tipo de item de trabalho começa com os caracteres especificados.
      • Termina com: o tipo de item de trabalho começa com os caracteres especificados.
      Status Status do item de trabalho.
      Fase Atualiza a fase do item de trabalho.

      Campo personalizado para manter diferentes fases da transação.
      Prioridade Prioridade de execução:
      • Crítico
      • Alto
      • Médio
      • Baixo(a)
      O robô atribuído executa o processo de bot de acordo com a prioridade definida na fila de trabalho. A prioridade padrão é sempre Alta.
      Tipo de data Tipo de data do item de trabalho. Se você fornecer entradas para este campo, também deverá fornecer entradas para os campos FromData e ToDate.
      FromDate Se o método estiver selecionando itens de trabalho dentro de um intervalo de datas, data de início no intervalo.
      Até o momento Se o método estiver selecionando itens de trabalho dentro de um intervalo de datas, data de término no intervalo.
      Deslocamento Número de itens de trabalho que serão recuperados após o limite definido. Por exemplo, se o limite for 20, o próximo item de trabalho selecionado começará em 21.
      CAMPOS DE SAÍDA
      Registros de saída Retorna os detalhes dos itens de trabalho em um formulário de objeto.
    3. Clique em OK.
      Nota:
      Uma porta de entrada de dados é criada com cada campo configurado.

    EscolherItemDeTrabalho

    Permite que um robô escolha um item de trabalho com base nos critérios fornecidos. Você também pode configurar critérios adicionais para o item de trabalho a ser selecionado.

    queryConditions incluídos no componente PickWorkItem são considerados para calcular o número de robôs necessários para concluir uma execução de processo de bot autônomo, se o processo de bot estiver habilitado com o pool de robôs. Para obter mais informações sobre como calcular o número de robôs, consulte Calcular o número de robôs em Central de APR. Para obter mais informações sobre conceitos de pool de robôs, consulte Pool de robôs em Central de APR.

    Entrada
    Prioridade
    Saída
    WorkItemId
    SolicitarConteúdo

    Para especificar critérios adicionais para selecionar itens de trabalho, siga as etapas a seguir.

    1. Clique no ícone de configurações de método ( ícone de configurações de método).
    2. Insira os critérios conforme fornecidos na tabela.
      Tabela 4. CONFIGURAÇÃO DE ESCOLHA DE ITEM
      Campo Descrição
      CONFIGURAÇÃO
      FILTROS DE ENTRADA
      Nome Nome do item de trabalho com base nos filtros a seguir.
      • É igual a: o nome do item de trabalho é exatamente igual aos critérios especificados.
      • Contém: o nome do item de trabalho contém os caracteres especificados por você.
      • StartsWith: o nome do item de trabalho começa com os caracteres especificados.
      • Termina com: o nome do item de trabalho começa com os caracteres especificados.

      A seleção expõe uma porta de entrada de dados.
      Tipo Tipo de item de trabalho com base nos filtros a seguir.
      • Igual a: o tipo de item de trabalho é exatamente igual aos critérios especificados.
      • Contém: o tipo de item de trabalho que contém caracteres especificados por você.
      • StartsWith: o tipo de item de trabalho começa com os caracteres especificados.
      • Termina com: o tipo de item de trabalho começa com os caracteres especificados.

      A seleção expõe uma porta de entrada de dados.
      Fase Fase do item de trabalho com base nos filtros a seguir.
      • Igual a: a fase do item de trabalho é exatamente igual aos critérios especificados.
      • Contém: a fase do item de trabalho contém os caracteres especificados por você.
      • StartsWith: a fase do item de trabalho começa com os caracteres especificados.
      • Termina com: a fase do item de trabalho começa com os caracteres especificados.

      A seleção expõe uma porta de entrada de dados.
      Status Status do item de trabalho para o robô selecionar.
      CAMPOS DE SAÍDA
      Nome Porta de saída de dados que retorna o nome do item de trabalho.
      Tipo Porta de saída de dados que retorna o tipo do item de trabalho.
      Observações Porta de saída de dados que retorna comentários sobre o item de trabalho.
      Fase Porta de saída de dados que retorna a fase do item de trabalho.
      SolicitarConteúdo Conteúdo de cadeia de caracteres para o item de trabalho. Seleciona o conteúdo armazenado quando o item de trabalho é criado.
      SensitiveRequestContent O conteúdo confidencial deste campo é selecionado, descriptografado e passado para o Design studio de RPA para desktop ou robôs.
      PROPRIEDADES JSON
      ANOTAÇÕES DE CAMINHO JSON Porta de saída de dados que retorna a notação de caminho JSON de um item de trabalho.

      Clique no ícone Adicionar chave ( Ícone Adicionar chave.) para adicionar um nome de chave.

      O JSON pode ser passado nos campos RequestContent e SensitiveRequestContent.

      Ao selecionar o item de trabalho, os dados JSON são selecionados de um item de trabalho. Por exemplo, se um par de chave-valor "Cidade: Mumbai" (Cidade é a chave e Mumbai é o valor) estiver no campo RequestContent e "Cidade: Délhi" (Cidade é a chave e Délhi é o valor) for criado no campo SensitiveRequestContent. Quando você tenta escolher o mesmo item de trabalho, já que a chave é a mesma para ambos os campos, o campo SensitiveRequestContent tem precedência e essa saída é recuperada desse campo.
    3. Clique em OK.

    ItemDeTrabalho da Versão

    Libera um item de trabalho que foi aceito e executado por um bot. Você deve executar o método PickWorkItem antes de executar este método.
    Entrada
    WorkItemId
    Saída
    Retornar

    AtualizarItemDeTrabalho

    Permite que um robô atualize um item de trabalho depois de selecioná-lo com o método PickWorkItem com base nos critérios especificados. Você pode configurar critérios adicionais para o item de trabalho a ser atualizado. Você deve executar o método PickWorkItem antes de executar este método.
    Entradas
    WorkItemId
    SolicitarConteúdo
    Modo da versão
    Prioridade
    Status
    Tipo de exceção

    Para especificar critérios adicionais para atualizar itens de trabalho, siga as etapas a seguir.

    1. Clique no ícone de configurações de método ( ícone de configurações de método).
    2. Insira os critérios conforme fornecidos na tabela.
      Tabela 5. ATUALIZAR CONFIGURAÇÃO DE ITEM
      Campo Descrição
      CONFIGURAÇÃO
      CAMPOS DE ENTRADA
      Fase Atualiza a fase do item de trabalho.

      Campo personalizado para manter diferentes fases da transação.
      Adiado até Opção para especificar um período de tempo durante o qual o mesmo item de trabalho não será selecionado. Por exemplo, 5 minutos.
      Nome Nome do item de trabalho.
      Tipo O tipo do item de trabalho.

      Por exemplo, para uma fila do sistema de contabilidade, poupança e atual são tipos de contas.

      Para configurar o campo de entrada, consulte Configurar propriedades da porta.
      Observações Comentários de apoio sobre o item de trabalho.
      ANS Acordo de nível de serviço (ANS) da conclusão do item de trabalho.
      Conteúdo da resposta Conteúdo de cadeia de caracteres para o item de trabalho. Atualiza o conteúdo armazenado de um item de trabalho.
      SensitiveRequestContent Atualiza o conteúdo confidencial de um item de trabalho.
      PROPRIEDADES JSON
      ANOTAÇÕES DE CAMINHO JSON
      Nome Par de chave-valor (conteúdo JSON) para o conteúdo da solicitação.
      Para adicionar uma chave, faça o seguinte:
      1. Clique no ícone Adicionar chave ( Ícone Adicionar chave.).
      2. Insira o nome da chave no campo.
      3. Para adicionar mais chaves, repita as etapas anteriores.
      4. Para passar o valor para esses campos, consulte Configurar propriedades da porta.
      Confidencial O conteúdo confidencial é atualizado para um item de trabalho.

      Com essa funcionalidade, você pode passar informações confidenciais por meio de filas.

      Por exemplo, se você quiser que os dados do cliente sejam criptografados na fila, use o campo Confidencial para armazenar detalhes do cliente, como número do cartão de crédito, endereço e assim por diante.

      Quando você adiciona um par de chave-valor "Cidade: Mumbai" no campo SensitiveRequestContent e adiciona outro par de chave-valor "País: Índia" na Notação de caminho JSON e o UpdateWorkItem é executado. Em seguida, no campo SensitiveRequestContent, a saída é combinada com "Cidade: Mumbai" e "País: Índia".