DocumentaçãoAEM 6.4Guia de desenvolvimento

Desenvolvimento com o CRXDE Lite developing-with-crxde-lite

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Desenvolvedor
CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

Esta seção descreve como desenvolver seu aplicativo AEM usando o CRXDE Lite.

Consulte a documentação de visão geral para obter mais informações sobre os diferentes ambientes de desenvolvimento disponíveis.

O CRXDE Lite é incorporado ao AEM e permite executar tarefas de desenvolvimento padrão no navegador. Com o CRXDE Lite, você pode criar um projeto, criar e editar arquivos (como .jsp e .java), pastas, modelos, componentes, caixas de diálogo, nós, propriedades e pacotes ao registrar.

O CRXDE Lite é recomendado quando você não tem acesso direto ao servidor AEM, quando você desenvolve um aplicativo estendendo ou modificando os componentes prontos para uso e pacotes Java ou quando não precisa de um depurador dedicado, conclusão de código e realce de sintaxe.

NOTE
A partir do AEM 6.4.8.1, o acesso anônimo ao CRXDE Lite não é mais possível.
Os usuários são redirecionados para a tela de logon.
NOTE
É recomendável usar a variável Ferramentas de desenvolvedor do AEM para Eclipse e AEM Extensão de Colchetes HTL durante o desenvolvimento do projeto.

Introdução ao CRXDE Lite getting-started-with-crxde-lite

Para começar a usar o CRXDE Lite, proceda da seguinte maneira:

  1. Instalar AEM.

  2. No navegador, digite https://<host>:<port>/crx/de. Por padrão, é http://localhost:4502/crx/de.

  3. Insira seu username e senha. Por padrão, é admin e admin.

  4. Clique em OK.

A interface do usuário do CRXDE Lite tem a seguinte aparência no navegador:

chlimage_1-238

Agora você pode usar o CRXDE Lite para desenvolver seu aplicativo.

Visão geral da interface do usuário overview-of-the-user-interface

O CRXDE Lite oferece a seguinte funcionalidade:

Barra do comutador superior
Permite alternar rapidamente entre o CRXDE Lite, o Gerenciador de pacotes e o Compartilhamento de pacotes.
Dispositivo de caminho de nó

Exibe o caminho para o nó selecionado no momento.

Também é possível usá-lo para pular para um nó, inserindo o caminho à mão ou colando de outro lugar e pressionando Enter.

Também oferece suporte para procurar nós com nome de nó específico. Insira o nome do nó que deseja encontrar e aguarde (ou clique no símbolo de pesquisa no lado direito). Você pode tentar inserir, por exemplo, a string carvalho no widget para ver como ele funciona. Se um determinado nó ou nós forem carregados no painel explorador, a lista será exibida e você poderá selecionar o caminho e pressionar Enter para navegar até ele. Observe que ele só funciona para os nós atualmente carregados no aplicativo cliente CRXDE no navegador. Se quiser pesquisar o repositório inteiro, use Ferramentas e, em seguida, Query.

Painel do Explorer

Exibe uma árvore de todos os nós no repositório.

Clique em um nó para exibir suas propriedades na Propriedades guia . Depois de clicar em um nó, você pode selecionar uma ação na barra de ferramentas. Clique no nó novamente para renomeá-lo.

Filtro de navegação em árvore (ícone binário): permite filtrar os nós no repositório para o qual o nome contém o texto de entrada. Ela se aplica somente aos nós que foram carregados localmente.

Painel Editar

Início guia : permite pesquisar conteúdo e/ou documentação e acessar recursos do desenvolvedor (documentação, blog do desenvolvedor, knowledge base) e suporte (Adobe homepage e centro de suporte).

Clique duas vezes em um arquivo na Explorer painel para exibir seu conteúdo; como, por exemplo, um arquivo .jsp ou .java. Em seguida, você pode modificá-la e salvar as alterações.

Depois que um arquivo é editado no Editar , as seguintes ferramentas estão disponíveis na barra de ferramentas:

