[Документация Yandex Cloud](../../index.md) > [Yandex DataLens](../index.md) > [Воркбуки и коллекции](index.md) > Работа с воркбуком

# Работа с воркбуком Yandex DataLens

В этом разделе вы узнаете, как работать с воркбуком:

* [Создать воркбук](#create-workbook)
* [Редактировать воркбук](#edit-workbook)
* [Переместить воркбук](#move-workbook)
* [Копировать воркбук](#copy-workbook)
* [Экспортировать воркбук](#export-workbook)
* [Добавить или удалить ключи для встраивания](#embedded-keys)
* [Настроить доступ к воркбуку](#security)
* [Удалить воркбук](#delete-workbook)

Большинство действий можно выполнить как из коллекции, так и со страницы воркбука.

{% list tabs %}

- Из коллекции
  
  Напротив нужного воркбука нажмите ![image](../../_assets/console-icons/ellipsis.svg) и выберите требуемое действие.

- В воркбуке
  
  На странице воркбука вверху нажмите ![image](../../_assets/console-icons/ellipsis.svg) и выберите требуемое действие. Для некоторых действий предусмотрены отдельные кнопки.

{% endlist %}

Ниже описаны действия, выполняемые со страницы воркбука.

## Создать воркбук {#create-workbook}

Чтобы создать воркбук:

1. Перейдите на [главную страницу](https://datalens.ru) DataLens.
1. На панели слева выберите ![collections](../../_assets/console-icons/rectangles-4.svg) **Коллекции и воркбуки**.

   
   {% note info %}
   
   Если вы не видите на панели слева ![collections](../../_assets/console-icons/rectangles-4.svg) **Коллекции и воркбуки**, попросите пользователя с ролью `datalens.admin` [включить воркбуки и коллекции](index.md#enable-workbooks) в вашей организации.
   
   {% endnote %}


1. В правом верхнем углу нажмите **Создать** → **Создать воркбук**.
1. Укажите название воркбука.
1. (опционально) Укажите описание воркбука.
1. (опционально) Нажмите кнопку **Выбрать файл** для [импорта](export-and-import.md#import-workbook) воркбука.
1. Нажмите кнопку **Создать**.

<iframe width="650" height="366" src="https://runtime.strm.yandex.ru/player/video/vplvjkoqfpihhax3cw34?autoplay=0&mute=0" allow="autoplay; fullscreen; accelerometer; gyroscope; picture-in-picture; encrypted-media" frameborder="0" scrolling="no"></iframe>

## Редактировать воркбук {#edit-workbook}

Чтобы изменить название и описание воркбука:

1. Вверху страницы воркбука рядом с названием нажмите ![image](../../_assets/console-icons/pencil-to-line.svg) **Редактировать**.
1. Введите новое название и описание воркбука и нажмите кнопку **Сохранить**.

## Переместить воркбук {#move-workbook}

Чтобы переместить воркбук:

1. На странице воркбука вверху нажмите ![image](../../_assets/console-icons/ellipsis.svg) → ![image](../../_assets/console-icons/arrow-right.svg) **Переместить**.
1. Выберите коллекцию, в которую хотите переместить воркбук, и нажмите кнопку **Переместить**. Чтобы переместить воркбук в новую коллекцию, нажмите кнопку **Создать коллекцию**.

## Копировать воркбук {#copy-workbook}

Чтобы создать копию воркбука:

1. На странице воркбука вверху нажмите ![image](../../_assets/console-icons/ellipsis.svg) → ![icon](../../_assets/console-icons/copy.svg) **Копировать**.
1. В открывшемся окне выберите коллекцию, в которую хотите скопировать воркбук, и нажмите кнопку **Копировать**. Чтобы скопировать воркбук в новую коллекцию, нажмите кнопку **Создать коллекцию**.
1. Введите название нового воркбука и нажмите кнопку **Копировать**.

После копирования воркбука вы можете удалить лишние или создать новые объекты в нем.


## Экспортировать воркбук {#export-workbook}

Вы можете [экспортировать воркбук](export-and-import.md#export-workbook) и скачать файл экспорта в формате JSON. С помощью инструментов экспорта и импорта в DataLens можно переносить [воркбуки](index.md) между инсталляциями. Подробнее читайте в разделе [Экспорт и импорт воркбуков Yandex DataLens](export-and-import.md).



## Добавить или удалить ключи для встраивания {#embedded-keys}

Вы можете безопасно [встроить непубличные объекты](../security/private-embedded-objects.md#how-to-private-embed) на сайт или в приложение с помощью специальных ссылок с JWT-токеном. При генерации JWT-токена используются ключи для встраивания.

Чтобы добавить ключи для встраивания:

1. На странице воркбука вверху нажмите ![ellipsis](../../_assets/console-icons/ellipsis.svg) и выберите ![key](../../_assets/console-icons/key.svg) **Ключи для встраивания**.
1. Нажмите кнопку ![plus](../../_assets/console-icons/plus.svg) **Создать ключ**.
1. Введите название ключа и нажмите кнопку **Создать**.
1. Внизу нажмите кнопку **Скачать файл с ключом** или скопируйте значение ключа.

   {% note warning %}

   После закрытия окна все данные из него будут потеряны.

   {% endnote %}

   Новый ключ для встраивания появится в списке.

Чтобы удалить ключ для встраивания:

1. На странице воркбука вверху нажмите ![ellipsis](../../_assets/console-icons/ellipsis.svg) и выберите ![key](../../_assets/console-icons/key.svg) **Ключи для встраивания**.
1. Напротив ключа нажмите ![key](../../_assets/console-icons/trash-bin.svg) и подтвердите удаление ключа.

Подробнее о встраивании непубличных объектов читайте в разделе [Встраивание через JWT](../security/private-embedded-objects.md).



## Настроить доступ к воркбуку {#security}

На каждый воркбук и коллекцию можно назначать права доступа пользователям и [группам пользователей](../../organization/operations/create-group.md). [Права доступа](../security/roles.md#workbooks-collections-roles) определяют допустимые операции по отношению к воркбуку или коллекции. При этом выполняется наследование прав доступа:

* права на воркбук распространяются на все объекты внутри него;
* права на коллекцию распространяются на все коллекции и воркбуки внутри нее, а также на объекты внутри воркбуков.

Права доступа можно назначить отдельным пользователям или группам, в которые входят пользователи, прошедшие [аутентификацию](../../iam/concepts/authorization/index.md#authentication).

{% note info %}

* Для воркбуков и коллекций можно назначать права пользователям, даже если они еще не приняли [приглашение в DataLens](../security/add-new-user.md).
* Права наследуются всеми вложенными объектами. Унаследованные права можно изменить только на уровне родительского объекта, от которого они наследуются.

{% endnote %}

### Назначить права доступа {#wb-coll-grant}

Чтобы назначить права доступа к воркбуку:
  
1. На странице воркбука вверху нажмите ![icon](../../_assets/console-icons/lock-open.svg) **Доступ**.

   В блоке **Наследуемые права** отображаются пользователи, которые унаследовали права доступа к объекту, потому что им были назначены права на один из его родительских объектов. Для каждого пользователя указывается унаследованное право доступа и сам объект, от которого это право унаследовано.

   В блоке **Прямые права** отображаются пользователи, которым назначены права на выбранный объект.

1. Нажмите кнопку ![image](../../_assets/console-icons/plus.svg) **Добавить пользователя**.
1. В открывшемся окне выберите пользователя или группу, укажите право доступа и нажмите кнопку **Сохранить**. Пользователю или группе будут назначены права на данный объект.

### Отозвать права доступа {#wb-coll-revoke}

Чтобы отозвать права доступа к воркбуку:

1. На странице воркбука вверху нажмите ![icon](../../_assets/console-icons/lock-open.svg) **Доступ**.
1. В блоке **Прямые права** напротив пользователя (группы), у которого вы хотите отозвать права, нажмите значок ![image](../../_assets/console-icons/trash-bin.svg).

   {% note info %}

   Если пользователя нет в списке, возможно, ему назначены права на родительский объект. Вы можете отозвать права для родительского объекта. Чтобы перейти к объекту наследования прав, найдите пользователя в списке **Наследуемые права** и нажмите на название объекта.

   {% endnote %}

1. В открывшемся окне нажмите **Отозвать роль**.


## Удалить воркбук {#delete-workbook}

Чтобы удалить воркбук:

1. На странице воркбука вверху нажмите ![image](../../_assets/console-icons/ellipsis.svg) → ![icon](../../_assets/console-icons/trash-bin.svg) **Удалить**.

1. Подтвердите удаление воркбука.