Перейти к основному содержимому
Версия: 1.20.1

SimpleAttachmentService

Этот серверный класс позволяет собирать вложения с удаленного экземпляра при выполнении миграции из какой-либо сторонней системы в SimpleOne.

SimpleAttachmentService()


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

SimpleAttachment()
const attach = new SimpleAttachmentService();

createAttachmentByUrl(url, recordDocId, fileName)


Используйте этот метод, чтобы создать копию вложения из удаленного экземпляра по указанному URL-адресу и прикрепить ее к записи по указанному DocumentID в параметре recordDocId.

Параметры:

НаименованиеТипОбязательноЗначение по умолчанию
urlStringДаНет
recordDocIdStringДаНет
fileNameStringДаНет

Возвращаемое значение:

ТипОписание
StringМетод возвращает ID созданного вложения.

Пример:

createAttachmentByUrl()
const attach = new SimpleAttachmentService();
attach.setUsername('john.doe'); // Укажите настоящее имя пользователя перед использованием этого метода.
attach.setPassword('123456'); // Укажите настоящий пароль перед использованием этого метода.
const docID = ss.getDocIdByIds('155931135900000084', '155931135900000001');
const attachId = attach.createAttachmentByUrl('http://simple.instance.com/v1/attachments/download/159229954513242397', docID, 'test.sop');

setUrl(url)


Используйте этот метод, чтобы указать URL-адрес удаленного экземпляра, к которому нужно настроить доступ для работы с файлами.

Параметры:

НаименованиеТипОбязательноЗначение по умолчанию
urlStringДаНет

Возвращаемое значение:

ТипОписание
VoidМетод не возвращает значение.

Пример:

setUrl()
attach.setUrl('https://simple.instance.com:8443');

setUsername(username)


Используйте метод, чтобы задать логин (username) для пользователя при установке соединения с удаленным экземпляром.

примечание

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

Параметры:

НаименованиеТипОбязательноЗначение по умолчанию
usernameStringДаНет

Возвращаемое значение:

ТипОписание
VoidМетод не возвращает значение.

Пример:

setUsername()
attach.setUsername('john.doe');

setPassword(password)


Используйте этот метод, чтобы установить пароль для пользователя, чей контекст безопасности используется при установлении соединения с удаленным экземпляром.

Параметры:

НаименованиеТипОбязательноЗначение по умолчанию
passwordStringДаНет

Возвращаемое значение:

ТипОписание
VoidМетод не возвращает значение.

Пример:

setPassword()
attach.setPassword('123456');

getAttachmentSN(sourceDocId, targetDocId)


Используйте метод для получения файла с удаленного экземпляра. Укажите DocumentID необходимой записи и записи текущего экземпляра, к которой необходимо прикрепить вложение. Для указания и авторизации на удаленном экземпляре, воспользуйтесь методами setUrl(), setUsername() и setPassword(), описанными выше.

Параметры:

НаименованиеТипОбязательноЗначение по умолчанию
sourceDocIdStringДаНет
targetDocIdStringДаНет

Возвращаемое значение:

ТипОписание
StringМетод возвращает ID созданного вложения.

Пример:

getAttachmentSN()
const attach = new SimpleAttachmentService();
attach.setUrl('https://source-now.instance.com:8443'); // Целевой экземпляр. Укажите настоящий URL-адрес здесь перед использованием этого метода.
attach.setUsername('john.doe'); // Укажите настоящее имя пользователя перед использованием этого метода.
attach.setPassword('123456'); // Укажите настоящий пароль перед использованием этого метода.
const docID = ss.getDocIdByIds('155931135900000084', '155931135900000001');
const attachId = attach.getAttachmentSN('f91d84fe7cff58d4db91f2e9c2dc02fb', docID);