SPFx-Projekte/PortalSettings
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 3 Activity

Aktualisiere Versionsnummer auf 3.2.0 in README.md, package.json, package-lock.json und package-solution.json. Füge Provisionierungsfeature für moderne PortalSettings.aspx hinzu und integriere zugehörige Tests.

Browse Source
This commit is contained in:
Torsten Brendgen
2026-08-18 21:06:28 +02:00
parent c0e7c316e3
commit eb1ad7ba1e
10 changed files with 85 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+10 -13
View File
@@ -6,14 +6,14 @@ PortalSettings V3 ist ein providerbasiertes SPFx-WebPart für SharePoint Server
| Eigenschaft | Wert |
|---|---|
| Version | 3.1.0 |
| Version | 3.2.0 |
| SharePoint Framework | 1.4.1 |
| Build-Node | 8.17.0 |
| npm | 6.x |
| Gulp | lokal 3.9.1 |
| Komponente | Client-Side WebPart |
Die frühere provisionierte `PortalSettings.aspx` und der leere Application Customizer wurden entfernt. Die Oberfläche wird vollständig vom WebPart erzeugt und verwendet kein `innerHTML`.
Die Oberfläche wird vollständig vom WebPart erzeugt und verwendet kein `innerHTML`. Ein schlankes SharePoint-Feature provisioniert beim Installieren der App im Root-Web automatisch die moderne `SitePages/PortalSettings.aspx` und platziert dort genau eine Instanz des WebParts.
## Unterstützte Solutions
@@ -164,22 +164,20 @@ sharepoint/solution/portal-settings.sppkg
## Installation
1. `portal-settings.sppkg` im App Catalog durch Version `3.1.0.0` ersetzen.
1. `portal-settings.sppkg` im App Catalog durch Version `3.2.0.0` ersetzen.
2. Die App im Root Web der gewünschten Site Collection installieren oder aktualisieren.
3. Eine moderne Seite erstellen.
4. Das WebPart **Portal Settings** einmal auf der Seite hinzufügen.
5. Die Seite veröffentlichen und nur für die gewünschte Administratorgruppe verlinken.
3. Die App provisioniert automatisch die veröffentlichte Seite `SitePages/PortalSettings.aspx` mit dem WebPart.
4. Eine bereits vorhandene `PortalSettings.aspx` wird nicht überschrieben.
Optional kann eine Seite per PnP PowerShell erzeugt werden:
```powershell
.\deployment\Add-PortalSettingsPage.ps1 `
-SiteUrl 'http://clshp001/sites/target' `
-PageName 'PortalSettingsV3' `
-Publish
```
Die Standardseite heißt absichtlich `PortalSettingsV3.aspx`, damit die alte V2-Seite während der Abnahme erhalten bleiben kann.
Das Skript bleibt als Reparaturweg erhalten und verwendet standardmäßig ebenfalls `PortalSettings.aspx`.
## Migration von V2
@@ -191,11 +189,10 @@ V3 liest die vorhandenen Konfigurationsorte direkt weiter:
Es ist keine Datenmigration in eine neue Liste erforderlich. Empfohlenes Vorgehen:
1. V3-Paket installieren.
2. `PortalSettingsV3.aspx` parallel zur alten Seite bereitstellen.
3. Alle drei Provider laden und Konfigurationen testweise speichern.
4. Root Web und Subwebs prüfen.
5. Erst danach die alte `PortalSettings.aspx` löschen oder archivieren.
1. Paket aktualisieren und die App im Root-Web aktualisieren.
2. Fehlt `PortalSettings.aspx`, wird sie durch das Feature angelegt. Eine vorhandene Seite bleibt unverändert.
3. Falls eine vorhandene Seite das WebPart noch nicht enthält, das PnP-Skript als Reparaturweg ausführen.
4. Alle Provider laden, Konfigurationen testweise speichern und Root Web sowie Subwebs prüfen.
## Diagnose