Page History

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

SimpleAttachment()

Используйте этот конструктор класса для создания пустого объекта SimpleAttachment.

Code Block

language	js
theme	Eclipse
title	SimpleAttachment
linenumbers	true

const attach = new SimpleAttachment();

base64Decode(data, strict)

Этот метод возвращает строку ASCII, декодированную из указанной строки base64.

Параметры:

Название	Тип	Обязательный	Значение по умолчанию
data	String	Да	Нет
strict	Boolean	Нет	true

Если входные данные содержат символы, не входящие в алфавит base64, а параметр strict задан как true, то метод base64_decode() вернёт false. Если параметр strict задан как false, символы, не входящие в алфавит base64, будут отброшены.

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

Тип	Описание
String	Декодированная строка.

Пример:

Code Block

language	js
theme	Eclipse
title	base64Decode()
linenumbers	true

const attach = new SimpleAttachment();
const result = attach.base64Decode('TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQ=');
ss.info(result);
// Информация: Lorem ipsum dolor sit amet

base64Encode(data)

Этот метод преобразует указанную строку в base64.

Параметры:

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

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

Тип	Описание
String	Закодированная строка base64.

Пример:

Code Block

language	js
theme	Eclipse
title	base64Encode()
linenumbers	true

const attach = new SimpleAttachment();
const result = attach.base64Encode('Lorem ipsum dolor sit amet');
ss.info(result);
// Информация: TG9yZW0gaXBzdW0gZG9sb3Igc2l0IGFtZXQ=

copy(sourceTableName, sourceID, targetTableName, targetID)

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

Параметры:

Название	Тип	Обязательный	Значение по умолчанию
sourceTableName	String	Да	Нет
sourceID	String	Да	Нет
targetTableName	String	Да	Нет
targetID	String	Да	Нет

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

Тип	Описание
Boolean	Метод возвращает true,если вложения были успешно скопированы. В случае ошибки метод возвращает false.

Пример:

Code Block

language	js
theme	Eclipse
title	copy()
linenumbers	true

const attach = new SimpleAttachment();
attach.copy('sys_email', '155964310500000059', 'task', current.sys_id);

deleteAttachment(attachmentID)

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

Параметры:

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

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

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

Пример:

Code Block

language	js
theme	Eclipse
title	deleteAttachment()

const attach = new SimpleAttachment();
attach.deleteAttachment('157052637119478714');

getAttachmentUrlById(attachmentId)

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

Параметры:

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

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

Тип	Описание
String	Этот метод возвращает URL-адрес вложения в облачном хранилище.

Пример:

Code Block

language	js
theme	Eclipse
title	getAttachmentUrlById
linenumbers	true

const ATTACH_ID = '163553718313772587';
const simpleAttach = new SimpleAttachment();
const attachUrl = simpleAttach.getAttachmentUrlById(ATTACH_ID);
ss.info(attachUrl);
// Информация: https://s3-{your-instance-url}/public-attachment/5/32/9bnc2pcb3axyfatgtc6lsi7...

getContent(attachmentId)

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

Параметры:

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

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

Тип	Описание
String/Object	Значение в поле вложения Контент. Если поле пустое или прикрепленный файл имеет другой формат, метод возвращает null.

Пример:

Code Block

language	js
theme	Eclipse
title	getContent
linenumbers	true

const attach = new SimpleAttachment();
ss.info(attach.getContent('168109939701169218'));
// Info: task active  additional_comments  approval_state ...

readBase64(attachmentId)

Этот метод позволяет получить закодированную строку из указанного вложения. Вместе с методом writeBase64() может использоваться для копирования вложений.

Note
Размер вложения не должен превышать 10 Мб. В случае превышения метод возвращает пустую строку, а в Журнале исключений (sys_log_exception)появляется запись: `File size exceeded allowed limit`.

Параметры:

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

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

Тип	Описание
String	Закодированная строка base64. В случае, если файл слишком большой, возвращаемая строка может быть пустой.

Пример:

Code Block

language	js
theme	Eclipse
title	readBase64()
linenumbers	true

const read = new SimpleAttachment();
ss.info(read.readBase64('168025458107121347'));
// Информация: 0YLQtdGB0YLQvtCy0YvQuSDQtNC+0LrRg9C80LXQvdGC

rename(attachmentId, fileName)

Данный метод позволяет изменить название файла и его расширение.

Параметры:

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

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

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

Пример:

Code Block

language	js
theme	Eclipse
title	rename()
linenumbers	true

const DOC_ID = ss.getDocIdByIds(current.sys_db_table_id, current.sys_id);
const simpleAttach = new SimpleAttachment();
const attachRecord = new SimpleRecord('sys_attachment');
attachRecord.addQuery('record_document_id', DOC_ID);
attachRecord.addQuery('mime_content_type', 'application/json');
attachRecord.selectAttributes(['sys_id']);
attachRecord.query();
attachRecord.next();
simpleAttach.rename(attachRecord.sys_id, `${current.number} - ${current.subject}.json`);

write(documentId, fileName, content, contentType)

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

Параметры:

Название	Тип	Обязательный	Значение по умолчанию
documentId	String	Да	Нет
filename	String	Да	Нет
content	String	Да	Нет
contentType	String	Да	Нет

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

Тип	Описание
String	Метод возвращает sys_id вложения; в случае ошибки возвращает null.

Пример:

Code Block

language	js
theme	Eclipse
title	write()
linenumbers	true

const simpleAttach = new SimpleAttachment();
const attachId =
    simpleAttach.write(
        ss.getDocIdByIds(current.sys_db_table_id, current.sys_id),
        'readme.json',
        JSON.stringify(current.getAttributes(), null, '\t'),
        'application/json'
    );

writeBase64(documentId, fileName, base64, mimeContentType)

Данный метод предназначен для создания и добавления вложения к указанной записи, закодированного при помощи base64. Вы можете использовать этот метод вместе с readBase64() для копирования вложений.

Параметры:

Название	Тип	Обязательный	Значение по умолчанию
documentID	String	Да	Нет
fileName	String	Да	Нет
base64	String	Да	Нет
mimeContentType	String	Да	Нет

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

Тип	Описание
String или NULL	Метода возвращает ID вложения;в случае ошибки возвращает null.

Пример:

Code Block

language	js
theme	Eclipse
title	writeBase64()
linenumbers	true

const CURRENT_USER_DOC_ID = ss.getDocIdByIds(ss.getUser().sys_db_table_id, ss.getUserID());
const simpleAttach = new SimpleAttachment();
const base64Value = 'R0lGODlhAQABAIAAAP///wAAACwAAAAAAQABAAACAkQBADs=';
const attachId = simpleAttach.writeBase64(
    CURRENT_USER_DOC_ID,
  	'file_example.gif',
    base64Value,
    'image/gif'
);
ss.info(attachId);
// Информация: 162245472311776172

Table of Contents

absoluteUrl	true
class	fixedPosition

Page tree

Versions Compared

Old Version 17

New Version 18

Key

SimpleAttachment()

base64Decode(data, strict)

base64Encode(data)

copy(sourceTableName, sourceID, targetTableName, targetID)

deleteAttachment(attachmentID)

getAttachmentUrlById(attachmentId)

getContent(attachmentId)

readBase64(attachmentId)

rename(attachmentId, fileName)

write(documentId, fileName, content, contentType)

writeBase64(documentId, fileName, base64, mimeContentType)