Редактирование Предзаполненных значений в Webclient

Функция Предзаполненные значения Sparkify позволяет один раз задать значения по умолчанию для полей документации, и они автоматически подставляются везде, где применимы. Редактировать — это действие, доступное на уровне проекта в Webclient, когда вы хотите обновить само предзаполненное значение уровня проекта — откройте существующее предзаполнение через значок карандаша, введите новое значение и подтвердите. Новое значение сохраняется как предзаполнение уровня проекта и становится значением по умолчанию для каждой новой Документации, создаваемой из того же шаблона в дальнейшем.

Редактирование не переписывает существующие Документации проекта. Оно лишь обновляет предзаполнение, хранящееся на уровне проекта. Чтобы распространить новое значение также на Документации, которые уже существуют в проекте — то есть переписать поле в каждой из них — Владелец или Менеджер должен выполнить Применение как отдельный шаг.

Кто может это использовать

Редактирование в Webclient доступно Владельцам, Менеджерам и Пользователям. Все трое видят значок молнии и кнопку Предзаполненные значения на информационной карточке проекта и находят опцию Редактировать предзаполненные значения внутри выпадающего меню. Исключены только Гости. Редактирование открыто роли Пользователя, потому что само действие имеет низкие ставки: оно лишь обновляет значение предзаполнения уровня проекта; оно не переписывает существующие Документации. (Этот второй шаг — Применение, которое ограничено Владельцами и Менеджерами.) Если вы Гость и вам нужно отредактировать предзаполненное значение на уровне проекта, попросите Владельца, Менеджера или Пользователя выполнить это.

Где появляется Редактировать

Редактирование на уровне проекта в Webclient доступно через значок молнии в верхней панели или кнопку Предзаполненные значения на информационной карточке проекта — обе открывают одно и то же выпадающее меню с двумя вариантами: Применить предзаполненные значения и Редактировать предзаполненные значения. На уровне Workspace также есть опция Редактировать, которая делает то же самое в рамках workspace: обновляет значение предзаполнения для всего workspace, используемое как значение по умолчанию для новых Документаций в дальнейшем. Ни Редактирование на уровне Workspace, ни Редактирование на уровне проекта не переписывает существующие Документации — это задача Применения.

Описания точек входа и снимки экрана см. в родительской статье: Предзаполненные значения.

Что делает Редактировать

Редактирование позволяет открыть существующее предзаполнение уровня проекта через значок карандаша и ввести новое значение напрямую. После подтверждения новое значение сохраняется на уровне проекта и используется как значение по умолчанию для каждой новой Документации, создаваемой из того же шаблона в дальнейшем. Существующие Документации проекта не затрагиваются Редактированием; они сохраняют то значение, которое имели при создании.

Шаг подтверждения

Подтверждение Редактирования — это простое уведомление об успехе. После того как вы ввели новое значение и подтвердили, вы увидите сообщение Предзаполненное значение обновлено — и всё. Никакого предварительного просмотра области действия, никакой массовой перезаписи, никакого шага распространения. Новое значение теперь является предзаполнением уровня проекта, используемым как значение по умолчанию для каждой новой Документации, создаваемой из того же шаблона.

Если вы также хотите, чтобы существующие Документации проекта были переписаны с новым значением, это отдельное действие: Владелец или Менеджер должен выполнить Применение, которое запускает перезапись по всему проекту со своим собственным подтверждением с предварительным просмотром области действия.

Редактировать или Применить?

Редактировать и Применить — это два отдельных потока с разными эффектами.

• Редактировать сохраняет новое значение как предзаполнение уровня проекта. После подтверждения вы получаете уведомление «Предзаполненное значение обновлено» — и всё. Новые Документации, создаваемые из шаблона в дальнейшем, стартуют с новым значением, но существующие Документации проекта не затрагиваются.
• Применить — это то, что переписывает значение во всех существующих Документациях проекта, которые используют выбранный шаблон. Владелец или Менеджер открывает поток Применения, выбирает Шаблон документации, выбирает поля и значения и подтверждает — в этот момент происходит перезапись по всему проекту.

Редактирование и Применение — это разные потоки. Редактирование Предзаполненных значений на уровне проекта и Применение предзаполненных значений — независимые шаги. Если вам нужно изменить только значение по умолчанию для будущего, Редактирования достаточно; чтобы также переписать существующие Документации, попросите Владельца или Менеджера выполнить Применение (Пользователи могут выполнять Редактирование, но не Применение).

Редактировать или Применить: какой шаг имеет высокие ставки?

Само Редактирование имеет низкие ставки — оно лишь обновляет предзаполненное значение уровня проекта, используемое как значение по умолчанию для новых Документаций в дальнейшем. Существующие Документации не затрагиваются, поэтому ошибку в редактировании легко откатить: просто снова откройте Редактирование и введите предыдущее значение.

Шаг с высокими ставками — Применение, которое переписывает то же поле во всех существующих Документациях проекта, использующих выбранный шаблон. У Применения нет кнопки отмены — как только подтверждение Применения записано, единственный путь назад — снова запустить Применение с предыдущим значением. Если вы (как Владелец или Менеджер) планируете соединить Редактирование с Применением, момент, чтобы поймать опечатку, — это подтверждение Применения с предварительным просмотром области действия, а не после.