DocumentatieGenStudioHandleiding voor uitbreidbaarheid

Experience Selector MFE in Salesforce

Laatst bijgewerkt: 14 mei 2026

Gemaakt voor:

  • Developer

In dit onderwerp wordt uitgelegd hoe klanten en implementatoren de GenStudio for Performance Marketing Experience Selector micro frontend (MFE) op een Salesforce org kunnen implementeren en uitvoeren. Het behandelt beheerderstappen (geen code), ontwikkelaarstappen (opstellen en vormen), en veiligheid-verwante montages zoals het Beleid van de Veiligheid van de Inhoud (CSP).

Voor generische MFE integratieopties, configuratieeigenschappen, en kadervoorbeelden, zie ​ de Selecteur MFE van de Ervaring van GenStudio ​.

Wat deze integratie doet

https://video.tv.adobe.com/v/3491085?captions=dut&learn=on

Met de Lightning Web Component (LWC) sfgsmfe wordt de UMD-bundel van de Adobe Experience Selector UMD geladen en weergegeven in een <dialog> , zodat gebruikers een ervaring kunnen kiezen in GenStudio for Performance Marketing .

De integratie kan ook:

  • Voorproef en decodeert: toon de geselecteerde lading als JSON, gedecodeerde HTML, en een geanimeerde voorproef van HTML binnen LWC.
  • E-mailmalplaatjes (facultatief): A Create Email Template stroom in Salesforce kan Apex (EmailTemplateController.createEmailTemplate) roepen om een EmailTemplate verslag (HTML, onderwerp, en omslag) op te nemen.

Het script Experience Selector voor GenStudio for Performance Marketing wordt geladen vanaf een door Adobe gehoste URL op experience.adobe.com , niet vanaf een statische bron van Salesforce in de standaard implementatie.

Vereisten

  • Salesforce org: een zandbak of productiorg waar u meta-gegevens en gebruik Lightning App Builder kunt opstellen.

  • Salesforce CLI: Salesforce CLI (sf) is geïnstalleerd en voor authentiek verklaard, bijvoorbeeld:

    code language-bash 
    sf org login web --alias <your-org-alias>

  • Toestemmingen: De gebruikers die e-mailmalplaatjes creëren hebben toegang tot de omslag en de rechten van het doelE-mailmalplaatje nodig om malplaatjes volgens uw org beleid tot stand te brengen. Apex wordt uitgevoerd with sharing .

  • Adobe/GenStudio: Uw organisatie-identiteitskaart van Adobe IMS en SUSI clientId moet uw configuratie van Adobe aanpassen (zie ​ integratiewaarden ​ vormen).

  • Browser/CSP: Salesforce moet ladende manuscripten van https://experience.adobe.com toestaan (zie ​ het beleid van de inhoudsveiligheid en Adobe URL ​ vormen).

Het pakket implementeren (ontwikkelaar)

Het project gebruikt de lay-out van Salesforce DX; de standaardpakketmap is force-app .

  1. Van uw projectwortel, stel bron aan doelorg op:

    code language-bash 
    sf project deploy start --source-dir force-app --target-org <your-org-alias>

  2. Bevestig dat de implementatie zonder fouten is voltooid.

  • force-app/main/default/lwc/sfgsmfe — LWC-bundel (HTML, JS, CSS, meta).
  • force-app/main/default/classes/EmailTemplateController.cls — Apex voor het maken van sjablonen.

De repo kan ook statische bronnen bevatten (reactApp, sfgsmfe_react ). De huidige GenStudio for Performance Marketing loader in sfgsmfe.js gebruikt de Adobe CDN-URL voor standalone.js ; die Statische Middelen worden niet vereist voor dat ladingspad tenzij u de implementatie verandert.

De component toevoegen aan een bliksempagina (admin)

De component sfgsmfe wordt weergegeven voor:

  • Pakketpagina’s voor toepassingen weergeven
  • Homepages
  • Pagina’s opnemen
  • Tabs (via een bliksempagina op een aangepast tabblad)

