Editor DITAVAL ditaval-editor
Os arquivos DITAVAL são usados para gerar saída condicional. Em um único tópico, você pode adicionar condições usando atributos de elemento para condicionar o conteúdo. Em seguida, crie um arquivo DITAVAL, no qual especifique as condições que devem ser selecionadas para gerar conteúdo e qual condição deve ser deixada de fora da saída final.
O AEM Guides permite criar e editar facilmente arquivos DITAVAL usando o editor DITAVAL. O editor DITAVAL recupera os atributos (ou tags) definidos no sistema e você pode usá-los para criar ou editar arquivos DITAVAL. Para obter mais detalhes sobre como criar e gerenciar tags no AEM, consulte a seção Administração de Tags na documentação do AEM.
Criar arquivo DITAVAL
Execute as seguintes etapas para criar um arquivo DITAVAL:
-
Na interface do Assets, navegue até o local em que deseja criar o arquivo DITAVAL.
-
Clique em Criar > Tópico DITA.
-
Na página Blueprint, selecione o modelo de arquivo DITAVAL e clique em Próximo.
-
Na página Propriedades, especifique o Título e o Nome para o arquivo DITAVAL.
note note NOTE O nome é sugerido automaticamente com base no Título do arquivo. Se você quiser especificar manualmente o nome do arquivo, verifique se ele não contém espaços, apóstrofos ou chaves e termine com .ditaval. -
Clique em Criar. A mensagem Topic Created (Tópico criado) é exibida.
Você pode optar por abrir o arquivo DITAVAL para edição no editor DITAVAL ou salvar o arquivo de tópico no repositório AEM.
Editar arquivo DITAVAL
Execute as seguintes etapas para editar um arquivo DITAVAL:
-
Na interface do Assets, navegue até o arquivo DITAVAL que deseja editar.
-
Para obter um bloqueio exclusivo sobre o arquivo, selecione-o e clique em Fazer Check-out.
-
Selecione o arquivo e clique em Editar para abri-lo no editor AEM Guides DITAVAL.
O editor DITAVAL permite executar as seguintes tarefas:
R: Alternar painel esquerdo
Alterna a exibição do painel esquerdo. Se você tiver aberto o arquivo DITAVAL pelo mapa DITA, o mapa e o repositório serão mostrados nesse painel. Para obter mais informações sobre como abrir um arquivo por meio do mapa DITA, consulte Editar tópicos por meio do mapa DITA.B: Salvar
Salva as alterações feitas no arquivo. Todas as alterações são salvas na versão atual do arquivo.C: Adicionar propriedade
Adicione uma única propriedade no arquivo DITAVAL.
A primeira lista suspensa lista os atributos DITA permitidos que você pode usar no arquivo DITAVAL. Há cinco atributos com suporte -
audience,platform,product,propseotherprops.A segunda lista suspensa mostra os valores configurados para o atributo selecionado. Em seguida, a lista suspensa seguinte mostra as ações que você pode configurar no atributo selecionado. Os valores permitidos no menu suspenso de ações são -
include,exclude,passthrougheflag. Para obter mais informações sobre esses valores, consulte a definição do elemento prop na documentação do OASIS DITAD: Adicionar todas as propriedades
Se quiser adicionar todas as propriedades condicionais ou atributos definidos no sistema com um único clique, use o recurso Adicionar todas as propriedades.note note NOTE Se todas as propriedades condicionais definidas já existirem no arquivo DITAVAL, não será possível adicionar mais propriedades. Você recebe uma mensagem de erro neste cenário. 
-
Após concluir a edição do arquivo DITAVAL, clique em Salvar.
note note NOTE Se você fechar o arquivo sem salvar, as alterações serão perdidas. Se você não deseja confirmar as alterações no repositório AEM, clique em Fechar e em Fechar sem salvar na caixa de diálogo Alterações não salvas.
Visualizações do editor DITAVAL
O editor DITAVAL do AEM Guides é compatível com a visualização de arquivos DITAVAL em dois modos ou visualizações diferentes:
Autor: Esta é uma exibição típica do What You See is What You Get (WYSISYG) do editor DITAVAL. Você pode adicionar ou remover propriedades usando a interface de usuário simples, que apresenta as propriedades, seus valores e ações na lista suspensa. Na visualização Autor, você tem as opções para inserir uma propriedade individual e inserir todas as propriedades com um único clique.
Você também pode encontrar a versão do arquivo DITAVAL que você está trabalhando no momento, passando o ponteiro sobre o nome do arquivo.
Source: A visualização Source exibe o XML subjacente que compõe o arquivo DITAVAL. Além de fazer edições de texto regulares nessa visualização, um autor também pode adicionar ou editar propriedades usando o Catálogo inteligente.
Para chamar o Catálogo inteligente, coloque o cursor no final de qualquer definição de propriedade e digite "<". O editor mostrará uma lista de todos os elementos XML válidos que você pode inserir nesse local.