- Mostrar na árvore: mostra o arquivo na árvore do repositório.
- Pesquisar/substituir ...: faça pesquisa ou substitua.

Clique duas vezes na linha de status do Editar o painel abre Ir para linha para que seja possível inserir um número de linha específico.

Guia Propriedades
Exibe as propriedades do nó selecionado. É possível adicionar novas propriedades ou excluir as existentes.
Guia Controle de acesso

Exibir permissões com base no caminho atual, no nível do repositório ou no principal.

As permissões são divididas em

- Política de Controle de Acesso Aplicável: As políticas que podem ser aplicadas à seleção atual.

- Políticas de Controle de Acesso Local: As políticas atuais aplicadas localmente à seleção atual.

- Políticas de Controle de Acesso Efetivas: As políticas atuais aplicadas para a seleção atual podem ser definidas localmente ou herdadas dos nós principais.

Nota. Para poder ver as informações de Controle de Acesso, o usuário conectado ao CRXDE Lite deve ter direitos para ler as entradas de ACL. O usuário anônimo não pode ver essas informações por padrão. Faça logon como, por exemplo, administrador para ver as informações.

Guia Replicação
Exibe o status de replicação do nó atual. Você pode replicar e excluir o nó atual.
Guia Console

Logs do servidor:

Exibe mensagens de logs. Você pode configurar o nível de log, limpar o console, fixar na posição de rolagem selecionada e ativar/desativar a exibição de mensagens.

Controle da versão:

Exibe mensagens de controle de versão.

Guia Informações da compilação
Exibe informações quando um pacote está sendo criado.
Atualizar
Atualiza a seleção atual. As alterações de outros usuários são atualizadas na visualização do repositório. As alterações efetuadas não são afetadas.
Salvar Tudo

Salvar Tudo:

Salva todas as alterações feitas. Até clicar em Salvar, as alterações são temporárias e serão perdidas ao sair do console.

Reverter:

Descarta todas as alterações feitas no nó selecionado desde a última ação de salvamento e, em seguida, recarrega o estado atual do repositório para o nó selecionado.

Reverter tudo:

Descarta todas as alterações feitas em todo o repositório desde a última ação de salvar e, em seguida, recarrega o estado atual do repositório.

Criar ...

Menu suspenso para criar o seguinte no nó selecionado:

- Nó: um nó com um tipo de nó arbitrário

- Arquivo: nt:file node e seu subnó nt:resource

- Pasta: nt:folder node

- Modelo: Modelo de AEM

- Componente: Componente AEM

- Diálogo: Caixa de diálogo AEM

Excluir
Exclui o nó selecionado.
Copiar
Copia o nó selecionado.
Colar
Cola o nó copiado abaixo do nó selecionado.
Mover ...
Move o nó selecionado para o nó definido na caixa de diálogo.
Renomear ...
Renomeia o nó selecionado.
Misturas ...
Permite adicionar tipos mixin ao tipo de nó. Os tipos mixin são usados principalmente para adicionar recursos avançados, como controle de versão, controle de acesso, referência e bloqueio ao nó.
Ferramentas

Menu suspenso com as seguintes ferramentas:

- Configuração do Servidor...: para acessar o Felix Console.

- Consulta ...: para consultar o repositório.

- Privilégios ...: para abrir o gerenciamento de privilégios, onde você pode exibir e adicionar privilégios.

- Testar Controle de Acesso ...: um local onde você pode testar a permissão para determinado caminho e/ou principal.

- Exportar tipo de nó: para exportar tipos de nó no sistema como notação cnd.

- Importar Tipo de Nó ...: para importar tipos de nó usando notação cnd.

- Instalar o SiteCatalyst Debugger...: instruções sobre como instalar o Analytics Debugger.

Widget de logon

Exibe os usuários conectados no momento e o espaço de trabalho em que estão conectados, por exemplo, admin@crx.default.

