use-case-pattern-page-builder

name	use-case-pattern-page-builder
description	Criação de guia de novo conteúdo padrão de caso de uso para o repositório de blueprints do Adobe Experience Platform. Use essa habilidade ao adicionar um novo padrão de caso de uso, criar conteúdo de orientação de implementação ou quando o usuário mencionar adicionar padrões ao site de blueprints. Lida com o fluxo de trabalho completo: coleta de informações de padrão, geração do arquivo do Markdown com a estrutura de modelo correta e atualização de todas as páginas de referência cruzada (TOC.md, overview.md).
source-git-commit	349d26f612d4002d1de3d27c7f893bd63ac467a3
workflow-type	tm+mt
source-wordcount	923
ht-degree	94%

Page Builder do padrão de caso de uso

Essa habilidade orienta a criação de um novo padrão de caso de uso para o repositório de blueprints da Adobe Experience Platform. Ele lida com o fluxo de trabalho completo: coleta de informações de padrão do usuário, geração do arquivo de conteúdo do Markdown com a estrutura de modelo correta e atualização de todas as páginas de referência cruzada para que o novo padrão seja detectável.

Antes de iniciar, leia os seguintes arquivos de referência para a estrutura completa do modelo e a lista de verificação de páginas a serem atualizadas:

• references/pattern-template.md — o modelo de marcação completa com valores de espaço reservado
• references/pages-to-update.md — a lista de verificação de páginas que devem ser atualizadas ao adicionar um padrão

Fase 1: Coleta de informações

Entrevistar o usuário para coletar todas as informações necessárias antes de gerar quaisquer arquivos. Solicite o seguinte e não prossiga para a geração de conteúdo até que cada item seja fornecido ou explicitamente adiado.

Informações necessárias

1. Nome do padrão — O título legível (por exemplo, "Mensagens Acionadas por Eventos").

2. Categoria — Exatamente um dos seguintes:

   • audience-building-activation
   • personalization
   • campaign-management-orchestration
   • analysis
   • conversational-experience

3. Descrição de recurso principal — Uma frase única que descreve o que este padrão faz (usado na tabela de visão geral e na descrição do frontmatter).

4. Soluções Adobe principais — Os produtos Adobe são fundamentais para esse padrão. Escolha entre: Journey Optimizer, Real-Time Customer Data Platform, Experience Platform, Customer Journey Analytics, Brand Concierge, Journey Optimizer B2B edition, Real-Time CDP B2B edition ou outros, conforme apropriado.

5. Objetivos de negócios com suporte — Um ou mais objetivos de negócios do conjunto existente em /help/blueprints/business-objectives/. Cada deve incluir o nome do objetivo, a subpasta de categoria e o nome do arquivo. Verifique se os arquivos referenciados existem antes de gerar o conteúdo.

6. Exemplo de casos de uso tático — 6 a 10 cenários com marcadores que descrevem como esse padrão pode ser aplicado em diferentes contextos comerciais. Cada deve ter um nome de cenário em negrito seguido por uma descrição.

7. KPIs — Uma tabela com três colunas: KPI (nome), Descrição (o que ele mede), Medida (fórmula ou abordagem).

8. Links de referência — links de referência para documentos principais do Experience League que abrangem os aplicativos e a capacidade do padrão de caso de uso.

Opcional, mas recomendado

• Parágrafos de visão geral do caso de uso (3-5 parágrafos; se não forem fornecidos, faça um rascunho deles das outras informações)
• Lista de aplicativos com descrições da função de cada aplicativo Adobe

Se o usuário não fornecer os itens opcionais, gere padrões razoáveis com base na categoria do padrão, soluções e plano de execução.

Fase 2: geração de conteúdo

Gere o arquivo de marcação padrão no seguinte caminho:

/help/blueprints/use-case-patterns/{category}/{kebab-case-pattern-name}.md

O nome do arquivo deve usar letras maiúsculas e minúsculas derivadas do nome do padrão. Por exemplo, "Mensagens acionadas por evento" torna-se event-triggered-messaging.md.

Use o modelo de references/pattern-template.md e preencha todos os valores de espaço reservado com as informações coletadas. O arquivo gerado deve incluir cada seção no modelo:

