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

·      Item: select an associated XSL style sheet

·      Form: select an associated XSL style sheet

 

Catalog Pages:

·         Generation Profile: allows you to select the format the different levels of the channels will be displayed in the client:

·          111 – Regroup all in a single page: show the three channel levels grouped in only one page.

·          112 – Regroup first 2 levels: the first two levels are displayed in the first page and the third level is displayed on a second page.

·          122 - Regroup last 2 levels: the first level is displayed in the first page, and the second and third levels are displayed on the second page.

·          123 – Dispatch all levels in separate pages: the three levels are displayed in different pages.

Select the 123 option.

NOTE: The Generation Profile can be different for each client. 

 

Extension:

Is use to define the output file type (Html or Xml)

 

Open the Skin folder and select the Generation Profile for each client.

 

 

 

Once you have modified all the fields needed, click Save.

 

Launch Input Editor

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).

It also enables you to add any Item (Hidden, HomePage / ChannelItem, Forms, Sales Terms) that can reside on the servers as opposed to being included in the Data file.

The most common use it to generate static Forms and Home Page Items (Channel Items).

 

 

Click the Launch Input Editor button.

The following screen will be displayed:

 

 

NOTE: you can also open the Input Editor by click the  button on the toolbar menu.

 

Right click on EMPLOYEE.

 

 

·         Channel image: The image displayed by default at the top of the Channel Home Page. It must be a .gif file and must be located in the ClgData folder.

 

·         Tip of Day: Item mostly used for flash advertising/ info. This item is by default located on the Channel Home Page below the Channel Image. 

 

·         Alias: “Categories Alias” is a feature that allows declaring an Alias for any category or sub-category. This Alias becomes the REF of the corresponding CGY node and gives the name of the file that is generated to contain the category’s description. Thus it becomes possible to create a stable HREF to this page. “Category Alias” is not applicable to the PalmOS platform.

 

·         Blob Def: Management of attached files also called BLOBs (for Binary Large Objects). The attached files are moved to the zip archive and can be called by their NAM.

 

·         Hidden Item:  Item accessible only through <A HREF=””> links. Use this item for complex browsing structures.

 

·         Form Submit: To create a mobile form. This form will be sent back to the Email or HTTP address.

 

·         Channel Item: Item appearing on the Channel Home Page mostly used for “How to…” functionalities or table of content.

 

The items can have the following attributes:

 

·         NAM: Item Title

·         DES: Item Content (supports Bold, Tables, Hyperlinks)

·         FNC: Item Footnote (supports Bold, Hyperlinks)

·         OPT: Item Short Content (recommended for Wap use)

·         REF: Item unique reference

·         BLO (palm): Item PalmOS Image (Deprecated)

·         BLO (ppc): Item PocketPC/ Symbian Image (Deprecated)

·         BLOB: Binary large objects second version (Deprecated)

·         IMG: Image to display

·         A HREF: Hyperlinks

·         PRC: Item Price

·         QTY: Item Quantity

·         OPR: Item Additional Attribute (Numbers only)

·         PKG: Item Additional Attribute (viewable in the list/catalogue columns)

·         SEL: Item Pre-selector. If this field is not empty, Item will be visible in the List.

·         SKIN (ppc): Item Attributed Skin for PocketPC/ Symbian.

 

Tables

 

Tables can be included into terms Content (DES) through a wizard.

To create a Table, select an Item (Channel Item, Tip of Day, etc) and click anywhere in the DES: Content field to enable the buttons.

Click  to launch the Table Editor. The following screen is displayed:

 

 

Click Yes. The following screen is displayed:

 

 

* Click this button to insert a column

 

 Click this button to add a column

 

* Click this button to delete a column

 

* Click this button to add a blob definition

 

* Click this button to add a hyperlink

 

* Click this button to move to the previous table (if any, if not this button is not available)

 

* Click this button to move to the next table (if any, if not this button is not available)

 

 Click this button to change size and title of each column

 

 Click this button to insert a line

 

 Click this button to delete a line

 

 Click this button to add a line

 

Adding a Channel Image

 

In this example, we added a channel image, contacts.gif. Later, we will add more things to our example.

 

 

