Site App Catalog: SharePoint Apps lokal testen - Die vollständige Anleitung

Was ist ein Site App Catalog?

Ein Site App Catalog ist ein spezieller App-Katalog, der nur für eine einzelne SharePoint Site Collection verfügbar ist. Im Gegensatz zum Tenant App Catalog, der Apps für den gesamten Tenant bereitstellt, ermöglicht der Site App Catalog das lokale Testen und Installieren von SharePoint Framework (SPFx) Lösungen und Add-ins in einer isolierten Umgebung.

Vorteile des Site App Catalogs

• ✅ Lokales Testen: Apps können in einer Site Collection getestet werden, ohne den Tenant zu beeinflussen
• ✅ Isolierte Umgebung: Perfekt für Entwicklung und Testing ohne Produktions-Risiko
• ✅ Schnelle Iteration: Apps können schnell aktualisiert werden ohne Tenant-weite Auswirkungen
• ✅ Delegierte Verwaltung: Site Collection Admins können Apps nach der Einrichtung selbst verwalten
• ✅ Mehrere Versionen: Verschiedene Versionen derselben App in unterschiedlichen Site Collections testen

Wichtiger Hinweis: Tenant Admin Rechte erforderlich!

⚠️ Wichtig: Das Erstellen eines Site App Catalogs erfordert Tenant Administrator Rechte. Es gibt keine UI-Option in SharePoint Online - Sie müssen PowerShell, PnP PowerShell oder die CLI für Microsoft 365 verwenden.

Nach der Einrichtung können Site Collection Administratoren Apps eigenständig im Site App Catalog verwalten.

Voraussetzungen

Bevor Sie beginnen, benötigen Sie:

1. Tenant Administrator Rechte in Microsoft 365
2. Site Collection Administrator Rechte auf der Ziel-Site Collection
3. Einen bereits existierenden Tenant App Catalog (muss einmalig im SharePoint Admin Center erstellt werden)
4. Eines der folgenden Tools:
   • SharePoint Online Management Shell (Windows)
   • PnP PowerShell (Windows, macOS, Linux)
   • CLI für Microsoft 365 (Cross-platform)

Methode 1: SharePoint Online Management Shell (Windows)

Installation

Öffnen Sie PowerShell als Administrator und installieren Sie das Modul:

Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Force

→ Offizielle Microsoft Dokumentation zur Installation

Site App Catalog erstellen

# Verbindung zum SharePoint Admin Center herstellen
Connect-SPOService -Url https://ihrtenant-admin.sharepoint.com

# Site App Catalog aktivieren
Add-SPOSiteCollectionAppCatalog -Site https://ihrtenant.sharepoint.com/sites/ihrsite

Wichtig: Ersetzen Sie ihrtenant mit Ihrem tatsächlichen Tenant-Namen und ihrsite mit Ihrer Site Collection URL.

Site App Catalog entfernen

Wenn Sie den Site App Catalog wieder deaktivieren möchten:

Remove-SPOSiteCollectionAppCatalog -Site https://ihrtenant.sharepoint.com/sites/ihrsite

Hinweis: Dies deaktiviert nur den App Catalog - die “Apps for SharePoint” Bibliothek und deren Inhalte bleiben erhalten.

Methode 2: PnP PowerShell (Empfohlen - Cross-Platform)

PnP PowerShell ist die moderne, plattformübergreifende Alternative und funktioniert auf Windows, macOS und Linux.

Installation

# Installation (erfordert PowerShell 7.2 oder höher)
Install-Module -Name PnP.PowerShell -Force

→ PnP PowerShell Installation Guide

Site App Catalog erstellen

# Verbindung zum SharePoint Admin Center herstellen
Connect-PnPOnline -Url https://ihrtenant-admin.sharepoint.com -Interactive

# Site App Catalog aktivieren
Add-PnPSiteCollectionAppCatalog -Site https://ihrtenant.sharepoint.com/sites/ihrsite

Site App Catalog entfernen

Remove-PnPSiteCollectionAppCatalog -Site https://ihrtenant.sharepoint.com/sites/ihrsite

Alle Site App Catalogs auflisten

Hilfreich, um einen Überblick zu bekommen:

Get-PnPTenantSite -Filter "SiteCollectionAppCatalogEnabled eq 1"

Methode 3: CLI für Microsoft 365 (Cross-Platform)