Clique nele para fazer logon ou fazer logon novamente como um usuário específico. Se você não especificar um espaço de trabalho para fazer logon, você será conectado ao espaço de trabalho padrão, crx.default.

Se você deseja navegar pelo repositório como usuário anônimo, use anonymous como o nome de logon e qualquer senha (por exemplo, um espaço ou um ponto).

Se sua autorização não for mais válida (por exemplo, ela expirou), o widget de logon exibirá "Não autorizado - Logon...". Clique nele para fazer logon novamente.

Criação de pastas creating-a-folder

Para criar uma pasta com o CRXDE Lite:

  1. Abra o CRXDE Lite no navegador.

  2. No painel Navegação, clique com o botão direito do mouse na pasta na qual deseja criar a nova pasta e selecione Criar …, em seguida Criar pasta ….

  3. Insira a pasta Nome e clique em OK.

  4. Clique em Salvar tudo para salvar as alterações no servidor.

Criação de um modelo creating-a-template

Para criar um template com CRXDE Lite:

  1. Abra o CRXDE Lite no navegador.

  2. No painel Navegação, clique com o botão direito do mouse na pasta onde deseja criar o modelo e selecione Criar …, em seguida Criar Modelo….

  3. Insira o Rótulo, Título, Descrição, Tipo de recurso e Classificação do modelo. Clique em Avançar.

  4. Esta etapa é opcional: defina as Caminhos permitidos. Clique em Avançar

  5. Esta etapa é opcional: defina as Pais permitidos. Clique em Avançar.

  6. Esta etapa é opcional: defina as Filhos permitidos. Clique em OK.

  7. Clique em Salvar tudo para salvar as alterações no servidor.

Ele cria:

  • Um nó do tipo cq:Template com propriedades de modelo

  • Um nó filho do tipo cq:PageContent com propriedades de Conteúdo da página

É possível adicionar propriedades ao modelo: consulte o Criação de uma propriedade seção.

Criação de um componente creating-a-component

O recurso descrito aqui só está disponível se o tipo de nó cq:Component está disponível no repositório.

Para criar um componente com o CRXDE Lite:

  1. Abra o CRXDE Lite no navegador.

  2. No painel Navegação, clique com o botão direito do mouse na pasta onde deseja criar o componente, selecione Criar …, em seguida Criar componente ….

  3. Insira o Rótulo, Título, Descrição, Tipo de Recurso Super e Grupo do componente. Clique em Avançar.

  4. Esta etapa é opcional: definir as propriedades do componente É Contêiner, Sem Decoração, Nome da célula e Caminho da caixa de diálogo. Clique em Avançar.

  5. Esta etapa é opcional: definir a propriedade do componente Pais permitidos. Clique em Avançar.

  6. Esta etapa é opcional: definir a propriedade do componente Filhos permitidos. Clique em OK.

  7. Clique em Salvar tudo para salvar as alterações no servidor.

Ele cria:

  • Um nó do tipo cq:Component
  • Propriedades do componente
  • Um script .jsp de componente

Criação de uma caixa de diálogo creating-a-dialog

Para criar uma caixa de diálogo com o CRXDE Lite:

  1. Abra o CRXDE Lite no navegador.

  2. No painel Navegação, clique com o botão direito do mouse no componente onde deseja criar a caixa de diálogo e selecione Criar …, em seguida Criar Caixa de Diálogo….

  3. Insira o Rótulo e Título. Clique em OK.

  4. Clique em Salvar tudo l para salvar as alterações no servidor.

Ele cria um diálogo com a seguinte estrutura:

dialog[cq:Dialog]/items[cq:Widget]/items[cq:WidgetCollection]/tab1[cq:Panel]

Agora você pode adaptar a caixa de diálogo às suas necessidades modificando propriedades ou criando novos nós.

Também é possível usar o Editor de caixa de diálogo para editar uma caixa de diálogo. Clicar duas vezes no nó da caixa de diálogo no CRXDE Lite exibirá o editor. Mais informações sobre o Editor de caixa de diálogo podem ser encontradas here.

