Installation

Rechne mit etwa 15 Minuten.

VoraussetzungenAnkerlink kopieren

Du brauchst:

• Das Paket shop365.sppkg von der snutig GmbH.
• Ein Konto mit der Rolle SharePoint-Administrator oder globaler Administrator in deinem Microsoft-365-Tenant. Damit lädst du die App hoch und genehmigst ihre API-Berechtigungen.
• Einen App-Katalog für den Tenant. Die meisten Tenants haben bereits einen. Falls nicht, beschreibt Microsoft das Anlegen unter App-Katalog verwenden.
• Eine SharePoint-Website für den Shop. Wer die Ersteinrichtung ausführt, braucht dort mindestens Besitzer-Rechte, denn die Einrichtung legt Listen an.
• Eine gültige Shop365-Lizenz für deinen Tenant.

1. Tenant-Namen herausfinden und das SharePoint Admin Center öffnenAnkerlink kopieren

Jeder Microsoft-365-Tenant hat einen Kurznamen. Das ist der erste Teil deiner SharePoint-Adresse:

Für das Admin Center hängst du an den Tenant-Namen -admin an. Der Demo-Tenant heißt snutigdemo, sein Admin Center liegt also unter https://snutigdemo-admin.sharepoint.com/.

Alternativ erreichst du es im Microsoft 365 Admin Center über Admin Center → SharePoint.

2. App-Katalog öffnenAnkerlink kopieren

1. Klicke in der linken Navigation auf Weitere Funktionen.
2. Klicke unter Apps auf Öffnen.

Der App-Katalog des Tenants öffnet sich auf der Seite Manage apps (Apps verwalten). Seine Adresse folgt dem Muster https://<tenant>.sharepoint.com/sites/appcatalog/….

3. Paket hochladenAnkerlink kopieren

1. Klicke auf Upload und wähle shop365.sppkg aus.
2. SharePoint fragt, wie die App aktiviert werden soll. Wähle eine der beiden Möglichkeiten:
   • Für alle Websites aktivieren: Shop365 erscheint auf jeder Website in der Webpart-Auswahl. Das ist der einfachste Weg.
   • Nur aktivieren: Websitebesitzer fügen die App dann auf jeder Website selbst hinzu (Websiteinhalte → Neu → App → Shop365).
3. Bestätige. Shop365 steht jetzt mit dem Status Enabled in der Liste.

4. API-Berechtigungen genehmigenAnkerlink kopieren

Shop365 verschickt Bestell-E-Mails über Microsoft Graph. Das Paket fordert dafür zwei delegierte Berechtigungen an:

1. Öffne im SharePoint Admin Center Erweitert → API-Zugriff.
2. Wähle unter Ausstehende Anforderungen jede Shop365-Anforderung für Microsoft Graph aus und klicke auf Genehmigen.
3. Danach stehen die Berechtigungen unter Genehmigte Anforderungen.

Brauchst du keine E-Mail-Benachrichtigungen, kannst du diesen Schritt überspringen. Die Bestellungen werden in jedem Fall in SharePoint gespeichert.

5. Webpart auf einer Seite einfügenAnkerlink kopieren

1. Öffne auf der Website für den Shop eine bestehende Seite oder lege eine neue an. Für einen Shop in voller Breite nimmst du einen Abschnitt mit voller Breite oder eine Seite ohne Titelbereich.
2. Klicke auf Bearbeiten und dann auf das + in einem Abschnitt.
3. Suche in der Webpart-Auswahl nach Shop365 (Gruppe Advanced) und füge das Webpart ein.
4. Klicke auf Veröffentlichen.

Shop365 läuft auch in Microsoft Teams, als Registerkarte oder als persönliche App. Füge es dazu aus dem App-Katalog zu Teams hinzu oder binde die SharePoint-Seite als Registerkarte ein.

6. Ersteinrichtung ausführenAnkerlink kopieren

Beim ersten Aufruf der Seite stellt Shop365 fest, dass seine Listen fehlen, und zeigt den Einrichtungsbildschirm Willkommen bei Shop365. Ausführen sollte ihn ein Websitebesitzer.

1. Optional: Setze den Haken bei Beispieldaten anlegen (Lieferanten und Artikel mit Bildern). Dann legt Shop365 Beispiel-Lieferanten, -Kategorien und -Artikel an, praktisch für eine Demo oder Schulung. Die Beispiele kannst du später in der Verwaltung wieder löschen.
2. Klicke auf Setup starten.
3. Warte auf Einrichtung abgeschlossen und klicke auf Zum Shop.

Die Einrichtung legt die sechs Listen aus der Übersicht an und speichert die installierte Version in Shop365Settings.

Bricht die Einrichtung zwischendurch ab, klicke einfach erneut auf den Knopf. Bereits vorhandene Listen und Spalten werden übersprungen. Die Version wird erst gespeichert, wenn alle Schritte geklappt haben.

7. Webpart konfigurierenAnkerlink kopieren

Wähle im Bearbeitungsmodus das Shop365-Webpart aus und klicke auf den Stift (Webpart bearbeiten). Rechts öffnet sich der Eigenschaftenbereich.

Trage mindestens den Shop-Titel ein. Für E-Mail-Benachrichtigungen brauchst du außerdem die Adresse des Einkaufs. Alle Felder erklärt Administration → Webpart-Eigenschaften. Veröffentliche die Seite danach erneut.

Öffne dann den Shop, geh auf Verwaltung → Einstellungen und trage dich als ersten Administrator ein. Solange niemand eingetragen ist, kann jede Person die Verwaltung öffnen (siehe Admin-Rollen).

Auf eine neue Version aktualisierenAnkerlink kopieren

1. Lade im App-Katalog (Manage apps) das neue shop365.sppkg hoch und wähle Ersetzen, wenn SharePoint danach fragt.
2. Öffne die Shop-Seite. Braucht die neue Version Änderungen an den Listen, sieht ein Websitebesitzer Shop365 aktualisieren mit der installierten und der verfügbaren Version.
3. Klicke auf Update durchführen. Vorhandene Daten bleiben erhalten; ergänzt werden nur fehlende Listen, Spalten und Ansichten.

Fehlen auf einer Website Listen, weil zum Beispiel eine gelöscht wurde, zeigt derselbe Bildschirm Installation aktualisieren und nennt die fehlenden Listen.

LizenzAnkerlink kopieren

Beim Laden prüft Shop365 die Lizenz deines Tenants beim Lizenzserver von snutig. Das Ergebnis wird pro Browsersitzung 30 Minuten zwischengespeichert.

• Lizenz gültig: Der Shop lädt ganz normal.
• Lizenz abgelaufen oder ungültig: Alle sehen Lizenz abgelaufen mit dem Ablaufdatum. Melde dich in diesem Fall bei info@snutig.de.
• Lizenzserver nicht erreichbar (Proxy, Störung, keine Antwort nach 8 Sekunden): Der Shop lädt trotzdem. Gesperrt wird er nur bei einer eindeutigen Antwort „ungültig“ oder „abgelaufen“.

Übertragen werden dabei nur die Kennung von Shop365 und die ID deines Tenants, keine Benutzer- oder Bestelldaten.

FehlerbehebungAnkerlink kopieren