--- source: e1e130c7446d --- # 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. ::: info App of databron? Je kunt SharePoint-nieuws op twee manieren in Lumicast gebruiken: - De **[SharePoint News-app](/nl/features/apps/sharepoint-news)**: 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](/nl/features/page-editor). **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 1. Ga naar **Data koppelingen** en klik op **Data koppeling aanmaken**. 2. Klap **Microsoft SharePoint** uit en kies **SharePoint-nieuws**. 3. 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. 4. Kies de **Sitenaam**. In de lijst staan alleen sites die het gekoppelde account kan lezen. 5. Vul een **Naam** in en stel de opties hieronder in. 6. 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). | ::: tip 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. ::: ::: info 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. ::: ::: info 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: 1. Vanaf de gekozen **hubsite** zoekt Lumicast met SharePoint-zoeken de **gekoppelde sites** op (maximaal 50). 2. Het haalt de nieuwste nieuwsberichten op van de hub en van elke gekoppelde site. 3. 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. ::: info 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). ## Gerelateerd - [SharePoint News-app](/nl/features/apps/sharepoint-news) · [SharePoint List News-app](/nl/features/apps/sharepoint-list-news) · [SharePoint Birthdays-app](/nl/features/apps/sharepoint-birthdays) - [Databronnen](/nl/features/datasources) · [Verbindingen](/nl/features/connections) · [Live data aan pagina's koppelen](/nl/features/binding-data)