WireLess Mobile 1.0 Channel Designer User’s Manual

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

WireLess Mobile 1.0 Channel Designer User’s Manual

 

 

 

 

 

 

 

 

Table of Contents

 

 

Table of Contents. 1

Introduction. 3

Getting Started. 4

Definitions. 4

Basic Unit 4

Access to the Item on the Mobile device. 4

Directories Tree Structure. 4

Creating a Channel. 6

General Settings. 10

Web Site Selection Page. 11

Skins. 13

Launch Input Editor. 14

Tables. 17

Adding a Channel Image. 19

Creating a 6 Col txt file. 19

Adding a Channel Item.. 20

Process CSP. 23

Submitting a Channel. 25

Adding the channel to a user. 28

Synchronizing with the client. 31

Advanced Options. 40

Adding a Form.. 40

1. Create a database. 40

2. Create a system DSN.. 41

3. Verify the Global ASA file. 44

4. Create an asp file. 45

5. Create a form from the Input Editor 47


Introduction

 

The objective of this document is to guide you through the launch of Mobile Services and their administration.

 

This manual is divided in the following sections:

·        Getting started: This section explains some characteristics of the WireLess Mobile

·        Creating a channel: This section explains how to create a channel with the WireLess Mobile Channel Designer. This chapter explains the channel’s items and their attributes, how to use the Input Editor and the Process CSP. It also explains an example of a channel creation.

·        Submitting a channel: This section explains how to submit a channel using the WireLess Mobile Affiliates Management DB.

·        Adding a channel to a user: This section explains how to link the channel to the user.

·        Synchronizing with the client: This section explains how to download the channel to the client. It also shows screen shots of the channel downloaded in the client.

·        Advanced Options: This section explains advanced options, such as a form creation.


Getting Started

 

Definitions

Basic Unit

The Basic WireLess Mobile Unit is called Item. An Item might represent a News Article, a Contact Name, a Product, a Form, etc.

·      Each Item has Attributes (Reference, Title, Footnote, Content, Price, Associated Logo).

·      Each Item might have an associated Category and Sub-category.

·      Each Item has a Type (Hidden Item, Channel Item, FormSubmitItem)

 

Access to the Item on the Mobile device

The Access to the Item on the Mobile device can be:

·      Through a Mobile HyperLink to the Item Reference.

·      By browsing through the list of available Category / Subcategory (called Catalogue Access hereafter) dynamically created by the WireLess Mobile Server.

·      By browsing through a list of pre-selected Items (called List Access hereafter).

 

Directories Tree Structure

 

§         C:\WireLess Mobile: created at install time. It is MANDATORY to place this directory in the windows PATH environment variable.

§         C:\WireLess Mobile\Mts: contains the Wm COM components to install in MTS.

§         C:\Inetpub\wwwroot _fr: WEB publication directory (_fr suffix depends on chosen language).

§         .\Admin: admin pages (user removal, stats)

§         .\fr: “X” site pages.

§         .\fr\Includes: this important directory contains globaldefs.inc (site parameterization) and all helper functions.

§         .\PalmSynchro: PDA sync directory. Contains the sync server trace files + Sync simulation pages (testsync.htm)

§         .\test: in-depth debugging tools (testMime.asp)

§         .\Wap: wap publication resources

§         C:\Program Files: for complementary software (if any)

§         C:\Temp: proposed directory for backups/ transfers

§         C:\XmlAreaPub_FR: Public Area for Wm Data (mainly XML). The _FR suffix corresponds to the chosen language.

§         .\Aff: “Affiliate” area, contains the Channels.

§         .\Common: contains data that is common to all Channels.

§         .\.\clgdata: images and XSL skins

§         .\.\Services: models of dynamic services

§         .\.\Wap: Wap resources & trace files

§         .\Database: for the Access database (if any)

§         .\Mbr: “Member” area, contains the Users' contexts (preferences & temporary data).

§         Online: directory for Web Deployment (must be mounted)

§         Tools: various tools (.vbs script files mainly)

§         C:\XmlAreaSas_FR: SAS for CSP


Creating a Channel

 

To create a channel, open the WireLess Mobile Channel Designer.

