Botão Relatar um problema técnico

Ferramenta de feedback de diagnóstico nas tarefas Validação de documentos e Classificação de documentos do Action Center, os dados que cada relatório envia, como os valores são anonimizados e quem pode acessá-los.

O botão Relatar um problema técnico é uma ferramenta de feedback de diagnóstico disponível em dois tipos de tarefas do Action Center, uma tarefa de Validação de Documentos ou uma tarefa de Classificação de Documentos, e em qualquer app que incorpore a mesma tela de validação ou classificação. Ele permite que um usuário relate um erro técnico, uma falha ou comportamento inesperado da tela que esteja bloqueando seu trabalho e o envie para a equipe de engenharia do UiPath Document Understanding sem sair da tela. Ela está disponível apenas no Automation Cloud e não aparece em tarefas de aplicativo codificadas.

Ambos os tipos de tarefas usam o mesmo botão e a mesma caixa de diálogo. Elas diferem apenas em um aspecto: os dados que cada uma pode anexar, porque a validação e a classificação produzem estruturas de dados diferentes. Tudo o mais nesta página se aplica a ambos.

Localizar o botão

O botão flutuante acima do documento e pode ser arrastado para qualquer posição, portanto, não precisa cobrir o conteúdo que está sendo revisado. Sua posição será lembrada para a próxima consulta.

Primeira visita

Na primeira visita de um usuário, uma chamada apresenta o botão e aponta que ele pode ser movido. Ignorar o texto explicativo com Obtê-lo impede que ele apareça novamente.

O que a caixa de diálogo contém

Selecionar o botão abre uma caixa de diálogo com três partes independentes: uma descrição do problema, um anexo de dados de diagnóstico opcional e uma reversão de versão opcional. Cada parte é explicada nas seções a seguir.

Descrevendo o problema

O que deu errado? contém uma descrição em texto livre do problema. É a única parte obrigatória da caixa de diálogo: até que contenha texto, Enviar relatório permanece indisponível. A caixa de diálogo está limitada a problemas técnicos, o que significa um erro, uma falha ou comportamento inesperado da tela que bloqueia o trabalho do usuário.

Este campo é enviado exatamente como é digitado. Ao contrário dos dados descritos na seção a seguir, eles não são ofuscados, com alias ou filtrados de qualquer forma.

AVISO:

Qualquer coisa digitada na descrição é transmitida textual. As descrições do problema e as etapas que levaram a ele são o que a equipe de engenharia precisa.

Envio dos resultados e da taxonomia

A caixa de seleção Dados é selecionada por padrão.

• Em uma tarefa de validação de documentos, Enviar o Resultado da Extração e Taxonomia: a taxonomia contém a lista de tipos de documentos, cada um com seus campos e tipos de campos. O resultado da extração são as informações que estão sendo validadas: quais campos foram encontrados, as pontuações de confiança e onde na página cada valor foi localizado.
• Em uma tarefa de classificação de documentos, Enviar o Resultado da Classificação e Taxonomia: a taxonomia contém a lista de tipos de documentos. O resultado da classificação são as informações que estão sendo validadas: a qual tipo de documento cada conjunto de páginas foi atribuído.

Em ambos os casos, o arquivo do documento em si nunca é capturado e nenhum texto lido dele é incluído. Ambas as estruturas refletem o estado quando a tela as carrega, portanto, alterações posteriores não são enviadas.

Quando Enviar relatório está selecionado, a tela recarrega a tarefa como estava quando foi aberta. Isso acontece sempre que a caixa de seleção Dados fica selecionada ou uma versão é escolhida em Experimentar uma versão anterior.

AVISO:

O recarregamento acontece sem um prompt de confirmação, e quaisquer valores alterados na tela, mas ainda não salvos, são perdidos. Salve o trabalho antes de relatar um problema.

Para obter exemplos de quais dados são coletados, consulte Exemplos dos dados que são enviados.

Tentando uma versão anterior

A caixa de seleção Experimentar uma versão anterior lista versões recentes da própria tela de validação ou classificação, o que ajuda quando um problema apareceu apenas após uma atualização recente. Cada entrada mostra a data de publicação da versão e o identificador de compilação.

