Fragmentos de conteúdo do autor

No capítulo anterior, você criou cinco modelos de fragmento de conteúdo: Pessoa, Equipe, Local, Endereço e Informações de contato. Este capítulo percorre as etapas para criar fragmentos de conteúdo com base nesses modelos. Também explica como criar políticas de pastas para limitar quais modelos de fragmento de conteúdo podem ser usados na pasta.

Pré-requisitos prerequisites

Este documento faz parte de um tutorial dividido em várias partes. Certifique-se de que o capítulo anterior foi concluída antes de prosseguir com este capítulo.

Objetivos objectives

Neste capítulo, saiba como:

  • Criar pastas e definir limites usando políticas de pastas
  • Criar referências de fragmento diretamente do editor de Fragmento de conteúdo
  • Use os tipos de dados Guia, Data e Objeto JSON
  • Inserir referências de conteúdo e fragmento no editor de texto de várias linhas
  • Adicionar várias referências de fragmento
  • Aninhar fragmentos de conteúdo

Instalar conteúdo de amostra sample-content

Instale um pacote de AEM que contenha várias pastas e imagens de amostra usadas para acelerar o tutorial.

  1. Baixar Advanced-GraphQL-Tutorial-Starter-Package-1.1.zip

  2. No AEM, navegue até Ferramentas > Implantação > Pacotes para acessar Gerenciador de pacotes.

  3. Carregue e instale o pacote (arquivo zip) baixado na etapa anterior.

    Pacote carregado por meio do gerenciador de pacotes

Criar pastas e definir limites usando políticas de pastas

Na página inicial do AEM, selecione Assets > Arquivos > WKND compartilhado > Inglês. Aqui você pode ver as várias categorias de Fragmento de conteúdo, incluindo Aventuras e Colaboradores.

Criar pastas create-folders

Navegue até o Aventuras pasta. Você pode ver que as pastas para Equipes e Locais já foram criadas para armazenar Fragmentos de conteúdo de Equipes e Locais.

Crie uma pasta para os Fragmentos de conteúdo dos instrutores que são baseados no Modelo de fragmento de conteúdo de pessoa.

  1. Na página Aventuras, selecione Criar > Pasta no canto superior direito.

    Criar pasta

  2. No modal Criar pasta exibido, digite "Professores" no Título campo. Observe o 's' no final. Os títulos das pastas que contêm muitos fragmentos devem ser plurais. Selecione Criar.

    Criar modal de pasta

    Agora você criou uma pasta para armazenar o Adventure Instructors.

Definir limites usando políticas de pasta

O AEM permite definir permissões e políticas para pastas de Fragmento de conteúdo. Ao usar as permissões, você pode conceder acesso a determinadas pastas apenas a determinados usuários (autores) ou grupos de autores. Com as políticas de pastas, é possível limitar os modelos de fragmento de conteúdo que os autores podem usar nessas pastas. Neste exemplo, vamos limitar uma pasta aos modelos de Pessoa e Informações de contato. Para configurar uma política de pasta:

  1. Selecione o Professores que você criou, selecione Propriedades na barra de navegação superior.

    Propriedades

  2. Selecione o Políticas e desmarque Herdado de /content/dam/wknd-shared. No Modelos de fragmento de conteúdo permitidos por caminho selecione o ícone de pasta.

    Ícone de pasta

  3. Na caixa de diálogo Selecionar caminho que é aberta, siga o caminho conf > WKND compartilhado. O modelo de fragmento de conteúdo de pessoas, criado no capítulo anterior, contém uma referência ao modelo de fragmento de conteúdo de informações de contato. Os modelos de Informações de pessoa e contato devem ser permitidos na pasta Professores para criar um Fragmento de conteúdo do professor. Selecionar Person e Informações de contato, depois pressione Selecionar para fechar o diálogo.

    Selecionar caminho

  4. Selecionar Salvar e fechar e selecione OK na caixa de diálogo sucesso exibida.

  5. Agora você configurou uma política de pasta para a pasta de instrutores. Navegue até o Professores e selecione Criar > Fragmento do conteúdo. Os únicos modelos que agora podem ser selecionados são Person e Informações de contato.

    Políticas de pasta

