Editar Valores pré-preenchidos no Webclient

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. Editar é a ação que alcança na camada de projeto do Webclient quando pretende atualizar o próprio valor pré-preenchido a nível de projeto — abra o pré-preenchimento existente através de um ícone de lápis, escreva o novo valor e confirme. O novo valor é guardado como pré-preenchimento ao nível do projeto e torna-se a predefinição para cada nova Documentação criada a partir do mesmo modelo dali em diante.

Editar não reescreve as Documentações existentes do projeto. Apenas atualiza o pré-preenchimento guardado na camada de projeto. Para propagar também o novo valor às Documentações que já existem no projeto — ou seja, para reescrever o campo em cada uma delas — um Proprietário ou Gestor tem de executar Aplicar como passo separado.

Quem o pode utilizar

Editar no Webclient está disponível para Proprietários, Gestores e Utilizadores. Todos os três veem o ícone de raio e o botão Valores pré-preenchidos no cartão de informação do projeto, e encontram a opção Editar valores pré-preenchidos dentro do menu pendente. Apenas os Convidados ficam excluídos. Editar está aberto ao papel de Utilizador porque a ação em si é de baixo impacto: apenas atualiza o valor pré-preenchido ao nível do projeto; não reescreve as Documentações existentes. (Esse segundo passo é Aplicar, que está restrito a Proprietários e Gestores.) Se for Convidado e precisar de que um valor pré-preenchido a nível de projeto seja editado, peça a um Proprietário, Gestor ou Utilizador que o execute.

Onde aparece Editar

Editar na camada de projeto do Webclient é alcançado através do ícone de raio na barra superior ou do botão Valores pré-preenchidos no cartão de informação do projeto — ambos abrem o mesmo menu pendente com duas opções: Aplicar valores pré-preenchidos e Editar valores pré-preenchidos. A camada Workspace também tem uma opção Editar que faz o mesmo ao nível do Workspace: atualiza o valor pré-preenchido a todo o Workspace utilizado como predefinição para novas Documentações dali em diante. Nem Editar ao nível do Workspace nem Editar ao nível do projeto reescrevem as Documentações existentes — isso é tarefa do Aplicar.

Para os percursos dos pontos de entrada e as capturas de ecrã, consulte o artigo principal: Valores pré-preenchidos.

O que faz Editar

Editar permite-lhe abrir o pré-preenchimento existente ao nível do projeto através de um ícone de lápis e escrever um novo valor diretamente. Uma vez confirmado, o novo valor é guardado na camada de projeto e usado como predefinição para cada nova Documentação criada a partir do mesmo modelo dali em diante. As Documentações existentes do projeto não são tocadas por uma Edição; conservam o valor que tinham quando foram criadas.

O passo de confirmação

A confirmação de Editar é um simples aviso de sucesso. Uma vez que tenha escrito o novo valor e confirmado, verá uma mensagem Valor pré-preenchido atualizado — e é tudo. Sem pré-visualização do âmbito, sem reescrita em bloco, sem passo de propagação. O novo valor é agora o pré-preenchimento ao nível do projeto, utilizado como predefinição para cada nova Documentação criada a partir do mesmo modelo.

Se também pretende que as Documentações existentes do projeto sejam reescritas com o novo valor, essa é uma ação separada: um Proprietário ou Gestor tem de executar Aplicar, que aciona a reescrita a todo o projeto com a sua própria confirmação com pré-visualização do âmbito.

Editar ou Aplicar?

Editar e Aplicar são 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 e Aplicar são fluxos distintos. Editar os valores pré-preenchidos ao nível do projeto e Aplicar os valores pré-preenchidos são passos independentes. Se apenas precisa de alterar a predefinição para a frente, Editar é suficiente; para reescrever também as Documentações existentes, peça a um Proprietário ou Gestor que execute Aplicar (os Utilizadores podem executar Editar, mas não Aplicar).

Editar vs Aplicar: qual é o passo de alto impacto?

Editar sozinho é de baixo impacto — apenas atualiza o valor pré-preenchido ao nível do projeto utilizado como predefinição para novas Documentações dali em diante. As Documentações existentes ficam intactas, pelo que um erro de edição é fácil de reverter: basta reabrir Editar e escrever o valor anterior.

O passo de alto impacto é Aplicar, que reescreve o mesmo campo em todas as Documentações existentes do projeto que usem o modelo escolhido. Aplicar não tem botão de anular — assim que uma confirmação de Aplicar é escrita, a única forma de voltar atrás é executar Aplicar novamente com o valor anterior. Se você (como Proprietário ou Gestor) planeia encadear uma Edição com um Aplicar, o momento para detetar uma gralha é na confirmação com pré-visualização do âmbito de Aplicar, não depois.