De component toevoegen:

  1. Open App Manager in Setup .
  2. Maak een New Lightning App (of open een bestaande app die u wilt uitbreiden).
    ​ Nieuw bliksemtoepassingenmodaal ​ {width="80%" modal="regular"}
  3. Open de app en selecteer Edit .
    ​ Edit Bliksem App modal ​ {width="80%" modal="regular"}
  4. Maak een New Page (of bewerk een bestaande bliksempagina).
    ​ het Nieuwe modaal van de Pagina ​ {width="60%" modal="regular"}
  5. In Lightning App Builder, sleep de sfgsmfe component op de lay-out.
  6. Save , Activate en wijs de pagina toe aan de juiste Bliksem-app, -profielen en -zichtbaarheid van de app, zodat bedoelde gebruikers deze kunnen openen.

Beveiligingsbeleid voor inhoud configureren en Adobe URL

De LWC injecteert een <script> -tag waarvan src punten aanwijst bij de UMD-bundel van Adobe, bijvoorbeeld:

https://experience.adobe.com/solutions/GenStudio-experience-selector-mfe/static-assets/resources/@genstudio/experience-selector/umd/standalone.js

U moet Salesforce zodanig configureren dat deze oorsprong is toegestaan voor het laden van scripts volgens de beveiligingsinstellingen voor CSP en bliksemschichten van uw organisatie.

Als het script niet kan worden geladen:

  1. Open de browsergereedschappen voor ontwikkelaars.
  2. Controleer de tabbladen Console en Network op geblokkeerde aanvragen of CSP-overtredingen.
  3. Voeg Trusted URLs (en eventuele verwante instellingen voor uw Salesforce-versie) voor https://experience.adobe.com toe of pas deze aan, na de huidige Salesforce-documentatie voor bliksemschichten.
    ​ Salesforce CSP Vertrouwde Plaatsen ​ {width="80%" modal="regular"}

Integratiewaarden configureren (ontwikkelaar/implementatie)

Verschillende waarden worden ingesteld in de LWC JavaScript for sfgsmfe . Klanten vervangen deze doorgaans per omgeving.

Waarde
Beschrijving
folderId
Salesforce-map-id (00l...) voor e-mailsjablonen waarin nieuwe sjablonen worden gemaakt. Vereist voor Apex; de map moet bestaan en toegankelijk zijn voor de actieve gebruiker.
imsOrg
Adobe IMS-organisatie-id doorgegeven aan GenStudioExperienceSelector.renderExperienceSelectorWithSUSI .
susiConfig.clientId
Adobe SUSI client ID for the Experience Selector app registration.
GenStudio script.src
URL van de UMD standalone.js -bundel; bijwerken als Adobe een nieuw pad publiceert.

Bij het maken van e-mailsjablonen worden GenStudio-velden toegewezen aan de sjabloon (bijvoorbeeld onderwerp van experienceFields). Pas toewijzingen in LWC aan als uw inhoudsmodel verschilt.

Voor details op renderExperienceSelectorWithSUSI en verwante opties, zie ​ Eigenschappen van de Configuratie ​ in het onderwerp van de Selecteur MFE van de Ervaring.

Apex: EmailTemplateController

EmailTemplateController.createEmailTemplate normaal:

  • Valideert de sjabloonnaam, map-id en niet-lege HTML.
  • Maakt een EmailTemplate met TemplateType = 'custom' , HtmlValue , Subject , Body en maptoewijzing.
  • Oppervlaktefouten naar de LWC tot en met AuraHandledException.

Operationele tips:

  • Eerbiedig DeveloperName uniek en noemend regels in org.
  • Bevestig de map-id en dat de gebruiker EmailTemplate -records in die map kan maken.
  • Gebruik Salesforce-logbestanden voor foutopsporing wanneer DML de exacte fout niet vastlegt.

Controlelijst voor validatie

Bevestig de items in deze lijst na implementatie en configuratie voor een betrouwbare validatie van de integratie:

  1. Implementatie wordt zonder fouten voltooid.
  2. Gebruikers kunnen de bliksempagina met sfgsmfe openen en de gebruikersinterface van de Experience Selector bekijken.
  3. Er wordt geen laadfout weergegeven in de component. het tabblad Netwerk retourneert HTTP 200 voor standalone.js .
  4. Select a GenStudio Experience opent de selecteur en de selectiecallbacks lopen.
  5. Create Email Template slaagt wanneer u die stroom gebruikt, en het malplaatje verschijnt onder de gevormde omslag in Setup.

Zie ook

recommendation-more-help
genstudio-for-performance-marketing-help-extensibility