-

docs/forms/cmp/entity.rst

 «Объекты Synergy»
 --------
 
-Тип «Пользователь»
+Тип данных «Пользователи»
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. js:class:: AS.FORMS.UserLinkView
 
@@ -10,23 +11,29 @@
     .. code-block:: js
 
         {
-          "id": "link-cmp",
-          "type": "link",
+          "id": "userlink-cmp",
+          "type": "entity",
           "style": {},
           "config": {
-              "read-only": false,
-              "fill-with-current": true,    // заполнять ссылкой на текущий документ
-              "script": ""
+            "entity": "users",                            // тип данных
+            "read-only": false,                           // заблокировать от изменений пользователем
+            "depends": "positionlink-cmp",                // связь с компонентом
+            "fill-with-current": true,                    // заполнять создающим пользователем
+            "custom": true,                               // разрешать ввод произвольного текста
+            "multi": true,                                // позволять мультивыбор
+            "groups": true,                               // отображать группы
+            "show-without-position": true,                // отображать не назначенных на должность
+            "editable-label": true,                       // разрешать редактировать label выбранного элемента
+            "customNameFormats": {                        // изменить формат отображения ФИО в зависимости от языка системы
+                "ru": "${l} ${f.short}.${p.short.dot}",   // русский язык
+                "kz": "${l} ${f.short}.${p.short.dot}",   // казахский язык
+                "en": "${l} ${f.short}.${p.short.dot}"    // английский язык
+            },
+            "script": ""
           },
           "fromHistory": true,
-          "fullId": "link-cmp",
-          "required": false,
-          "data": {                         // дефолтное значение
-              "id": "link-cmp",
-              "type": "link",
-              "value": "http://arta.pro",   // URL ссылки
-              "key": "ARTA Software; true"  // наименование ссылки
-          }
+          "fullId": "userlink-cmp",
+          "required": true
         }
 
     .. note:: Значение параметра ``key`` состоит из надписи к ссылке и через «; »
@@ -41,22 +48,31 @@
     .. code-block:: js
 
         {
-          "id": "link-cmp",
-          "type": "link",
-          "value": "http://arta.pro",   // URL ссылки
-          "key": "ARTA Software; true"  // наименование ссылки
+          "id": "userlink-cmp",
+          "type": "entity",
+          "value": "syndevel s., DEVDEP, ARTA, Someone",                                                    // значение компонента
+          "key": "cbc93e4a-b3b6-4b5d-8b93-7692b32e3ceb;63e8d268-a135-4fa9-91d2-ed5d0024c93b;g-131;text-0",  // список id выбранных пользователей, разделенных «;»
+          "formatVersion": "V1",
+          "manualTags": {"63e8d268-a135-4fa9-91d2-ed5d0024c93b": "DEVDEP"}                                  // пользователи, для которых были изменены названия вручную
         }
 
-    .. js:function:: isOpenInNew()
+    .. note:: Идентификаторы могут иметь приставки:
+              * без приставки - пользователь
+              * g - группа (g-идентификатор_группы)
+              * text - произвольный текст (text-номер_просто_число)
 
-        Открывать ссылку в новом окне
+    .. js:function:: getSelectedIds()
 
-        :returns: ``boolean``
+        Получить идентификаторы выбранных пользователей
 
-    .. js:function:: setValueFromInput(newUrl, newTitle, newOpenInNew)
+        :returns: ``[string]``
 
-        Вставить значение
+    .. js:function:: getValue()
 
-        :param string newUrl: URL ссылки
-        :param string newTitle: наименование ссылки
-        :param boolean newOpenInNew: открывать ссылку в новом окне
+        Получить значение
+
+        :returns: ``object`` {personID:"идентификатор пользователя", personName:"название пользователя", positionName:"название должности пользователя (если существует)", customFields:{calendarColor:"цвет статуса", calendarStatusLabel:"текст статуса"}}
+
+    .. js:function:: setValue(value)
+
+        :param object value: объект вида {personID:"идентификатор пользователя", personName:"название пользователя", positionName:"название должности пользователя (если существует)", customFields:{calendarColor:"цвет статуса", calendarStatusLabel:"текст статуса"}}