Aplicar Valores pré-preenchidos em todo o projeto no Webclient
Atualize um valor pré-preenchido a todo o projeto no Webclient escolhendo um valor existente e confirmando-o através do passo de confirmação com pré-visualização do âmbito. A alteração reescreve todas as Documentações existentes do projeto e define a nova predefinição para cada nova Documentação.
A funcionalidade Valores pré-preenchidos do Sparkify permite-lhe definir os valores predefinidos dos campos de documentação uma única vez e fazer com que se preencham automaticamente onde quer que se apliquem. Aplicar é a ação que alcança na camada de projeto do Webclient quando o valor que pretende definir como padrão do projeto já existe como valor num ou mais campos dentro de qualquer Modelo de Documentação escolhido nos Valores pré-preenchidos. Escolhe os campos, escolhe o valor, e uma única confirmação reescreve esse valor em todas as Documentações existentes do projeto.
O que torna a camada de projeto diferente é o que acontece quando confirma. O novo valor reescreve o campo em todas as Documentações existentes do projeto que foram criadas a partir desse modelo — e torna-se a predefinição para cada nova Documentação criada a partir desse modelo a partir daí. O efeito é bidirecional: para trás sobre o que já existe, para a frente sobre o que ainda está por vir.
Quem o pode utilizar
Aplicar a todo o projeto no Webclient está disponível para Proprietários e Gestores. Os Utilizadores podem abrir o menu pendente da camada de projeto (uma vez que estão autorizados a executar Editar), mas a opção Aplicar valores pré-preenchidos não estará disponível para eles. A restrição de Aplicar corresponde ao raio de impacto: uma única confirmação reescreve os valores dos campos em todas as Documentações existentes do projeto, pelo que Aplicar permanece ao nível do Proprietário / Gestor. Se precisar que um valor pré-preenchido a nível de projeto seja aplicado e não for Proprietário nem Gestor, peça a um deles que o execute.
Onde aparece Aplicar
Aplicar é específico da camada de projeto do Webclient. Ambos os pontos de entrada para os pré-preenchimentos da camada de projeto — o ícone de raio na barra superior e o botão Valores pré-preenchidos no cartão de informação do projeto — abrem o mesmo menu pendente com duas opções: Aplicar valores pré-preenchidos e Editar valores pré-preenchidos. A camada Workspace não expõe Aplicar de todo — não existe um equivalente ao nível do Workspace para a reescrita a todo o projeto. Editar ao nível do Workspace apenas define a predefinição a todo o Workspace para novas Documentações dali em diante.
Para os percursos dos pontos de entrada e as capturas de ecrã, consulte o artigo principal: Valores pré-preenchidos.
O que faz Aplicar
Aplicar permite-lhe escolher um ou mais campos e depois selecionar um valor existente para o definir como pré-preenchimento ao nível do projeto para esses campos. Use-o quando o valor que pretende já existe como valor num ou mais campos dentro de qualquer Modelo de Documentação escolhido nos Valores pré-preenchidos, e quer adotá-lo como o novo padrão do projeto. Não está a escrever nada de novo; está a escolher entre valores existentes. Depois de escolher, o fluxo termina no passo de confirmação de Aplicar (descrito abaixo).
O passo de confirmação de Aplicar
Antes de qualquer alteração ser confirmada, o fluxo mostra um passo de confirmação com uma pré-visualização do âmbito. A pré-visualização explica exatamente o que a confirmação fará:
- Quantos campos serão aplicados.
- Quantas Documentações existentes serão reescritas — todas as Documentações já presentes no projeto criadas com o mesmo Modelo de Documentação adotam agora o novo valor para esses campos.
A seguir confirma ou cancela. Nada é escrito até confirmar — não há sobreposição silenciosa.
Aplicar ou Editar?
Aplicar e Editar são agora dois fluxos separados com efeitos diferentes:
- Editar guarda um novo valor como pré-preenchimento ao nível do projeto. Após confirmar, obtém uma confirmação «Valor pré-preenchido atualizado» — e é tudo. As novas Documentações criadas a partir do modelo dali em diante começam com o novo valor, mas as Documentações existentes do projeto não são tocadas.
- Aplicar é o que reescreve o valor em todas as Documentações existentes do projeto que usem o modelo escolhido. Um Proprietário ou Gestor abre o fluxo de Aplicar, escolhe o Modelo de Documentação, escolhe os campos e os valores, e confirma — nesse momento ocorre a reescrita a todo o projeto.
Editar já não encadeia com Aplicar. Editar o valor pré-preenchido e aplicá-lo às Documentações existentes são agora dois passos independentes. Se apenas precisa de alterar a predefinição para a frente, Editar é suficiente; para reescrever também as Documentações existentes, execute Aplicar como passo separado.
Use-o com cuidado
A propagação a todo o projeto torna o Aplicar poderoso: uma única confirmação reescreve o mesmo campo em todas as Documentações existentes do projeto que usem esse modelo, e torna-se a predefinição para cada nova. Não há botão de anular. Assim que confirma, a alteração é escrita em todas as Documentações afetadas, e a única forma de a reverter é executar Aplicar novamente com o valor anterior — o que significa que você (ou alguém da sua equipa) tem mesmo de se lembrar de qual era o valor anterior. Se ninguém se lembrar, o estado anterior está perdido.
É por isso que o passo de confirmação com pré-visualização do âmbito é o único momento que conta. Antes de algo ser escrito, a pré-visualização mostra-lhe quantos campos estão prestes a ser aplicados e quantas Documentações existentes serão reescritas com os novos valores. Leia-a com atenção — é o momento de detetar um campo errado ou uma gralha, não depois.