Click Save and then click Quit.

 

Creating a 6 Col txt file

 

We must create a txt file with some sample data in the ClgData folder.

 

 

The complete path is: c:\XmlAreaPub_FR\Aff\EMPLOYEE\Clgdata

 

In the ClgData folder create a new text document.

 

 

 

The text document must be in columns separated with tabs.

In this example, we entered the following information:

 

 

Save the file, and return to the WireLess Mobile Channel Designer.

 

Adding a Channel Item

 

We will add two channel items to the example EMPLOYEE.

From the WireLess Mobile Channel Designer, Open the Input Editor.

Right click on EMPLOYEE -> Add Channel Item.

 

 

NAM: is the name that will be displayed in the client.

You can also add a description and an image.

NOTE: the image must be in .gif format and must be located in the ClgData folder of the corresponding channel.

 

 

In this example, we added a second Channel item:

 

 

Click Save, and then Quit.

Open the Process CSP and generate the channel.

 

From the terminal, the channel is displayed as follows:

 

 

                   

 

Process CSP

 

Click the Process CSP button. The following screen will be displayed:

 

 

NOTE: you can also open this screen by clicking the  button on the toolbar.

 

Input:

·         Input file: select the file to process.

·         Input type: to check the CSP type (see Launch Input Editor)

 

Option:

·         Generate HTML files directly: Allow checking Pocket-like device output file in html format

·         Activate trace: allows generating trace file

·         UserId: Is used to simulate dynamic in checking (output files will be generate in the member directory specify in this place)

 

Release:

Select this checkbox if you want to generate a new release.

 

In the Input file field, select the  button and select the txt file created.

 

 

 

Click Open.

Click Generate to generate the channel. The following message will be displayed:

 

 

Click OK.

 

Submitting a Channel

 

Now it is necessary to submit the channel from the WireLess Mobile Affiliates Management DB.

Click Start -> Programs -> WireLess Mobile Server Components -> WireLess Affiliates Management DB

 

 

The following screen is displayed:

 

 

Click the Create button.

 

Enter the channel name, as shown in the screen above. Click Create.

 

 

Click the Submit button.

 

 

As shown in the picture above, the channel EMPLOYEE was submitted.

 

Adding the channel to a user

 

To download a channel to the client, the channel must be published to the user.

Open the Internet Explorer and type the following address: http://localhost/wm_fr/fr/asp/default.asp

 

 

If you need to create a user, click s’cririre.

 

 

Complete the information requested and then click Inscription Gratuite.

 

Enter you user and password to login:

 

 

Click OK. The following screen is displayed:

 

 

Click Employee:

 

 

Select EMPLOYEE:

 

 

Click Valider

 

 

As shown in the screen above, the user Cecilia is subscribed to the channel EMPLOYEE.

 

 

Synchronizing with the client

 

Click Start -> WM Mobile.

 

 

The following screen will be displayed:

 

 

Click Menu

 

 

Click Administrator Mode

 

 

Enter the password (1411). Click OK.

 

 

Verify the sync parameters are the correct ones. Click Menu -> Options -> Sync Parameters…

 

 

The following configuration screen is displayed:

 

 

Make the changes needed. Then click Apply, and then click Cancel to return to the previous screen.

 

 

Click the  button to synchronize.

 

 

Wait for the synchronization to be completed.

 

 

Click the Close button.

 

 

This is the main screen of the WireLess Mobile, which shows the channels to which the user is subscribed.

Click EMPLOYEE.

 

 

Click Employees

 

 

In this screen, the information displayed is from the first level. In other words, it is the information entered in the first column of the txt file.

 

Click HR Area

 

 

This is the second level, the information entered in the second columns of the txt file.

 

Click Manager. The following screen is displayed:

 

 

This is the third level, the information entered in the third columns of the txt file.

 

Click Brown.

 

 

This is the description, the data that was entered in the fourth column.

The screens displayed above are in the Generation Profile 123 – Dispatch all levels in separate pages format.

 

Selecting the Generation Profile 111 the levels are displayed as follow:

 

           

 

Selecting the Generation Profile 112:

 

            

 

