Edit documentation Edit document
GH-Elements

Item Remote Add

Item Remote Add is a gh-element that allows you to add items with references to other items. This allows you to create items that are linked to the current item and to the item selected in the drop-down list.

This element works using Item Reference.

Functional Characteristic

This element allows the user to add items that are already linked to other items. That is useful, for example, when user have to create the task related to some project and responsible user. To do this, you need to create a list of users in Item Remote Add and select the task application as the destination app. Then open the project item and select the user in the drop-down list. As a result, a task with the necessary links will be created.

Value Format

There is no value in the current element.

Element Options

The Item Remote Add has two blocks of settings with different groups of settings.

Field And Destination Reference Settings

The first block consists of Field Settings, which are standard settings, and Destination Reference Settings, which configure the destination and operation of the element.

Settings of current element field and destination reference

Name Description
Destination App allows you to select the application to which the item will be added; details...
Destination Field for Selected Item allows to select field where the item reference of the selected item will be saved; details...
Destination Field for Current Item allows to select field where the item reference of the current item will be saved; details...
Select first matched on Enter allows you to select the desired item by pressing a single button; details...
Show Thumbnail allows to display thumbnails of images in the drop-down list; details...
Autoselect by allows to select the field by which auto selection will be performed; details...

Destination App

This is the application where the item will be added. It does not have to be the same application where the current gh element is located.

Destination Field For Selected Item

In this setting, you must select the field in which the reference to the selected item will be saved. This field should be an Item Reference element, then the user will be able to go to the return element by the reference. After that, the item will be added to the destination program with the selected field filled in.

Destination Field For Current Item

Here you need to select the field in which the reference to the item in which the gh-element is located will be saved. And just like in the previous setting, an active item reference to the current item will be created.

Select First Matched On Enter

As you already understood, this option allows you to select the first found item by pressing the Enter key. If it is enabled, then when entering the name of any item, the user can press the Enter key and select it.

Show Thumbnail

This setting allows you to add thumbnails to the drop-down list of items. If it is enabled, the images taken from the selected field will be displayed in the drop-down list with the corresponding items.

Autoselect By

This is a feature that allows you to select a unique product by entering its full name. That is, if there is only one item left in the drop-down list, it will be automatically selected.

The second block contains settings for configuring the drop-down list of items. Due to this, the user can select the item that will be associated with the one created by the item reference.

Settings of item remote add dropdown

Name Description
Application allows to select the source application; details...
Thumbnail allows to select field from which images will be taken; details...
Title allows to select the field from which text for titles will be taken; details...
Subtitle allows to select field with text that will be taken for subtitles; details...
Filter allows to add filters that determine which items will be in the dropdown list; details...
Edit allows you to edit and delete a drop-down list item; details...

Application

This is the source program from which the data for the drop-down list will be taken. That is, all the following fields are from this application.

Thumbnail

This setting allows you to select the source field for the dropdown list thumbnails. Here you need to select some element Image.

Title

The current field is the source field whose values are used as the dropdown list option titles.

Subtitle

This setting allows you to select a field for subtitles. They will be displayed in the drop-down list below the titles.

Filter

Use this option to filter which items can be displayed in the dropdown list. You can use different filters on different fields to get only the items you need.

Edit

This is a column that contains two buttons to edit and delete options.

Element Style

The current gh-element does not require special style settings. But, despite this, in addition to the standard settings, it has one unique setting. And, of course, it has its own types of interpretations.

Style of item remote add element

General Settings

The basic style settings of the current gh element contain a single unique setting.

General settings of item remote add style

Name Description
Input Width allows to set the width of the enter field

Input Width

This is the setting field that determines the field width. You can enter your own value of the width.

Data Model

The Item Remote Add has a large data model that contains all element settings.

{
    "data_model": {
        "autoselect_by": "title",
        "current_item_destination_field": "697445",
        "destination_app": "29862",
        "interpretation": [],
        "select_first_matched_option": 1,
        "selected_apps": [{
            "app_id": "29674",
            "filters_list": [],
            "subtitle_field_ids": "695197",
            "thumbnail_field_id": "695197",
            "title_field_ids": "695198"
        }],
        "selected_item_destination_field": "697446",
        "show_tubnail": 0
    }
}
Name Type Description
autoselect_by string contains the selected field by which the autosuggestion is performed
current_item_destination_field string contains ID of the field in which the item reference to the destination fields will be saved
destination_app string contains ID of the application to which the item will be added
interpretation array contains all element interpretation types
select_first_matched_option boolean shows whether the user can select the option by pressing Enter
selected_apps array contains all the settings of the drop-down list
app_id string contains ID of the destination application
filters_list array contains all filters of the option
subtitle_field_ids string contains ID of the source field of subtitle
thumbnail_field_id string contains ID of the source field from which the images will be taken
title_field_ids string contains ID of the source field of the title
selected_item_destination_field string contains ID of the selected field
show_tubnail boolean contains ID of the field from which images for thumbnail will be taken

Filtration

This element cannot be filtered out.

Interpretation

The current element has only one type of interpretation, which is the default interpretation. This is the field where you can enter a specific name and select the required item.

Types of item remote add interpretation