Métodos de conector de fila

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 10 min. de leitura

    • Os métodos 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 Atribuir processo de bot . Design guia de Design studio de RPA para desktop para acessar os itens de trabalho. Para obter mais informações, consulte Atribua o processo de bot a um projeto de automação.
    2. Defina a propriedade QueueName executando as seguintes 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 igual ao definido em Central de APR.

    CreateJSONWorkItem

    Cria um item de trabalho para a fila no JSON formato.
    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, economia e corrente são tipos de contas.

      Para configurar o campo de entrada, consulte Configure as 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 Configure as propriedades da porta.
      Confidencial Conteúdo confidencial que é passado quando o item de trabalho é criado.

      Selecione esta opção como confidencial e, em seguida, os dados serão criptografados e armazenados no Conteúdo da solicitação confidencial campo 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 em Central de APR.

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

      Por exemplo, se você quiser que os dados do cliente sejam criptografados na fila, deverá usar Confidencial campo 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 ao aceitar uma cadeia de caracteres.
    Entrada
    SolicitContent
    Nome
    Saída
    WorkItemId
    IsNameExists

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

    1. Na barra 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 Configure as propriedades da porta.

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

      Por exemplo, se você quiser que os dados do cliente sejam criptografados na fila, deverá usar SensitiveRequestContent campo 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, economia e corrente são tipos de contas.

      Para configurar o campo de entrada, consulte Configure as 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
    TotalCount

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

    1. Clique no ícone 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 WORKITEM
      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 caracteres especificados.
      • IniciarCom : O nome do item de trabalho começa com os caracteres especificados.
      • EndCom : 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 do item de trabalho é exatamente igual aos critérios especificados.
      • Contém : O tipo do item de trabalho contém caracteres especificados.
      • IniciarCom : O tipo de item de trabalho começa com os caracteres especificados.
      • EndCom : 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 Alto .
      DateType Tipo de data do item de trabalho. Se você fornecer entradas para este campo, também deverá fornecer entradas para De Dados e. Até a data campos também.
      Data Se o método for escolher itens de trabalho dentro de um intervalo de datas, data de início no intervalo.
      Até a data Se o método for escolher 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
      OutRecords 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.

    SelecionoWorkItem

    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ídas no componente PickWorkItem são consideradas para calcular o número de robôs necessários para concluir o trabalho alocado, 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 . Para obter mais informações sobre conceitos de pool de robôs, consulte .

    Entrada
    Prioridade
    Saída
    WorkItemId
    SolicitContent

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

    1. Clique no ícone Configurações de método ( Ícone de configurações de método).
    2. Insira os critérios conforme fornecidos na tabela.
      Tabela 4. ESCOLHA A CONFIGURAÇÃO DO ITEM
      Campo Descrição
      CONFIGURAÇÃO
      FILTROS DE ENTRADA
      Nome Nome do item de trabalho com base nos 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 caracteres especificados.
      • IniciarCom : O nome do item de trabalho começa com os caracteres especificados.
      • EndCom : O nome do item de trabalho começa com os caracteres especificados.

      A seleção expõe dados na porta.
      Tipo Tipo do item de trabalho com base nos filtros a seguir.
      • Igual a : O tipo do item de trabalho é exatamente igual aos critérios especificados.
      • Contém : O tipo do item de trabalho contém caracteres especificados.
      • IniciarCom : O tipo de item de trabalho começa com os caracteres especificados.
      • EndCom : O tipo de item de trabalho começa com os caracteres especificados.

      A seleção expõe dados na porta.
      Fase Fase do item de trabalho 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 caracteres especificados.
      • IniciarCom : A fase do item de trabalho começa com os caracteres especificados.
      • EndCom : A fase do item de trabalho começa com os caracteres especificados.

      A seleção expõe dados na porta.
      Status Status do item de trabalho a ser selecionado pelo robô.
      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 observações sobre o item de trabalho.
      Fase Porta de saída de dados que retorna a fase do item de trabalho.
      SolicitContent Conteúdo da cadeia de caracteres do 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 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.

      JSON pode ser passado em ambos SolicitContent e. SensitiveRequestContent campos.

      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 é chave e Mumbai é valor) estiver em SolicitContent E "Cidade: Delhi" (Cidade é a chave e Deli é o valor) são criados em SensitiveRequestContent campo. Quando você tenta escolher o mesmo item de trabalho, já que a chave é a mesma para ambos os campos, o. SensitiveRequestContent o campo recebe precedência e essa saída é recuperada deste campo.
    3. Clique em OK.

    Release WorkItem

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

    AtualizarWorkItem

    Permite que um robô atualize um item de trabalho após selecioná-lo com o método Escolher WorkItem com base nos critérios especificados. Você pode configurar critérios adicionais para que o item de trabalho seja atualizado. Você deve executar o método PicWorkItem antes de executar este método.
    Entradas
    WorkItemId
    SolicitContent
    Release Mode
    Prioridade
    Status
    Tipo de exceção

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

    1. Clique no ícone Configurações de método ( Ícone de configurações de método).
    2. Insira os critérios conforme fornecidos na tabela.
      Tabela 5. ATUALIZAR A CONFIGURAÇÃO DO 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.
      Till Desferred Opção para especificar uma duração de tempo durante a 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, economia e corrente são tipos de contas.

      Para configurar o campo de entrada, consulte Configure as propriedades da porta.
      Observações Observações de suporte sobre o item de trabalho.
      ANS Acordo de nível de serviço (ANS) da conclusão do item de trabalho.
      ResponseContent Conteúdo da cadeia de caracteres do 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 Configure as propriedades da porta.
      Confidencial O conteúdo confidencial é atualizado para um item de trabalho.

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

      Por exemplo, se você quiser que os dados do cliente sejam criptografados na fila, deverá usar Confidencial campo 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" em SensitiveRequestContent E adicione outro par de chave-valor "País: India" na notação de caminho JSON e UpdateWorkItem será executado. Em seguida, em SensitiveRequestContent , a saída é combinada com "Cidade: Mumbai" e "País: India".