Apenas essa tela muda. O Action Center, o aplicativo que hospeda a tela, a tarefa, o documento, a taxonomia e o resultado da extração ou classificação não são afetados, assim como outros usuários. A taxonomia e os resultados são lidos no runtime em vez de integrados na tela, portanto, uma versão anterior ainda carrega os mesmos dados que o fluxo de trabalho produziu, incluindo quaisquer tipos de documentos e campos adicionados desde que essa versão foi publicada. Apenas o código da própria tela é mais antigo.

A escolha se aplica a cada tarefa desse tipo para o usuário que a fez, no navegador em que a fez, e dura até 30 dias, após os quais a versão mais recente é restaurada automaticamente. Um usuário pode reabrir a caixa de diálogo a qualquer momento para escolher uma versão diferente ou selecionar Usar a versão mais recente para retornar para a mais recente.

Quais dados são enviados

Duas transmissões separadas estão envolvidas quando um relatório é enviado:

• O relatório em si é sempre enviado. Ele carrega a descrição em texto livre e qual opção de reversão foi escolhida, se houver.
• A taxonomia e o resultado da extração ou classificação são enviados apenas quando a caixa de seleção de dados permanece selecionada.

O relatório também contém: o ID do documento e o ID da tarefa do Action Center, que são identificadores gerados pela UiPath; o nome da organização e do tenant, região e versão de compilação, que identificam o ambiente; e um identificador de usuário anônimo.

Tarefas de validação de documentos

Dados	Enviado para a UiPath?	Detalhes
O arquivo do documento (PDF ou imagem)	Nunca
A descrição do problema em texto livre	Sim, textual	Não ofuscado ou filtrado
Valores extraídos dos campos Booleano, Data, Número, Conjunto e Quantidade Monetária	Sim, textual	Preservado porque esses tipos contêm valores estruturados em vez de texto livre
Valores extraídos de todos os outros tipos de campos, incluindo o texto lido do documento	Não	Anonimizado aleatoriamente
Nomes de campo, grupo, categoria e tipo de documento	Não	Substituída por alias sequenciais, por exemplo, f1, g1, dt1
Posições de valor, dimensões da página e pontuações de confiança	Sim	Elas descrevem apenas o layout, não o conteúdo do documento

Tarefas de classificação de documentos

Dados	Enviado para a UiPath?	Detalhes
O arquivo do documento (PDF ou imagem)	Nunca
A descrição do problema em texto livre	Sim, textual	Não ofuscado ou filtrado
Nomes de tipo de documento, grupo, categoria e campo	Não	Substituída por alias sequenciais, por exemplo dt1, g1, c1, f1
Intervalos de páginas e contagens de páginas	Sim	Preservado para que uma sessão relatada ainda corresponda ao documento
Caixas de palavras, dimensões de página e pontuações de confiança	Sim	Eles descrevem apenas o layout, não o conteúdo do documento, nem qualquer conteúdo de palavra.

O que nunca é coletado

Os seguintes nunca são capturados, gerados ou transmitidos por esta funcionalidade:

• Arquivos HTTP Arquivo (HA)
• Tráfego de rede da página ao redor
• Capturas de tela e gravações de tela
• O arquivo do documento, sua camada de texto ou as imagens da página
• Cookies, conteúdo de armazenamento do navegador ou credenciais

Exemplos dos dados enviados

A ofuscação acontece no navegador, antes que qualquer coisa seja transmitida. Três transformações são aplicadas:

• Os nomes se tornam alias. Grupos, categorias, tipos de documentos, campos e colunas de tabelas são substituídos por alias sequenciais, como g1, c1, dt1, f1 e col1. Os relacionamentos persistem, portanto, a engenharia ainda pode ver a forma de uma taxonomia, mas nenhum nome criado pelo cliente faz.
• Os valores são anonimizados aleatoriamente. Cada letra se torna uma letra aleatória e cada dígito um dígito aleatório, enquanto a pontuação, o espaçamento e o comprimento persistem, então uma ordem de compra mantida em um campo de texto, como PO-4471/A, torna-se algo como qm-8213/x. A substituição é aleatória em vez de um hash fixo; então, dois valores de substituição idênticos nunca produzem os mesmos.
• Os nomes das propriedades são reduzidas. Nomes longos têm alias para manter a carga pequena o suficiente para transmitir.

