Encontrar e substituir permite que você pesquise uma palavra ou frase em toda a sua base de conhecimento e atualize tudo de uma vez. Ele funciona em artigos, variáveis, trechos e termos do glossário, eliminando a necessidade de editar cada item individualmente. Você também pode encontrar e substituir texto dentro de um único artigo usando a ferramenta do editor.
Encontrar e substituir globais
Pesquise e substitua vários artigos, variáveis, trechos e termos do glossário no seu projeto ao mesmo tempo.
Saiba mais →Encontre e substitua no editor
Pesquise e substitua dentro de um único artigo diretamente do editor Markdown ou Advanced WYSIWYG.
Saiba mais →Por que usar, encontrar e substituir
- Um nome de produto, nome de recurso ou outro termo mudou e precisa de atualização em todos os lugares onde aparece.
- Você quer padronizar a terminologia em toda a sua base de conhecimento.
- Você quer remover uma palavra ou frase de vários itens ao mesmo tempo.
- Você precisa atualizar o texto ou URL de um hiperlink onde quer que ele apareça.
Para alterações limitadas a um único artigo, use a ferramenta de encontrar e substituir no editor.
Antes de começar
Encontrar e substituir requer o papel de conteúdo Editor , ou um papel personalizado com a permissão Executar Encontrar e Substituir ativada.
Seu nível de acesso também determina o que você pode visualizar e alterar:
- Com acesso total, você pode pesquisar e substituir entre artigos, variáveis, trechos e termos do glossário.
- Com acesso ao conteúdo para visualização, mas sem acesso para atualização, as correspondências dentro das variáveis aparecem, mas a substituição não é permitida.
- Usuários com a função de Roteiro de Conteúdo não têm permissão para Encontrar e substituir. Leia os papéis de conteúdo para saber mais.
- Com acesso para atualização, mas sem permissão de publicação, a substituição é permitida, mas os artigos afetados só podem ser salvos como rascunhos.
- Com acesso somente leitura, você pode buscar e visualizar partidas, mas não pode realizar uma substituição.
- Sem acesso ao modo Encontrar e substituir, o recurso fica indisponível.
Se você tiver acesso para editar em um espaço de trabalho e visualizar apenas o acesso a outro, a substituição se aplica apenas ao espaço de trabalho que você pode editar. Uma mensagem após a substituição indica quantos itens foram atualizados e quantos foram pulados.
Realize a busca e substituição global
- Navegue até as ferramentas de conteúdo () na barra de navegação da esquerda e selecione Encontrar e substituir ().
- Digite a palavra ou frase para buscar no campo Buscar .
Os campos Encontrar e Substituir aceitam até 300 caracteres, com todos os caracteres especiais suportados.
- Insira o texto de substituição no campo Substituir por . Deixe este campo vazio para deletar o texto correspondente em vez de substituí-lo.
- Permita que Combinar palavras inteiras (ab) correspondam ao termo apenas quando ele aparece como uma palavra completa. Por exemplo, com essa opção ativada, substituir
pageporarticlenão afetahomepage. - Selecione o ícone Filtro () para restringir a busca, depois selecione Aplicar. Consulte as opções de Filtro abaixo.
- Selecione Encontrar tudo ou pressione
Enter. A lista de resultados exibe cada artigo, variável, trecho ou termo de glossário correspondente com base no filtro aplicado, junto com o número de ocorrências.
Se não houver correspondências, o Document360 exibe uma mensagem informando que nenhum resultado foi encontrado, em vez de listar itens com ocorrências zero.
- Selecione um item na lista para visualizá-lo. As partidas são destacadas, e as setas acima da prévia se movem entre ocorrências.
- Selecione os itens a substituir marcando a caixa ao lado de cada um, ou selecione a caixa de seleção no topo da lista para selecionar todos os resultados. Use o campo de busca acima da lista de resultados para localizar um item específico pelo nome.
- Selecione Substituir selecionado para atualizar apenas os itens marcados, ou Substituir todos para atualizar todos os itens da lista.
- Escolha como os artigos afetados devem ser salvos:
- O status de retenção preserva o estado atual de cada artigo. Artigos publicados recebem uma nova versão publicada; Artigos preliminares permanecem rascunhos.
- O rascunho transfere todos os artigos afetados para status de rascunho para revisão antes da publicação.
- Selecione Confirmar para aplicar as mudanças.
Depois que você trocar
- Se todas as correspondências forem substituídas com sucesso, o Document360 confirma a atualização e mantém seus filtros de busca.
- Se apenas alguns itens forem atualizados, o Document360 indica o resultado, por exemplo, "7 ocorrências em 3 artigos atualizadas, 1 ocorrência em 1 artigo falhada."
- Se uma substituição falhar, o Document360 exibe um erro e mantém o item nos seus resultados para que você possa tentar novamente.
Opções de filtro
| Filtro | Descrição |
|---|---|
| Módulo | Especifica quais tipos de conteúdo pesquisar: Artigos, Variáveis, Trechos ou Glossário. Múltiplas seleções são permitidas. Artigos é selecionado por padrão. |
| Encontre em | Especifica onde buscar: Conteúdo (padrão), Hiperlinks ou blocos de código. |
| Espaço de Trabalho / Linguagem | Filtre por workspace e idioma. |
| Selo | Filtrar por rótulo. |
| Visibilidade | Filtre por Visível ou Oculto. |
| Status | Filtrar por rascunho, artigos publicados ou não publicados. |
| Colaboradores | Filtre por nome do contribuidor. Múltiplas seleções permitidas. |
| Tags | Filtrar por tags de artigos... |
| Atualizado em | Filtre por faixa de datas da última atualização: 7 dias, 30 dias, 3 meses, 1 ano ou um intervalo personalizado. |
O conteúdo pesquisa o texto visível em seus artigos, incluindo textos de hiperlink e legendas de imagens. Hyperlinks pesquisa a URL do link em si, não o texto visível.
Ao buscar dentro dos Hiperlinks, a substituição modifica as próprias URLs. Revise suas mudanças cuidadosamente para evitar criar links quebrados. Substituir hiperlinks também pode afetar a análise de status dos links.
Entendendo os resultados da busca
- Se um termo aparece em um artigo e uma variável usada por esse artigo, apenas a correspondência no artigo é destacada. A variável aparece como um item separado na lista de resultados.
- Variáveis, trechos e termos do glossário podem ser substituídos da mesma forma que artigos, usando Substituir selecionados ou Substituir todos.
- Para termos do glossário, a busca corresponde à definição, não ao nome do termo em si. Para atualizar o nome do termo, edite-o diretamente na seção de Glossário.
- Atualizar uma variável, trecho ou termo do glossário aplica a alteração em todos os lugares onde ele é usado.
- Para artigos copiados usando o Replicate, apenas o original aparece nos resultados de busca. Uma substituição feita no original se aplica automaticamente às suas cópias.
Exportando seus resultados de busca
Selecione Exportar () na barra de resultados para baixar os resultados atuais como um arquivo. Use isso para registrar os itens que a substituição afetará antes de confirmar.
Encontre e substitua no editor
Você também pode encontrar e substituir texto dentro de um único artigo, diretamente do editor. Isso afeta apenas o artigo aberto.
Editor Markdown: Selecione o ícone Encontrar e substituir () no cabeçalho do artigo, ou use Ctrl+F.
Editor avançado de WYSIWYG: Selecione o ícone More () no cabeçalho do artigo, depois selecione Encontrar e substituir ().
Melhores práticas
- Para substituições em grande escala que afetam muitos artigos publicados, escolha o status Rascunho em vez de Retenção. Isso faz com que todos os artigos afetados sejam rascunhados, para que você possa revisar as mudanças antes de publicar, em vez de lançar as novas versões publicadas imediatamente.
- Defina as opções Módulo e Encontrar antes de fazer uma busca ampla, para manter os resultados focados.
- Aplique filtros antes de selecionar itens para substituir. Uma busca sem filtros pode afetar centenas de itens de forma não intencional.
- Ative Combinar palavras inteiras quando o termo de busca pode aparecer dentro de outras palavras, por exemplo,
logdentrologinde oucatalog. - Exporte seus resultados antes de uma grande substituição, para manter um registro dos itens afetados.
- Faça backup da sua base de conhecimento antes de uma substituição em grande escala, para permitir a restauração de conteúdo se necessário.
- Revise uma amostra dos itens substituídos depois para confirmar se a redação está correta.
- Use a ferramenta do editor para alterações limitadas a um único artigo. É mais rápido e apenas escopa a mudança para aquele artigo.
FAQ
Quem pode usar o Find and Replace?
Apenas usuários com a função de conteúdo Editor , ou uma função personalizada com a permissão Executar Encontrar e substituir . Seu nível de acesso também determina o que você pode buscar e substituir. Veja Antes de começar.
O que acontece se o campo Substituir com ficar vazio?
Cada palavra ou frase correspondente é excluída dos itens selecionados. Essa ação não pode ser desfeita, então revise seus resultados cuidadosamente antes de confirmar.
Encontrar e substituir afeta o Markdown ou o código HTML subjacente, ou apenas o texto visível?
Apenas o texto visível. A formatação Markdown ou HTML subjacente não é afetada.
Encontra e substitui artigos de busca na lixeira de reciclagem?
Não. Artigos na lixeira de reciclagem não aparecem nos resultados.
Um substituto cria uma nova versão do artigo?
Sim. Cada substituição cria uma nova versão no histórico de revisões do artigo, permitindo que você a reverta posteriormente se necessário.
Se um termo aparece tanto em um artigo quanto em uma variável que ele utiliza, o que acontece?
Apenas a correspondência no artigo é destacada e contada. A variável aparece separadamente nos resultados. Substituir o artigo não altera a variável, a menos que ela também seja selecionada e substituída.
URLs de hiperlink podem ser substituídos?
Sim. Defina o Find in nos hiperlinks. Isso atualiza a URL do link, não o texto visível. Para atualizar o texto visível, use Conteúdo. Revise suas mudanças cuidadosamente para evitar quebrar o vínculo.
Se o texto do título de um artigo for substituído, a URL também muda?
Não. Apenas o título é atualizado. A URL do artigo permanece inalterada, então os links existentes continuam funcionando.
Encontrar e substituir é sensível de maiúsculas e minúsculas?
Não. Buscar por "api" encontra API, API e API. O texto substituto é aplicado exatamente como inserido, independentemente de como o original foi escrito em maiúscula.