Adding Key Value Labels to Documents

Follow these steps to add a key value label to a document in Data Labeling. You add labels to annotate documents.

    1. In the Dataset Details page,
      • If Data records is selected, there are two ways to get to the Add labels page:
        • click the name of the document that you want to label.
        • click the action icon for the document that you want to label, and click Label.
      • If Gallery view is selected, click the name of the document you want to label.
    2. In the Add Labels page, the document is displayed with a bounding box around each of any recognized keys. You can’t add any bounding boxes.
      Note

      If OCR doesn’t return any output to label, a Retry dialog box is displayed. Click Retry to try running OCR again. If the retry fails, then the Retry failed dialog box is displayed and you have to click Go back to detail page to return to the Dataset Details page.
      There is functionality to help you pick out details in the record:
      • There are some icons that you can click to Zoom in, Zoom out, and Reset zoom to adjust the document size.
      • Click the Fit to screen icon to enlarge the document to fill the screen.
      • Click the Summary icon to display the Summary window, in which you can select from the list of labels to show the text labeled by the selected labels.
      • Click the Info icon, to display the Labeling instructions panel, which includes instructions from the Dataset creator in a resizeable and draggable panel.
      • The Info panel includes the text selected, the label added, and the confidence score from OCR.
      • There are forward and back arrows so you can move between the pages of the document.
      • Click Shortcuts to display a panel with the list of keystrokes to save you using the mouse to navigate this functionality and other actions on the screen.
      • Click Clear annotations to remove any labels from the document.
      • You can use multi color to display labeled words in different colors.
      • You can close, minimize, and move the panels that display all these functionalities to make it easier to label your images. The positions of these panels are cached in the browser. If you clear your browser's cache, or start using a different browser, they’re displayed in the default positions. After you use a browser, the panels display in the positions you left them the last time you used it.
      Note

      Any adjustments you make as to how the record is displayed, are just for display, and aren’t saved.
    3. Click a bounding box to select it to add a label.
    4. Under Label, select the correct label for the document.
    5. Repeat steps 3 and 4 until you’ve labeled all keys.
    6. (Optional) If you want to add the same label to more than one bounding box, you can highlight all those bounding boxes, and then select the label.
    7. Click Save & next to save your changes and label the next document, or click Save to save your change. If you don't want to label an item, click Skip to move to the next document. If you are at the last document, click Save & done to save your changes and return to the Dataset Details page.
      Note

      If you haven't used all the available labels before saving your selections, the Label confirmation dialog box is displayed asking you to confirm you want to save your changes.
    8. (Optional) Click Cancel to return to the Dataset Details page.
  • Use the dataset update command and required parameters to add a key value label to a document:
    oci data-labeling-service-dataplane record update [OPTIONS]
    For a complete list of flags and variable options for CLI commands, see the CLI Command Reference.
  • Run the UpdateRecord operation to add add a key value label to a document in Data Labeling.