Fragmentos de conteúdo de autor para professores

Navegue até o Professores pasta. Aqui, vamos criar uma pasta aninhada para armazenar as informações de contato dos instrutores.

Siga as etapas descritas na seção sobre criação de pastas para criar uma pasta chamada "Contact Info". A pasta aninhada herda as políticas de pasta da pasta principal. Você pode configurar políticas mais específicas para que a pasta recém-criada permita que apenas o modelo de Informações de contato seja usado.

Criar um fragmento do conteúdo do professor

Vamos criar quatro pessoas que podem ser adicionadas a uma equipe de professores de aventura.

  1. Na pasta Professores, crie um Fragmento de conteúdo com base no Modelo de fragmento de conteúdo de pessoa e atribua a ele o título de "Jacob Wester".

    O fragmento de conteúdo recém-criado tem a seguinte aparência:

    Fragmento do conteúdo da pessoa

  2. Insira o seguinte conteúdo nos campos:

    • Nome completo: Jacob Wester
    • Biografia: Jacob Wester tem sido um instrutor de caminhada por dez anos e amou cada minuto disso! Jacob é um buscador de aventura com um talento para escalar e mochila. Jacob é o vencedor de competições de escalada, incluindo a Batalha da Baía competição de pedregulhos. Jacob atualmente mora na Califórnia.
    • Nível de experiência do professor: Especialista
    • Habilidades: Escalada, Surfe, Mochila
    • Detalhes do administrador: Jacob Wester tem coordenado aventuras de mochila por três anos.
  3. No Foto do perfil adicione uma referência de conteúdo a uma imagem. Navegue até WKND compartilhado > Inglês > Colaboradores > jacob_wester.jpg para criar um caminho para a imagem.

Criar uma referência de fragmento por meio do editor de Fragmento de conteúdo fragment-reference-from-editor

O AEM permite criar uma referência de fragmento diretamente do editor de fragmentos de conteúdo. Vamos criar uma referência para as informações de contato do Jacob.

  1. Selecionar Novo fragmento de conteúdo abaixo do Informações de contato campo.

    Novo fragmento de conteúdo

  2. O modal Novo fragmento de conteúdo é aberto. Na guia Selecionar destino, siga o caminho Aventuras > Professores e marque a caixa de seleção ao lado da caixa Informações de contato pasta. Selecionar Próxima para prosseguir para a guia Propriedades.

    Novo modal de Fragmento de conteúdo

  3. Na guia Propriedades, digite "Informações de contato do Jacob Wester" no Título campo. Selecionar Criar, depois pressione Abertura na caixa de diálogo sucesso exibida.

    Guia Propriedades

    Novos campos que permitem editar o fragmento de conteúdo das informações de contato são exibidos.

    Fragmento do conteúdo das informações de contato

  4. Insira o seguinte conteúdo nos campos:

    • Telefone: 209-888-0000
    • E-mail: jwester@wknd.com

    Quando concluído, selecione Salvar. Agora você criou um fragmento de conteúdo das informações de contato.

  5. Para navegar de volta para o fragmento de conteúdo do professor, selecione Jacob Wester no canto superior esquerdo do editor.

    Voltar para o fragmento de conteúdo original

    A variável Informações de contato agora contém o caminho para o fragmento de Informações de contato referenciado. Esta é uma referência de fragmento aninhado. O fragmento concluído do conteúdo do professor tem esta aparência:

    Fragmento de conteúdo de Jacob Wester

  6. Selecionar Salvar e fechar para salvar o fragmento de conteúdo. Agora você tem um novo Fragmento do conteúdo do professor.

