JavaScript Records API

Общее

В контексте серверного JavaScript для работы с Records API добавлен сервис Records, который доступен в глобальном контексте.

Класс сервиса: ru.citeck.ecos.records.script.RepoScriptRecordsService

В сервисе предусмотрены следующие методы:

Возвращаемое значение	Название метода	Аргументы (* - обязательный)
Any (в зависимости от attributes)	getAtts	record*: RecordRef, attributes*: RecordAttributes
Record	get	record*: RecordRef
QueryRes	query	query*: RecsQuery, attributes: RecordAttributes

Типы:

• RecordRef - ссылка на запись. Допустимые значения: NodeRef, RecordRef, ScriptNode, String;

• Record - инстанс записи, у которой можно запросить атрибуты или записать туда атрибуты;

• QueryRes - результат поиска;

• RecsQuery - запрос на поиск записей;

• RecordAttributes - атрибуты для получения. Допустимо передавать String или String[] или Map<String, String>.

Возможные варианты:

1. Если мы передаем string, то получаем обычное значение (строка, число и тд.).

2. Если мы передаем массив [«aa», «bb»], то это эквивалентно объекту (Map) {"aa":"aa","bb":"cc"}

3. Если мы передаем объект (Map), то в результате получим тот же объект, но вместо значений исходного объекта будут значения атрибутов. Пример:

Пример:

{"disp": "cm:title"} -> {"disp": "Договор №2"}

• getAtts - получить атрибуты по заранее известной записи или записям (допускается массив);

• get - получить инстанс записи, с которым можно проводить операции чтения/записи атрибутов;

• query - выполнить поисковый запрос для получения записей.

Описание Record:

Возвращаемое значение	Название метода	Аргументы (* - обязательный)
RecordRef	getRef	-
String	getLocalId	-
Any (в зависимости от attributes)	load	attributes*: RecordAttributes
-	att	name*: String, value*: Any
Record	save	-

• getRef - получить RecordRef записи;

• getLocalId - получить локальный идентификатор записи;

• load - загрузить атрибуты из записи. Описание аргумента RecordAttributes см выше;

• att - установить значение некоторого атрибута в записи. Без вызова save ничего с реальной записью не происходит;

• save - сохранить изменения, которые сделаны с записью через метод att.

Методы att и save доступны с версии ecos-community-core 4.1.0

Примеры

Поиск записей:

var result = Records.query({
  sourceId: '',
  query: 'TYPE:"cm:person"',
  language: 'fts-alfresco'
}, ['cm:userName', 'cm:firstName']).records;

Загрузка атрибутов записи:

var result = Records.getAtts(['people@admin', 'people@fet'], {'aa': 'cm:userName'});
---
var result = Records.get('people@admin').load(['cm:userName', 'cm:firstName']) ;
---
var result = Records.get('people@admin').load('cm:firstName');

Изменение записи:

var rec = Records.get('workspace://SpacesStore/c34da292-fa35-4593-a08b-0e3a2c675db7');

rec.att('idocs:note', 'Some Value');
rec.att('ecos:documentAmount', 123);

rec.save();