De kracht van de SharePoint Property Bag: metadata op siteniveau voor betere informatievoorziening
SharePoint biedt verschillende manieren om metadata toe te voegen aan documenten en lijsten. Minder bekend, maar bijzonder krachtig, is de SharePoint Property Bag. Met een Property Bag kun je metadata opslaan op het niveau van een SharePoint-site, waardoor je centrale eigenschappen kunt beheren die relevant zijn voor een project, afdeling of applicatie.
In dit artikel leg ik uit wat een Property Bag is, hoe je deze kunt gebruiken en welke praktische scenario’s je ermee kunt realiseren.
Wat is een SharePoint Property Bag?
Een Property Bag is in feite een verzameling van sleutel-waardeparen die gekoppeld zijn aan een SharePoint-site. Je kunt er bijvoorbeeld gegevens in opslaan zoals:
| Eigenschap | Waarde |
| ProjectCode | PRJ-2025-001 |
| ProjectManager | Jan Jansen |
| Klant | Contoso |
| ProjectStatus | Uitvoering |
| Budget | €250.000 |
Deze gegevens zijn niet direct zichtbaar voor eindgebruikers zoals kolommen in een lijst, maar kunnen door beheerders, ontwikkelaars en automatiseringen worden uitgelezen en verwerkt.
Waarom metadata op siteniveau?
Bij veel organisaties wordt iedere projectsite gebruikt voor één specifiek project. In zo’n situatie ontstaat vaak de behoefte om projectinformatie centraal vast te leggen:
- Projectnummer
- Klantnaam
- Contractwaarde
- Start- en einddatum
- Projectleider
- Kostenplaats
- Organisatiedeel
Normaal gesproken wordt deze informatie verspreid opgeslagen:
- In lijsten
- In Excel-bestanden
- In documenteigenschappen
- In externe systemen
Met een Property Bag leg je deze informatie één keer vast en maak je deze beschikbaar voor allerlei toepassingen.
Een Property Bag vullen
Met PowerShell of PnP PowerShell kun je eenvoudig eigenschappen toevoegen.
Voorbeeld met PnP PowerShell
De gegevens worden vervolgens opgeslagen op de site zelf.
Eigenschappen uitlezen
Het ophalen van een waarde is net zo eenvoudig.
Of alle eigenschappen tegelijk:
Hiermee kun je gemakkelijk automatiseringen bouwen die sitegegevens verzamelen.
Scenario 1: Centraal projectregister opbouwen
Een veelvoorkomende uitdaging is het verkrijgen van een actueel overzicht van alle projecten binnen de organisatie.
Wanneer iedere projectsite dezelfde Property Bag-eigenschappen bevat, kun je een script bouwen dat alle sites doorloopt:
- Project A
- Project B
- Project C
Voor iedere site worden vervolgens eigenschappen uitgelezen zoals:
- ProjectCode
- Status
- ProjectManager
- Klant
- Einddatum
Deze gegevens kunnen worden verzameld in:
- Een SharePoint-lijst
- Dataverse
- SQL-database
- Power BI Dataset
Hierdoor ontstaat automatisch een centraal projectregister zonder dat projectteams extra administratie hoeven te voeren.
Scenario 2: Projectdashboard in Power BI
Property Bags zijn uitstekend geschikt als bron voor managementinformatie.
Denk aan dashboards met:
- Aantal actieve projecten
- Projecten per klant
- Budgetten per afdeling
- Projecten per projectmanager
- Verlopen projecten
Een periodieke automatisering leest de metadata uit alle sites en laadt deze in Power BI.
Het resultaat is een dashboard dat automatisch wordt bijgewerkt zodra sites worden aangepast.
Scenario 3: Siteclassificatie en governance
Veel organisaties hanteren verschillende typen sites:
- Projectsites
- Teamsites
- Afdelingssites
- Klantsites
Via de Property Bag kun je een classificatie opslaan:
Deze informatie kan vervolgens worden gebruikt voor:
- Governance-rapportages
- Compliance-controles
- Lifecycle management
- Geautomatiseerde archiveringsprocessen
Scenario 4: Dynamische pagina’s en webparts
Ontwikkelaars kunnen Property Bag-waarden uitlezen vanuit SPFx-oplossingen of andere maatwerkcomponenten.
Voorbeeld:
Een projectsite bevat:
Een webpart toont automatisch:
Hierdoor hoeft een beheerder gegevens slechts op één plek te onderhouden.
Scenario 5: Integratie met Power Automate
Power Automate kan sitegegevens uitlezen en gebruiken binnen workflows.
Praktische voorbeelden:
Archivering
Wanneer:
dan kan automatisch:
- de site worden vergrendeld;
- documenten worden gearchiveerd;
- een eigenaar worden geïnformeerd.
Meldingen
Wanneer:
kan automatisch een herinnering worden gestuurd.
Scenario 6: Zoek- en filtermogelijkheden verbeteren
Property Bag-waarden kunnen worden gepromoveerd naar gecrawlde eigenschappen binnen SharePoint Search.
Daardoor wordt het mogelijk om te zoeken op:
- Projectcode
- Klantnaam
- Locatie
- Afdeling
Ook kunnen aangepaste zoekresultaten of projectportalen worden gebouwd die sites filteren op deze metadata.
Voordelen van de Property Bag
- Metadata centraal op siteniveau opgeslagen
- Niet afhankelijk van specifieke lijsten of bibliotheken
- Eenvoudig uit te lezen via PowerShell en API’s
- Geschikt voor automatisering en rapportages
- Ondersteunt governance- en lifecycle-processen
- Kan worden geïntegreerd met zoekfunctionaliteit
Aandachtspunten
Hoewel Property Bags krachtig zijn, zijn er enkele aandachtspunten:
- Eindgebruikers kunnen de gegevens niet standaard beheren via de SharePoint-interface.
- Consistente naamgeving van sleutels is essentieel.
- Voor moderne SharePoint-omgevingen wordt steeds vaker gekeken naar alternatieven zoals Site Properties, Dataverse of centrale registratielijsten.
- Niet alle Property Bag-waarden worden automatisch geïndexeerd voor zoekdoeleinden.
Conclusie
De SharePoint Property Bag is een relatief onbekende maar zeer krachtige functie om metadata op siteniveau vast te leggen. Door projectinformatie, classificaties en beheergegevens centraal op een site op te slaan, ontstaat een solide basis voor rapportages, governance, automatisering en dashboards.
Voor organisaties die veel project- of afdelingssites beheren, kan de Property Bag een eenvoudige maar effectieve manier zijn om grip te krijgen op informatie die anders verspreid en moeilijk beheersbaar blijft. Het resultaat is meer inzicht, minder handmatig beheer en een betere aansluiting tussen SharePoint en de bedrijfsprocessen die erop draaien.