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

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

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

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

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

Где появляется Применить

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

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

Что делает Применить

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

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

Прежде чем какое-либо изменение будет зафиксировано, поток показывает шаг подтверждения с предварительным просмотром области действия. Предварительный просмотр чётко показывает, что сделает подтверждение:

• Сколько полей будет применено.
• Сколько существующих Документаций будет переписано — каждая Документация, уже находящаяся в проекте и созданная с тем же Шаблоном документации, теперь принимает новое значение для этих полей.

Затем вы подтверждаете или отменяете. Ничего не записывается, пока вы не подтвердите — никакой тихой перезаписи.

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

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

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

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

Используйте осторожно

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

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