Sitecore Content Hub External Component

door Danny Paul van Iersel, 18-3-2024

Basis

Potentieel kan elke react-app binnen Content Hub worden uitgevoerd. Als u een bundel van uw reactietoepassing heeft, kunt u ernaar verwijzen om deze als externe component te gebruiken.

Je kunt op 2 manieren een bundel toevoegen aan je Content Hub omgeving:

• Extern
• Intern

Van “From path”: bevat een externe URL waarnaar u kunt verwijzen.
Vanuit “From asset”: je kunt koppelen aan een interne bundel.

Interne bundels worden geüpload naar de Portal Assets:

Als we de configuratieweergave naar Tekst schakelen, kunnen we elke configuratie typen die de react-app vereist en deze binnen de app gebruiken.

JavaScript SDK

Als u de JavaScript SDK wilt gebruiken, moet u de package in uw toepassing installeren

Het installeren van de SDK kan gedaan worden door: npm install @sitecore/sc-contenthub-webclient-sdk

Enkele voorbeelden van hoe u dit kunt gebruiken, vindt u in de documentatie van Sitecore Content Hub: https://doc.sitecore.com/ch/en/users/content-hub/examples.html

Met de SDK heeft u volledige controle over elk onderdeel van een entiteit.

Je kunt in haken elk evenement dat Content Hub aanbiedt, zoals:

• Notifier events
• Search events
• Selection events
• Subscribing events

U kunt ook entiteitseigenschappen of relaties verzamelen.

Voor toegang tot eigenschappen moet u functies uit de SDK importeren met behulp van: import { IProperty } from "@sitecore/sc-contenthub-webclient-sdk/dist/contracts/base/property";

U kunt vervolgens toegang krijgen tot eigenschappen van een entiteit met de volgende code:
var titleProperty: IProperty = entity.getProperty("Title");

Voor het gebruik van relaties kunt u gebruik maken van de import:
import { IRelation } from "@sitecore/sc-contenthub-webclient-sdk/dist/contracts/base/relation";

U hebt dan toegang tot relaties zoals de volgende code: var relation : IRelation = entity.getRelation("AssetTypeToAsset");

Dit geeft u de mogelijkheid om de waarden te openen en te manipuleren op basis van uw vereisten.

Authenticatie

Als je de Client uit de SDK wilt gebruiken om andere delen van je Content Hub omgeving te bevragen, heb je een OAuth-client nodig.

U kunt een nieuwe OAuth-client configureren in de beheersectie.

Een volledige beschrijving over hoe u dit kunt configureren, vindt u in de Sitecore documentatie: https://doc.sitecore.com/ch/en/developers/cloud-dev/authentication-1286145.html

Om u een voorbeeld te geven van hoe u de OAuth-clients in uw toepassing kunt gebruiken:

import OAuthPasswordGrant from "@sitecore/sc-contenthub-webclient-sdk/dist/authentication/oauth-password-grant"; 
import { ContentHubClient } from "@sitecore/sc-contenthub-webclient-sdk/dist/clients/content-hub-client"; 

/ Your Sitecore Content Hub endpoint to connect to 
const endpoint = "https://your.m.endpoint.com"; 

//Enter your credentials here 
const oauth = new OAuthPasswordGrant( 
    "client_id",
    "client_secret",
    "username",
    "password"
    );
    
//Create the JavaScript SDK client 
const client new ContentHubClient (endpoint, oauth); 

// Authentication
// returns true when authentication succeeds.
// returns false or throws an error when authentication failed

await client.internalClient.authenticateAsync();

Conclusie

Er zijn veel manieren om uw Content Hub omgeving en de eindgebruikerservaring te verrijken.

Door uw Content Hub uit te breiden met externe componenten beschikt u over een eindeloos aanbod aan mogelijkheden.

Bent u op zoek naar een implementatiepartner?

Zit u vast aan uw configuratie of kunt u met uw huidige omgeving uw potentieel niet bereiken?

Wij helpen u graag en geven u onze expertise over hoe u kunt verbeteren of versnellen naar een hoger niveau.