Die CLI für Microsoft 365 ist eine Node.js-basierte Command Line Interface, die auf jeder Plattform läuft.

Installation

npm install -g @pnp/cli-microsoft365

→ CLI für Microsoft 365 Dokumentation

Site App Catalog erstellen

# Anmelden
m365 login

# Site App Catalog aktivieren
m365 spo site appcatalog add --siteUrl https://ihrtenant.sharepoint.com/sites/ihrsite

Site App Catalog entfernen

m365 spo site appcatalog remove --siteUrl https://ihrtenant.sharepoint.com/sites/ihrsite

Nach der Einrichtung: Apps hochladen und bereitstellen

Sobald der Site App Catalog aktiviert ist:

1. Apps-Bibliothek öffnen

1. Navigieren Sie zu Ihrer Site Collection
2. Gehen Sie zu Websiteinhalte (Site Contents)
3. Sie sehen nun eine neue Bibliothek: “Apps for SharePoint”

2. App-Package hochladen

1. Öffnen Sie die “Apps for SharePoint” Bibliothek
2. Klicken Sie auf Hochladen oder ziehen Sie die Datei per Drag & Drop
3. Wählen Sie Ihre .sppkg Datei (z.B. smarter-advent-calendar.sppkg)

3. App bereitstellen

Nach dem Hochladen erscheint ein Dialog:

1. Vertrauen Sie dieser App? → Prüfen Sie die angeforderten Berechtigungen
2. Wählen Sie:
   • ✅ “Diese App für alle Sites in dieser Site Collection verfügbar machen” (empfohlen)
   • oder lassen Sie es deaktiviert für eine einzelne Site
3. Klicken Sie auf Bereitstellen

4. App zu einer Site hinzufügen

1. Gehen Sie zur gewünschten Site in der Site Collection
2. Klicken Sie auf Einstellungen (Zahnrad) → Eine App hinzufügen
3. Wählen Sie “Von Ihrer Organisation” im Filter
4. Suchen Sie Ihre App und klicken Sie darauf, um sie zu installieren

App aktualisieren

Um eine neue Version zu testen:

1. Laden Sie die neue .sppkg Datei in die “Apps for SharePoint” Bibliothek hoch
2. SharePoint erkennt automatisch, dass eine Datei mit gleichem Namen existiert
3. Bestätigen Sie: “Vorhandene Datei ersetzen”
4. Die App wird automatisch in allen Sites aktualisiert, die sie verwenden

Tipp: Verwenden Sie Versionsnummern im Dateinamen für bessere Nachvollziehbarkeit:

• ✅ smarter-advent-calendar-v1.0.0.sppkg
• ✅ smarter-advent-calendar-v1.1.0.sppkg

Troubleshooting

Problem: “Must have Manage Web Site permissions or be a tenant admin”

Ursache: Sie haben keine Tenant Administrator Rechte.

Lösung:

1. Wenden Sie sich an einen Microsoft 365 Global Admin oder SharePoint Admin
2. Nur diese können Site App Catalogs erstellen
3. Nach der Einrichtung können Site Collection Admins Apps verwalten

Problem: App wird nach Installation nicht angezeigt

Lösung:

1. Prüfen Sie, ob die App korrekt bereitgestellt wurde (Status in “Apps for SharePoint”)
2. Löschen Sie den Browser-Cache (Strg + Shift + R)
3. Versuchen Sie einen InPrivate/Inkognito-Browser
4. Öffnen Sie die Browser Developer Tools (F12) und prüfen Sie auf Fehler in der Console

Problem: Berechtigungsfehler beim Bereitstellen

Ursache: Die App benötigt API-Berechtigungen, die noch nicht gewährt wurden.

Lösung:

1. Öffnen Sie SharePoint Admin Center
2. Gehen Sie zu Advanced → API access
3. Genehmigen Sie ausstehende Berechtigungsanfragen
4. Nur Tenant Admins können API-Berechtigungen gewähren

Problem: App funktioniert nicht in anderen Sites der Site Collection

Lösung:

• Stellen Sie sicher, dass Sie bei der Bereitstellung die Option “Diese App für alle Sites in dieser Site Collection verfügbar machen” aktiviert haben
• Anderenfalls müssen Sie die App erneut hochladen und mit dieser Option bereitstellen

Best Practices

1. Testing-Umgebung strukturieren

Erstellen Sie separate Site Collections für verschiedene Phasen:

