Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

Design the input and output fields that must be used in project tasks and configure the labeling application interface.

Understanding Project Task Design and Project Fields

Taskmonk offers pre-configured UI and customization controls that simplify labeling UI design. Project design, however, refers to the finalization of the input and output fields that must be included in the project. These are also the fields that must appear in the input files and in the output data.

Understanding Project Field Types in Taskmonk

Taskmonk offers a range of field types that enable you to easily control how Taskmonk handles specific kinds of data.

Click to view a tabulated description of the various field types available in Taskmonk.

 Field Types in Taskmonk

Field Type

Description

Implications of Using this Data Type in Taskmonk

Text

String data

 

Domain

The URL of a domain.

 

DropDown

Contains a list of values separated by commas.

Taskmonk allows the user to select only one option from the list of values, which is displayed as a drop-down list.

MultiSelect DropDown

Contains a list of values separated by commas.

Taskmonk allows the user to select only multiple options from the list of values, which is displayed as a series of check boxes or a drop-down, depending on how the output field is configured..

Date

Date value.

 

Radio

Contains a list of values separated by commas.

Taskmonk allows the user to select only one option from the list of values, which is displayed as a series of radio buttons.

LinkedField(Parent)

Contains a list of values separated by commas. Each of these values can have associated list of values (LoVs).

Taskmonk uses data of this data type to create drop-down lists where, once a user makes a selection, associated child LoVs appear in a separate drop-down list.

LinkedField(Child)

Contains a list of values separated by commas. Each of these lists is a child list associated with a parent linked field.

Taskmonk associates data of this data type to a parent linked field, and when that parent linked field is selected, the associated child LoVs appear in a separate drop-down list.

InputLinked

Use this field type when you want the labeler to select one option from a set of possibilities for a specific attribute.

If a pencil manufacturing company decides to package a sharpener or eraser with every box of pencils, the labeler should have a field labeled “Free Gift” and select “Sharpener” or “Eraser” from the list of options available. For step-by-step details on creating input-linked fields, see Creating Input-linked fields.

Notes

Contains paragraph text that is associated with the item that must be labeled.

 

Curation

This creates an empty field in the labeling UI, which must be filled using the curation values that you configured in Taskmonk.

 

Curation_PT

This is a curation field that enables the labeler to select the product type. You must associate this field with the Product Type column header in your curation file.

Taskmonk picks up the list of product types and displays them as drop-down options. Depending on the product type option that you choose, Taskmonk displays product type attributes, sourcing these options from the attributes that you mapped in your curation file.

For example, let’s say you have a product type called Pens & Pencils in the Product Type column in your curation file, and you associated the attribute displayColor to this product type, marking it as a closed list that can take only one value. In the Attributes Closed List, you define Red, Blue, and Black as values for the displayColor attribute.

Taskmonk displays the Product Type field as a drop-down list from which you pick Pens & Pencils. Taskmonk now lists out the attributes associated with this product type, of which, displayColor is one. You can now click the displayColor field and select Red, Blue, or Black as values for the displayColor attribute.

Taxonomy

These appear as placeholder read-only fields, which Taskmonk fills for you using values in your Taxonomy input file once you select a unique taxonomy entity for labeling.

Hybrid

This is text field with Dropdown option