Criar fragmentos adicionais

Siga o mesmo processo descrito na seção seção anterior para criar mais três fragmentos de conteúdo de instrutores e três fragmentos de conteúdo de informações de contato para esses instrutores. Adicione o seguinte conteúdo nos fragmentos de Professores:

Stacey Roswells

Campos
Valores
Título do fragmento de conteúdo
Stacey Roswells
Nome completo
Stacey Roswells
Informação de contato
/content/dam/wknd-shared/en/adventures/Instructors/contact-info/stacey-roswells-contact-info
Foto do perfil
/content/dam/wknd-shared/en/contributors/stacey-roswells.jpg
Biografia
Stacey Roswells é uma alpinista talentosa e aventureira alpina. Nascida em Baltimore, Maryland, Stacey é a mais nova de seis filhos. O pai de Stacey era tenente-coronel da Marinha dos Estados Unidos e a mãe era instrutora de dança moderna. A família de Stacey mudou-se com frequência com as atribuições de dever do pai, e tirou as primeiras fotos quando o pai estava estacionado na Tailândia. Também foi aqui que Stacey aprendeu a escalar.
Nível de experiência do professor
Avançado
Habilidades
Escalada de rochas

Kumar Selvaraj

Campos
Valores
Título do fragmento de conteúdo
Kumar Selvaraj
Nome completo
Kumar Selvaraj
Informação de contato
/content/dam/wknd-shared/en/adventures/Instructors/contact-info/kumar-selvaraj-contact-info
Foto do perfil
/content/dam/wknd-shared/en/contributors/kumar-selvaraj.jpg
Biografia
Kumar Selvaraj é um instrutor profissional experiente com certificação AMGA cujo principal objetivo é ajudar os alunos a melhorar suas habilidades de escalada e caminhada.
Nível de experiência do professor
Avançado
Habilidades
Escalada de rochas

Ayo Ogunseinde

Campos
Valores
Título do fragmento de conteúdo
Ayo Ogunseinde
Nome completo
Ayo Ogunseinde
Informação de contato
/content/dam/wknd-shared/en/adventures/Instructors/contact-info/ayo-ogunseinde-contact-info
Foto do perfil
/content/dam/wknd-shared/en/contributors/ayo-ogunseinde-237739.jpg
Biografia
Ayo Ogunseinde é um alpinista profissional e instrutor de mochilas que vive em Fresno, no centro da Califórnia. O objetivo de Ayo é guiar os caminhantes em suas aventuras mais épicas do parque nacional.
Nível de experiência do professor
Avançado
Habilidades
Escalada de rochas

Deixe a Informações adicionais campo vazio.

Adicione as seguintes informações nos fragmentos de Informações de contato:

Título do fragmento de conteúdo
Celular
Email
Stacey Roswells Contact Info
209-888-0011
sroswells@wknd.com
Informações de contato de Kumar Selvaraj
209-888-0002
kselvaraj@wknd.com
Informações de contato de Ayo Ogunseinde
209-888-0304
aogunseinde@wknd.com

Agora você está pronto para criar uma Equipe!

Criação de fragmentos de conteúdo para locais

Navegue até o Localizações pasta. Aqui, você vê duas pastas aninhadas que já foram criadas: Parque Nacional de Yosemite e Yosemite Valley Lodge.

Pasta de locais

Ignore a pasta Yosemite Valley Lodge por enquanto. Retornamos a ela posteriormente nesta seção quando criamos um local que atua como Base Inicial para nossa equipe de instrutores.

Navegue até o Parque Nacional de Yosemite pasta. Atualmente, contém apenas uma foto do Parque Nacional de Yosemite. Vamos criar um Fragmento de conteúdo usando o Modelo de fragmento de conteúdo de localização e intitulá-lo de "Parque Nacional de Yosemite".

Marcadores de posição de guias