📁 Development Site Collection
   → Site App Catalog für Dev-Builds
   
📁 Staging Site Collection  
   → Site App Catalog für Test-Builds
   
📁 Production Tenant
   → Tenant App Catalog für finale Releases

2. Dokumentation führen

Halten Sie fest:

• Welche Site Collections haben einen Site App Catalog?
• Welche Apps sind wo installiert?
• Welche Versionen sind in welcher Umgebung?
• Bekannte Issues pro Version

3. Versionierung

Verwenden Sie konsequent semantische Versionierung:

• v1.0.0 - Erste stabile Version
• v1.1.0 - Neue Features
• v1.1.1 - Bugfixes

4. Automatisierung mit Scripts

Erstellen Sie PowerShell-Scripts für häufige Aufgaben:

# Beispiel: App in mehrere Site Collections deployen
$sites = @(
    "https://tenant.sharepoint.com/sites/dev",
    "https://tenant.sharepoint.com/sites/staging"
)

foreach ($site in $sites) {
    Write-Host "Aktiviere Site App Catalog für $site"
    Add-PnPSiteCollectionAppCatalog -Site $site
}

Site App Catalog vs. Tenant App Catalog

Feature	Site App Catalog	Tenant App Catalog
Verfügbarkeit	Nur in der Site Collection	Tenant-weit, alle Sites
Erstellen	Tenant Admin via PowerShell	SharePoint Admin via UI oder PowerShell
Verwalten	Site Collection Admin	Tenant Admin
Verwendung	Testing, Entwicklung, isolierte Lösungen	Produktion, unternehmensweite Apps
Isolation	Hoch - keine Auswirkungen auf andere Sites	Niedrig - sichtbar für alle
Setup-Zeit	2-5 Minuten (PowerShell)	10-15 Minuten (UI Setup)
Anzahl	Mehrere pro Tenant möglich	Nur einer pro Tenant

Apps von Smarter Business Solutions testen

Alle unsere SharePoint Apps können Sie problemlos im Site App Catalog testen:

• 🎄 Smarter Advent Calendar: Virtueller Adventkalender fürs Intranet
• 🎰 Smarter Tombola: Verlosungen und Gewinnspiele in SharePoint
• 🎅 Smarter Secret Santa: Digitales Wichteln für Teams
• 📅 Smarter Event Booking: Event-Management für Microsoft 365
• 🧭 Smarter Navigation: Erweiterte Navigation für moderne SharePoint Sites

Package-Download anfordern

Besuchen Sie unsere Produktseiten und fordern Sie einen Download-Link an:

1. Wählen Sie “Test-Installation” als Installationsoption
2. Geben Sie Ihre E-Mail-Adresse ein
3. Erhalten Sie sofort:
   • ✅ Download-Link zur .sppkg Datei
   • ✅ Diese ausführliche Anleitung
   • ✅ Produkt-spezifische Setup-Hinweise

Weitere Ressourcen

Microsoft Dokumentation

• Site Collection App Catalog (Microsoft Learn)
• SharePoint Framework (SPFx) Overview
• SharePoint Online Management Shell

PowerShell Tools

• PnP PowerShell Documentation
• PnP PowerShell Installation Guide
• CLI für Microsoft 365

Community & Support

• SharePoint Dev Community (GitHub)
• PnP Community
• SBS Support

Fazit

Der Site App Catalog ist ein unverzichtbares Tool für SharePoint-Admins und Entwickler, die SharePoint Framework Lösungen sicher testen möchten. Obwohl die Einrichtung Tenant Admin Rechte erfordert und nur via PowerShell möglich ist, ist der Prozess in wenigen Minuten erledigt.

Wichtigste Erkenntnisse:

• ⚠️ Tenant Admin Rechte sind zwingend erforderlich
• 💻 PowerShell, PnP PowerShell oder CLI - keine UI-Option
• ✅ Nach Setup können Site Admins Apps selbst verwalten
• 🔒 Perfekt für isoliertes Testing ohne Produktions-Risiko
• 🚀 Schnelle Iteration und mehrere Versionen parallel möglich

Haben Sie Fragen zur Einrichtung oder Installation unserer Apps? Kontaktieren Sie uns!

---

Tipp: Speichern Sie diese Anleitung als Lesezeichen - als SharePoint Admin werden Sie sie regelmäßig brauchen! 🔖