Microsoft SharePoint koppelen
Lumicast kan nieuws en lijsten uit Microsoft SharePoint ophalen en op je schermen tonen. In deze handleiding lees je hoe je een Microsoft-account koppelt, hoe je een databron voor SharePoint-nieuws maakt en, waar de meeste organisaties om vragen, hoe je nieuws bundelt van een complete hub met sites in plaats van één site.
App of databron?
Je kunt SharePoint-nieuws op twee manieren in Lumicast gebruiken:
- De SharePoint News-app: een kant-en-klare, vormgegeven nieuwscarrousel. Het beste voor één site, met zo min mogelijk instellingen.
- Een databron voor SharePoint-nieuws (deze handleiding): de flexibele optie die je koppelt aan je eigen pagina's. Nieuws van een hele hub bundelen kan alleen met de databron.
Vereisten
- Een Microsoft-account dat de SharePoint-site(s) kan lezen die je wilt tonen. Tijdens het koppelen log je in en geef je toestemming. Lumicast vraagt alleen leestoegang (
Sites.Read.All) en schrijft nooit iets naar SharePoint. - Voor nieuws van een hele hub: je SharePoint moet al een hubsite gebruiken (een beheerbegrip in SharePoint: één site is aangewezen als hub en andere sites zijn eraan gekoppeld). Is je intranet ingericht als hub met afdelings- of teamsites eronder? Dan zit je goed.
1. De verbinding en databron aanmaken
- Ga naar Data koppelingen en klik op Data koppeling aanmaken.
- Klap Microsoft SharePoint uit en kies SharePoint-nieuws.
- Kies bij Selecteer verbinding een bestaande Microsoft SharePoint-verbinding, of kies Nieuwe verbinding, log in met een account dat de betreffende sites kan lezen en geef toestemming. Je kunt de verbinding hergebruiken voor andere SharePoint-databronnen en -apps.
- Kies de Sitenaam. In de lijst staan alleen sites die het gekoppelde account kan lezen.
- Vul een Naam in en stel de opties hieronder in.
- Klik op Opslaan. Lumicast begint met ophalen en bewaart het laatste nieuws.
2. Instellingen
| Instelling | Wat het doet |
|---|---|
| Sitenaam | De SharePoint-site waar het nieuws vandaan komt. In hubmodus is dit je hubsite. |
| Volledige artikelinhoud ophalen | Aan: haalt de volledige tekst van elk bericht op (zwaarder). Uit: alleen de samenvatting. Zie de opmerking hieronder. |
| Nieuws van de hele hub opnemen | Behandelt de gekozen site als hub en bundelt het nieuws van de hub en alle sites die eraan gekoppeld zijn. Uit = alleen de gekozen site (het oorspronkelijke gedrag). |
Volledige inhoud of aantal items
Het ophalen van de volledige tekst is het zware deel. Daarom bepaalt deze instelling hoeveel items we laden:
- Volledige inhoud aan: de tekst van elk artikel wordt apart opgehaald, dus we bewaren de 20 nieuwste items.
- Volledige inhoud uit (alleen samenvatting): er wordt niets per artikel opgehaald, dus we laden de 100 nieuwste items.
In hubmodus wordt de volledige tekst alleen opgehaald voor de uiteindelijke, samengevoegde lijst. Zo blijft het ook met veel sites goed te doen.
Afbeeldingen in een artikel
Elke afbeelding in de tekst van een artikel, een Afbeelding-webonderdeel of een plaatje in een tekstblok, komt binnen onder images, in de volgorde waarin ze op de pagina staan, naast de bannerafbeelding van het artikel in imageUrl. Koppel ze aan een afbeeldingslaag: afbeeldingen kunnen niet in een tekstlaag worden weergegeven.
images wordt alleen gevuld als Volledige artikelinhoud ophalen aan staat, want de tekst komt uit die aanvraag. Standaardafbeeldingen uit SharePoint-sjablonen en afbeeldingen die buiten SharePoint worden gehost, worden overgeslagen.
Eigen pagina-eigenschappen
Eigen kolommen die je toevoegt aan de bibliotheek Sitepagina's (Site Pages) van een site, verschijnen automatisch bij elk nieuwsitem onder properties, met de interne naam van de kolom als sleutel. Je hoeft niets in te stellen. Vul een waarde in via het deelvenster Paginadetails van de pagina en publiceer de pagina opnieuw. Kolommen van het type Persoon of groep komen binnen als lookup-id, niet als naam.
3. Zo werkt het bundelen van nieuws uit een hele hub
Het overzicht "nieuws uit deze hub" van SharePoint zelf is een webonderdeel op een pagina. Er is geen API die dat in één keer teruggeeft. Lumicast bouwt het daarom zelf na:
- Vanaf de gekozen hubsite zoekt Lumicast met SharePoint-zoeken de gekoppelde sites op (maximaal 50).
- Het haalt de nieuwste nieuwsberichten op van de hub en van elke gekoppelde site.
- Het voegt die samen tot één feed, nieuwste eerst, en zet bij elk artikel de site waar het vandaan komt. Zo kan een gekoppelde pagina de bronsite naast de kop tonen.
Nieuwe sites en berichten verschijnen automatisch zodra SharePoint ze heeft geïndexeerd. Je hoeft de databron niet opnieuw in te stellen als er een nieuwe afdelingssite aan de hub wordt toegevoegd.
Een gekoppelde site die het account niet kan lezen, wordt stilletjes overgeslagen in plaats van dat de hele feed mislukt. Zorg er dus voor dat het account toegang heeft tot elke site waarvan je het nieuws wilt tonen.
Klassieke subsites zijn geen hubsites
Dit bundelt sites die aan een hub gekoppeld zijn: elk daarvan is een zelfstandige site. Bijvoorbeeld een hub op .../sites/company-hub met de gekoppelde sites .../sites/marketing en .../sites/hr. Ouderwetse subsites binnen één site (.../sites/company-hub/archive) worden niet meegenomen. Staat je content in een hub met losse sites, de moderne SharePoint-opzet? Dan zit je hier goed.
Problemen oplossen
"This Microsoft connection needs to be reconnected." Lumicast toont deze melding als het op de achtergrond geen toegang meer heeft tot SharePoint. Meestal komt dat doordat je Microsoft-tenant nu meervoudige verificatie (MFA) afdwingt (via Security Defaults of een Conditional Access-beleid) en de opgeslagen aanmelding van vóór dat beleid is. Oplossing: kies op de pagina Data koppelingen bij de verbinding Opnieuw verbinden en rond de MFA-controle af. Met de vernieuwde aanmelding werkt de toegang weer. Komt het steeds terug? Dan vraagt het MFA-beleid van de tenant ook bij de automatische aanmelding op de achtergrond om verificatie. Een beheerder van Microsoft Entra ID moet de app van de verbinding dan uitsluiten van dat beleid (voor Conditional Access is Entra ID Premium nodig). Twijfel je, neem dan contact op met de support van Lumicast. (De onderliggende foutmelding van Microsoft is "multi-factor authentication required",
AADSTS50076.)Het hubnieuws mist sommige sites. Het opsporen van sites gebruikt de zoekindex van SharePoint. Nieuwe sites of berichten kan het enkele minuten tot een paar uur duren voordat ze zijn geïndexeerd, en tot die tijd verschijnen ze niet. Verschijnt een bestaande site nooit? Controleer dan of het gekoppelde account die site echt kan lezen en neem contact op met support.
Met de hub-schakelaar aan zie je alleen het nieuws van de hubsite zelf. Meestal betekent dit dat de gekoppelde sites nog niet zijn geïndexeerd (zie hierboven). Lukt het opsporen helemaal niet, dan valt Lumicast veilig terug op alleen de gekozen site. Een hubdatabron geeft dus nooit minder terug dan dezelfde site zonder de schakelaar.
Je ziet alleen samenvattingen, geen volledige artikelen. Zet Volledige artikelinhoud ophalen aan. Daardoor worden er wel minder items geladen (zie de tip hierboven).