O AEM permite usar espaços reservados para guias, a fim de agrupar diferentes tipos de conteúdo e facilitar a leitura e o gerenciamento dos fragmentos de conteúdo. No capítulo anterior, você adicionou espaços reservados para guias ao modelo de Localização. Como resultado, o fragmento de conteúdo do local agora tem duas seções de guia: Detalhes do local e Endereço do local.

Espaços reservados da guia

A variável Detalhes do local contém a variável Nome, Descrição, Informações de contato, Imagem do local, e Tempo por Temporada campos, enquanto a variável Endereço do local contém uma referência a um Fragmento de conteúdo de endereço. As guias deixam claro quais tipos de conteúdo devem ser preenchidos, de modo que a criação de conteúdo é mais fácil de gerenciar.

Tipo de dados Objeto JSON

A variável Tempo por Temporada é um tipo de dados Objeto JSON, o que significa que aceita dados no formato JSON. Esse tipo de dados é flexível e pode ser usado para qualquer dado que você queira incluir no seu conteúdo.

Você pode ver a descrição do campo criada no capítulo anterior, passando o mouse sobre o ícone de informações à direita do campo.

Ícone Informações do objeto JSON

Nesse caso, precisamos fornecer o tempo médio para o local. Insira os seguintes dados:

{
    "summer": "81 / 89°F",
    "fall": "56 / 83°F",
    "winter": "46 / 51°F",
    "spring": "57 / 71°F"
}

A variável Tempo por Temporada O campo agora deve ter esta aparência:

Objeto JSON

Adicionar conteúdo

Vamos adicionar o restante do conteúdo ao Fragmento do conteúdo de localização para consultar as informações com o GraphQL no próximo capítulo.

  1. No Detalhes do local insira as seguintes informações nos campos:

    • Nome: Parque Nacional de Yosemite
    • Descrição: O Parque Nacional Yosemite fica nas montanhas de Sierra Nevada, na Califórnia. É famosa por suas lindas cachoeiras, sequoias gigantes e vistas icônicas dos penhascos El Capitan e Half Dome. Caminhadas e acampamentos são as melhores maneiras de experimentar Yosemite. Numerosas trilhas oferecem oportunidades infinitas para aventura e exploração.
  2. No Informações de contato crie um Fragmento de conteúdo com base no modelo Contact Info e o nomeie como "Yosemite National Park Contact Info". Siga o mesmo processo descrito na seção anterior sobre criação de uma referência de fragmento no editor e insira os seguintes dados nos campos:

    • Telefone: 209-999-0000
    • E-mail: yosemite@wknd.com
  3. No Imagem do local , navegue até Aventuras > Localizações > Parque Nacional de Yosemite > yosemite-national-park.jpeg para criar um caminho para a imagem.

    Lembre-se de que, no capítulo anterior, você configurou a validação da imagem; portanto, as dimensões da imagem do Local devem ser inferiores a 2560 x 1800 e o tamanho do arquivo deve ser inferior a 3 MB.

  4. Com todas as informações adicionadas, a variável Detalhes do local A guia agora tem esta aparência:

    Guia Detalhes do local concluída

  5. Navegue até o Endereço do local guia. No Endereço , crie um Fragmento de conteúdo intitulado "Endereço do Parque Nacional de Yosemite" usando o Modelo de Fragmento de Conteúdo de Endereço que você criou no capítulo anterior. Siga o mesmo processo descrito na seção sobre criação de uma referência de fragmento no editor e insira os seguintes dados nos campos:

    • Endereço: 9010 Curry Village Drive
    • Cidade: Vale do Yosemite
    • Estado: CA
    • Código postal: 95389
    • País: Estados Unidos
  6. O concluído Endereço do local A guia do fragmento do Parque Nacional de Yosemite tem esta aparência:

    Guia Endereço do local concluída

  7. Selecione Salvar e fechar.

