Элемент приложения «Элемент плана проекта»

При вычислении внутренних подписей приложения система учитывает пользовательские настройки для подписания данных. В полученных данных содержится набор подписей двух типов: подписи атрибутов и подписи файла.

Каждая такая подпись содержит в себе:

• hash — подпись данных приложения;

• body — данные, для которых вычислен хеш;

• type — тип подписи.

В указанном примере контекст содержит:

• dokument — приложение типа Файл, включающее настройки подписи.

В представленном примере выполняется поиск подписи и использование hash, body для сохранения полученной подписи у приложения.

const app = await Context.data.dokument.fetch();
const dataSigns = await app.getDataSigns();
const dataSign = res.find( (res: any)  => res.type === SignType.File);

const newSign: NewSign = {
    sign: "aGVsbG8=",
    codeProvider: "External",
    body: btoa(app.data.__file!.hash),
    hash: dataSign.hash
}

await app.uploadSign(newSign);

Этот метод следует использовать, если нужно добавить новые права доступа к существующим.

// Добавим права на элемент инициатору процесса
const item = await Context.data.request.fetch();
const user = Context.data.__createdBy;
// Получаем текущие права
const currPermissions = await item.getPermissions();
currPermissions.values.push(new PermissionValue(user, [PermissionType.READ]));
await item.setPermissions(currPermissions);

// Пример сохранения подписей в контекстные переменные типа Файл
const app = await Context.data.dokument!.fetch();
const signHistory = await app.getSignHistory();

Context.data.sign_attributes = await signHistory[0].signs[0].createSignFile();

const attributes = await signHistory[0].signs[0].createAttributesFile();
if (attributes !== undefined) {
  Context.data.attributes = attributes;
}

// Запишем подписчиков элемента приложения в контекст
const subscribers = await item.getSubscribers();
Context.data.subscribers = subscribers;

Выполнить удаление дубликатов в полях, в которых хранятся массивы ссылок на объекты системы (пользователи, файлы, элементы приложений, документы).

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

const app1 = await Context.data.app1.fetch();
const app2 = await Context.data.app2.fetch();

app1.data.executors.push(app2.data.executors);
app1.normalize();

// Далее перебираем элементы нового массива
app1.data.executors.forEach( ... );

Сохранять элемент необходимо после изменения данных элемента.

const request = await Context.data.service_request.fetch();
request.data.responsible = Context.data.responsible;
await request.save();

Существующие права полностью заменяются новыми.

Для элементов приложения не имеют смысла права на создание, поэтому недоступно значение PermissionValue.Create.

Статус элемента приложения меняется сразу при выполнении этого метода.

Дополнительного вызова не требуется.

Метод используется для реализации собственного механизма подписания в приложениях. С помощью данного метода можно использовать для приложения подпись, полученную у внешнего провайдера.

Для того чтобы воспользоваться методом, необходимо иметь:

• тело подписи, представленное в формате base64;

• тип подписи;

• код провайдера (строковая константа, которая его идентифицирует);

• хеш данных приложения, которые подписали;

• данные, по которым вычислена подпись.

В примере указан сценарий, где:

• dokument — это приложение типа Документ в контексте;

• Класс MySignProvider — несуществующий провайдер для примера.

В результате мы получаем флаг, который говорит о результате загрузки. Если флаг имеет значение true — загрузка прошла успешно, false — подпись не загружена.

const app = await Context.data.dokument.fetch();
const provider = new MySignProvider();
const innerSigns = await Conetxt.data.dokument.getDataSigns();

const attributesInnerSign = innerSigns.find(sign => sign.type === SignType.Attributes);
const sign = provider.Sign(attributesInnerSign.body);

const newSign: NewSign = {
    sign: sign,
    codeProvider: "MyProvider",
    body: attributesInnerSign.body,
    signType: SignType.Attributes,
    hash: attributesInnerSign.hash,
};

const isUploaded = await app.uploadSign(newSign);