Item Remote Update

Item Remote Update is a gh-element that allows the user to remotely update a reference in a specific field in the selected item. More precisely, the field value will be replaced with a reference to the item in which the gh-element is located.

This element can be only used in items.

In order for Item Remote Update to work, you must first configure a list of existing items. After that, the user can select any item from this list and update the Item Reference field selected in the settings.

Functional Characteristic

The current gh element is a specific element that allows the user to perform one specific action: replace the field value with the current item's reference. It is useful in different cases. For example, we have two applications:

• Tasks - contains a link to a specific project.
• Projects - many tasks can be assigned to a project. The Item Remote Update is located here.

Then, within the project item, the user can reassign the task to another project. It can also be used in conjunction with Item Remote Add, which creates items remotely.

Value Format

This element does not contains any value.

Element Options

Item Remote Update has two blocks of settings.

Field And Destination Reference Settings

As usual, the first block contains standard Field Settings and Destination Reference Settings, which consists of various additional settings.

Select First Matched On Enter

Since this block consists of additional settings, the first setting only allows you to add a feature to an element. That is, if you have enabled the current setting, the user can select the desired item by clicking on the Enter button.

To do this, the user first needs to enter the name of the desired item. When it is first in the list, the user can select it. Obviously, if this option is disabled, nothing will happen after pressing Enter.

Show Thumbnail

The current setting allows you to determine whether thumbnails are displayed in the drop-down list. It works in pair with the Thambnails.

The point is that you choose which images will be in the list using the Thumbnail setting. And the current setting determines whether thumbnails will be displayed at all, even if you have already selected the image source.

Autoselect By

Such as the Item Remote Add, Item Remote Update has an extra feature. It allows users to select the required item by entering its full title or subtitle. And the current setting is responsible for that.

Auto-selection works only if the required item has a unique title or subtitle.

That is that the current setting provides two options:

• Title field
• Subtitle field

So, you choose which field will be used for auto-selection. When you select Title field, the user will have to enter the title of the item. If you select Subtitle field, the user will have to enter a subtitle.

Dropdown Settings

The second set of settings configures the drop-down list of items and the destination field to be updated.

Application

In this setting, you have to select the application that will be updated with the current gh-element. In other words, the items of this particular application will be updated when it is selected. Also, all data for the following settings will be taken from this application..

Thumbnail

This setting is responsible for the image on the thumbnails. Specifically, here you have to select the source field for the element thumbnails.

This is the field that is taken from the selected application. That should be the Image element. If this field is not filled in for any element, a gray cross will be displayed instead of an image in the list.

Destination

Here you must select the field whose value will be updated. When the user selects any item, the value will be overwritten in this field. This setting provides you with a list of fields of a particular application for selection.

The field must be Item Reference, since the value in it will be rewritten to a reference to the item where Item Remote Add is located.

Title

Each item has a name in the drop-down list. This title comes from a specific field. So, here you have to select the source field for the title of the item in the list.

A list of fields from the previously selected application is provided for selection.

Subtitle

Similar to the previous setting, this one allows you to select a source field from the application for a specific entity in the drop-down list. In this case, the value of the selected field is used as a subtitle for the item.

Filter

This setting is used to set the conditions for displaying items. This means that it allows you to add and customize filters to weed out items that may appear in the drop-down list. The works of the setting is based on the Filter element.

Edit

The last setting of the block allows you to configure the option itself. It consists of two buttons. One of them, which looks like a pencil, allows you to edit the current option. The other, with a trash can icon, allows you to delete an option.

Element Style

This is not the element that has a large number of style settings. There is only a standard set of settings with one additional. And, of course, it has its own types of interpretations.

General Settings

The general style settings contain that single additional option.

Input Width

This is a customizing setting that allows you to set the width of the current gh-element. To do that you just have to enter the required width into this field.

The width is measured in pixels. The default value is the minimum width at the same time. It is equal to 190 pixels.

Data Model

The current element has the following data model:

{
    "data_model": {
        "autoselect_by": "title",
        "interpretation": [],
        "select_first_matched_option": 1,
        "selected_apps": [{
            "app_id": "298650",
            "destination_field_ids": "699427",
            "filters_list": [],
            "subtitle_field_ids": "697431,697430",
            "thumbnail_field_id": "697435",
            "title_field_ids": "697436,697435"
        }],
        "show_tubnail": 1
    }
}

Filtration

This element cannot be filtered out.

Interpretation

This gh-element has only one type of interpretation, which displays an input field and a customized drop-down list.