Zum Hauptinhalt springen

Shop Installation

Allgemein​

Hier finden Sie die Dokumentation zur Installation und Bereitstellung des Platyno Shops.

Mithilfe des Provisioning Skripts erstellen Sie die nötigen Datenstrukturen für den Platyno Shop.

  • Im Abschnitt Provisioning finden Sie eine Anleitung zum Anwenden des Provisioning Skripts.

Mithilfe von Logic Apps werden die Abläufe des Platyno Shops gehandhabt.

  • Im Abschnitt Azure Logic Apps finden Sie eine Übersicht zur Konfiguration (und Einrichtung der Authentifizierung) von Azure Logic Apps für Ihren Platyno Shop.

Provisioning​

Mit dem Provisioning Skript erstellen Sie automatisch die nötigen Datenstrukturen für Ihren Platyno Shop.

Voraussetzungen

Voraussetzungen für das Ausführen des Provisioning Skripts sind:

  1. Eine installierte Version des Platyno Shop Moduls auf Ihrem Tenant (Eine Anleitung zur Installtion finden Sie hier hier)
  2. Eine Site Collection (Es empfiehlt sich eine neue, eigenständige Site Collection für den Shop zu erstellen)

  1. Klicken Sie auf Download und laden Sie die Dateien herunter.

  2. Entpacken Sie die Dateien.

  3. Öffnen Sie die PowerShell und navigieren Sie in den vorhin entpackten Ordner (oder öffnen Sie die PowerShell im entpackten Ordner).

    Hinweis

    Das Skript erfordert PowerShell Version 5.1 (oder niedriger). Diese ist vorinstalliert mit Windows 10 (und Windows Server 2016). PowerShell Core (v6 oder v7) sind nicht unterstützt.

  4. Um das Provisioning Skript Install-Shop.ps1 auszuführen stehen Ihnen zwei Möglichkeiten zur Verfügung:

    • Führen Sie das Skript wie folgt in der PowerShell .\Install-Shop.ps1 aus und beantworten Sie die Fragen zur Konfiguration mit y (Ja) bzw. n (Nein).

    • Oder führen Sie das Skript direkt mit den Parametern aus:

      Install-Shop.ps1
      .\Install-Shop.ps1 -TargetWebUrl "{SITE URL}" -CreateShopPage -ShopPageName "Webshop" -SetHomePage -HideQuickLaunch -CreateStructures -ApplyDefaultPermissions -CreateShopDefinitions -CreateDemoData
      Übersicht zu den Parametern
      ParameterBeschreibung
      CreateShopPageErstellt eine eigene Websiteseite für den Platyno Shop
      ShopPageNameName des Shops (kann nachträglich beim Bearbeiten der Seite geändert werden; Standard: "Webshop")
      SetHomePageSetzt die Shop Websiteseite als HomePage der Site Collection
      HideQuickLaunchBlendet die linke Quick Launch Navigation aus und zeigt somit den Shop in voller Breite an
      CreateStructuresErstellt die Datenstrukturen für den Shop automatisch
      ApplyDefaultPermissionsWendet Standardeinstellungen und -berechtigungen in der Shop Umgebung an:
      - Visitors Gruppe bekommt Berechtigungen zum Bearbeiten (anstatt Lesen)
      - Members Gruppe bekommt Berechtigungen zum Mitwirken (anstatt Bearbeiten)
      - Unique Permissions werden angewendet für die Listen ShopBasket, ShopOrders, ShopOrderItems
      CreateShopDefinitionsErstellt Standard Demo-Einträge in der Liste ShopDefinitions
      CreateDemoDataLegt Demo Produkte im Shop an

Azure Logic Apps​

App Registrierung erstellen​

  1. Öffnen Sie das Azure Portal.

  2. Klicken Sie auf Neue Registrierung.

  3. Füllen Sie den Namen aus und bestätigen Sie mit Klick auf Registrieren.

Bild

API Scope konfigurieren​

  1. In der App Registrierungsseite wählen Sie links den Menüpunkt Eine API verfügbar machen aus.

  2. Klicken Sie bei Anwendungs-ID-URI auf Festlegen.

Bild

  1. Klicken Sie unter Von dieser API definierte Bereiche auf Bereich hinzufügen.

Bild

  1. Vergeben Sie die folgenden Informationen:
  • Bereichname: user_impersonation
  • Wer darf einwilligen?: Administratoren und Benutzer
  • Anzeigename der Administratoreinwilligung: Platyno Shop Zugriff
  • Beschreibung der Administratoreinwilligung: Ermöglicht der Applikation Zugriff auf den Platyno Shop
  • Anzeigename der Benutzereinwilligung: Platyno Shop Zugriff
  • Beschreibung der Benutzereinwilligung: Ermöglicht der Applikation Zugriff auf den Platyno Shop
  1. Klicken Sie unter Autorisierte Clientanwendungen auf Eine Clientanwendung hinzufügen.

Bild

  1. Vergeben Sie der Clientanwendung eine Client-ID.
Hinweis

Die Client-ID entspricht der ID der registrierten SharePoint App in der SPFx Solution. Um diese herauszufinden, gehen Sie im Azure Portal zu den App-Registrierungen, dann wechseln Sie zu Alle Anwendungen und suchen Sie nach "sharepoint". Der Name kann unterschiedlich sein, doch lautet ähnlich wie: "SharePoint Online Client Extensibility Web Application Principal"

  1. Haken Sie für Autorisierte Bereiche die Box mit dem vorhin erstellten Bereich an.

Bild

Azure Logic App konfigurieren​

  1. Öffnen Sie das Azure Portal.

  2. Öffnen Sie die Ressourcengruppe, welche die Workflows beinhaltet.

  3. Für die beiden Workflows platyno-shop-flow-cancel-order und platyno-shop-flow-start-order führen Sie bitte die folgenden Schritte aus.

  4. Klicken Sie links auf den Menüpunkt Autorisierung und danach auf Richtlinie hinzufügen.

  5. Vergeben Sie der Richtlinie einen Namen.

  6. Tragen Sie für Issuer folgenden Wert https://sts.windows.net/{tenantId}/ mit der entsprechenden Tenant ID ein.

  7. Klicken Sie auf Standardanspruch hinzufügen.

  8. Für Audience können Sie die Anwendungs-ID-URI aus Schritt 2 vom Abschnitt API Scope konfigurieren kopieren.

  9. Speichern Sie die Konfiguration durch Klicken auf Speichern.

    Bild

Platyno Shop konfigurieren​

  1. Öffnen Sie Platyno Shop Seite und klicken Sie auf Bearbeiten.

  2. In den Webpart Einstellungen wechseln Sie zum Abschnitt Workflow Einstellungen.

  3. Mit Authentifizierung können Sie die Authentifizierung für die konfigurierten Flows aktivieren.

  4. Ist als Authentifizierung Azure AD ausgewählt, können Sie mit dem Feld AAD Client ID die Anwendungs-ID-URI aus Schritt 2 kopieren.

    Diese kann aus der Übersichtsseite der App Registrierung aus Schritt 2 vom Abschnitt API Scope konfigurieren kopiert werden.

    URL Signatur

    Sollte der Workflow zuvor über eine URL Signatur konfiguriert gewesen sein, entfernen Sie bitte die URL Parameter aus der Workflow URL

    Bild