Инструкция. Выбор документов с использованием диалога добавления связей

Создание описания связей

Для текущего документа нужно создать описания связей, со всеми модулями, из которых возможен выбор документов.

Подключение диалога выбора документа

В схеме, по которой открывается форма добавить свойство "addLinked<Name>" со ссылкой на системную схему "SelectLinkedDocDialogResource"

<schema-ref name="addLinkedDoc" ref="SelectLinkedDocDialogResource"/>

Конфигурация диалога выбора

• Создать схему - наследник "LinkedDocSelectionParams<Name>" с системной схемы "LinkedDocSelectionParamsCommon". внутри созданной схемы переопределить свойства:
  
  • title - заголовок диалога
  • allowedManual - отображать ли вкладку "вручную"
  • isManySelect - доступен ли множественный выбор
  • modules - массив идентификаторов модулей, из которых можно выбирать документы. Если можно выбирать из любых, то нужно вернуть пустой массив. Тогда выбор будет ограничиваться настройками описания связей.
  • submit_caption - название кнопки для подтверждения выбора

  • cancel_caption - название кнопки для отмены
    Значения в них задаются с помощью формул, вычисляемым при открытии.

    Пример

    <schemas xmlns="http://www.intertrust.ru/schema/palette/tn-schema">
      <schema name="LinkedDocSelectionParamsExample" extends="LinkedDocSelectionParamsCommon">
        <meta>
          <category name="Система\Делопроизводство"/>
          <documentation>Ресурс с параметрами выбора документа в диалоге добавления связанного</documentation>
        </meta>
        <string name="title" temporal="true">
          <calc-values>
            <script event="open" lang="SPEL"><![CDATA['Выберите документ из системы']]></script>
          </calc-values>
        </string>
        <boolean name="allowedManual" temporal="true">
          <calc-values>
            <script event="open" lang="SPEL"><![CDATA[false]]></script>
          </calc-values>
        </boolean>
        <boolean name="isManySelect" temporal="true">
          <calc-values>
            <script event="open" lang="SPEL"><![CDATA[true]]></script>
          </calc-values>
        </boolean>
        <string name="modules" array="true" temporal="true">
          <calc-values>
            <script event="open" lang="SPEL"><![CDATA[T(java.util.Arrays).asList("OutputDocs", "InternalDocs")]]></script>
          </calc-values>
        </string>
        <string name="submit_caption" temporal="true">
          <calc-values>
            <script event="open" lang="SPEL"><![CDATA['Добавить документ']]></script>
          </calc-values>
        </string>
      </schema>
    </schemas>

• Для созданной схемы создать форму, она не будет использоваться, но её наличие необходимо системе для вычисления свойств схемы. В ней можно сделать, например, только поле title.

Подключение к форме

На форме создать:

• скрытое поле, указывающее на свойство "addLinked<Name>". В нём указывается recalc.
• кнопка с действием update-linked-doc и указанной схемой с параметрами "LinkedDocSelectionParams<Name>"

<!--скрытое поле -->
<field attribute-ref="addLinkedDoc" recalc="true">
	<properties>
		<hide>
			<condition>true</condition>
		</hide>
	</properties>
</field>
<!--кнопка -->
<button attribute-ref="addLinkedDoc" name="${ui.form.RkkResourceForm.section.Attributes.button.addLinkedDoc.name:Добавить документ из системы}">
	<appearance>
		<label-style width="17" unit="symbol">
			<style id="tunBtnHeader"/>
		</label-style>
	</appearance>
	<action>
		<custom>
			<update-linked-doc schema-ref="LinkedDocSelectionParamsExample"/>
		</custom>
	</action>
</button>

Доработка обработчика событий

При нажатии на кнопку будет показан диалог выбора связей с учётом заданных параметров. Web-клиент заполнит объект со структурой SelectLinkedDocDialogResource

После выбора отправится запрос на обновление, который надо обработать в custom-event-handler и сделать с выбранным документом то, что нужно в конкретном случае.

function recalc(object, changedField) {
    if (changedField == 'addLinkedDoc') {
        var addLinkedDoc = values.get('addLinkedDoc');
        if (addLinkedDoc.getValues().get("ids") != null) {
            var ids = addLinkedDoc.getValues().get("ids").getValues();
            for (var i = 0; i < ids.size(); i++) {
                var unid = getIdFromHref(ids.get(i).getValue());
                System.out.println("unid = "+unid);
                if (!unid.equals("")) {
                    var rkk = appdp.getEntityByUNID(unid);
                    //rkk - выбранный в диалоге документ
                }
            }
        }
        TunableObjectHelper.putAFInstanceValue(object.tuning(), "addLinkedDoc", null);
    }
}
 
function getIdFromHref(href) {
    var index = href.lastIndexOf("/", href.length())+1;
    if (index < 0) {
        return href;
    } else {
        return href.substring(index);
    }
}