Criar um mapeamento entre um tópico e um Fragmento de experiência
O Adobe Experience Manager Guides fornece o recurso para criar um mapeamento baseado em JSON entre um tópico e um modelo de Fragmento de experiência. Você pode usar esse mapeamento para publicar conteúdo presente em alguns ou todos os elementos de um tópico em um Fragmento de experiência.
-
Para baixar o experienceFragmentMapping.json, entre no Adobe Experience Manager como administrador.
-
Selecione o link do Adobe Experience Manager na parte superior e escolha Ferramentas.
-
Selecione Guias na lista de ferramentas e selecione a Pasta Perfis.
-
Selecione o bloco do perfil que você deseja configurar. É possível configurar o mapeamento para o perfil global ou de nível de pasta. Por exemplo, selecione o bloco Perfil Global.
-
Selecione a guia Configuração do Editor XML e selecione o ícone Editar na parte superior.
-
Selecione o ícone Baixar para baixar o arquivo experienceFragmentMapping.json no sistema local. Em seguida, você pode fazer alterações no arquivo e fazer upload do mesmo.
-
Você precisa seguir as seguintes validações:
-
Deve ser um arquivo JSON
-
Ela deve conter uma matriz contendo pelo menos um objeto, e cada objeto deve conter o seguinte:
"template": string
"mapping": array
Cada objeto de mapeamento deve conter o seguinte:
"name": string
"class": string
"resourceType": string
"attributeMap": array
-
-
Salve o arquivo e faça upload dele.
O Experience Manager Guides converte o tópico completo em HTML, que pode ser mapeado para os componentes principais usados no Fragmento de experiência. Por exemplo, o conteúdo em uma marca <p>
pode ser mapeado para criar um componente de texto no Fragmento de experiência.
name
: especifique o elemento HTML. Por exemplo,<div>
,<img>
class
: especifique a marca do elemento DITA correspondente ao elemento HTML. Por exemplo,<p>
<image>
resourceType
: especifique o tipo de recurso aplicável ao componente usado no Fragmento de experiência. Por exemplo,wcm/foundation/components/text
é o resourceType do componente wcmtext
.attributeMap
: Forneça informações adicionais ao componente, como se um componente de texto deve ser renderizado comoRichText
ou contém ofileReference
de um componente de imagem.
Arquivo de exemplo:
[
{
"template": "default",
"mapping": [
{
"name": "#element",
"resourceType": "wcm/foundation/components/text",
"attributeMap": [
{
"from": "outerHTML",
"to": "text"
},
{
"value": true,
"to": "textIsRich"
}
]
}
]
},
{
"template": "/conf/we-retail/settings/wcm/templates/experience-fragment-web-variation",
"mapping": [
{
"name": "div",
"class": "title",
"resourceType": "wcm/foundation/components/text",
"attributeMap": [
{
"from": "outerHTML",
"to": "text"
},
{
"value": true,
"to": "textIsRich"
}
]
},
{
"name": "h1, h2, h3, h4, h5, h6",
"resourceType": "wcm/foundation/components/text",
"attributeMap": [
{
"from": "outerHTML",
"to": "text"
},
{
"value": true,
"to": "textIsRich"
}
]
},
{
"name": "div",
"class": "p",
"resourceType": "wcm/foundation/components/text",
"attributeMap": [
{
"from": "outerHTML",
"to": "text"
},
{
"value": true,
"to": "textIsRich"
}
]
},
{
"name": "img",
"class": "image",
"resourceType": "wcm/foundation/components/image",
"attributeMap": [
{
"from": "outerHTML",
"to": "fileReference"
}
]
},
{
"name": "#element",
"resourceType": "wcm/foundation/components/text",
"attributeMap": [
{
"from": "outerHTML",
"to": "text"
},
{
"value": true,
"to": "textIsRich"
}
]
}
]
}
]
Ao publicar os Fragmentos de experiência no Editor da Web, selecione o Template
na lista suspensa da caixa de diálogo Gerar fragmento de experiência para exibir o mapeamento disponível para o modelo no campo Mapeamento. Se nenhum mapeamento personalizado estiver presente para um modelo, o mapeamento padrão será listado. Você pode usar o mapeamento padrão para publicar todo o tópico como um Fragmento de experiência.
Para obter mais detalhes, consulte Fragmentos de experiência do Publish.