Crowd-textract-analyze-document

Widget permettant la vérification humaine d'un résultat d'analyse de document Amazon Textract.

Attributs

Les attributs suivants sont pris en charge par cet élément.

header

Il s'agit du texte qui est affiché comme en-tête.

src

Il s'agit d'un lien vers l'image à analyser par le collaborateur.

InitialValue

Cet attribut définit les valeurs initiales des attributs trouvés dans l'UI du collaborateur.

Voici un exemple d'entrée initialValue :

[
            {
                "blockType": "KEY_VALUE_SET",
                "confidence": 38.43309020996094,
                "geometry": {
                    "boundingBox": {
                        "width": 0.32613086700439453,
                        "weight": 0.0942094624042511,
                        "left": 0.4833833575248718,
                        "top": 0.5227988958358765
                    },
                    "polygon": [
                        {"x": 0.123, "y": 0.345}, ...
                    ]
                }
                "id": "8c97b240-0969-4678-834a-646c95da9cf4",
                "relationships": [
                    {
                        "type": "CHILD",
                        "ids": [
                            "7ee7b7da-ee1b-428d-a567-55a3e3affa56",
                            "4d6da730-ba43-467c-a9a5-c6137ba0c472"
                        ]
                    },
                    {
                        "type": "VALUE",
                        "ids": [
                            "6ee7b7da-ee1b-428d-a567-55a3e3affa54"
                        ]
                    }
                ],
                "entityTypes": [
                    "KEY"
                ],
                "text": "Foo bar"
            },
]

Types de blocs

Cet attribut détermine le type d'analyse que les collaborateurs peuvent effectuer. KEY_VALUE_SET est le seul à être pris en charge.

clés

Cet attribut spécifie les nouvelles clés et la valeur de texte associée que le collaborateur peut ajouter. Les valeurs d'entrée pour keys peuvent inclure les éléments suivants :

• importantFormKey accepte les chaînes et est utilisé pour spécifier une seule clé.

• importantFormKeyAliases peut être utilisé pour spécifier des alias qui sont d'autres solutions acceptables aux clés fournies. Utilisez cet élément pour identifier d'autres orthographes ou présentations de vos clés. Ce paramètre accepte une liste d'une ou plusieurs chaînes.

Voici un exemple d'entrée pour keys.

[
      {
        importantFormKey: 'Address',
        importantFormKeyAliases: [
          'address',
          'Addr.',
          'Add.',
        ]
      },
      {
        importantFormKey: 'Last name',
        importantFormKeyAliases: ['Surname']
      }
]

no-key-edit

Cet attribut empêche les collaborateurs de modifier les clés des annotations qui sont passées par initialValue. Les employés ne peuvent alors pas modifier les clés détectées sur vos documents. C'est obligatoire.

no-geometry-edit

Cet attribut empêche les collaborateurs de modifier les polygones d'annotations qui sont passés par initialValue. Par exemple, cela empêche le collaborateur de modifier la bounding box autour d'une clé donnée. C'est obligatoire.

Hiérarchie des éléments

Les éléments parents et enfants de cet élément sont les suivants :

• Éléments parents - Crowd-form

• Éléments enfants – full-instructions, short-instructions

Régions

Les régions suivantes sont prises en charge par cet élément. Vous pouvez utiliser des codes HTML et CSS personnalisés dans ces régions pour formater vos instructions destinées aux collaborateurs. Par exemple, utilisez la section short-instructions pour fournir de bons et mauvais exemples sur la façon de finaliser une tâche.

full-instructions

Instructions générales sur la façon d'utiliser le widget.

short-instructions

Instructions importantes spécifiques à la tâche qui s'affichent à un endroit bien visible.

Exemple de modèle de travail à l'aide de l'élément de foule

Un exemple de modèle de travail utilisant l'élément Crowd ressemblerait à ceci :

<script src="https://assets.crowd.aws/crowd-html-elements.js"></script>
{% capture s3_uri %}http://s3.amazonaws.com/{{ task.input.aiServiceRequest.document.s3Object.bucket }}/{{ task.input.aiServiceRequest.document.s3Object.name }}{% endcapture %}

<crowd-form>
  <crowd-textract-analyze-document
    src="{{ s3_uri | grant_read_access }}"
    initial-value="{{ task.input.selectedAiServiceResponse.blocks }}"
    header="Review the key-value pairs listed on the right and correct them if they don't match the following document."
    no-key-edit
    no-geometry-edit
    keys="{{ task.input.humanLoopContext.importantFormKeys }}"
    block-types="['KEY_VALUE_SET']"
  >
    <short-instructions header="Instructions">
      <style>
        .instructions {
          white-space: pre-wrap;
        }
        .instructionsImage {
          display: inline-block;
          max-width: 100%;
        }
      </style>
      <p class='instructions'>Click on a key-value block to highlight the corresponding key-value pair in the document.

If it is a valid key-value pair, review the content for the value. If the content is incorrect, correct it.

The text of the value is incorrect, correct it.
<img class='instructionsImage' src="https://assets.crowd.aws/images/a2i-console/correct-value-text.png" />

A wrong value is identified, correct it.
<img class='instructionsImage' src="https://assets.crowd.aws/images/a2i-console/correct-value.png" />

If it is not a valid key-value relationship, choose No.
<img class='instructionsImage' src="https://assets.crowd.aws/images/a2i-console/not-a-key-value-pair.png" />

If you can’t find the key in the document, choose Key not found.
<img class='instructionsImage' src="https://assets.crowd.aws/images/a2i-console/key-is-not-found.png" />

If the content of a field is empty, choose Value is blank.
<img class='instructionsImage' src="https://assets.crowd.aws/images/a2i-console/value-is-blank.png" />

<b>Examples</b>
Key and value are often displayed next or below to each other.

Key and value displayed in one line.
<img class='instructionsImage' src="https://assets.crowd.aws/images/a2i-console/sample-key-value-pair-1.png" />

Key and value displayed in two lines.
<img class='instructionsImage' src="https://assets.crowd.aws/images/a2i-console/sample-key-value-pair-2.png" />

If the content of the value has multiple lines, enter all the text without line break. Include all value text even if it extends beyond the highlight box.
<img class='instructionsImage' src="https://assets.crowd.aws/images/a2i-console/multiple-lines.png" /></p>
    </short-instructions>

    <full-instructions header="Instructions"></full-instructions>
  </crowd-textract-analyze-document>
</crowd-form>

Sortie

L'exemple suivant est la sortie de cet élément. Vous trouverez une explication détaillée de cette sortie dans la documentation de l'API AnalyzeDocument Amazon Textract.

{
  "AWS/Textract/AnalyzeDocument/Forms/V1": {
    blocks: [
      {
        "blockType": "KEY_VALUE_SET",
        "id": "8c97b240-0969-4678-834a-646c95da9cf4",
        "relationships": [
          {
            "type": "CHILD",
            "ids": ["7ee7b7da-ee1b-428d-a567-55a3e3affa56", "4d6da730-ba43-467c-a9a5-c6137ba0c472"]
          },
          {
            "type": "VALUE",
            "ids": ["6ee7b7da-ee1b-428d-a567-55a3e3affa54"]
          }
        ],
        "entityTypes": ["KEY"],
        "text": "Foo bar baz"
      }
    ]
  }
}