SimpleAttachmentService

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

SimpleAttachmentService()

---

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

SimpleAttachment()

const attach = new SimpleAttachmentService();

createAttachmentByUrl(url, recordDocId, fileName)

---

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

Параметры:

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

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

Тип	Описание
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-адрес удаленного экземпляра, к которому нужно настроить доступ для работы с файлами.

Параметры:

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

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

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

Пример:

setUrl()

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

setUsername(username)

---

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

примечание

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

Параметры:

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

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

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

Пример:

setUsername()

attach.setUsername('john.doe');

setPassword(password)

---

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

Параметры:

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

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

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

Пример:

setPassword()

attach.setPassword('123456');

getAttachmentSN(sourceDocId, targetDocId)

---

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

Параметры:

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

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

Тип	Описание
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);