---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.0
alternate:
  - en/concepts/chart/versioning
  - ru/concepts/chart/versioning
  - href: ru/concepts/chart/versioning.md
    type: text/markdown
    title: Markdown version
csp:
  - script-src:
      - https://mc.yandex.ru
    img-src:
      - https://mc.yandex.ru
    connect-src:
      - https://mc.yandex.ru
      - wss://mc.yandex.ru
    child-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-ancestors:
      - 'blob:'
      - https://mc.yandex.ru
canonical: ru/concepts/chart/versioning.html
title: Версионирование чарта в DataLens On-premises
description: >-
  Версионирование чарта в DataLens On-premises — это возможность хранить историю
  изменений конфигурации чарта с помощью версий. Список версий доступен
  пользователям с минимальным правом доступа Редактирование на чарт.
vcsPath: ru/concepts/chart/versioning.md
---

# Версионирование в DataLens On-premises

Версионирование чарта — это возможность хранить историю изменений конфигурации чарта с помощью версий. Список версий доступен пользователям с минимальным правом редактирования на чарт.

Чтобы перейти к списку версий, в верхней части экрана нажмите на значок <!-- diplodoc:svg ![image](../../_assets/console-icons/ellipsis.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M3 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3M9.5 8a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0m5 0a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0" clip-rule="evenodd"/></svg> и выберите **История изменений**.

![image](../../_assets/datalens/concepts/chart-version-list.png)

Чтобы перейти к выбранной версии, нажмите на нее в списке. Номер версии отобразится в значении параметра `revId` строки адреса чарта. При переходе по ссылке, содержащей номер версии в параметре `revId`, сразу откроется эта версия чарта.


При редактировании в пределах текущей версии можно отменить или повторно выполнить внесенные изменения. Для этого нажмите:

* значок <!-- diplodoc:svg ![image](../../_assets/console-icons/arrow-uturn-ccw-left.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M2.47 4.72a.75.75 0 0 0 0 1.06l3 3a.75.75 0 0 0 1.06-1.06L4.81 6H9a3.25 3.25 0 0 1 0 6.5H8A.75.75 0 0 0 8 14h1a4.75 4.75 0 1 0 0-9.5H4.81l1.72-1.72a.75.75 0 0 0-1.06-1.06z" clip-rule="evenodd"/></svg> в верхней правой части экрана или сочетание клавиш **Ctrl** (**Cmd**) + **Z** — чтобы отменить изменения;
* значок <!-- diplodoc:svg ![image](../../_assets/console-icons/arrow-uturn-cw-right.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M13.53 4.72a.75.75 0 0 1 0 1.06l-3 3a.75.75 0 1 1-1.06-1.06L11.19 6H7a3.25 3.25 0 0 0 0 6.5h1A.75.75 0 0 1 8 14H7a4.75 4.75 0 1 1 0-9.5h4.19L9.47 2.78a.75.75 0 0 1 1.06-1.06z" clip-rule="evenodd"/></svg> в верхней правой части экрана или сочетание клавиш **Ctrl** (**Cmd**) + **Shift** + **Z** — чтобы повторно выполнить изменения.

Несохраненные изменения в текущей версии сбрасываются:

* при обновлении страницы;
* при сохранении чарта;
* при переключении на другую версию.

## Виды версий {#version-types}

Различают следующие версии:

1. **Актуальная**. Последняя сохраненная версия чарта.

   Версия отображается:
   
   * всем пользователям на дашбордах;
   
   
   * при открытии чарта в воркбуке;
   * при открытии чарта из контекстного меню на редактирование с дашборда.
   
   Актуальной может быть только одна версия чарта.

   Если у пользователя есть право доступа **Редактирование**, он может сделать актуальной любую версию чарта.
  
   {% note warning %}
  
   При актуализации любой версии, кроме черновой, создается новая версия чарта.

   {% endnote %}
  
1. **Черновик**. Версия, которая содержит несохраненные изменения чарта. Основные пользователи не видят изменений, которые вносятся в черновик. Это позволяет скрывать редактирование чарта до актуализации версии. Чарт может иметь только один черновик. 
   При открытии черновика вверху отображается панель, на которой указаны: тип версии, дата и время создания и логин автора версии. Справа на панели кнопки:

   * **Сделать актуальной** — делает черновик актуальной версией. Актуальная на текущий момент версия станет неактуальной.
   * **Открыть актуальную** — открывает актуальную версию.

   {% cut "Черновик" %}
   
   ![image](../../_assets/datalens/concepts/chart-draft-version.png)

   {% endcut %}

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

   При наличии черновой версии чарта можно сразу открыть ее, если добавить в URL параметр `unreleased=1`.

   Черновую версию чарта можно отобразить на дашборде. Для этого [добавьте в параметры](../../operations/chart/add-parameters.md) виджета на дашборде для этого чарта параметр `unreleased` со значением `1`.

1. **Неактуальная**. Версия, которая не является актуальной или черновиком.  
   При открытии неактуальной версии вверху отображается панель, на которой указаны: тип версии, дата и время создания и логин автора версии. Справа на панели кнопки:

   * **Сделать актуальной** — делает текущую неактуальную версию актуальной. Актуальная на текущий момент версия и черновик (если он есть) станут неактуальными.
   * **Открыть актуальную** — открывает актуальную версию.

   {% cut "Неактуальная версия" %}

   ![image](../../_assets/datalens/concepts/chart-irrelevant-version.png)

   {% endcut %}

![image](../../_assets/datalens/concepts/chart-version-types.png)

{% note tip %}

Любой версией чарта можно поделиться: добавьте к ссылке на чарт параметр `revId` (например, `?revId=zac5m4edoaqqr`).

{% endnote %}


## Создание новой версии {#version-create}

Новая версия автоматически создается:

* в режиме редактирования актуальной версии чарта — после нажатия кнопки **Сохранить** (создается новая актуальная версия) или <!-- diplodoc:svg ![chevron-down](../../_assets/console-icons/chevron-down.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M2.97 5.47a.75.75 0 0 1 1.06 0L8 9.44l3.97-3.97a.75.75 0 1 1 1.06 1.06l-4.5 4.5a.75.75 0 0 1-1.06 0l-4.5-4.5a.75.75 0 0 1 0-1.06" clip-rule="evenodd"/></svg> → **Сохранить как черновик** (создается новая черновая версия);
* в режиме редактирования черновика или неактуальной версии чарта — после нажатия кнопки **Сохранить как черновик** (создается новая черновая версия) или <!-- diplodoc:svg ![chevron-down](../../_assets/console-icons/chevron-down.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M2.97 5.47a.75.75 0 0 1 1.06 0L8 9.44l3.97-3.97a.75.75 0 1 1 1.06 1.06l-4.5 4.5a.75.75 0 0 1-1.06 0l-4.5-4.5a.75.75 0 0 1 0-1.06" clip-rule="evenodd"/></svg> → **Сохранить и сделать актуальной** (создается новая актуальная версия);
* в режиме просмотра черновика или неактуальной версии чарта — после нажатия кнопки **Сделать актуальной**.

Изменения конфигурации чарта, которые после сохранения приводят к созданию новой версии:

* изменение настроек чарта, доступных при нажатии на значок <!-- diplodoc:svg ![image](../../_assets/console-icons/gear.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M7.199 2H8.8a.2.2 0 0 1 .2.2c0 1.808 1.958 2.939 3.524 2.034a.2.2 0 0 1 .271.073l.802 1.388a.2.2 0 0 1-.073.272c-1.566.904-1.566 3.164 0 4.069a.2.2 0 0 1 .073.271l-.802 1.388a.2.2 0 0 1-.271.073C10.958 10.863 9 11.993 9 13.8a.2.2 0 0 1-.199.2H7.2a.2.2 0 0 1-.2-.2c0-1.808-1.958-2.938-3.524-2.034a.2.2 0 0 1-.272-.073l-.8-1.388a.2.2 0 0 1 .072-.271c1.566-.905 1.566-3.165 0-4.07a.2.2 0 0 1-.073-.27l.801-1.389a.2.2 0 0 1 .272-.072C5.042 5.138 7 4.007 7 2.199c0-.11.089-.199.199-.199M5.5 2.2c0-.94.76-1.7 1.699-1.7H8.8c.94 0 1.7.76 1.7 1.7a.85.85 0 0 0 1.274.735 1.7 1.7 0 0 1 2.32.622l.802 1.388c.469.813.19 1.851-.622 2.32a.85.85 0 0 0 0 1.472 1.7 1.7 0 0 1 .622 2.32l-.802 1.388a1.7 1.7 0 0 1-2.32.622.85.85 0 0 0-1.274.735c0 .939-.76 1.7-1.699 1.7H7.2a1.7 1.7 0 0 1-1.699-1.7.85.85 0 0 0-1.274-.735 1.7 1.7 0 0 1-2.32-.622l-.802-1.388a1.7 1.7 0 0 1 .622-2.32.85.85 0 0 0 0-1.471 1.7 1.7 0 0 1-.622-2.32l.801-1.389a1.7 1.7 0 0 1 2.32-.622A.85.85 0 0 0 5.5 2.2m4 5.8a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0M11 8a3 3 0 1 1-6 0 3 3 0 0 1 6 0" clip-rule="evenodd"/></svg> вверху экрана;
* добавление, переименование, удаление полей чарта;
* добавление, удаление полей в секции чарта.

## Редактирование версий {#version-edit}

Можно редактировать любую версию чарта.

### Редактирование актуальной версии {#actual-version-edit}

Если в чарте есть черновик, при переходе к редактированию актуальной версии на верхней панели появится сообщение о наличии черновой версии в истории изменений.

![image](../../_assets/datalens/concepts/chart-with-draft-version.png)

Нажмите на кнопку:

* **Открыть черновик** — чтобы перейти к черновику.
* **Показать в истории** — чтобы отобразить список версий.

### Редактирование черновика {#irrelevant-version-edit}

Для редактирования черновика выберите его в списке версий. Чтобы сохранить изменения черновика, вверху справа нажмите:

* **Сохранить как черновик** — будет создан новый черновик. Текущий черновик станет неактуальной версией.
* <!-- diplodoc:svg ![image](../../_assets/console-icons/chevron-down.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M2.97 5.47a.75.75 0 0 1 1.06 0L8 9.44l3.97-3.97a.75.75 0 1 1 1.06 1.06l-4.5 4.5a.75.75 0 0 1-1.06 0l-4.5-4.5a.75.75 0 0 1 0-1.06" clip-rule="evenodd"/></svg> → **Сохранить как копию** — будет создан новый чарт.
* <!-- diplodoc:svg ![image](../../_assets/console-icons/chevron-down.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M2.97 5.47a.75.75 0 0 1 1.06 0L8 9.44l3.97-3.97a.75.75 0 1 1 1.06 1.06l-4.5 4.5a.75.75 0 0 1-1.06 0l-4.5-4.5a.75.75 0 0 1 0-1.06" clip-rule="evenodd"/></svg> → **Сохранить и сделать актуальной** — будет создана новая актуальная версия, а все остальные версии станут неактуальными.

### Редактирование неактуальной версии {#current-version-edit}

Для редактирования неактуальной версии выберите ее в списке версий. Чтобы сохранить изменения неактуальной версии, вверху справа нажмите:

* **Сохранить как черновик** — будет создан черновик из редактируемой версии. Если есть текущий черновик, он станет неактуальной версией.
* <!-- diplodoc:svg ![image](../../_assets/console-icons/chevron-down.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M2.97 5.47a.75.75 0 0 1 1.06 0L8 9.44l3.97-3.97a.75.75 0 1 1 1.06 1.06l-4.5 4.5a.75.75 0 0 1-1.06 0l-4.5-4.5a.75.75 0 0 1 0-1.06" clip-rule="evenodd"/></svg> → **Сохранить как копию** — будет создан новый чарт.
* <!-- diplodoc:svg ![image](../../_assets/console-icons/chevron-down.svg) --><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M2.97 5.47a.75.75 0 0 1 1.06 0L8 9.44l3.97-3.97a.75.75 0 1 1 1.06 1.06l-4.5 4.5a.75.75 0 0 1-1.06 0l-4.5-4.5a.75.75 0 0 1 0-1.06" clip-rule="evenodd"/></svg> → **Сохранить и сделать актуальной** — будет создана новая актуальная версия, а все остальные, включая черновик, станут неактуальными.

## Ограничения {#restrictions}

* История изменений доступна только за последние три месяца.
* История изменений содержит только список версий чарта и включает: вид версии, дату и время сохранения и автора редактирования.
* Версии чарта не содержат изменений прав доступа (эта операция производится отдельно от редактирования самого чарта).
* В версиях не отображается список изменений. Доступен лишь просмотр сохраненного состояния конфигурации чарта.