1. Interface do YAML — título, descrição, solução (separada por vírgulas), exl-id (gerar um espaço reservado de UUID como xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx — a equipe de publicação atribuirá o real).

2. Seção de abertura — cabeçalho # {Pattern name} seguido de um parágrafo de introdução e a mensagem "Use este guia para entender..." sentença.

3. Padrão de caso de uso — Parágrafo de descrição e plano de execução.

4. Visão geral do caso de uso — 3 a 5 parágrafos que descrevem o escopo do padrão, quando ele se aplica, o que ele faz ou não faz e quem são os participantes típicos.

5. Principais objetivos de negócios — cada objetivo como um cabeçalho vinculado com uma breve descrição e uma linha de resumo de KPIs.

6. Exemplo de casos de uso tático — Lista com marcadores de 6 a 10 cenários.

7. Indicadores-chave de desempenho — Tabela com KPI, Descrição, Colunas de medição.

8. Aplicativos — Lista de aplicativos do Adobe com formatação e descrições [!DNL ...].

Fase 3: Atualizações de referência cruzada

Após gerar o arquivo de padrão, atualize os arquivos a seguir. Leia references/pages-to-update.md para obter a lista de verificação detalhada.

TOC.md

Arquivo: /help/blueprints/TOC.md

Adicione uma nova entrada na seção de categoria correta. As categorias são mapeadas para estas seções de índice:

Lesma da categoria	Cabeçalho da seção do índice
audience-building-activation	+ Audience Building & Activation{#audience-building-activation}
personalization	+ Personalization{#personalization-patterns}
campaign-management-orchestration	+ Campaign Management & Orchestration{#campaign-orchestration-patterns}
analysis	+ Analysis{#analysis-patterns}
conversational-experience	+ Conversational Experience{#conversational-experience-patterns}

O formato da entrada é:

    + [{{Pattern Title}}](/help/blueprints/use-case-patterns/{{category}}/{{filename}}.md)

Adicione a nova entrada após a última entrada existente na seção correspondente. Preservar o recuo exato (quatro espaços antes de +).

Página de visão geral

Arquivo: /help/blueprints/use-case-patterns/overview.md

Adicione uma nova linha à tabela de categorias correta. O formato é:

| [{{Pattern Title}}]({{category}}/{{filename}}.md) | {{Primary capability description}} | [!DNL {{Solution1}}], [!DNL {{Solution2}}] |

Adicionar a nova linha após a última linha existente na tabela de categorias correspondente.

Fase 4: validação

Depois que todos os arquivos forem criados e atualizados, verifique o seguinte:

1. Links de objetivo comercial — Cada link de objetivo comercial no arquivo padrão aponta para um arquivo existente em /help/blueprints/business-objectives/. Use glob ou read para confirmar se cada arquivo de destino existe.

2. Posicionamento da entrada do sumário — A nova entrada do sumário está dentro da seção de categoria correta e usa o formato de recuo e caminho corretos.

3. Linha de tabela de visão geral — A nova linha de visão geral está na tabela de categoria correta e segue o mesmo formato de coluna das linhas existentes.

4. Nomeação do arquivo — O nome de arquivo padrão usa kebab-case e corresponde ao caminho referenciado em TOC.md e overview.md.

5. Integridade do Frontmatter — O arquivo padrão inclui título, descrição, solução e exl-id no frontmatter do YAML.

6. Links do Experience League — Verifique se todas as URLs do Experience League são plausíveis (comece com https://experienceleague.adobe.com/pt-br).

Relate quaisquer falhas de validação ao usuário e corrija-as antes de considerar a tarefa como concluída.

Notas

• Sempre use a sintaxe [!DNL ...] para nomes de produtos Adobe em tabelas e corpo de texto, seguindo a convenção de arquivos de padrão existentes.
• O exl-id no front-matter deve ser um UUID de espaço reservado. O pipeline de publicação atribui o valor real.
• Se o usuário quiser criar vários padrões de uma só vez, repita as Fases 2 a 4 para cada padrão, mas colete todas as informações na Fase 1.
• Se for necessária uma nova categoria que não exista na lista acima, avise o usuário de que o TOC.md e o overview.md precisarão da criação de novas seções e lidarão com isso como uma etapa separada.