In dit artikel lees je hoe je eformity voor SharePoint 2019 kunt installeren en configureren. Daarnaast vertellen we ook hoe je inhoudstypen vanuit SharePoint naar je eformity‑omgeving kunt exporteren.

Installeren, updaten & de-installeren

We zullen eerst uitleggen hoe je eformity voor SharePoint 2019 kunt installeren, updaten en de-installeren. Je moet eerst de package downloaden.

Package Installeren

Je kunt de eformity Template Manager voor SharePoint 2019 package downloaden op de 'Downloads' pagina.

Het installeren van de eformity package wordt uitgevoerd via PowerShell. De eenvoudigste manier om dit te doen is door de SharePoint 2019 Management Shell te gebruiken.

Om de installatie uit te voeren moeten een aantal commando's worden uitgevoerd om de package te deployen. Je kunt de onderstaande commando's kopiëren en in PowerShell plakken en uitvoeren. Let wel op of het pad overeenkomt met de locatie van je gedownloade package.

Add‑SPSolution "D:\eformity.SharePoint.2019.wsp"

Install‑SPSolution -Identity "eformity.SharePoint.2019.wsp" -AllWebApplications -GACDeployment

Een package deployen kan een tijdje duren. Met het volgende commando kun je de status van de deployment opvragen en kijken of de deployment al klaar is of nog niet.

Stsadm -o Enumdeployments

Package updaten

Als je eformity wilt updaten naar de nieuwste versie, kan je dit doen met dit commando:

Update‑SPSolution -Identity "eformity.SharePoint.2019.wsp" -LiteralPath "D:\eformity.SharePoint.2019.wsp" -GACDeployment

Package de-installeren

Als je eformity wilt de-installeren, kan dat door de volgende twee commando's uit te voeren:

Uninstall‑SPSolution -Identity "eformity.SharePoint.2019.wsp" -AllWebApplications

Remove‑SPSolution "eformity.SharePoint.2019.wsp"

Instellingen configureren

Zodra je eformity succesvol hebt geïnstalleerd, kun je de instellingen configureren. Zo bepaal je onder andere de URL van je eformity-omgeving en ontdek je hoe je de feature activeert.

Basis instellingen

Om bij de instellingen te komen, ga je via General Application Settings naar Configure the Template Manager settings. Vul in het volgende scherm de gewenste instellingen in en klik op OK.

Er zijn een aantal velden die je kunt configureren. Deze verschillende velden worden in de onderstaande tabel apart toegelicht:

Veld	Omschrijving
Host	Dit is de URL naar je eformity‑omgeving. Dit veld is verplicht.
API key	Een API key is nodig om toegang te krijgen tot je eformity-omgeving. Je kunt een API key in je eformity‑omgeving configureren. Dit veld is verplicht.
Default site name	De sitenaam wordt gebruikt bij het exporteren van inhoudstypen vanuit SharePoint naar je eformity‑omgeving. Het exporteren van inhoudstypen wordt beschreven onder het kopje Inhoudstypen exporteren.
Default value mapper name	Met deze instelling kun je configureren welke value mapper wordt gebruikt voor het ophalen en instellen van documenteigenschappen in SharePoint.

Feature activeren

Nadat de SharePoint-package is geïnstalleerd, kan deze bij Site Collection worden geactiveerd. Het activeren van een feature kan alleen gedaan worden door een beheerder van de Site Collection.

Om een feature te activeren, ga je naar de instellingen van je site en klik je op de link Site Collection features onder het kopje Site Collection Administration.

Er wordt nu een lijst getoond met beschikbare features voor de huidige site. Zoek in deze lijst naar de feature eformity | Template Manager en klik op de Activate knop achter dit item.

De feature is nu geactiveerd en zichtbaar in je document libraries.

HTTPS met een Self-Signed certificaat

Deze stap is alleen nodig als je verbinding maakt met eformity via een HTTPS-verbinding met een Self-Signed certificaat.

Als dat het geval is, moet het root‑certificaat van de server worden ingesteld als vertrouwd certificaat in SharePoint. SharePoint negeert vertrouwde certificaten die via Manage Computer Certificates zijn ingesteld.

Een vertrouwd certificaat kan worden ingesteld via de Central Administration van SharePoint. Ga hiervoor via Security naar Manage trust.

Klik in de pagina Trust Relationships op New. Nu kom je in het venster Establish Trust Relationship. Voer een naam in bij Name en upload de public key van het root‑certificaat bij Root Authority Certificate. Klik op OK om het certificaat toe te voegen.

Inhoudstypen exporteren

Je kunt inhoudstypen vanuit je SharePoint‑omgeving exporteren naar je eformity‑omgeving. Deze inhoudstypen kunnen worden gebruikt om bij het uploaden van een document, een presentatie, enzovoort, vanuit eformity naar SharePoint automatisch een inhoudstype in te stellen.

Om inhoudstypen te exporteren, navigeer je naar de volgende URL. Pas de URL wel aan naar je eigen SharePoint-omgeving: jouwdomeinnaam.sharepoint.com/_layouts/15/eformity/ExportContentTypes.aspx.

Op de volgende pagina klik je op Export content types om inhoudstypen te exporteren naar je eformity-omgeving.

Op het volgende scherm kun je aangeven welke inhoudstypen je wilt exporteren en welke niet. De inhoudstypen zijn per groep ingedeeld. Je kunt hier per inhoudstype aangeven of je deze wilt exporteren naar je eformity‑omgeving.

Als het vinkje aan staat, wordt dit inhoudstype geëxporteerd. Staat het vinkje uit, dan niet. Met het vinkje naast de naam van de groep, bijvoorbeeld "Document Content Types", kun je alle inhoudstypen in deze groep in één keer aan- of uitvinken.

Als je alle inhoudstypen geselecteerd hebt die je wilt exporteren, klik je op Export selected items.

Je ziet nu een log die aangeeft of het exporteren is gelukt of niet.

Alle geselecteerde inhoudstypen zijn nu geëxporteerd naar je eformity‑omgeving.