Skip to content

RWS/studio-appstore-service

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AppStoreIntegrationServiceManagement & AppStoreIntegrationSeriveAPI

Table of contents

  1. How to publish AppStoreIntegrationServiceManagement on local folder path
  2. How to publish AppStoreIntegrationServiceAPI on local folder path
  3. How to publish AppStoreIntegrationServiceManagement on IIS Server
  4. How to publish AppStoreIntegrationServiceAPI on IIS Server
  5. How to publish AppStoreIntegrationServiceManagement on Azure
  6. How to publish AppStoreIntegrationServiceAPI on Azure

Prerequisite

Configuration of the local folder path

  • Go to release section and download the latest version available

    alt text

  • The .zip file contains the source code, two json files with the formats used by studio and a folder with possible configuration for appsettings.json

  • Download and unzip the files

  • Run Visual Studio as administrator and open the solution

  • From the files three under the AppStoreIntegrationServiceManagement project open appsettings.json

  • Go to the .zip file you just downloaded and copy the content of the file appsettings-local.json into the appsettings.json from project solution and save it

  • Now, the AppStoreIntegrationServiceManagement is set for local folder path deployment

Publishing to local folder path

  • From the Solution Explorer right-click on AppStoreIntegrationServiceManagement and select Publish

  • On the Publish window, click new to create a new Publish profile

    alt text

  • Select Folder from the prompt

    alt text

  • Make sure you choose an easy to find location becase this is where your .exe file will be published

  • Click Finish