Nas tarefas de validação de documentos, os valores dos campos Número, Data, Booleano, Definir e Quantidade Monetária são transmitidos como estão, para que os dígitos dentro deles nunca sejam substituídos. Nas tarefas de classificação de documentos, os intervalos de páginas são mantidos como estão, para que uma sessão relatada ainda corresponda ao documento.

Dados da tarefa de validação de documento

Taxonomia

Um fragmento da taxonomia conforme existe no navegador:

{
  "DataContractVersion": "1.0.0",
  "DocumentTypes": [
    {
      "DocumentTypeId": "Finance.AccountsPayable.VATInvoice",
      "Group": "Finance",
      "Category": "AccountsPayable",
      "Name": "VAT Invoice",
      "Fields": [
        {
          "FieldId": "Finance.AccountsPayable.VATInvoice.VendorName",
          "FieldName": "Vendor Name",
          "Type": "Text"
        },
        {
          "FieldId": "Finance.AccountsPayable.VATInvoice.TotalAmount",
          "FieldName": "Total Amount",
          "Type": "MonetaryQuantity"
        }
      ]
    }
  ]
}

O mesmo fragmento em que é transmitido:

{
  "type": "taxonomy",
  "t": {
    "d": "1.0.0",
    "D": [
      {
        "i": "g1.c1.dt1",
        "g": "g1",
        "c": "c1",
        "n": "g1.c1.dt1",
        "F": [
          { "fi": "g1.c1.dt1.f1", "fn": "g1.c1.dt1.f1", "T": "txt" },
          { "fi": "g1.c1.dt1.f2", "fn": "g1.c1.dt1.f2", "T": "mq" }
        ]
      }
    ]
  },
  "i": { "DisplayMode": "compact" }
}

ExtractionResult

Um resultado de extração conforme existe no navegador:

{
  "DocumentId": "7f3c1e90-4a2b-4c8d-9e11-6b5a0d2f8c43",
  "ResultsVersion": 1,
  "ResultsDocument": {
    "Language": "eng",
    "DocumentGroup": "Finance",
    "DocumentCategory": "AccountsPayable",
    "DocumentTypeId": "Finance.AccountsPayable.VATInvoice",
    "DocumentTypeName": "VAT Invoice",
    "Fields": [
      {
        "FieldId": "Finance.AccountsPayable.VATInvoice.VendorName",
        "FieldName": "Vendor Name",
        "FieldType": "Text",
        "OperatorConfirmed": true,
        "Values": [
          {
            "Value": "ACME Corporation Ltd",
            "Confidence": 0.987,
            "OcrConfidence": 0.994,
            "DataSource": "Extraction",
            "Reference": {
              "Tokens": [
                { "Page": 0, "PageWidth": 612, "PageHeight": 792, "Boxes": [[72.4, 118.9, 143.2, 12.7]] }
              ]
            }
          }
        ]
      },
      {
        "FieldId": "Finance.AccountsPayable.VATInvoice.TotalAmount",
        "FieldName": "Total Amount",
        "FieldType": "MonetaryQuantity",
        "Values": [
          { "Value": "1416.00", "Confidence": 0.912, "DataSource": "Extraction" }
        ]
      }
    ]
  }
}

O mesmo resultado que é transmitido:

{
  "type": "extraction",
  "e": {
    "d": "4b9f7a21-8c6e-1d3f-5a44-2e8b9c1f0d76",
    "rv": 1,
    "rd": {
      "l": "eng",
      "g": "g1",
      "c": "c1",
      "i": "g1.c1.dt1",
      "n": "g1.c1.dt1",
      "F": [
        {
          "fi": "g1.c1.dt1.f1",
          "fn": "g1.c1.dt1.f1",
          "ft": "txt",
          "o": true,
          "V": [
            {
              "va": "xqmp lwzkqmpxrjd vbn",
              "cf": 0.987,
              "oc": 0.994,
              "ds": "ext",
              "r": { "tk": [ { "p": 0, "pw": 612, "ph": 792, "bx": [[72, 119, 143, 13]] } ] }
            }
          ]
        },
        {
          "fi": "g1.c1.dt1.f2",
          "fn": "g1.c1.dt1.f2",
          "ft": "mq",
          "V": [ { "va": "1416.00", "cf": 0.912, "ds": "ext" } ]
        }
      ]
    }
  }
}

