From 678b788b32ac4a42c1e9254d63069a86aed452fc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9=20=D0=9C=D0=B0?=
 =?UTF-8?q?=D0=BA=D0=B0=D1=80=D0=BE=D0=B2?= <dmakarov@optimacros.com>
Date: Tue, 29 Apr 2025 13:38:39 +0300
Subject: [PATCH 1/2] getCollection docs

---
 API/common.md       | 5 +++--
 API/scripts.om.d.ts | 2 +-
 changelog.md        | 2 +-
 3 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/API/common.md b/API/common.md
index 82d87b4..2ef60db 100644
--- a/API/common.md
+++ b/API/common.md
@@ -747,10 +747,11 @@ get(longId: number): EntityInfo | null;
 
 &nbsp;
 
+<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;
 
diff --git a/API/scripts.om.d.ts b/API/scripts.om.d.ts
index 498db23..2091dbb 100644
--- a/API/scripts.om.d.ts
+++ b/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 {
diff --git a/changelog.md b/changelog.md
index cab1b0a..c73930e 100644
--- a/changelog.md
+++ b/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> |

From 76c47af110f96812deb8927e48739d7aea7ded44 Mon Sep 17 00:00:00 2001
From: mgolovkina <m.golovkina@optimacros.com>
Date: Thu, 19 Jun 2025 22:56:03 +0700
Subject: [PATCH 2/2] Small corrections after review

---
 API/common.md | 2 +-
 changelog.md  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/API/common.md b/API/common.md
index e058088..ec9f705 100644
--- a/API/common.md
+++ b/API/common.md
@@ -751,7 +751,7 @@ get(longId: number): EntityInfo | null;
 ```js
 getCollection(longId: number[]): (EntityInfo | null)[];
 ```
-Возвращает массив сущностей [`EntityInfo`](#entity-info) параллельный массиву их [`longId`](#long-id). Если сущность не найдена, на её месте будет возвращён `null`.
+Возвращает массив сущностей [`EntityInfo`](#entity-info), параллельный массиву их [`longId`](#long-id). Если сущность не найдена, на её месте будет возвращёно значение `null`.
 
 &nbsp;
 
diff --git a/changelog.md b/changelog.md
index c73930e..5e9da48 100644
--- a/changelog.md
+++ b/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>Был **обратно несовместимо** переработан метод [`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> |
+| 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> |