Selecting the Generation Profile 122:

 

               

 

Advanced Options

Adding a Form

 

To add a form it is necessary to do the following steps:

 

  1. Create a database
  2. Create a system DSN
  3. Verify the global asa file
  4. Fix the asp file information of the database created.
  5. Create a form from the Input Editor

 

1. Create a database

 

In this example, the database is created using Microsoft Access 2000.

Create a table called Employee with the following fields: Name, Area and Category.

 

 

Enter a password to the database and exit.

 

2. Create a system DSN

 

Click Start -> Settings -> Control Panel -> Administrative tools -> Data Sources (ODBC)

 

 

Click Add...

 

 

Click Finish.

 

 

Click Select…

 

 

Select the database employee.mdb from the path c:\XmlAreaPub_FR\Database.

Click OK.

 

Click Advanced…

Enter a user and password

 

 

Click OK.

 

 

The system DSN employee is created. Click OK.

 

3. Verify the Global ASA file

 

Add the DSN employee to the global.asa file.

The path is: c:\inetpub\wwwroot_fr

 

 

Open the global.asa file and add the DSN created:

 

session("employee")="DSN=employee"

 

 

Save and exit.

 

4. Create an asp file

 

It is necessary to create an .asp file to transport the information entered in the client.

 

The following is an example of an asp file.

 

 

<%@ LANGUAGE = VBScript%>

<!--#include file="../fr/Includes/Aladdino_script.inc"-->

<%

Response.Expires = -1

Response.Buffer = True

response.ContentType="text/xml"

' variables de formulaire

dim l_connection

dim F_login

dim F_ID

dim F_Tournee

dim F_Type

dim Url_form

 

llogin   = request("ALAD_MBR_UID") ' c'est le login

nom      = request("name")

area     = request("area")

cat      = request("cat")

 

'  debut de traitement

''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''

call initdb()

 

call extract (l_connection)

           

'call aff()

'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''

sub initdb()      

            if InitDBConnection(l_connection, l_command) and OpenDbConnection(l_connection, l_command, session("employee")) then

                        call InitRecordset(l_recordset)

            end if

end sub

 

Sub  extract (p_connection)

dim l_sqlformater

dim l_query

dim l_select

dim fs

dim fname

            ' Requete qui compte le nombre d'OT correspondant à la tournée

            call InitSQLFormater(l_sqlformater, p_connection)

            'Requete qui extrait les informations de chaque OT correspondant à la tournée

   

            l_query = "insert into employee (name, area, cat, login)"

            l_query = l_query & " values ('" & nom & "','" & area & "','" & cat & "','" & "pepe" & "')"

           

            'Response.Write l_query

           

            'Exécution de la requete

            Set l_recordset = p_connection.Execute(l_query)

           

            'Création du fichier Xml

            'Response.write("<?xml version=""1.0"" encoding=""ISO-8859-1""?>")

           

            set l_sqlformater = nothing

end sub

 

Sub aff()

%>

<!-- html>

<head>

<title>CD _FORM_</title>

</head>

            <body bgcolor="#ffffff" alink="silver">

coucou

</body>

</html -->

<%end sub%>

 

 

5. Create a form from the Input Editor

 

Right click on Employee, and click Add Form Submit.

 

 

The following screen is displayed:

 

 

§         Check box: Select name and label (the label appears after the checkbox).

§         Drop down: Displays the information in a drop down list. The information in the list must be entered in the column Value(s)

§         Text Area: An input box

§         Static Text: Displays the text entered in the label column.

§         Radio Button: NOT WORKING!

§         Hidden Input: A hidden input box

 

 

In this example, we entered the following information:

 

 

Click Save, then Quit.

 

 

Click Save, and then click Quit.

 

Open the Skin folder and check the checkbox With DBL for each client selected.

 

 

Click Save.

 

Open the Process CSP to generate the channel.

 

 

Now synchronize the client.

 

     

 

Click Close.

 

The Main screen of Employees displays as follow:

 

 

Click Add Employee:

 

 

Enter some information:

 

 

Click OK.

 

 

Click Continue…Returns to the main screen.

Synchronize.

 

 

The information entered in the client is sent to the database.