DocumentaçãoAEMTutoriais do AEMTutorials da AEM Foundation

Configurar Sling Dynamic Include

Last update: Wed May 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Experienced
  • Developer

Uma apresentação em vídeo da instalação e utilização do Apache Sling Dynamic Include com Dispatcher AEM em execução Apache HTTP Web Server.

https://video.tv.adobe.com/v/34697?quality=12&learn=on&captions=por_br

NOTE
Verifique se a versão mais recente do AEM Dispatcher está instalada localmente.

  1. Baixe e instale o Sling Dynamic Include pacote.

  2. Configurar Sling Dynamic Include por meio da OSGi Configuration Factory em http://<host>:<port>/system/console/configMgr/org.apache.sling.dynamicinclude.Configuration.

    Ou, para adicionar a uma base de código AEM, crie a variável sling:OsgiConfig nó em:

    code language-xml 
    <?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:cq="http://www.day.com/jcr/cq/1.0"
    xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:nt="http://www.jcp.org/jcr/nt/1.0"
    jcr:primaryType="sling:OsgiConfig"
    include-filter.config.enabled="{Boolean}true"
    include-filter.config.path="/content"
    include-filter.config.resource-types="[my-app/components/content/highly-dynamic]"
    include-filter.config.include-type="SSI"
    include-filter.config.add_comment="{Boolean}false"
    include-filter.config.selector="nocache"
    include-filter.config.ttl=""
    include-filter.config.required_header="Server-Agent=Communique-Dispatcher"
    include-filter.config.ignoreUrlParams="[]"
    include-filter.config.rewrite="{Boolean}true"
    />
<!--
* include-filter.config.include-type="SSI | ESI | JSI"
* include-filter.config.ttl is # of seconds (requires AEM Dispatcher 4.1.11+)
-->

  3. (Opcional) Repita a última etapa para permitir componentes em conteúdo bloqueado (inicial) de modelos editáveis a ser distribuído via SDI também. O motivo para a configuração adicional é que o conteúdo bloqueado dos modelos editáveis é exibido no /conf em vez de /content.

    code language-xml 
    <?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:sling="http://sling.apache.org/jcr/sling/1.0" xmlns:cq="http://www.day.com/jcr/cq/1.0"
    xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:nt="http://www.jcp.org/jcr/nt/1.0"
    jcr:primaryType="sling:OsgiConfig"
    include-filter.config.enabled="{Boolean}true"
    include-filter.config.path="/conf"
    include-filter.config.resource-types="[my-app/components/content/highly-dynamic]"
    include-filter.config.include-type="SSI"
    include-filter.config.add_comment="{Boolean}false"
    include-filter.config.selector="nocache"
    include-filter.config.ttl=""
    include-filter.config.required_header="Server-Agent=Communique-Dispatcher"
    include-filter.config.ignoreUrlParams="[]"
    include-filter.config.rewrite="{Boolean}true"
    />
<!--
* include-filter.config.include-type="SSI | ESI | JSI"
* include-filter.config.ttl is # of seconds (requires AEM Dispatcher 4.1.11+)
-->

  4. Atualizar Apache HTTPD Web serverdo httpd.conf arquivo para habilitar o Include módulo.

    code language-shell 
    $ sudo vi .../httpd.conf
    code language-shell 
    LoadModule include_module libexec/apache2/mod_include.so

  5. Atualize o vhost arquivo a ser respeitado inclui diretivas.

    code language-shell 
    $ sudo vi .../vhosts/aem-publish.local.conf
    code language-shell 
    <VirtualHost *:80>
...
   <Directory /Library/WebServer/docroot/publish>
      ...
      # Add Includes to enable SSI Includes used by Sling Dynamic Include
      Options FollowSymLinks Includes

      # Required to have dispatcher-handler process includes
      ModMimeUsePathInfo On

      # Set includes to process .html files
      AddOutputFilter INCLUDES .html
      ...
   </Directory>
...
</VirtualHost>

  6. Atualizar o arquivo de configuração dispatcher.any para suporte (1) nocache seletores e (2) ative o suporte TTL.

    code language-shell 
    $ sudo vi .../conf/dispatcher.any
    code language-shell 
    /rules {
  ...
  /0009 {
    /glob "*.nocache.html*"
    /type "deny"
  }
}
    note tip
    TIP
    Sair da trilha * desativado no glob *.nocache.html* regra acima, pode resultar em problemas nas solicitações de subrecursos.
    code language-shell 
    /cache {
    ...
    /enableTTL "1"
}

  7. Sempre reiniciar Apache HTTP Web Server depois de fazer alterações em seus arquivos de configuração ou no dispatcher.any.

    code language-shell 
    $ sudo apachectl restart
NOTE
Se você estiver usando Sling Dynamic Includes para veicular inclusões de borda (ESI), certifique-se de armazenar em cache informações cabeçalhos de resposta no cache do dispatcher. Os possíveis cabeçalhos incluem o seguinte:
  • "Cache-Control"
  • "Disposição de conteúdo"
  • "Content-Type"
  • "Expira"
  • "Última modificação"
  • "ETag"
  • "X-Content-Type-Options"
  • "Última modificação"

Materiais de suporte

recommendation-more-help
c92bdb17-1e49-4e76-bcdd-89e4f85f45e6