Uso do AEM Sidekick

​​O sidekick AEM fornece aos autores de conteúdo uma barra de ferramentas que oferece opções sensíveis ao contexto para que eles possam editar, visualizar e publicar seu conteúdo diretamente das páginas do seu site.

Este documento explica como usar o sidekick.

Instalação

Consulte o documento Instalação do AEM Sidekick para saber como instalar e configurar o sidekick.

Uso do Sidekick

O sidekick pode ser chamado nos seguintes contextos:

Para usar a extensão sidekick, navegue até um URL associado ao seu projeto. Pode ser um dos seguintes:

A extensão sidekick pode ser alternada clicando no ícone Adobe Experience Cloud ao lado da barra de endereços. Se estiver usando o bookmarklet, clique nele na barra de ferramentas do navegador.

Adição de projetos

Adicionar projetos à sua configuração do sidekick é opcional para a maioria dos casos de uso. O sidekick é capaz de detectar automaticamente se um URL está associado ao seu projeto. Se você quiser que o sidekick também reconheça domínios personalizados, como o domínio de produção do seu projeto, será necessário manter o projeto na configuração do sidekick clicando no link + no lado direito.

Alternador de ambiente

^{O alternador de ambiente em um sidekick nos documentos do Google.}

Ao usar a criação baseada em documentos para criar conteúdo, o conteúdo é movido do editor para diferentes ambientes. O alternador de ambiente permite que você pule facilmente entre eles.

Visualização

Essa opção direciona você ao ambiente de visualização, que reflete as alterações mais recentes da página renderizada a partir do documento de origem. Você também pode enviar URLs de visualização às partes interessadas para que elas possam revisar o conteúdo antes que ele seja publicado. Observe que essa opção só estará ativada se o conteúdo que você está visualizando tiver sido visualizado anteriormente.

O URL de visualização segue o padrão https://branch--repo--org.hlx.page/path.

Em tempo real

Essa opção só estará disponível se ainda não houver um ambiente de produção. Ele mostra o conteúdo publicado e serve como um plug-in (e a origem) para o ambiente de produção do projeto. Observe que essa opção só estará habilitada se o conteúdo que você está visualizando tiver sido publicado antes.

O URL ativo é quase idêntico ao URL de pré-visualização, com a única diferença no domínio de primeiro nível: https://main--repo--org.hlx.live/path

Produção

Essa opção direciona você ao ambiente de produção, que é o site do projeto voltado para o público. Observe que essa opção pode não estar disponível durante o estágio de desenvolvimento do projeto ou porque o conteúdo ainda não foi publicado.

Esse ambiente pode ser um CDN de terceiros ou "traga seu próprio". Dependendo da configuração do projeto, o novo conteúdo pode aparecer somente após um atraso.

Se o nome de domínio voltado para o público for yourproject.com, o URL de produção seria https://yourproject.com/path

Ações

Há várias ações que você pode realizar em seu conteúdo usando convenientemente a barra de ferramentas do sidekick. As ações que não foram executadas desde a última alteração do conteúdo recebem um indicador laranja.

Visualização

\ ^{A ação de visualização em um sidekick nos documentos do Google.}

Visualizar é a ação predominante no editor. Ele (re)gera a página de visualização com base no documento atual e a abre em uma guia separada.

Editar

A variável Editar A ação está disponível nos três ambientes. Ele abre o editor online do documento de origem da página atual em uma janela separada.

^{O sidekick em um ambiente de visualização.}

No mínimo, o acesso de leitura ao documento no Google Drive ou OneDrive é necessário para usar esta ação.

Recargar

A variável Recarregar A ação está disponível somente no ambiente de visualização. Ele pode ser usado para forçar uma atualização de conteúdo, por exemplo, se você tiver o editor e a visualização abertos lado a lado ao trabalhar no conteúdo. A ação é idêntica à ação Visualizar no editor.

Publicação

A variável Publish A ação está disponível nos três ambientes e disponibiliza a versão de visualização atual da página nos ambientes ativo e de produção.

^{O sidekick em um ambiente dinâmico.}

Os visitantes do seu site voltado para o público não poderão ver as alterações até que sejam publicados.

Ações em massa

Abra o sidekick no Google Drive ou no Microsoft SharePoint e selecione um ou mais arquivos para visualizar e publicar arquivos em massa e copie convenientemente seus URLs. Você também pode usar esse recurso para visualizar e publicar mídia como SVG ou PDF arquivos.

O Adobe continua a estender o suporte para formatos de arquivo que podem ser publicados diretamente de sua fonte de conteúdo (SharePoint ou GDrive) com base no uso popular e em considerações de segurança. Atualmente, os formatos compatíveis incluem: PDF, SVG, JPG, PNG.

Os formatos que estão sendo considerados para serem adicionados incluem: XML, MP4 bem como bruto DOCX, XLSX, PPTX sem transformação.

Limitação: no Microsoft SharePoint, seleções maiores (mais de 60) podem não estar totalmente expostas ao sidekick e, portanto, podem precisar ser divididas em selos menores.

Visualização em massa

Selecionar vários documentos no SharePoint ou no GDrive permite que você visualize vários documentos em massa.

^{Visualização em massa no Google Drive.}

Publicação em massa

Selecionar vários documentos no SharePoint ou no GDrive permite publicá-los em massa.

^{Publicar em massa no Google Drive.}

Copiar URLs

Use esse recurso para copiar os URLs de pré-visualização, produção ou em tempo real de um ou vários arquivos.

Desfazer publicação de conteúdo

Se você precisar remover conteúdo do seu site, a primeira coisa a fazer é excluir, renomear ou mover o documento de origem subjacente nos documentos do Google ou no OneDrive.

Para uma página sem um documento de origem (isto é, ele foi renomeado ou movido), o sidekick mostrará as duas ações a seguir quando invocado no ambiente de visualização.

Observação: se você estiver conectado ao sidekick, pode ignorar a exclusão do documento de origem subjacente e simplesmente manter pressionada a tecla Alt (Windows) ou Opção (Mac) chave para exibir a Excluir e Cancelar publicação ações.

^{O sidekick em uma página de visualização sem um documento de origem.}

Excluir

A variável Excluir A ação excluirá permanentemente a página de todos os ambientes, desfazendo implicitamente a publicação.

Desfazer publicação

Este Cancelar publicação a ação cancelará a publicação da página, mas ainda a manterá no ambiente de visualização para referência.

Consulte o documento Criação e publicação de conteúdo para obter mais informações sobre exclusão de conteúdo.

Cuidado: as ações Excluir e Cancelar publicação não podem ser desfeitas! Verifique novamente o URL e o conteúdo da página para garantir que realmente seja correto excluir e/ou desfazer a publicação de uma página. O documento de origem pode ter sido movido acidentalmente e talvez não precise ser excluído.

Compartilhamento do Sidekick

Você pode compartilhar a configuração do sidekick para seu projeto clicando no símbolo de compartilhamento na parte superior direita. Isso copiará um URL de compartilhamento para a área de transferência e permitirá que você o cole em um DM ou email para um colega. O URL de compartilhamento permitirá que o recipient instale facilmente o sidekick do seu projeto.

Consulte o documento Instalação do AEM Sidekick para obter mais informações.

Personalização do Sidekick

Se você for um desenvolvedor, poderá personalizar o sidekick para o seu projeto.

Bibliotecas de terceiros