Criar mais um fragmento

  1. Navegue até o Yosemite Valley Lodge pasta. Crie um fragmento de conteúdo usando o modelo de fragmento de conteúdo de localização e o nomeie como "Yosemite Valley Lodge".

  2. No Detalhes do local insira as seguintes informações nos campos:

    • Nome: Yosemite Valley Lodge
    • Descrição: Yosemite Valley Lodge é um centro para reuniões de grupo e todos os tipos de atividades, como compras, refeições, pesca, caminhadas e muito mais.
  3. No Informações de contato crie um Fragmento de conteúdo com base no modelo de Informações de contato e o nomeie como "Informações de contato do Yosemite Valley Lodge". Siga o mesmo processo descrito na seção sobre criação de uma referência de fragmento no editor e insira os seguintes dados nos campos do novo Fragmento de conteúdo:

    • Telefone: 209-992-0000
    • E-mail: yosemitelodge@wknd.com

    Salve o fragmento de conteúdo recém-criado.

  4. Voltar para Yosemite Valley Lodge e vá para a página Endereço do local guia. No Endereço , crie um Fragmento de conteúdo intitulado "Endereço do Yosemite Valley Lodge" usando o Modelo de fragmento de conteúdo de endereço que você criou no capítulo anterior. Siga o mesmo processo descrito na seção sobre criação de uma referência de fragmento no editor e insira os seguintes dados nos campos:

    • Endereço: 9006 Yosemite Lodge Drive
    • Cidade: Parque Nacional de Yosemite
    • Estado: CA
    • Código postal: 95389
    • País: Estados Unidos

    Salve o fragmento de conteúdo recém-criado.

  5. Voltar para Yosemite Valley Lodge e selecione Salvar e fechar. A variável Yosemite Valley Lodge A pasta agora contém três fragmentos de conteúdo: Yosemite Valley Lodge, Yosemite Valley Lodge Contact Info e Yosemite Valley Lodge Address.

    Pasta do Yosemite Valley Lodge

Criar um fragmento do conteúdo da equipe

Procurar pastas para Equipes > Equipe do Yosemite. Você pode ver que a pasta Equipe do Yosemite atualmente contém apenas o logotipo da equipe.

Pasta da equipe do Yosemite

Vamos criar um fragmento de conteúdo usando o Modelo de fragmento de conteúdo de equipe e atribuí-lo ao título de "Equipe do Yosemite".

Referências de conteúdo e fragmento no editor de texto de várias linhas

O AEM permite adicionar referências de conteúdo e fragmento diretamente no editor de texto multilinha e recuperá-las posteriormente usando consultas do GraphQL. Vamos adicionar referências de conteúdo e fragmento à Descrição campo.

  1. Primeiro, adicione o seguinte texto à Descrição campo: "A equipe de aventureiros profissionais e instrutores de caminhada que trabalham no Parque Nacional de Yosemite."

  2. Para adicionar uma referência de conteúdo, selecione a Inserir ativo ícone na barra de ferramentas do editor de texto multilinha.

    Ícone Inserir ativo

  3. Na modal exibida, selecione team-yosemite-logo.png e pressione Selecionar.

    Selecionar imagem

    A referência de conteúdo agora é adicionada na variável Descrição campo.

Lembre-se de que, no capítulo anterior, você permitiu a adição de referências de fragmento ao Descrição campo. Vamos adicionar um aqui.

  1. Selecione o Inserir fragmento de conteúdo ícone na barra de ferramentas do editor de texto multilinha.

    Ícone Inserir fragmento de conteúdo

  2. Navegue até WKND compartilhado > Inglês > Aventuras > Localizações > Yosemite Valley Lodge > Yosemite Valley Lodge. Pressione Selecionar para inserir o fragmento de conteúdo.

    Inserir modal de Fragmento de conteúdo

    A variável Descrição O campo agora é semelhante ao seguinte:

    Campo Descrição