Taskmonk allows the user to select only one option from the list of values ,When they give “(“ this in dropdown all drop-down list will be displayed.

Name-Value Pair

This component includes sub fields

In Taskmonk the "NV Pair Field" component has a subfield configurable as a text input, dropdown, or multi-dropdown, with mandatory and flexible width options

Dynamic Field

This is a flexible output field

In Taskmonk it takes JSON data and displays different widgets on task pages, often used in chat evaluation and product ranking projects. It supports various widget types like Text, Image, and OptionedMessage, and generates the necessary output JSON using custom code and updateOutputField

Color Selection

It displays color based on dropdown values

In Taskmonk this feature in Text projects allows an output field to display colors based on dropdown values, supporting both color names and hex codes.

Configure Project Fields

The Project Settings > Task Design > Fields tab enables you to specify the input and output fields required for your project tasks.

 

 Configure Task Input Fields

Configure Task Input Fields

The Input Field tab enables you to specify fields that must exist in source files containing unlabeled input data. Once you save these specifications, Taskmonk uses these fields to validate unlabeled data during file-based import.

 

 

You can add input fields into Taskmonk projects manually or using a project input file.

Adding Input Fields from a Project Input File

This is the easiest way to add input fields to your project.

When you add input fields from a project input file, Taskmonk reads the column headers available in the file and automatically creates fields using the header information in your data file. You can then review the auto-created fields and update them as required.

For best results, we recommend that you download and update this Sample Project Data file.

To add input fields from a project input file, click the Browse Input Field button and select the input source file. Taskmonk now identifies column headers in the source file and creates an input field for each column header:

 

 

 Configure Task Input Fields

Adding Input Fields Manually

To manually add input fields to your project UI:

  1. In the Input Fields tab, click Create Input Field. The Create Input Field modal appears.

  2. Enter the name of the input field.

     

  3. Click Create to add the new field to your project.

The name of the input fields must match the column headers in your input data file.

You can similarly add as many input fields as required.

Updating Input Fields

Once you have created the input fields associated with your project, you can update their details and order as required.

You can perform the following updates on your project input fields:

Updating Input Field Names

To update an input field’s name:

  1. Click the Edit icon adjacent to it. This renders the Field Name field editable.

  2. Update the name as required, and click the Update Field Name icon.

     

Updating Input Field Types

To update input field types:

  1. Click the Field Type drop-down list to display the field type options available.

  2. Select the required field type. For example, in the screenshot below, the product_URL field refers to a column in the input file that contains links to product images. If you want the labeling UI to display the image, you must change the field type to Image.

     

    For more information on field types in Taskmonk, see Understanding Field Types.

  3. Set Mandatory as True to indicate that this field must be filled when updating input data.

  4. Set Operational as True to make the field available to labelers.

Reordering Input Fields

It is typically a good idea to order your input fields in the same sequence as the column headers in the project input files.

To reorder input fields, use the Up and Down arrows adjacent to the field names.

 Configure Task Output Fields

Configure Task Output Fields

The Output Field tab enables you to specify fields that must exist in the labeling output. Once you save these specifications, Taskmonk uses these fields to populate the output section of the labeling UI, making it easy for the labeler to specify details for each output field as appropriate.

Creating Task Output Fields

In image annotation projects, output fields are automatically created. Additional annotation details can be added as class attributes. In text-based projects, however, output fields can be flexibly configured as required.

Taskmonk does not require you to manually create output fields. However, you must add at least one curation output field if you are creating a curation project.

To add output fields to your project:

  1. Click the Create Output Field button on the right side of the page. The Create Output Field modal appears:

    Create_Output_Field.png

    The Create Output Field modal enables you to specify details associated with the output field.

  2. Enter the Name of the output field in the field provided.

  3. Click the Set Data Type field and select the data type that you want to associate with the output field. For detailed information about the options available in this field, see Data Type Options in Taskmonk, below.

  4. Select the Mandatory check box to indicate that this field must be filled when labeling data.

  5. Select the All Levels check box to indicate that this field must be available to users at all execution levels, such as labeling, quality analysis, and so on.

  6. Click Create to save the new output field and return to the Task Design > Output Fields tab.

  7. Set Customer Visible as True to make the field available in the output when retrieved by the customer.

    image-20220118-055854.png

  • You can create as many fields as you want to appear in the labeling UI, apart from the curation and taxonomy fields.

  • Curation and Taxonomy fields are automatically added to the labeling UI for curation or taxonomy projects. To display and populate these fields, the labeler must search and select the taxonomy and curation PT details in the labeling UI.

Data Type Options in Taskmonk

Taskmonk supports the following data types and offers additional fields to contain property specifications associated with specific data types.

Also see Understanding Project Field Types in Taskmonk, above.

Data Type

Description

Additional Fields

Steps

Text

Enables you to specify that the field contains text.

Select Format

  1. Select Text in the Data Type field.

  2. Click Select Format and select the format of the text. Choose from the following options:

    • Number: Accepts only numbers.

    • Alphabet: Accepts only alphabets.

    • Alphanumeric: Accepts only numbers and alphabets.

    • Any: Accepts any text, including special characters, such as !,@,#, and so on.

Domain

Enables you to specify that the field contains domain names.

Possible Values

  1. Select Domain in the Data Type field.

  2. Select this field to create a validation field in the labeling UI, so labelers can enter the URL value, and it will get validated against the values you enter in the Possible Values field.

    Example: www.google.com,www.taskmonk.ai,www.microsoft.com

DropDown

Enables you to specify that the field contains a list of values that must appear as drop-down options.

Possible Values

  1. Select DropDown in the Data Type field.

  2. Enter the list of values in the Possible Values field, separating each value by a comma.

    Example: Violet,Indigo,Blue,Green,Yellow,Orange,Red

MultiSelect DropDown

Enables you to specify that the field contains a list of values from which multiple values can be chosen.

Component Type

Possible Values

  1. Select MultiSelect DropDown in the Data Type field.

  2. Choose between DropDown and Checkbox to indicate how you want the list to appear in the UI.

  3. Enter the list of values in the Possible Values field, separating each value with a comma. Thus, users can now select multiple values from the list of possible values that appears in this field
    in the labeling UI.

    Example: Violet,Indigo,Blue,Green,Yellow,Orange,Red

Date

Enables you to specify that the field contains a date.

 

Select Date in the Data Type field.

Radio

Enables you to specify that the field contains a list of values that must appear as radio buttons.

View Orientation

Possible Values

  1. Select Radio in the Data Type field.

  2. Choose between Horizontal and Vertical in the View Orientation field to indicate how you want options associated with this field to appear in the UI.

  3. Enter the list of values in the Possible Values field, separating each value with a comma. Thus, users can choose one radio button from the options available to them in the labeling UI.

    Example: Violet,Indigo,Blue,Green,Yellow,Orange,Red

LinkedField (Parent)

Enables you to specify that the field contains a list of values, each of which could have child list of values.

For example, the parent linked field Dress Item has three options: Shirts, Trousers, and Socks. If the user selects Shirts or Trousers, additional options associated with their sizes must appear; however, if the user chooses Socks, these options may not be needed if the socks are unisize.

Field Type

Possible Values

  1. Select LinkedField (Parent) in the Data Type field.

  2. Choose between DropDown, Radio, and Radio Inline in the Field Type field to indicate how you want options associated with this field to appear in the UI.

    1. DropDown: Displays the options as a drop-down list.

    2. Radio: Displays the options as a list of radio buttons.

    3. Radio Inline: Displays the options as radio buttons that appear in a single horizontal line.

  3. Enter the list of values in the Possible Values field, separating each value with a comma. Thus, users can choose one parent linked field from the options available to them in the labeling UI.

    Example: Shirts,Trousers,Socks

LinkedField (Child)

Enables you to specify that the field contains a list of values, which appears only when the labeler selects a specific parent value in the UI.

Field Type

Choose parent field for this field

Possible Values and Child values

  1. Select LinkedField (Child) in the Set Data Type field.

  2. Choose between DropDown, MultiSelect DropDown, Radio, and Radio Inline in the Field Type field to indicate how you want options associated with this field to appear in the UI.

    1. DropDown: Displays the options as a drop-down list.

    2. MultiSelect DropDown: Displays the options as a drop-down list from which multiple values can be selected.

    3. Radio: Displays the options as a list of radio buttons.

    4. Radio Inline: Displays the options as radio buttons that appear in a single horizontal line.

  3. Choose the parent field for the child linked field using the drop-down list provided.

Enter the child values against each possible value in the parent field.

Example:
Shirt: S,M,L,XL,XXL
Trousers: 36,38,40,42,44,46
Socks: [None]

 

InputLinked

Enables you to specify that the labeler must select one option from a set of possibilities for a specific attribute.

For example, if a pencil manufacturing company decides to package a sharpener or eraser with every box of pencils, the labeler should have a field labeled “Free Gift” and select “Sharpener” or “Eraser” from the list of options available. For step-by-step details on creating input-linked fields, see Creating Input-linked fields.

InputLinked Option

Input Field Names

  1. Select InputLinked in the Set Data Type field.

  2. Specify whether the options linked to the input-linked field must appear as radio buttons or a drop-down list, using the Input Field Names field.

  3. Enter the Input Field Names in the field provided.

Notes

Enables you to specify that the labeler must enter paragraph text that is associated with the item that must be labeled.

[None]

 

Curation

Enables you to specify that the labeler must fill this field using curation values associated with it.

Field Type

Possible Values

  1. Select Curation in the Set Data Type field.

  2. Use the Field Type field to specify the source of the curation values from the following options:

    1. Attribute Values: Select this option if the curation values must be taken from a curation file that you uploaded in the Project Lookup tab. For information on working with the Project Lookup tab, see Adding Lookup Data to Projects.

    2. Text: Select this option to create a field where the labeler can enter any text value.

    3. DropDown: Select this option if you want to provide the values associated with this curation field in the Possible Values field, below.

If you select Attribute Values as the Field Type, you do not need to provide any data in the Possible Values field.

Curation PT

Enables you to specify that the labeler must fill this field using a product type field that will determine the associated labeling fields that must be displayed.

Possible Values

You must ensure that the name of the field is the same as the name of the corresponding column in your curation file. Otherwise the associated values will not get populated.

Taxonomy

Use this field to create taxonomy fields, which appear as placeholder read-only fields. Taskmonk auto-fills these for you using values in your Taxonomy input file once you select a unique taxonomy entity for labeling.

 

You must ensure that the name of the field is the same as the name of the corresponding column in your taxonomy file. Otherwise the associated values will not get populated.

Hybrid

Enables you to specify that the field contains a list of values that must appear as drop-down options.

Possible Values

  1. Select Hybrid in the Data Type field.

  2. Enter the list of values in the Possible Values field, separating each value with a comma. When user enter the “(“ this users can now select multiple values from the list of possible values that appears in this field

Name Value Pair

Enables you to specify that the field contains options to add or delete rows, and also features a flex design

  1. Select Name Value Pair in the Data Type

  2. Enable Flex design

    image-20240829-073330.png

  3. Click on Sub fields in NV Pair

  4. Enter the Field name

  5. Select field types such as Text, Dropdown, and Multi-Dropdown.

  6. Enter flex width

  7. Enter the list of values in the Possible Values field, separating each with value with a comma

    image-20240829-073643.png

Dynamic field

Enables the field which accepts JSON data

Possible Value

  1. Select Dynamic Field in the Data Type field.

  2. Enter the list of values in the Possible Values field, separating each value by comma.

  3. The field supports various widget types like Text, Image, and OptionedMessage. Include the desired widget types in your JSON data

Color Selection

Enables the display colors according to dropdown values

Possible Value

  1. Select Dynamic Field in the Data Type field.

  2. Enter the list of values in the Possible Values field, separating each value by comma.

Deleting Task Output Fields

To delete one or more task output fields, select the check boxes adjacent to the output fields that you want to delete and click the Delete button that appears at the top-right section of the Output Field tab.

Design the Labeling Application

Once your input and output fields are in place, you must create specifications that will determine the UI for your labeling application.

Taskmonk enables you to either create projects using its predefined project templates or design custom templates within Taskmonk and use them in your projects. Use the links below for more information:

 Using Taskmonk Pre-defined Templates to Create Labeling UI

Using Taskmonk Pre-defined Templates to Create Labeling UI

Before you select a pre-defined template, you must create the input and output fields required for your project.

Taskmonk provides pre-defined project templates to simplify your task of creating labeling UIs. To use pre-defined templates in Taskmonk:

  1. Click the Task Design > UI Template > Pre-defined Template tab and then select the template that you want to use. See Understanding Predefined Templates below to know more about the templates.

     

  2. Click Apply to confirm your choice of template.

 

  Understanding Predefined Templates

Understanding Predefined Templates

For text-based projects, two predefined UI layouts are available.

Template 1 ensures that all the input fields are grouped in a two-column grid on the top half of the page. Previous level results and the output fields are grouped on the bottom half of the page.

Example:

 

 

Template 2 ensures that all the input fields are grouped in a single column to the left of the page. Previous level results and the output fields are grouped into separate tabs on the right of the page.

Example:

 

 

 Designing Custom Templates in Taskmonk

Designing Custom Templates in Taskmonk

This functionality is only available for text-based projects.

To design a custom template:

  1. Navigate to the Task Design > UI Template > User-defined Template tab.

     

     

  2. To create a new template, enter the name of the new group in the Add Group field and click the Add New Group icon at the right of the field.. This displays the Layout Type modal, where you can specify the layout that you want to use for your project.

     

     

  3. Select the Layout Type as desired. This will determine how the input and output fields are grouped in the labeling UI. The following layout types are available:

  4. Click OK. The Design Layout page appears.

  5. Once you are satisfied with the layout, click Save to save the layout and return to the user-defined template tab.

  6. If you require the output from the previous levels to be shown in a separate section, click Design Layout. This panel can be designed in the same manner as the Mixed Layout Type Template.

  7. Ensure that the Show Level Result in Separate Section is checked to show the output from the previous levels in a separate section.

  8. Select Show Level Results in Single Tab to show results from all levels in a single tab.

  9. Click Apply to activate the layout for the labeling UI.

  10. Click Preview to preview the layout. Click Browse Input File to upload a sample input file and view input values.

     

     

At least one input field must be added before the layout can be saved.

 Working with Separate Layout Type Template

  3. Click the Add Field icon to add an input/output field. A placeholder field appears. Click the placeholder field and select the input/output field from the drop-down. You can drag and drop the placeholder field to reposition it within the corresponding base area. Resize the field as required by dragging the bottom-right corner.

 Working with Mixed Layout Type Template

Working with Mixed Layout Type Template

  1. Click the Add Field icon to add an input/output field. A placeholder field appears. Click the placeholder field and select the input/output field from the drop-down. You can drag and drop the placeholder field to reposition it across the base area. Resize the field as required by dragging the bottom-right corner. Input fields are highlighted in blue; output fields are highlighted in yellow.

     

     

  2. Once you are satisfied with the layout, click Save to save the layout and return to the user-defined template tab.

Related Links

  • No labels

© 2020 Taskmonk Technology Pvt. Ltd. All Rights Reserved .