getCollection update

API/common.md

@@ -747,10 +747,11 @@ get(longId: number): EntityInfo | null;
 
  
 
+<a name="entities-info.get-collection"></a>
 ```js
-getCollection(longId: number[]): EntityInfo[];
+getCollection(longId: number[]): (EntityInfo | null)[];
 ```
-Возвращает массив сущностей [`EntityInfo`](#entity-info) по массиву их [`longId`](#long-id). Корректно работает, только если все переданные `longId` корректные (существуют в модели). Иначе возвращает массив меньшей размерности. Использовать с осторожностью. Порядок возвращаемых сущностей `EntityInfo` может отличаться от порядка переданных `longId`.
+Возвращает массив сущностей [`EntityInfo`](#entity-info), параллельный массиву их [`longId`](#long-id). Если сущность не найдена, на её месте будет возвращёно значение `null`.
 
 &nbsp;
 

API/scripts.om.d.ts

@@ -783,7 +783,7 @@ export interface ResultInfo {
 
 export interface EntitiesInfo {
 	get(longId: number): EntityInfo | null;
-	getCollection(longId: number[]): EntityInfo[];
+	getCollection(longId: number[]): (EntityInfo | null)[];
 }
 
 export interface CopyData {

changelog.md

@@ -2,7 +2,7 @@
 
 | Дата релиза | Тег релиза | Версия ScriptAPI | Версии MiddleWork | Версия приложения | Изменения |
 | --- | --- | --- | --- | --- | --- |
-| xx.xx.xxxx | [v9.300](https://github.com/optimacros/scripts_documentation/tree/v9.300) | — | <ul><li>9.300</li></ul> | <ul><li> — </li></ul> | <ul><li>Интерфейсы доступа к содержимому грида — заголовкам и ячейкам — были вынесены в отдельный файл — [readingGrid.md](./API/readingGrid.md)</li><li>Добавлен интерфейс постраничного получения списка опций значений клетки [DropDownSelector](./API/readingGrid.md#dropdown-selector) и метод для получения доступа к нему — [`Cell.dropDownSelector()`](./API/readingGrid.md#cell.dropdown-selector)</li><li>Метод получения списка опций значений клетки [`Cell.dropDown()`](./API/readingGrid.md#cell.dropdown) признан устаревшим</li></ul> |
+| xx.xx.xxxx | [v9.300](https://github.com/optimacros/scripts_documentation/tree/v9.300) | — | <ul><li>9.300</li></ul> | <ul><li> — </li></ul> | <ul><li>Интерфейсы доступа к содержимому грида — заголовкам и ячейкам — вынесены в отдельный файл [readingGrid.md](./API/readingGrid.md)</li><li>**Обратно несовместимо** переработан метод [`EntitiesInfo.getCollection()`](./API/common.md#entities-info.get-collection)</li><li>Добавлен интерфейс постраничного получения списка опций значений клетки [DropDownSelector](./API/readingGrid.md#dropdown-selector) и метод для получения доступа к нему — [`Cell.dropDownSelector()`](./API/readingGrid.md#cell.dropdown-selector)</li><li>Метод получения списка опций значений клетки [`Cell.dropDown()`](./API/readingGrid.md#cell.dropdown) признан устаревшим</li></ul> |
 | 24.03.2025 | [v9.300](https://github.com/optimacros/scripts_documentation/tree/v9.300) | — | <ul><li>9.300</li></ul> | <ul><li> — </li></ul> | <ul><li>В интерфейсе [Filesystem](./API/fs.md#filesystem) изменены декларации функций `delete()`, `rename()`, `copy()`, `createDir()`, `deleteDir()`, `getSize()`</li><li>В интерфейс [CellBuffer](./API/common.md#cell-buffer) добавлена функция `lastApplyErrors()`</li><li>В интерфейсе [Importer](./API/exportImport.md#importer) исправлены исключения, которые могут бросать функции</li></ul> |
 | 16.12.2024 | [v9.?00.x.x](https://github.com/optimacros/scripts_documentation/tree/v9.?00.x.x) | — | <ul><li>9.?00.x.x</li></ul> | <ul><li> — </li></ul> | <ul><li>Интерфейс работы с лицензиями воркспейса `EnterpriseLicenseManager` заменён на новый интерфейс работы с данными договора о параметрах воркспейса [EnterpriseContractManager](./API/common.md#enterprise-contract-manager)</li></ul> |
 | 15.11.2024 | [9.200.x.13](https://github.com/optimacros/scripts_documentation/tree/v9.200.x.13) | — | <ul><li>9.200.dev.13</li></ul> | <ul><li> 9.200.x.x </li></ul> | <ul><li>В интерфейс [Filesystem](./API/fs.md#filesystem) добавлен метод для изменения кодировки файла `changeTextFileCharset()`</li></ul> |