Running the PA Admin

  • Go to the folder where you published your application
  • Double-click AppStoreIntegrationServiceManagement.exe
  • A console will open that will tell you "The application has started"
  • In the same console you will find the link where you can view your application (e.g. https://localhost:5005)
  • Copy the link in the browser and the application should start

Login in the PA Admin

  • The application has a build in user with administrator privillege with the following credentials:

    Username: Admin

    Password: administrator

  • Pass the credentials in the login form and click sign-in

Configuration of the local folder path

  • Go to release section and download the latest version available

    alt text

  • The .zip file contains the source code, two json files with the formats used by studio and a folder with possible configuration for appsettings.json

  • Download and unzip the files

  • Run Visual Studio as administrator and open the solution

  • From the files three under the AppStoreIntegrationServiceAPI project open appsettings.json

  • Go to the .zip file you just downloaded and copy the content of the file appsettings-local.json into the appsettings.json from project solution and save it

  • Now, the AppStoreIntegrationServiceAPI is set for local folder path deployment

Publishing to local folder path

  • From the Solution Explorer right-click on AppStoreIntegrationServiceAPI and select Publish

  • On the Publish window, click new to create a new Publish profile

    alt text

  • Select Folder from the prompt

    alt text

  • Make sure you choose an easy to find location becase this is where your .exe file will be published

  • Click Finish

Running the API

  • Go to the folder where you published your application
  • Double-click AppStoreIntegrationServiceAPI.exe
  • A console will open that will tell you "The application has started"
  • In the same console you will find the link where you can view your application (e.g. https://localhost:5005)
  • Copy the link in the browser and the application should start

Prerequisites

Configuration of the IIS Server

  • Open the IIS server you installed

  • In the left-hand side you will find the name of your computer (e.g. WSAMZN-FGLJ96PK)

    alt text

  • Exapand or right-click to create a new webiste

    alt text

  • In the New Website prompt enter your site data

    alt text

  • Click on Test Settings to check if the IIS Manager has access to the application path

    alt text

  • If you got the same warning as in the previous image, close the window and select Connect As to enter the credentials used to login in windows

    alt text

  • For the application pool you can used either the application pool created when you enter your site name, or the built in DefaultAppPool

  • In the left-hand side you will find the application pool directory

    alt text

  • In the application pools list select the one used by your application and from the right hand-side menu click on Advanced settings

  • In the promt, make sure the Identity field is set to Locals system

    alt text

Publishing to IIS

  • Run Visual Studio as administrator!

  • Replace the content of appsettings.json in Visual Studio with the content from appsettings-local.json

  • In Visual Studio, from the solution explorer right-click on AppStoreIntegrationServiceManagement and select Publish

  • On the Publish window click new to create a new Publish profile

    alt text

  • Select Web Server (IIS) from the list

    alt text

  • Select Web Deploy in the following window

    alt-text

  • In the next window enter the details of your webiste you created in IIS Server

    Server: localhost

    Site name: the name of the site you set in IIS Server APP

    Destination URL: http://localhost:80/Plugins (if you enter https instead of http you will have to enter your credentials)

  • Click on Validate connection

  • If the connection succedeed you can click finish

  • Wait for the publish to end and the application should open in browser

Prerequisites

Configuration of the IIS Server

  • Open the IIS server you installed

  • In the left-hand side you will find the name of your computer (e.g. WSAMZN-FGLJ96PK)

    alt text

  • Exapand or right-click to create a new webiste

    alt text

  • In the New Website prompt enter your site data

    alt text

  • Click on Test Settings to check if the IIS Manager has access to the application path

    alt text

  • If you got the same warning as in the previous image, close the window and select Connect As to enter the credentials used to login in windows

    alt text

  • For the application pool you can used either the application pool created when you enter your site name, or the built in DefaultAppPool

  • In the left-hand side you will find the application pool directory

    alt text

  • In the application pools list select the one used by your application and from the right hand-side menu click on Advanced settings

  • In the promt, make sure the Identity field is set to Locals system

    alt text

Publishing to IIS

  • Run Visual Studio as administrator!

  • Replace the content of appsettings.json in Visual Studio with the content from appsettings-local.json

  • In Visual Studio, from the solution explorer right-click on AppStoreIntegrationServiceAPI and select Publish

  • On the Publish window click new to create a new Publish profile

    alt text

  • Select Web Server (IIS) from the list

    alt text

  • Select Web Deploy in the following window

    alt-text

  • In the next window enter the details of your webiste you created in IIS Server

    Server: localhost

    Site name: the name of the site you set in IIS Server APP

    Destination URL: http://localhost:80/Plugins (if you enter https instead of http you will have to enter your credentials)

  • Click on Validate connection

  • If the connection succedeed you can click finish

  • Wait for the publish to end and the application should open in browser

Configure Azure Resources for AppStoreIntegrationServiceManagement

  • Go to Microsoft Azure

  • Click on Resource Groups icon:

    alt-text

  • Click on AppService in the list

  • On the AppService page, make sure the Overview tab is selected from the navigation bar:

    alt-text

  • In the Resources list clik on your resource you want to use to host the application

  • On your application resource click on Configuration in the left side navigation bar

  • The Application settings section should be configured with the following key-value pairs

APPSTOREINTEGRATION_BLOBNAME: _the blobl used for your application_ (e.g. managementpluginblob)
APPSTOREINTEGRATION_PLUGINSFILENAMEV1: _the file used to store the plugins_ (e.g. pluginsV1.json)
APPSTOREINTEGRATION_PLUGINSFILENAMEV2: _the file used to store the plugins_ (e.g. pluginsV2.json)
APPSTOREINTEGRATION_MAPPINGFILENAME: _the file used to store the name mappings_ (e.g. mappings.json) 
APPSTOREINTEGRATION_PRODUCTSFILENAME: _the file used to store the products_ (e.g. productsFile.json)  
APPSTOREINTEGRATION_SETTINGSFILENAME: _the file used to store the site settings_ (e.g. settingsFile.json)   
APPSTOREINTEGRATION_STORAGE_ACCOUNTKEY: _the account key from your Azure_
APPSTOREINTEGRATION_STORAGE_ACCOUNTNAME: _the account name of your Azure_
  • The Connection string section should be configured with the following key-value pair:
AppStoreIntegrationServiceContextConnection: _your data base connection string_
  • Note: The Application settings and Connection string sections from both AppStoreIntegrationServiceAPI and AppStoreIntegrationServiceManagement should always be in sync

  • Don't forget to click Save otherwise your configuration will be lost:

    alt-text

Download publish profile for AppStoreIntegraionServiceManagement

  • Go to Microsoft Azure

  • Click on Resource Groups icon:

    alt-text

  • Click on AppService in the list

  • On the AppService page, make sure the Overview tab is selected from the navigation bar:

    alt-text

  • On the top of the page click on Get publish profile to download the profile locally:

    alt-text

Prepare publish profile in Visual Studio for AppStoreIntegrationServiceManagement

  • Warning: Before proceeding to publishing steps make sure you copy the content from appsettings-azure.json into appsettings.json from the solution explorer

  • Open the solution containg the AppStoreIntegrationServiceManagement in Visual Studio

  • Right-click on AppStoreIntegrationServiceManagement and select Publish

  • On the Publish page press New:

    alt-text

  • In the promted window select Import file:

    alt-text

  • Click Next and browse your computer for the publish profile you downloaded at step 2

  • Click Finish

  • In the Settings tab on Publish page click on Show all settings

  • Under File Publish Option make your you check:

    alt-text

  • Click Publish and wait for the process to finish. If there are no errors during the process the application should open in browser

Configure Azure Resources for AppStoreIntegrationServiceManagement

  • Go to Microsoft Azure

  • Click on Resource Groups icon:

    alt-text

  • Click on AppService in the list

  • On the AppService page, make sure the Overview tab is selected from the navigation bar:

    alt-text

  • In the Resources list clik on your resource you want to use to host the application

  • On your application resource click on Configuration in the left side navigation bar

  • The Application settings section should be configured with the following key-value pairs

APPSTOREINTEGRATION_BLOBNAME: _the blobl used for your application_ (e.g. managementpluginblob)
APPSTOREINTEGRATION_PLUGINSFILENAMEV1: _the file used to store the plugins_ (e.g. pluginsV1.json)
APPSTOREINTEGRATION_PLUGINSFILENAMEV2: _the file used to store the plugins_ (e.g. pluginsV2.json)
APPSTOREINTEGRATION_MAPPINGFILENAME: _the file used to store the name mappings_ (e.g. mappings.json) 
APPSTOREINTEGRATION_PRODUCTSFILENAME: _the file used to store the products_ (e.g. productsFile.json)  
APPSTOREINTEGRATION_SETTINGSFILENAME: _the file used to store the site settings_ (e.g. settingsFile.json)   
APPSTOREINTEGRATION_STORAGE_ACCOUNTKEY: _the account key from your Azure_
APPSTOREINTEGRATION_STORAGE_ACCOUNTNAME: _the account name of your Azure_
  • The Connection string section should be configured with the following key-value pair:
AppStoreIntegrationServiceContextConnection: _your data base connection string_
  • Note: The Application settings and Connection string sections from both AppStoreIntegrationServiceAPI and AppStoreIntegrationServiceManagement should always be in sync

  • Don't forget to click Save otherwise your configuration will be lost:

    alt-text

Download publish profile for AppStoreIntegraionServiceAPI

  • Go to Microsoft Azure

  • Click on Resource Groups icon:

    alt-text

  • Click on AppService in the list

  • On the AppService page, make sure the Overview tab is selected from the navigation bar:

    alt-text

  • On the top of the page click on Get publish profile to download the profile locally:

    alt-text

Prepare publish profile in Visual Studio for AppStoreIntegrationServiceAPI

  • Warning: Before proceeding to publishing steps make sure you copy the content from appsettings-azure.json into appsettings.json from the solution explorer

  • Open the solution containg the AppStoreIntegrationServiceAPI in Visual Studio

  • Right-click on AppStoreIntegrationServiceAPI and select Publish

  • On the Publish page press New:

    alt-text

  • In the promted window select Import file:

    alt-text

  • Click Next and browse your computer for the publish profile you downloaded at step 2

  • Click Finish

  • In the Settings tab on Publish page click on Show all settings

  • Under File Publish Option make your you check:

    alt-text

  • Click Publish and wait for the process to finish. If there are no errors during the process the application should open in browser