Agora você adicionou as referências de conteúdo e fragmento diretamente no editor de texto de várias linhas.

Tipo de dados de Data e Hora

Vamos analisar os tipos de dados Data e hora. Selecione o Calendário no lado direito da janela Data de Fundação da Equipe para abrir a exibição de calendário.

Exibição do calendário de datas

Datas passadas ou futuras podem ser definidas usando as setas para frente e para trás em ambos os lados do mês. Digamos que a equipe do Yosemite foi fundada em 24 de maio de 2016, então definiremos a data para então.

Adicionar várias referências de fragmento

Vamos adicionar Professores à referência do fragmento Membros da equipe.

  1. Selecionar Adicionar no Membros da equipe campo.

    Botão Adicionar

  2. No novo campo exibido, selecione o ícone de pasta para abrir a modal Selecionar caminho. Navegue pelas pastas para WKND compartilhado > Inglês > Aventuras > Professores, em seguida, marque a caixa de seleção ao lado de jacob-wester. Pressione Selecionar para salvar o caminho.

    Caminho de referência do fragmento

  3. Selecione o Adicionar botão mais três vezes. Use os novos campos para adicionar os três professores restantes à equipe. A variável Membros da equipe O campo agora tem esta aparência:

    Campo de membros da equipe

  4. Selecionar Salvar e fechar para salvar o fragmento de conteúdo da equipe.

Adicionar referências de fragmento a um fragmento de conteúdo de aventura

Por fim, vamos adicionar os Fragmentos de conteúdo recém-criados a uma aventura.

  1. Navegue até Aventuras > Mochila de Yosemite e abra o Fragmento de conteúdo da mochila do Yosemite. Na parte inferior do formulário, é possível ver os três campos criados no capítulo anterior: Localização, Equipe do professor, e Administrador.

  2. Adicione a referência do fragmento na Localização campo. O caminho do Local deve fazer referência ao Fragmento de conteúdo do Parque Nacional de Yosemite que você criou: /content/dam/wknd-shared/en/adventures/locations/yosemite-national-park/yosemite-national-park.

  3. Adicione a referência do fragmento na Equipe do professor campo. O caminho da Equipe deve fazer referência ao Fragmento de conteúdo da equipe do Yosemite que você criou: /content/dam/wknd-shared/en/adventures/teams/yosemite-team/yosemite-team. Esta é uma referência de fragmento aninhado. O fragmento de conteúdo da equipe contém uma referência ao modelo de Pessoa que faz referência aos modelos de Informações de contato e Endereço. Portanto, você tem fragmentos de conteúdo aninhados três níveis abaixo.

  4. Adicione a referência do fragmento na Administrador campo. Digamos que Jacob Wester seja um administrador do Yosemite Backpacking Adventure. O caminho deve levar ao fragmento de conteúdo do Jacob Wester e aparecer da seguinte maneira: /content/dam/wknd-shared/en/adventures/instructors/jacob-wester.

  5. Agora você adicionou três referências de fragmento a um Fragmento de conteúdo de aventura. Os campos têm esta aparência:

    Referências de fragmento de aventura

  6. Selecionar Salvar e fechar para salvar seu conteúdo.

Parabéns.

Parabéns! Agora você criou fragmentos de conteúdo com base nos modelos avançados de fragmento de conteúdo criados no capítulo anterior. Você também criou uma política de pastas para limitar quais modelos de fragmento de conteúdo podem ser selecionados em uma pasta.

Próximas etapas

No próximo capítulo, você aprenderá a enviar consultas avançadas do GraphQL usando o IDE (Ambiente de desenvolvimento integrado) do GraphiQL. Essas consultas nos permitem visualizar os dados criados neste capítulo e, eventualmente, adicionar essas consultas ao aplicativo WKND.

recommendation-more-help
e25b6834-e87f-4ff3-ba56-4cd16cdfdec4