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 Type	Description	Implications of Using this Data Type 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 a text input field combined with a dropdown list. It allows users to either type their input or select from predefined options.	In Taskmonk, users can choose only one option from a list. When they enter “(“, the dropdown menu will reveal all the available options.
Name-Value Pair	This component includes sub fields	In Taskmonk, the "NV Pair Field" component includes a subfield that can be customized as a text input, dropdown, or multi-dropdown. It supports both mandatory and flexible width settings.
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, for Text projects, this feature allows an output field to display colors according to dropdown selections, 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

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:

Adding Input Fields Manually

To manually add input fields to your project UI:

In the Input Fields tab, click Create Input Field. The Create Input Field modal appears.
Enter the name of the input field.
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:

Click the Edit icon adjacent to it. This renders the Field Name field editable.
Update the name as required, and click the Update Field Name icon.

Updating Input Field Types

To update input field types:

Click the Field Type drop-down list to display the field type options available.
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.
Set Mandatory as True to indicate that this field must be filled when updating input data.
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

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:

Click the Create Output Field button on the right side of the page. The Create Output Field modal appears:
The Create Output Field modal enables you to specify details associated with the output field.
Enter the Name of the output field in the field provided.
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.
Select the Mandatory check box to indicate that this field must be filled when labeling data.
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.
Click Create to save the new output field and return to the Task Design > Output Fields tab.
Set Customer Visible as True to make the field available in the output when retrieved by the customer.

Data Type Options in Taskmonk

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

Data Type	Description	Additional Fields	Steps	Preview of Data Types on Task Page

Data Type	Description	Additional Fields	Steps
Text	Enables you to specify that the field contains text.	Select Format	Select Text in the Data Type field. 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.
DropDown	Enables you to specify that the field contains a list of values that must appear as drop-down options.	Possible Values	Select DropDown in the Data Type field. 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	Select MultiSelect DropDown in the Data Type field. Choose between DropDown and Checkbox to indicate how you want the list to appear in the UI. 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	Select Radio in the Data Type field. 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. 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	Select LinkedField (Parent) in the Data Type field. 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. DropDown: Displays the options as a drop-down list. Radio: Displays the options as a list of radio buttons. Radio Inline: Displays the options as radio buttons that appear in a single horizontal line. 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	Select LinkedField (Child) in the Set Data Type field. 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. DropDown: Displays the options as a drop-down list. MultiSelect DropDown: Displays the options as a drop-down list from which multiple values can be selected. Radio: Displays the options as a list of radio buttons. Radio Inline: Displays the options as radio buttons that appear in a single horizontal line. 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	Select InputLinked in the Set Data Type field. 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. 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	Select Curation in the Set Data Type field. Use the Field Type field to specify the source of the curation values from the following options: 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. Text: Select this option to create a field where the labeler can enter any text value. DropDown: Select this option if you want to provide the values associated with this curation field in the Possible Values field, below.
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
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.
Hybrid	Enables you to specify that the field contains a list of values that must appear as drop-down options.	Possible Values	Select Hybrid in the Data Type field. 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		Select Name Value Pair in the Data Type Enable Flex design Click on Sub fields in NV Pair Enter the Field name Select field types such as Text, Dropdown, and Multi-Dropdown. Enter flex width Enter the list of values in the Possible Values field, separating each with value with a comma
Dynamic field	Enables the field which accepts JSON data	Possible Value	Select Dynamic Field in the Data Type field. Enter the list of values in the Possible Values field, separating each value by comma. 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	Select Dynamic Field in the Data Type field. 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

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

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.
Click Apply to confirm your choice of template.

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.