Versão de novembro de 2023 do Adobe Experience Manager Guides as a Cloud Service
Esta nota de versão aborda as instruções de atualização, a matriz de compatibilidade e os problemas corrigidos na versão de novembro de 2023 do Adobe Experience Manager Guides as a Cloud Service (mais tarde conhecido como Experience Manager Guides as a Cloud Service).
Para obter mais informações sobre os novos recursos e aprimoramentos, consulte Novidades da versão de novembro de 2023 do Experience Manager Guides as a Cloud Service.
Atualização para a versão de novembro de 2023
Atualize sua configuração atual do Experience Manager Guides as a Cloud Service executando as seguintes etapas:
- Confira o código Git do Cloud Services e alterne para a ramificação configurada no pipeline do Cloud Services correspondente ao ambiente que você deseja atualizar.
- Atualize a propriedade
<dox.version>no arquivo/dox/dox.installer/pom.xmlde seu código Git do Cloud Services para 2023.11.0.406. - Confirme as alterações e execute o pipeline dos Serviços em nuvem para atualizar para a versão de novembro de 2023 do Experience Manager Guides as a Cloud Service.
Etapas para ativar o acionador de um script por meio de um servlet
(Somente se você estiver em uma versão anterior à versão de junho de 2023 do Experience Manager Guides as a Cloud Service)
Após concluir a instalação, você pode optar por APRESENTAR o acionador para iniciar o trabalho de tradução:
PUBLICAÇÃO:
http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade
Resposta:
{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}
Na resposta JSON anterior, a chave lockNodePath contém o caminho para o nó criado no repositório que aponta para o trabalho enviado. Ela será excluída automaticamente quando o trabalho for concluído e, em seguida, você poderá consultar esse nó para saber o status do trabalho.
Aguarde até que esse trabalho seja concluído antes de prosseguir para as próximas etapas.
GET
http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json
Etapas para pós-processar o conteúdo existente para usar o relatório de link corrompido
(Somente se você estiver em uma versão anterior à versão de junho de 2023 do Experience Manager Guides as a Cloud Service)
Execute as seguintes etapas para pós-processar o conteúdo existente e usar o novo relatório de link desfeito:
-
(Opcional) Se houver mais de 100.000 arquivos DITA no sistema, atualize o
queryLimitReadse oqueryLimitInMemoryemorg.apache.jackrabbit.oak.query.QueryEngineSettingsServicepara um valor maior (qualquer valor maior que o número de ativos presentes, por exemplo, 200.000) e reimplante.-
Use as instruções fornecidas na seção Substituições de configuração em Instalar e configurar o Adobe Experience Manager Guides as a Cloud Service para criar o arquivo de configuração.
-
No arquivo de configuração, forneça os seguintes detalhes (propriedade) para configurar a opção
queryLimitReadsequeryLimitInMemory:table 0-row-3 1-row-3 2-row-3 PID Chave de propriedade Valor de propriedade org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Valor: 200000 Valor padrão: 100000 org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitInMemory Valor: 200000 Valor padrão: 100000
-
-
Execute uma solicitação POST para o servidor (com autenticação correta) -
http://<server:port>//bin/guides/reports/upgrade. -
A API retorna um jobId. Para verificar o status do trabalho, você pode enviar uma solicitação GET com a ID do trabalho para o mesmo ponto de extremidade -
http://<server:port>/bin/guides/reports/upgrade?jobId= {jobId}
(Por exemplo:http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678) -
Quando o trabalho for concluído, a solicitação anterior do GET responderá com êxito. Se a tarefa falhar por algum motivo, a falha poderá ser vista nos logs do servidor.
-
Reverta para o valor padrão ou existente anterior de
queryLimitReadsse você o alterou na etapa 1.
Etapas para indexar o conteúdo existente para usar a nova localização e substituição e lista de tópicos na guia Relatórios:
(Somente se você estiver em uma versão anterior à versão de junho de 2023 do Experience Manager Guides as a Cloud Service)
Execute as seguintes etapas para indexar o conteúdo existente e usar o novo texto de localização e substituição no nível do mapa e da lista de tópicos na guia relatórios:
-
Execute uma solicitação POST para o servidor (com autenticação correta) -
http://<server:port>/bin/guides/map-find/indexing. (Opcional: é possível passar caminhos específicos dos mapas para indexá-los; por padrão, todos os mapas serão indexados || Por exemplo:https://<Server:port>/bin/guides/map-find/indexing?paths=<map_path_in_repository>) -
Você também pode passar uma pasta raiz para indexar os mapas DITA de uma pasta específica (e suas subpastas). Por exemplo,
http://<server:port>/bin/guides/map-find/indexing?root=/content/dam/test. Observe que se os parâmetros de caminhos e de raiz forem transmitidos, somente o parâmetro de caminhos será considerado. -
A API retorna um jobId. Para verificar o status do trabalho, você pode enviar uma solicitação do GET com a ID do trabalho para o mesmo ponto de extremidade -
http://<server:port>/bin/guides/map-find/indexing?jobId={jobId}(Por exemplo:http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42) -
Quando o trabalho for concluído, a solicitação anterior do GET responderá com sucesso e mencionará se algum mapa falhou. Os mapas indexados com êxito podem ser confirmados nos logs do servidor.
Etapas para lidar com o conflito 'fmdita rewriter'
O Experience Manager Guides tem um módulo personalizado de reescrita do sling para manipular os links gerados no caso de mapas cruzados (links entre os tópicos de dois mapas diferentes).
Se você tiver outro reescritor sling personalizado em sua base de código, use um valor de 'order' maior que 50, pois o reescritor Experience Manager Guides sling usa 'order' 50. Para substituir isso, é necessário um valor >50. Para obter mais detalhes, consulte Pipelines de regravação de saída.
Durante esta atualização, como o valor de 'order' é alterado de 1000 para 50, você precisa mesclar o reescritor personalizado existente, se houver, com 'fmdita-rewriter'.
Matriz de compatibilidade
Esta seção lista a matriz de compatibilidade dos aplicativos de software compatíveis com a versão de novembro de 2023 do Experience Manager Guides as a Cloud Service.
FRAMEMAKER e FRAMEMAKER PUBLISHING SERVER
Conector de oxigênio
Versão do modelo da knowledge base
Problemas corrigidos
Os bugs corrigidos em várias áreas estão listados abaixo:
Criação
- O espaço após o elemento conref
<ph>desaparece ao salvar o tópico. (13642) - Erro de aplicativo ao tentar salvar arquivos DITA antes que o pós-processamento seja concluído. (13571)
- Se o título de um tópico contiver uma barra
/, a guia no editor mostrará apenas as letras que vêm após ele. (13455) - A visualização da imagem não desaparece após ser exibida no Editor. (13454)
- O pop-up Inserir palavra-chave não é exibido ao usar chaves definidas pelo mapa raiz em outros tópicos. 12950)
- Os ícones de fechamento não ficam visíveis quando gráficos muito altos são visualizados no painel Histórico de versões. (12867)
- Não é possível modificar o fuso horário da coluna Versão Criada em para as Linhas de Base. (12711)
- O painel Histórico de Versão na interface do usuário do Assets mostra um carimbo de data/hora incorreto para o campo Atual. (12624)
- Criar um arquivo DITA a partir de um modelo com um nome de arquivo começando com caracteres numéricos resulta em um erro de namespace. (12188)
- No Editor da Web, a janela Referências de Chave é aberta ao inserir a marca
varname. (10940) - Os arquivos Zip não são reconhecidos no Editor da Web, e você não pode arrastá-los e soltá-los. (12709)
- O conteúdo com alguns atributos aplicados nele não está sendo realçado no modo Autor ou Visualização. (11063)
- Ao fechar um tópico após editá-lo, você é redirecionado para a Página inicial do AEM em vez de retornar à exibição de pasta. (13306)
- Ocorre atraso no pós-processamento de arquivos que foram copiados e colados nos serviços de nuvem. (12457)
- A configuração de mapa de raiz persiste no Editor da Web mesmo se o usuário não a tiver definido explicitamente nas Preferências do usuário. (11551)
Publicação
- A funcionalidade Publicar como fragmento de conteúdo não funciona para os arquivos listados nos resultados da pesquisa. (14090)
- Na publicação do PDF Nativo, a seleção da cor de fundo no layout do modelo requer um recarregamento de página ao reverter para
None. (13621) - Problema ao confirmar o armazenamento de dados de um mapa DITA grande com links de pares de escopo na publicação do AEM Site. (13530)
- Na publicação do PDF nativo, a acessibilidade é comprometida, pois as imagens no cabeçalho e no rodapé não exibem texto alternativo. (12829)
- A duplicação do layout de página no PDF nativo não funciona sem uma extensão adicionada automaticamente. (12534)
- Ao gerar a saída do PDF com a publicação nativa do PDF, o nome do arquivo é truncado após um ponto. (13620)
- Ícone e dica de ferramenta incorretos são exibidos para a opção Editar conteúdo na barra de ferramentas Layouts de Página dos Modelos usados na publicação do PDF Nativo. (13492)
- Os metadados personalizados não estão disponíveis na saída final. (12116)
- A reescrita fmdita entra em conflito com a configuração de reescrita do usuário e leva à exibição de URLs longos em vez dos links. (12076)
- Na predefinição do Site do AEM, a opção de Gerar PDF separada para cada tópico não é funcional. (11555)
- A publicação nativa do PDF não é compatível com a conversão de espaço de cores CMYK. (10754)
- As chamadas de linha de base dinâmicas estão usando o nome em vez do título, o que resulta na falha da opção Exportar API de mapa DITA. (14268)
Gerenciamento
- A referência de conteúdo é quebrada ao copiar e colar os arquivos DITA com links de autorreferência sem GUID. (13540)
- No Editor da Web, a linha de base mostra o título da versão anterior em vez da versão selecionada do arquivo DITA. (13444)
- A guia Relatórios na interface do Editor da Web não mostra a lista de tópicos para mapas DITA antigos criados antes da atualização de julho de 2023 do Experience Manager Guides as a Cloud Service. (11852)
- As predefinições de condição para um mapa DITA grande não estão sendo criadas. (10936)
- Um link de autorreferência é exibido abaixo da lista de Links quebrados nos relatórios. (13539)
Revisar
- Os painéis de revisão lado a lado das versões anterior e atual no Editor da Web não estão corretos na versão de outubro de 2023 do Experience Manager Guides as a Cloud Service. (14156)
- A personalização do modelo de email para o fluxo de trabalho Revisão não funciona com a sobreposição de nós. (13954)
- O botão Fechar na página Revisar do Experience Manager Guides leva os usuários para a Página inicial do AEM. (13535)
- Os caracteres quebrados aparecem ao criar os trechos em coreano. (13489)
- Os anexos coreanos na tela Revisão da Experience Manager Guides não são clicáveis. (13436)
- O título do mapa é cortado na tela de revisão e colaboração, sem a opção de visualizar o título completo. (13012)
Tradução
- A aprovação automática às vezes não funciona, e ocorrem exceções se um valor incorreto for definido em Status da tradução. (13607)
- A linha de base exportada do painel Tradução falha e não abre no idioma de destino. (12993)
Problema conhecido
A Adobe identificou o seguinte problema conhecido para a versão de novembro de 2023.
- A regeneração de tópico seletivo para saída do AEM Site falha.