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

При помощи метода RefItem.fetch можно получить элемент приложения, на который указывает объект-ссылка. Если элемент приложения не будет найден, то вызов метода вернет ошибку, которую следует корректно обработать. Пример кода:

let appItem: any;
try {
    appItem = await Context.data.any_app.fetch();
} catch (err) {
    // Тут должна быть обработка ошибки получения элемента приложения
    // Ошибка может возникнуть, например, если элемент, на который ссылатся объект типа `RefItem`, не найден
}

Объект-ссылку можно создать, используя конструктор:

const refItem = new RefItem(namespace, code, id);

Где:

— namespace — код раздела;

— code — код приложения;

— id — уникальный идентификатор элемента.

Если точно известно приложение, на элемент которого указывает объект-ссылка, то в конструкторе можно явно указать тип целевого элемента:

// Объект-ссылка, которая указывает на элемент типа Пользователь
const refUserItem = new RefItem<UserItem>('system', 'users', userId);