From fc4d417abcb17ee76fa905c04428597ce1f7dd9b Mon Sep 17 00:00:00 2001 From: ivanbaluta Date: Fri, 3 Apr 2026 18:30:40 +0700 Subject: [PATCH] Improve wording and fix inconsistencies in DataLens workbooks and collections docs --- .../workbooks-collections/export-import-notifications.md | 4 ++-- en/datalens/workbooks-collections/index.md | 6 +++--- en/datalens/workbooks-collections/migrations.md | 2 +- ru/datalens/workbooks-collections/collections-operations.md | 2 +- ru/datalens/workbooks-collections/export-and-import.md | 2 +- .../workbooks-collections/export-import-notifications.md | 4 ++-- ru/datalens/workbooks-collections/index.md | 4 ++-- ru/datalens/workbooks-collections/migrations.md | 2 +- ru/datalens/workbooks-collections/workbooks-operations.md | 4 ++-- 9 files changed, 15 insertions(+), 15 deletions(-) diff --git a/en/datalens/workbooks-collections/export-import-notifications.md b/en/datalens/workbooks-collections/export-import-notifications.md index d0bd90d7fd..d61ea23841 100644 --- a/en/datalens/workbooks-collections/export-import-notifications.md +++ b/en/datalens/workbooks-collections/export-import-notifications.md @@ -21,7 +21,7 @@ Check RLS for correct operation and reconfigure it if needed. Critical error. In {{ datalens-short-name }}, each entity has required fields with prescribed formats. The error indicates missing required fields or wrong data type. Fix the configuration or try re-exporting the workbook. -#### Workbook contains objects with incorrect type {#export-object-type-error} +#### Workbook contains objects with an incorrect type {#export-object-type-error} It is likely that the workbook configuration was edited and some objects got wrong types. For example, the `Chart` type was set for a dashboard. Fix the configuration or try re-exporting the workbook. @@ -81,7 +81,7 @@ When importing connections using a {{ connection-manager-name }} service account Critical error. In {{ datalens-short-name }}, each entity has required fields with prescribed formats. The error indicates missing required fields or wrong data type. Fix the configuration or try re-exporting the workbook. -#### Workbook contains objects with incorrect type {#import-object-type-error} +#### Workbook contains objects with an incorrect type {#import-object-type-error} It is likely that the workbook configuration was edited and some objects got wrong types. For example, the `Chart` type was set for a dashboard. Fix the configuration or try re-exporting the workbook. diff --git a/en/datalens/workbooks-collections/index.md b/en/datalens/workbooks-collections/index.md index 063756f645..41994a3c66 100644 --- a/en/datalens/workbooks-collections/index.md +++ b/en/datalens/workbooks-collections/index.md @@ -22,7 +22,7 @@ Workbooks and collections are a new way to store objects in {{ datalens-short-na Workbooks make it much easier to work with objects: -* They allow you to consistently [set up permissions](./workbooks-operations.md#wb-coll-grant) to linked objects: connections, datasets, charts, and dashboards. +* They allow you to consistently [set up permissions](./workbooks-operations.md#wb-coll-grant) for linked objects: connections, datasets, charts, and dashboards. * With them, you can set up permissions for [user groups](../../organization/operations/create-group.md). * You can copy workbooks maintaining the integrity of internal links and making their copies independent of the original. @@ -52,7 +52,7 @@ To transfer any object from a folder to a workbook, perform [migration](./migrat ## Viewing linked objects {#related-objects} -You can look up where the object is used or which objects are used by it. Do it by clicking ![image](../../_assets/console-icons/ellipsis.svg) → ![image](../../_assets/console-icons/code-trunk.svg) **Linked objects** on the workbook page or object editing window. For example, this can give you a clue as to the sources used to build a dashboard or the charts based on a certain dataset. +You can look up where the object is used or which objects are used by it. To do this, click ![image](../../_assets/console-icons/ellipsis.svg) → ![image](../../_assets/console-icons/code-trunk.svg) **Linked objects** on the workbook page or object editing window. For example, this can give you a clue as to the sources used to build a dashboard or the charts based on a certain dataset. {% cut "Linked object window" %} @@ -60,4 +60,4 @@ You can look up where the object is used or which objects are used by it. Do it {% endcut %} -If you get an error when opening the linked object window, click **Retry**. \ No newline at end of file +If you get an error when opening the linked object window, click **Retry**. diff --git a/en/datalens/workbooks-collections/migrations.md b/en/datalens/workbooks-collections/migrations.md index 0359718856..62c002a09e 100644 --- a/en/datalens/workbooks-collections/migrations.md +++ b/en/datalens/workbooks-collections/migrations.md @@ -42,7 +42,7 @@ When this migration type is selected, the object is transferred to the [workbook * Object IDs remain the same. * Links to objects do not change and lead to the workbook. -During migration, {{ datalens-short-name }} finds linked objects recursively across all links. Therefore, you to start your migration from any object. For example, from a dashboard. {{ datalens-short-name }} will find all linked charts, datasets, and connections. Then it will search for the links of the objects it found. Finally, it will prompt you to put all the objects it found into a single workbook. +During migration, {{ datalens-short-name }} finds linked objects recursively across all links. Therefore, you can start your migration from any object. For example, from a dashboard. {{ datalens-short-name }} will find all linked charts, datasets, and connections. Then it will search for the links of the objects it found. Finally, it will prompt you to put all the objects it found into a single workbook. {% note warning %} diff --git a/ru/datalens/workbooks-collections/collections-operations.md b/ru/datalens/workbooks-collections/collections-operations.md index 402305bc83..5e07afd404 100644 --- a/ru/datalens/workbooks-collections/collections-operations.md +++ b/ru/datalens/workbooks-collections/collections-operations.md @@ -5,7 +5,7 @@ description: Следуя данной инструкции, вы сможете # Работа с коллекцией {{ datalens-full-name }} -В этом разделе вы узнаете, как работать с воркбуком: +В этом разделе вы узнаете, как работать с коллекцией: * [Создать коллекцию](#create-collection) * [Редактировать коллекцию](#edit-collections) diff --git a/ru/datalens/workbooks-collections/export-and-import.md b/ru/datalens/workbooks-collections/export-and-import.md index 26b06890b2..a5d611c4d8 100644 --- a/ru/datalens/workbooks-collections/export-and-import.md +++ b/ru/datalens/workbooks-collections/export-and-import.md @@ -39,7 +39,7 @@ description: Следуя данной инструкции, вы сможете При попытке закрыть окно с индикатором до завершения процесса появится предупреждение о завершении экспорта. Выберите: * **Вернуться** — продолжить экспорт. - * **Отменить экспорт**. + * **Отменить экспорт** — прервать процесс. После завершения экспорта могут появиться [предупреждения](./export-import-notifications.md#export-notifications) об особенностях воркбука и список объектов, требующих внимания. Нажмите **Скачать**, чтобы скачать файл экспорта в формате JSON. diff --git a/ru/datalens/workbooks-collections/export-import-notifications.md b/ru/datalens/workbooks-collections/export-import-notifications.md index f8fce32c93..6f6bf7ee55 100644 --- a/ru/datalens/workbooks-collections/export-import-notifications.md +++ b/ru/datalens/workbooks-collections/export-import-notifications.md @@ -27,7 +27,7 @@ description: На данной странице приведены ошибки #### Инсталляция {{ datalens-short-name }} не поддерживает конфигурацию воркбука {#export-installation-error} -Версия чарта или дашборда не совместима с инсталляцией {{ datalens-short-name }}, в которую производится импорт. Например, экспорт выполнен из новой облачной версии {{ datalens-short-name }}, а импорт осуществляется в устаревшую версию open source {{ datalens-short-name }}. +Версия чарта или дашборда несовместима с инсталляцией {{ datalens-short-name }}, в которую производится импорт. Например, экспорт выполнен из новой облачной версии {{ datalens-short-name }}, а импорт осуществляется в устаревшую версию open source {{ datalens-short-name }}. #### В воркбуке есть объекты, связанные с несуществующими объектами {#export-bad-links} @@ -87,7 +87,7 @@ description: На данной странице приведены ошибки #### Инсталляция {{ datalens-short-name }} не поддерживает конфигурацию воркбука {#import-installation-error} -Версия чарта или дашборда не совместима с инсталляцией {{ datalens-short-name }}, в которую производится импорт. Например, экспорт выполнен из новой облачной версии {{ datalens-short-name }}, а импорт осуществляется в устаревшую версию open source {{ datalens-short-name }}. +Версия чарта или дашборда несовместима с инсталляцией {{ datalens-short-name }}, в которую производится импорт. Например, экспорт выполнен из новой облачной версии {{ datalens-short-name }}, а импорт осуществляется в устаревшую версию open source {{ datalens-short-name }}. #### В воркбуке есть объекты, связанные с несуществующими объектами {#import-bad-links} diff --git a/ru/datalens/workbooks-collections/index.md b/ru/datalens/workbooks-collections/index.md index d5fe0a025d..63d11eca3f 100644 --- a/ru/datalens/workbooks-collections/index.md +++ b/ru/datalens/workbooks-collections/index.md @@ -34,7 +34,7 @@ description: Из статьи вы узнаете, что такое воркб * Воркбуки можно собирать в коллекции. -Подходы к организации объектов в воркбуках и в папках старой объектной модели не пересекаются: +Объекты в воркбуках и папках старой объектной модели существуют независимо: * Воркбук нельзя положить в папку. * Объект из воркбука нельзя добавить на дашборд, размещенный в папке. @@ -65,4 +65,4 @@ description: Из статьи вы узнаете, что такое воркб {% endcut %} -Если при открытии окна связанных объектов отображается ошибка, попробуйте нажать кнопку **Повторить**. \ No newline at end of file +Если при открытии окна связанных объектов отображается ошибка, попробуйте нажать кнопку **Повторить**. diff --git a/ru/datalens/workbooks-collections/migrations.md b/ru/datalens/workbooks-collections/migrations.md index 4a7deb100c..d89ff0e325 100644 --- a/ru/datalens/workbooks-collections/migrations.md +++ b/ru/datalens/workbooks-collections/migrations.md @@ -42,7 +42,7 @@ description: Следуя данной инструкции, вы выполни * идентификаторы объектов остаются прежними; * ссылки на объекты не меняются и ведут в воркбук. -Во время переноса {{ datalens-short-name }} находит связанные объекты рекурсивно по всем связям. Поэтому миграцию можно начать с любого объекта. Например, с дашборда. {{ datalens-short-name }} найдет все связанные чарты, датасеты и подключения. Затем для найденных объектов также выполнит поиск связей. В итоге все найденные объекты предложит сложить в один воркбук. +Во время переноса {{ datalens-short-name }} находит связанные объекты рекурсивно по всем связям. Поэтому миграцию можно начать с любого объекта. Например, с дашборда. {{ datalens-short-name }} найдет все связанные чарты, датасеты и подключения. Затем для найденных объектов также выполнит поиск связей. В итоге {{ datalens-short-name }} предложит сложить все найденные объекты в один воркбук. {% note warning %} diff --git a/ru/datalens/workbooks-collections/workbooks-operations.md b/ru/datalens/workbooks-collections/workbooks-operations.md index bb588ac330..8ec861b0d4 100644 --- a/ru/datalens/workbooks-collections/workbooks-operations.md +++ b/ru/datalens/workbooks-collections/workbooks-operations.md @@ -30,7 +30,7 @@ description: Следуя данной инструкции, вы сможете {% endlist %} -В инструкциях опишем действия для способа через воркбук. +Ниже описаны действия, выполняемые со страницы воркбука. ## Создать воркбук {#create-workbook} @@ -147,4 +147,4 @@ description: Следуя данной инструкции, вы сможете 1. На странице воркбука вверху нажмите ![image](../../_assets/console-icons/ellipsis.svg) → ![icon](../../_assets/console-icons/trash-bin.svg) **Удалить**. -1. Подтвердите удаление воркбука. \ No newline at end of file +1. Подтвердите удаление воркбука.