Modifying the Web.Config File for Mobile

Once the Mobile Web Service is installed, you need to modify the web.config file to accomplish the following:

·            Configure for SSO (optional)
If desired, you can configure your mobile application to maintain SSO Login authentications when users log in just as you may already require for e-Business.

·            Configure the SSO Web Service Security Mode (optional)
If you configure SSO with your mobile application and your SSO Web Service is installed with a HTTPS certificate, you need to modify the binding and security mode.

·            Link the Mobile App to the DNN Shopping Cart
This ensures any product purchases go through the same DNN Mobile Shopping Cart you have previously set up on your Personify e-Business website.

·            Configure the Customer Image Location
This determines where the customer image appears on the screen when a user is viewing a customer’s profile page.

·            Configure the Product Image Location
This determines where on the screen a product’s image appears when a user is viewing the Product Listing or a specific product’s detail page.

·            Configure the Received Message Size Max Amount
This setting controls the size of the request from the mobile phone. If your organization decides to store images for items such as profiles and products, you need to set it to a higher value.

·            Add the Personify Version
This setting allows for backward compatibility with various version of Personify.

Note.pngMake sure you have already saved all the customer and product images (in the same resolution size) to folders on the Personify database.

To modify the web.config file:

1.    Navigate back to the Personify Mobile Web Service Installation folder you copied to your local drive.

2.    Rename the RenametoWeb.Config file to web.config.

3.    Open web.config in a text editor such as Notepad.

4.    If necessary, update the “DefaultORG” and “DefaultORGUNIT” settings.

Note.pngYour organization received the Personify application with a STARTUP Org and a STARTUP Org Unit. These settings are needed to connect to Personify the first time. If this Org and Org Unit do not exist in your database for any reason, you must update the web.config file to an Org or Org Unit in your Personify database.

5.    Update any of the values listed below, as necessary:

Key

Value

Comments

DefaultORG

(enter the Default ORG name, if it isn’t entered already)

You should have updated this in step 4.

DefaultORGUNIT

(enter the Default ORGUNIT name, if it isn’t entered already)

You should have updated this in step 4.

UserAuthentication

PERSONIFY or SSO

If you enter SSO, ensure the SSO parameters below are correct.

maxReceivedMessageSize

2MB (minimum recommended value)

This setting controls the size of the request from the mobile phone. If your organization decides to store images for items such as profiles and products, you need to set it to a higher value.

IF USER Authentication is SSO, following fields are required.

SSOInterfaceType

SSO

These values MAP to the Parameter Names defined in "Configuration and Verify Interfaces" screen - SSO Configuration.

SSOInterfaceExtension

SSO

No changes need to be made for this.

SSOVendorUserParameterName

SSO USERNAME

This needs to be the same username entered for SSO USERNAME on APP014.

SSOVendorPasswordParameterName

SSO PASSWORD

This needs to be the same username entered for SSO PASSWORD on APP014.

SSOWebServiceURLParameterName

SSO WEB SERVICE URL

This could be the same username entered for SSO WEB SERVICE URL on APP014.

Security Mode

Transport

This only needs to be modified to “Transport” if your SSO Web Service if installed with a HTTPS Certificate.

For DNN Web Site Integration following keys are required.

DNNShoppingCartWebServiceURL

Mobile Enabled URL of the Mobile Shopping Cart website.

Make sure you enter the Mobile Shopping Cart page’s website, and not the regular Shopping Cart.

DNNShoppingCartWebServiceUserId

USERNAME

Same as Personify User ID defined in the DNN Site - PersonifySiteSettings Module

DNNShoppingCartWebServicePassword

PASSWORD

Same as Personify User Password defined in the DNN Site - PersonifySiteSettings Module

For Imaging Service, the following fields are required.

CustomerImageURL

(enter the virtual directory pointing to customer images)

Note that the PersonifyImagingService is responsible for storing customer images in this location.

ProductImageURL

(enter the virtual directory pointing to product images)

Note that the PersonifyImagingService is responsible for storing product images in this location.

For backward compatibility with various versions of Personify

PersonifyVersion

(enter your Personify version, for example: 730)

Do not include any spaces or service pack information

6.    Save and close the file.