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.
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.
Dropdown Settings
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.
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.
General Settings
The basic style settings of the current gh element contain a single unique setting.
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.