Zum Hauptinhalt springen

Shop Installation

General​

Here you can find the documentation for installing and deploying the Platyno Shop.

Use the Provisioning Script to create the necessary data structures for the Platyno Shop.

  • See the Provisioning section for instructions on how to use the provisioning script.

Logic Apps handle the operations of the Platyno Shop.

  • See the Azure Logic Apps section for an overview of configuring (and setting up authentication) in the Logic Apps for your Platyno Shop.

Provisioning​

With the provisioning script you can automatically create the necessary data structures for your Platyno Shop.

Requirements

Prerequisites for running the provisioning script are:

  1. An installed version of the Platyno Shop module on your tenant (You can find instructions on how to install it here)
  2. A Site Collection (It is recommended to create a new standalone site collection for the store).

  1. Click Download to download the provisioning script.

  2. Unzip the files.

  3. Open PowerShell and navigate to the folder you unzipped earlier (or open PowerShell in the unzipped folder).

    Note

    The script requires PowerShell version 5.1 (or lower). This is pre-installed with Windows 10 (and Windows Server 2016). PowerShell Core (v6 or v7) are not supported.

  4. To run the provisioning script Install-Shop.ps1 you have two options:

    • Run the script as follows in PowerShell .\Install-Shop.ps1 and answer the configuration questions with y (Yes) or n (No).

    • Or run the script directly with the parameters:

      Install-Shop.ps1
      .\Install-Shop.ps1 -TargetWebUrl "{SITE URL}" -CreateShopPage -ShopPageName "Webshop" -SetHomePage -HideQuickLaunch -CreateStructures -ApplyDefaultPermissions -CreateShopDefinitions -CreateDemoData
      Parameters overview
      ParameterDescription
      CreateShopPageCreates a dedicated site page for the Platyno Shop
      ShopPageNameName of the store (can be changed later when editing the page; default: "Webshop")
      SetHomePageSets the store site page as the homepage of the Site Collection.
      HideQuickLaunchHides the left Quick Launch Navigation and therefore shows the store in full width
      CreateStructuresCreates the data structures for the store automatically
      ApplyDefaultPermissionsApplies default settings and permissions in the store environment:
      - Visitors group gets permissions to edit (instead of read)
      - Members group gets permissions to participate (instead of edit)
      - Unique permissions are applied to the ShopBasket, ShopOrders, ShopOrderItems lists.
      CreateShopDefinitionsCreates standard demo entries in the ShopDefinitions list
      CreateDemoDataCreates demo products in the store

Azure Logic Apps​

Create app registration​

  1. Open the Azure Portal.

  2. Click New registration.

  3. Fill in the name and confirm by clicking Create.

Bild

Configure API scope​

  1. In the app registration page, select Expose an API on the left.

  2. For Application ID URI, click Set.

Bild

  1. Under Scopes defined by this API, click Add Area.

Bild

  1. Assign the following information:
  • Scope name: user_impersonation.
  • Who can consent?: Administrators and users
  • Admin consent display name: Platyno Shop Access
  • Admin consent description: Allows the application to access the Platyno Shop.
  • User consetnt display name: Platyno Shop Access
  • User consent description: Allows the application to access the Platyno Shop.

Bild

  1. Under Authorized client applications, click Add a client application.
Info

The Client ID corresponds to the ID of the registered SharePoint App in the SPFx Solution. To find out the Client ID, go to the App Registrations in the Azure Portal, then go to All Apps and search for "sharepoint". The name may be different but is similar to: "SharePoint Online Client Extensibility Web Application Principal".

  1. For Authorized scopes check the box with the area you created earlier.

Bild

Configure Azure Logic App​

  1. Open the Azure Portal.

  2. Open the resource group that contains the workflows.

  3. For the two workflows platyno-shop-flow-cancel-order and platyno-shop-flow-start-order, please perform the following steps.

  4. Click on the menu item Authorization on the left and then on Add policy.

  5. Give the policy a name.

  6. For Issuer enter the following value https://sts.windows.net/{tenantId}/ with the corresponding Tenant ID.

  7. Click Add standard claim.

  8. For Audience, you can copy the application ID URI from step 2 from the Configure API Scope section.

  9. Save the configuration by clicking Save.

    Bild

Configure Platyno Shop​

  1. Open the Platyno Shop page and click Edit.

  2. In the webpart settings go to the Workflow settings section.

  3. Authentication allows you to enable authentication for the configured flows.

  4. If Azure AD is selected as authentication, you can use the AAD Client ID field to copy the Application ID URI from step 2.

    This can be copied from the App Registration overview page from step 2 from the Configure API Scope section.

    URL Signature

    If the workflow was previously configured using a URL signature, please remove the URL parameters from the workflow URL.

    Bild