Click Start -> Programs ->WireLess Mobile Server Components -> WireLess Mobile Channel Designer.

 

 

The following screen will be displayed only the first time you enter the program:

 

 

It is necessary to initialize the Base Directory.

 

Click the  button.

 

 

Go to C:\XmlAreaPub_US and select the Admin.CSP.xml file and click Open.

The following is the WireLess Mobile Channel Designer main screen.

 

 

Select in the Drop Down Menu number 0.

To create a new channel, it is first necessary to create a new Theme. A theme can contain more than one channel.

Click Edit -> Create new Theme.

 

 

We will create a Theme named Employee.

 

 

You can also enter a description. Click OK.

To create a new Channel in the theme, right click on Employee and click Create new
Channel
:

 

 

Enter the Channel Name, in this example Employee, and select the Model Channel.

Channel Names are limited to 16 Characters. DO NOT use special characters (accent, space, dot, underscore, apostrophe).

Choose either an existing Channel or a Template Channel. Your new Channel will take the Model Channel’s default settings.

 

Then click Create.

 

 

Click OK.

The following screen will be displayed.

 

 

Double click on EMPLOYEE to change the settings.

 

In this first screen you can select the clients. For each client, a folder will be created when generating the content of the channel. In this example we will only select Pocket PC 2002 and Windows.

 

Palm Devices

 

Pocket-like Devices

 

Other Devices

 

General Settings

 

Click General Settings:

 

 

PDA Display:

·         Channel Title: The channel name entered when the channel was created. It appears on the PDA home page.

·         Catalog Title: is the catalog button name, enter the button text that will appear on the PDA home page as access to the Catalog. In this example we entered Employees.

·         List Title: enter the button text that will appear on the PDA home page as access to the List.

Input Configuration: is the format of the input data. In this first example, select CSP TXT Data 6 Col + CorpAliasSource. For this type of format, it will be necessary to create a txt file. The CorpAliasSource file is created automatically when the channel is generated, and it contains the structure of the page and the general items. You can generate in this file all the sections of the channels that are not part of the catalog or applicative transition files.

CSP TXT Data 6 Col + CorpAliasSource: it is necessary to create a txt document with 6 columns separated by tabs.

CSP TXT Data 14 Col + CorpAliasSource: it is necessary to create a txt document with 14 columns separated by tabs.

CSP XmlE Data + CorpAliasSource: In order to use your native XML format, you will need to create an XSL Stylesheet transforming your XML into XMLe.

This Stylesheet can be store as ..\xmlareapub\aff\NAM\clgdata\NAM.xls in order to do on-the fly transformations.

CSP Full XmlE + CorpAliasSource:

CSP Xml/Xsl + CorpAliasSource:

 

 

Options:

·      Subscription-based: check if you want the Channel to have a Validity End date. Note: registering Users to this channel will require the use of the WIP web Pages (see part VII).

·      Dynamic: check if you want to enable the Personalization feature of the Channel (one user, one personalized Channel. Note: registering Users to this channel will require the use of the WIP web Pages (see part VII).

·         Compression: check if you want the Mobile Content to be compressed on PocketPC and PalmOS. This feature is not enabled for Dynamic Channels for performance reasons.

 

Web Site Selection Page

 

Click Web Site Selection Page

 

 

This tab enables you to manage the Default Channel Selection Web Page

 

General Web Settings:

·         Channel Description: enter a short description that will appear on the Default Channel Selection Web Page (see part VI).

·         Logo (.gif): a .gif file that will appear in the client.

 

Additional Themes:

·      Premium: check if you want this Channel to appear in the Premium category of the Default Channel Selection Web Page

·      New: check if you want this Channel to appear in the New category of the Default Channel Selection Web Page

NOTE: Channels will appear both in their Theme and in the Premium and/or New category.

 

 

To add a logo to the channel, first you must copy the .gif file in the ClgData sub folder of the EMPLOYEE directory.

 

 

The ClgData folder is where all the specific files for this channel must be.

Click the  icon and select a .gif file from the ClgData folder.

 

 

Click Open.

 

Skins

 

Now click Skins. The following window will be displayed:

 

 

General Pages:

·      Channel Home Page: select an associated XSL style sheet

·      List: select an associated XSL style sheet</