Criação de um nó creating-a-node

Para criar um nó com CRXDE Lite:

  1. Abra o CRXDE Lite no navegador.

  2. No painel Navegação, clique com o botão direito do mouse no nó onde deseja criar o novo nó, selecione Criar …, em seguida Criar nó ….

  3. Insira o Nome e Tipo. Clique em OK.

  4. Clique em Salvar tudo para salvar as alterações no servidor.

Agora você pode adaptar o nó às suas necessidades modificando propriedades ou criando novos nós.

NOTE
A maioria das operações de edição, incluindo Criar nó, mantém todas as alterações na memória e somente as armazena no repositório ao salvar (por meio do botão "Salvar tudo"). No entanto, algumas operações, como mover, são automaticamente persistentes.
A validação com relação a se o nó recém-criado é permitido pelo tipo de nó do nó pai também é executada pelo repositório JCR primeiro ao salvar as alterações. Se você receber uma mensagem de erro ao salvar um nó, verifique se a estrutura de conteúdo é válida (por exemplo, não é possível criar um nt:unstructured nó como filho de nt:folder nó ).

Criação de uma propriedade creating-a-property

Para criar uma propriedade com o CRXDE Lite:

  1. Abra o CRXDE Lite no navegador.

  2. No painel Navegação , selecione o nó no qual deseja adicionar a nova propriedade.

  3. No Propriedades no painel inferior, digite a Nome, o Tipo e Valor. Clique em Adicionar.

  4. Clique em Salvar tudo para salvar as alterações no servidor.

Criação de um script creating-a-script

Para criar um novo script:

  1. Abra o CRXDE Lite no navegador.

  2. No painel Navegação, clique com o botão direito do mouse no componente onde deseja criar o script e selecione Criar …, em seguida Criar arquivo ….

  3. Insira o arquivo Nome incluindo a sua extensão. Clique em OK.

  4. O novo arquivo é aberto como uma guia no painel Editar.

  5. Edite o arquivo .

  6. Clique em Salvar tudo para salvar as alterações.

Como exportar e importar tipos de nó exporting-and-importing-node-types

Com o CRXDE Lite, você pode importar e/ou exportar definições de tipo de nó em Notação CND (Compact Namespace e Definição de Tipo de Nó).

Para exportar uma definição de tipo de nó:

  1. Abra o CRXDE Lite no navegador.

  2. Selecione o nó desejado.

  3. Selecionar Ferramentas then Exportar tipo de nó.

  4. A definição, em notação cnd, será exibida no navegador. Salve as informações, se necessário.

Para importar uma definição de tipo de nó:

  1. Abra o CRXDE Lite no navegador.

  2. Selecionar Ferramentas then Importar Tipo de Nó….

  3. Insira a notação CND para a definição na caixa de texto.

  4. Verificar Permitir atualização se estiver atualizando uma definição existente.

  5. Clique em Importar.

Logs logging

Com o CRXDE Lite, você pode exibir o arquivo error.log que está localizado no sistema de arquivos em <crx-install-dir>/crx-quickstart/server/logs e filtrá-lo com o nível de log apropriado. Proceda do seguinte modo:

  1. Abra o CRXDE Lite no navegador.

  2. No Console na parte inferior da janela, no menu suspenso à direita, selecione Logs do servidor.

  3. Clique no botão Stop ícone para exibir as mensagens.

É possível:

  • Ajuste os parâmetros de log no Felix Console clicando no botão Configurações de registro ícone .
  • Limpe as mensagens clicando no botão Pincel ícone .
  • Fixar a mensagem na seleção atual clicando no botão Pino ícone .
  • Ative ou desative a exibição de mensagens clicando no botão Stop ícone .

Controle de acesso access-control

NOTE
Consulte Administração de usuários, grupos e direitos de acesso para obter mais informações.
recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e