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

Метод возвращает закодированную строку 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)

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

Параметры:

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

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

Да

Нет

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

Тип	Описание
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();
const content = ss.info(attach.getContent('157052637119478714168109939701169218'));
// Info: task active  additional_comments  approval_state ...

readBase64(attachmentId)

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

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

Параметры:

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

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

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

Пример:

Code Block

language	js
theme	Eclipse
title	readBase64()
linenumbers	true

const read = new SimpleAttachment();
ss.info(read.readBase64('159050716911764097168025458107121347'));
// Информация: 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 attachIDattachId =
    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,

contentType

mimeContentType)

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

Параметры:

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

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

Тип	Описание
String

или NULL

Метода возвращает

sys_ID вложения

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);
//Info Информация: 162245472311776172

Table of Contents

absoluteUrl	true
class	fixedPosition

Page tree

Versions Compared

Old Version 6

New Version Current

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)