Dados da tarefa de classificação de documentos

Tipos de Documento

Um tipo de documento conforme ele existe no navegador:

{
  "DataContractVersion": "1.0.0",
  "DocumentTypes": [
    {
      "DocumentTypeId": "Finance.AccountsPayable.VATInvoice",
      "Group": "Finance",
      "Category": "AccountsPayable",
      "Name": "VAT Invoice",
      "Fields": [
        {
          "FieldId": "Finance.AccountsPayable.VATInvoice.VendorName",
          "FieldName": "Vendor Name",
          "Type": "Text"
        }
      ]
    }
  ]
}

O mesmo tipo de documento em que é transmitido:

{
  "type": "cs-taxonomy",
  "t": {
    "d": "1.0.0",
    "D": [
      {
        "i": "g1.c1.dt1",
        "g": "g1",
        "c": "c1",
        "n": "g1.c1.dt1",
        "F": [
          { "fi": "g1.c1.dt1.f1", "fn": "g1.c1.dt1.f1", "T": "txt" }
        ]
      }
    ]
  },
  "i": { "EnablePageReordering": true }
}

Resultado de Classificação

Um resultado de classificação conforme existe no navegador:

{
  "Classifications": [
    {
      "DocumentId": "7f3c1e90-4a2b-4c8d-9e11-6b5a0d2f8c43",
      "DocumentTypeId": "Finance.AccountsPayable.VATInvoice",
      "ClassifierName": "Invoice-Classifier-2",
      "Confidence": 0.964,
      "OcrConfidence": 0.991,
      "DocumentBounds": {
        "StartPage": 0,
        "PageCount": 3,
        "PageRange": "1-3"
      },
      "Reference": {
        "TextStartIndex": 0,
        "TextLength": 4821,
        "Tokens": [
          { "Page": 0, "PageWidth": 612, "PageHeight": 792, "Boxes": [[72.4, 118.9, 143.2, 12.7]] }
        ]
      }
    }
  ]
}

O mesmo resultado que é transmitido:

{
  "type": "classification",
  "c": {
    "K": [
      {
        "d": "4b9f7a21-8c6e-1d3f-5a44-2e8b9c1f0d76",
        "i": "g1.c1.dt1",
        "cn": "wmqpjxk-Kqzmwpxjmb-7",
        "cf": 0.964,
        "oc": 0.991,
        "b": {
          "sp": 0,
          "pc": 3,
          "pr": "1-3"
        },
        "r": {
          "ti": 0,
          "tl": 4821,
          "tk": [
            { "p": 0, "pw": 612, "ph": 792, "bx": [[72, 119, 143, 13]] }
          ]
        }
      }
    ]
  }
}

Quem pode acessar esses dados

Os relatórios chegam à equipe de engenharia do UiPath Document Understanding e são usados apenas para diagnosticar e corrigir problemas técnicos. Os relatórios nunca são compartilhados com outras pessoas.

O identificador anexado a um relatório não contém nome, endereço de e-mail e nenhum outro detalhe de contato. A equipe de engenharia não pode diferenciar um relatório de quem o enviou, a funcionalidade não fornece nenhum canal por meio do qual qualquer pessoa na UiPath possa entrar em contato com essa pessoa e os relatórios não são respondidos individualmente.

Disponibilidade e desativação da funcionalidade

A disponibilidade do botão é controlada exclusivamente pela equipe de engenharia do UiPath Document Understanding. Não há nenhuma maneira de autoatendimento para desabilitá-la, e alterar sua disponibilidade para uma organização requer uma solicitação para a UiPath.

Informações relacionadas

• Create Document Validation Action
• Create Document Classification Action
• Atividades do Document Understanding
• Informações legais