Riferimento documento blueprint

Utilizza questa abilità durante la creazione o la modifica di documenti blueprint in questo archivio. I blueprint sono implementazioni ripetibili che affrontano problemi di business consolidati e includono diagrammi di architettura, considerazioni tecniche e collegamenti alla documentazione di Adobe Experience League.

Quando applicare

• Creazione di un nuovo documento blueprint o di una pagina di panoramica blueprint
• Aggiunta o ristrutturazione di sezioni in una blueprint esistente
• Collegamento o citazione della documentazione di Adobe Experience League
• Allineamento di nuovi contenuti alle convenzioni blueprint (contenuti introduttivi, intestazioni, diagrammi)

Riferimento rapido

1. Scopo del documento: i blueprint forniscono l'architettura del sistema e del flusso di dati per mostrare come Adobe Experience Platform e le applicazioni sono integrate. Sono visive e tecniche, non di marketing.
2. Sezioni: utilizzare le sezioni standard del modello; omettere solo quando non applicabile (vedere reference.md).
3. Experience League: preferisci il collegamento ad Experience League per documenti di prodotto, API, guardrail e tutorial. Utilizza URL completi; consulta reference.md per i pattern e la formattazione degli URL.
4. Struttura dell'archivio: i blueprint sono attivi in help/blueprints/. Aggiorna help/blueprints/TOC.md quando aggiungi o sposti pagine blueprint.

Modello documento

Ogni pagina blueprint deve seguire questa struttura. Includi solo le sezioni applicabili.

markdown
1---
2title: [Short descriptive title]
3description: "[One sentence: what this blueprint shows and why it matters.]"
4solution: [Product name, e.g. Real-Time Customer Data Platform, Journey Optimizer]
5exl-id: [UUID - leave blank if new, this will be auto-generated as part of the Experience League publishing flow]
6---
7# [H1 - same as title or expanded]
8
9[1–3 paragraphs: what the blueprint covers, key capabilities, and who it’s for.]
10
11## Applications
12
13* [Product 1]
14* [Product 2]
15
16## Use cases
17
18* [Use case 1]
19* [Use case 2]
20
21## Prerequisites
22
23[Bullets or short paragraphs: required products, config, or setup.]
24
25## Architecture Diagram
26
27<img src="[path to SVG/image]" alt="[Descriptive alt]" style="width:90%; border:1px solid #4a4a4a" class="modal-image" />
28
29## Guardrails
30
31[Link to Experience League guardrails and any blueprint-specific limits.]
32
33## Implementation patterns
34
35[Optional: named patterns with bullets.]
36
37## Implementation steps
38
391. [Step with link to Experience League where relevant]
402. ...
41
42## Implementation considerations
43
44[Optional: identity, performance, security, etc.]
45
46## Related documentation
47
48[Grouped links to Experience League: product docs, APIs, tutorials.]

Per le pagine di panoramica o hub, utilizza una struttura più breve: introduzione, casi d’uso (o schede), immagine dell’architettura, tabella di scenari/pattern, prerequisiti, guardrail, documentazione correlata. Per alcuni esempi, vedere le panoramiche esistenti in help/blueprints/.

Frontmatter

Riferimento ad Adobe Experience League

• Quando collegare: collega ad Experience League per la documentazione del prodotto, i riferimenti API, i guardrail, i tutorial e i passaggi di configurazione. Non duplicare lunghe procedure; riepiloga e collega.
• Formato URL: utilizzare URL completi. Preferisci https://experienceleague.adobe.com/docs/?lang=it... o https://experienceleague.adobe.com/it/docs/.... Per i documenti per sviluppatori, https://developer.adobe.com/... è valido.
• Testo collegamento: usa testo descrittivo (ad esempio "[Crea schemi] (url)" non "Fai clic qui"). Per i nomi dei prodotti nel testo del collegamento, utilizzare [!DNL Product Name] quando appropriato.
• Sezione documentazione correlata: fine dei blueprint con una sezione "Documentazione correlata" che raggruppa i collegamenti per categoria (ad esempio, configurazioni di destinazione, documentazione di SDK, profilo e segmentazione, tutorial).

Per i pattern URL dettagliati, il raggruppamento di collegamenti e gli esempi, vedi reference.md.

Elenco di controllo prima dell’invio

• elemento frontale ha title, description, solution, exl-id
• H1 corrisponde o espande in modo appropriato il titolo
• Diagramma dell'architettura presente e testo alternativo descrittivo
• collegamento ai passaggi dell'implementazione ad Experience League in cui si svolgono le procedure
• [ La sezione dei guardrail ] contiene collegamenti ai documenti ufficiali del guardrail di Experience League
• La sezione della documentazione correlata include collegamenti Experience League rilevanti
• Le pagine nuove o spostate si riflettono in help/blueprints/TOC.md

Risorse aggiuntive

• Note complete sul modello e sulla sezione: reference.md
• Blueprint esistenti: help/blueprints/ (ad esempio audience-activation/real-time-lookup.md, customer-journeys/journey-optimizer/journey-optimizer-overview.md)
• Sommario e navigazione: help/blueprints/TOC.md