SAP_xMII_part_I

8/9/2019 SAP_xMII_part_I

1/216

SAP xMII Training Labs

Table of Contents

2006 SAP Americas. All Rights Reserved. Page 1

Lab 1 Creating a Web Page ..................................................................3

Lab 2 Images and Image Maps ............................................................. 11

Lab 3 Tables .................................................................................. 17

Lab 4 Frames ................................................................................. 21

Lab 5 Forms ................................................................................... 25

Lab 6 Style Sheets ........................................................................... 35

Lab 7 SAP xMII Installation Guide......................................................... 39

Lab 8 Getting Connected ................................................................... 69

Lab 9a Building Queries Using the Template Editor .................................. 75

Lab 9b Building Displays Using the Template Editor.................................. 91

Lab 9c Using the Dynamic Page Generator ............................................ 119

Lab 10a Web Page Design .................................................................123

Lab 10b Web Page Design (on your own) .............................................. 127

Lab 11a Scripting with xMII ...............................................................129

Lab 11b More Scripting with xMII ........................................................ 137

Lab 11c Still More Scripting with xMII ..................................................143

Lab 12a Personalization - Setting Up Roles ...........................................147

Lab 12b Personalization - Setting Up Users ...........................................149

Lab 12c Personalization Assign Users to Roles...................................... 151

Lab 13 Editing the Style Sheets .......................................................... 153

Lab 14 Security.............................................................................. 155

Lab 15 Personalization Navigation Editor ............................................ 157

Lab 16 Data Manipulation / Inline Transform .........................................163

Lab 17 xMII Reports ........................................................................171

Lab 18 iCommand...........................................................................181

2006 SAP Americas.

All Rights Reserved.

These materials may not be reproduced without the express

written permission of SAP.


2/216

SAP xMII Training


Rev 08/06

2006 SAP Americas.

All Rights Reserved.

These materials may not be reproduced without the expresswritten permission of SAP Americas.


3/216

SAP xMII Training


Lab 1 Creating a Web Page

Purpose

This lab provides the student an introduction to some basic web page designconcepts. Students will use Microsoft FrontPage 2003 to create web page contentand edit the properties of each.

Topics Covered

This lab will cover

Page (Document) Sections

HTML Tag Syntax

Changing Properties (font types/colors, background colors, etc.)

Procedure1. Start Microsoft FrontPage the instructor will be able to guide you to its

location on the training computer.

2. Well begin by creating a template page that well use for creating additionalpages. Templates allow you to maintain the consistency of web pages on a website. If a new page isnt already opened, from the icon barmenu, select thenew page icon.


4/216

SAP xMII Training


FrontPage should look like this:

3. Click on File and choose Open Site.

4. In the Site Name text box enter\\\Training (check with thetrainer for the ).

5. Create a folder to save all the webpages that you create.


5/216

SAP xMII Training


6. You should note 4 tabs at the bottom of your new page labeled Design,Split, Code and Preview. Select the Codetab and review the code thatwas entered by FrontPage.

Notice the HTML tags prefixed with the tag. The page editor insertedthese entries into the page source. Since they are contained in the headersection of the page between the and tags, this information is

not actually displayed on the page. tags contain information regardingthe web editing software, language, and web site theme that are applied to theweb page.

The text in between the and tags makes up a string that isdisplayed at the top of the clients web browser. We will customize the title onevery new page that we create in this Lab. Enter an interesting title for yourtemplatepage.


6/216

SAP xMII Training


7. Since we will be using this page as a template for the other pages we willcreate, we will define the properties (e.g. fonts, colors, etc.) that we want. Inthetag:

- Add a background color to the page by including the bgcolorparameter.- Setup the font properties for the text within the body of the page by addingthe tag with the parameters (face, color, size) you want. Dont forgetthe closing tag.


7/216

SAP xMII Training


8. Switch back to the Designtab and view the effects of the changes to your webpage.

9. Now right-click on the page (in Normal view). In the pop-up window, selectPage PropertiesThis will allow you to set some more document defaultswithin the Template page. Review the tabs and the properties in each. Youwill note the Page Properties is an easy place to change the title, backgroundcolor, fonts, etc.


8/216

SAP xMII Training


10.Lets save this as our template page. From the Filemenu, select Save Asandenter a File name: BasePage.htm. Save all work in the Training folder thatyou created.

**Note: To view our BasePage.htm, open the browser (Internet Explorer) and type:http:///training//BasePage.htm


9/216

SAP xMII Training


11.Now lets create our other web pages from the BasePage.htmtemplate. Wellstart with a page that will be the header for our web site. Modify theBasePage.htmby changing the text (example: My SAP xMII Page), backgroundcolor, fonts, etc. Use your imagination. When you are done making yourchanges to the header page, Save As Header.htm.

HINT: When saving the page, use the Change titlebutton to modify the Page title.

12.Repeat the above step to create additional pages for the Table of Contents(TOC.htm) and two new base pages (Page1.htmand Page2.htm).


10/216

SAP xMII Training



11/216

SAP xMII Training


Lab 2 Images and Image Maps

Purpose

This lab will introduce the student to the basics of adding web graphics to a webpage. We will investigate images (graphics) and image maps (hotspots or hyperlinkregions) that can be used as part of a web site navigation system.

Topics Covered

This lab will cover

Adding web images or graphics

Image pathing and sizing

Creating / Editing Image Maps

Procedure

1. Well begin by inserting a graphic divider to separate the web pages headerinformation from the rest of the page. Open the Header.htmpage and placethe cursor at the bottom of the page. From the Insertmenu, select thePicture\Clip Artoption. Select Goto view the clip art currently installed onyour server.


12/216

SAP xMII Training


2. Search through the available border clipart images and find one that you like.Click on the image and select Insertto add it into your web page document.

3. Switch to the CODEtab and note the syntax of the tag we just added.You should see something similar to the following

The srcparameter contains the image file path. Because we have not yetsaved our page, the image file is currently stored in a temporary file location.When we save the page, you will be prompted to specify another file storage

location. We will save the file and note the new image later in this lab.You should also note the heightand widthparameters. By default, theseparameters are set in pixels, resulting in a fixed image size, however they canalso be set as a percentage of the page, resulting in an image size relative tothe size of the page.

4. Modify the widthparameter of your image to 90%. To see the effect of thenew setting, switch to the Previewtab and resize the width of your web page.As you resize you should see the width of the image scale with the page. Thisfunctionality is useful when developing sites for multiple resolutions.


13/216

SAP xMII Training


5. Now Savethe Header.htm page. You will be prompted to save the embeddedimage to a location on the server. The location where you save the file will

determine the final path setting for the image (ie: src parameter). The imagepath is saved relative to the source HTML page.

Example 1:If you save the image in the same folder as the HTML page, the image tagshould look like this

Since the image file is in the same folder as the HTML page, no additional path

information is required in the src parameter.


14/216

SAP xMII Training


Example 2:

If you chose to store the image file in an alternate location, the image tagshould look something like this

Since the image file in this example was not stored in the same location as the

HTML page, additional path information was included in the src parameter.The path defines the location of the image file relativeto the HTML page. Inthis example, the image file namedj157996.gifis stored upone folder level(represented by ..) from the Header.htm page, in the /imagesfolder.

6. Next were going to add another image that we will use to navigate our website. Open the TOC.htm page. From the Insertmenu, select Picture\FromFile., navigate to the Training folderand select the LinkMenu.giffile. ClickOK.

7. Well add a few hotspots or hyperlink regions to the LinkMenu image fornavigation. To do this, select the LinkMenu image. From the Viewmenu, selectToolbars\Picturesto display the Picture Toolbar

HotspotTools


15/216

SAP xMII Training


8. Select the Rectangular Hotspot tool and draw a rectangle around the Link 1text on the LinkMenu image. After drawing the rectangle, a dialog box willpopup allowing you to enter a Hyperlink URL. Select the Page1.htmfile fromyour training folder that you created earlier and click OK.

9. Switch to the Codetab and review the and the tags. You shouldsee something that looks like this

The maptag can contain several areatags. The areatags contain the actualhotspot link information. The areatag includes parameters for the linked page(href), the shapeof the hotspot, and the coordinates (cords)for thehotspot touch region. The coordinates are defined in X1, Y1, X2, Y2 sequenceand use the top left corner of the image as the origin.

The tag was also updated to include a new usemapparameter thatreferences the tag that was just created.


16/216

SAP xMII Training


10. Switch back to Normal view and add another rectangular hotspot regionaround Link 2. Create a hyperlink to Page2.htm. In the HTMLview, youshould note a new area tag has been added after the existing area tag, butbefore the tag. The final HTML code should look something like this

Save your TOC.htm page.

11.Open Page1.htmand enter any information that you want to be shown.Experiment with the formatting tools located on the toolbars.

12.Open Page2.htmand enter information regarding the author of the web site,credits to the instructor, etc


17/216

SAP xMII Training


Lab 3 Tables

Purpose

Tables can be used to organize the layout of web pages. In this lab the student will

learn how to add tables and become familiar with defining spacing, borders,background images, and hyper-linking cells.

Topics Covered

This lab will cover the following topics

Table creation

Cell text justification

Table/Cell backgrounds

Hyper-Linking cells

Procedure

1. Open the Header.htmpage and switch to the Normal view.

2. First, well create a table that well use for organizing the text in our title.Place the cursor in front of the title information on the page. From the Tablemenu, select Insert\Table


18/216

SAP xMII Training


3. Create a 1 row by 2 column table and click OKto insert the table and close thedialog. The page should look similar to the following

Switching to the Code tab, you will see the tag can contain many

(table row) and (table data) tags. The number of pairsdetermine the number of rows in the table and the number of pairs determine the number of columns in the row.

The information between the and the tags defines the cell

contents. By default, FrontPage inserts as a placeholder for the celldata.

4. Switch back to the Designview to modify the cell contents. Highlight and cut

the title text on your page, then paste it in the first cell of the table. Addsome additional text in the second cell.


19/216

SAP xMII Training


5. You can change the settings of the entire table or of each individual cell byright-clicking and selecting either Table Propertiesor Cell Propertiesfromthe popup menu. This will display the dialog box

HINT: Setting the Border Size to 0 will eliminate the appearance of theborder so only the text will be displayed in the browser.

6. Open Page1.htmand add a 1-row x 2-column table at the top of the page. Inthe left cell, type the text To TOC. In the right cell type the text To Page2.


20/216

SAP xMII Training


7. Next, well create hyperlinks to both the TOC.htm and Page2.htmpage. Tocreate the hyperlink, highlight the appropriate text in the cell. From the Insertmenu, select Hyperlinkto display the hyperlink dialog box, and then selectthe appropriate page you wish to hyperlink to. Click OKto complete.

8. Open up Page2.htm and repeat the table creation and hyperlink procedure(make sure you change the text in the right cell to To Page 1).

**Hint: To change hyperlink color: from File menu choose properties, then choosethe Background tab.


21/216

SAP xMII Training


Lab 4 Frames

Purpose

The student will explore the use of Framesin a web page. Frames can be used toorganize the layout of your web site. A Frames page divides the browser windowinto different sections (e.g. frames), each of which can display its own page. Wewill create the Home page for the web site.

Topics Covered


Creating a Frames page

Frame syntax

Creating Hyperlinks to target frames

Procedure

1. First well create the Frames page. From the File menu, select New > Page.to open the Newpage dialog box. Select the More page templatesoption, thenFrames Pagestab (note the variety of templates you can choose from). Clickon the Banner and Contents page and then click OKto create the new Framespage.


22/216

SAP xMII Training


Your new page should look like this

2. Next well need to Set Initial Pagefor each frame section. In the BannerFrame (top section), click the Set Initial Pagebutton and set the page to theHeader.htm webpage from your training folder.

NOTE: The full path to the page will be shown in the URL. This will be adjusted when thepage is saved much like the image file path.


23/216

SAP xMII Training


3. Repeat this step to set the Contents Frame (left frame) initial page to TOC.htmand the Target Frame (right frame) initial page to Page1.htm.

After setting the initial pages, the page should look something like this

4. Before we save our file, lets review the HTML code generated for the framespages. Switch to the Frames Page Code tab. It should look like this

This page uses frames, but your browser doesn'tsupport them.

Note the frame nameand targetparameter values. These will be importantwhen creating hyperlinks.


24/216

SAP xMII Training


5. Now we can save the page as Main.htmin the your training folder.

6. Switch back to the Frames Page HTMLview and note the modified paths to the

initial HTML pages (defined in the srcparameter).

This page uses frames, but your browser doesn't

support them.


25/216

SAP xMII Training


Lab 5 FormsPurpose

The purpose of this lab is to introduce the basics of gathering information from aFormand submitting the data to a server.

Topics Covered


Html Forms

Html Form Elements

Basic JAVA Applets

Referencing objects on the web page

Gather information from a user and submitting it to the web server.

Procedure

1. Create a new page using the File/New Page select a normal page and save itas OrderEntry.htm.

2. Using the Front Page tools, we will build an Order Entry screen that willultimately look like this:


26/216

SAP xMII Training


Insert aformon the new web page.

Right click on the form, choose Form Properties and set the following properties.

To align the elements on the form we will create a table9 rows x 2 columns:(insert this table within the form, after the buttons).


27/216

SAP xMII Training


Begin building the Order Entryscreen by entering the static text descriptionsoutlined above in the appropriate cells of the table that was just created.

Order entry Lab Example

Order Date

Description

Quantity

Ship From

Horsham (Next to Radio button)

Exton (Next to Radio button)


28/216

SAP xMII Training


Using the FrontPage Insert Menuwe will add the following Html elements to theform.

One Submit and one Reset Push Button should have been created when theformwas inserted.

Submit Button (Push Button)

Select (click) and drag the Submitbutton to the appropriate cell.

Double click the Submitbutton and configure the Push Button Propertiesasfollows...

Reset Button (Push Button)

The ResetPush Button is not used for this example. Single click it and press thedelete key.


29/216

SAP xMII Training


Select Element (Drop-Down Menu)

Insert one Select ElementInsert/Form/Drop-Down Menu

Double click the Select Elementand configure these Drop-Down MenuProperties.

Text Element (One-Line Text Box)

Insert a One-Line Text BoxInsert/Form/ One-Line Text Box

Double click the Text Elementand configure these Text Box Properties...


30/216

SAP xMII Training


Radio Element (Radio Button)

Insert (2) two RadioElements Insert/Form/ Radio Button

Double click each RadioElement and configure these Radio Button Properties...

Text Area Element (Scrolling Text Box)

Insert (1) one Text AreaElement Insert/Form/Scrolling Text Box

Double click the Text AreaElement and configure these Scrolling Text BoxProperties...


31/216

SAP xMII Training


iCalendar

The calendar control we will build into the page is a Java applet provided with

CMS.To add the iCalendar applet, go to the Normalview and select the cell in the tablewhere you want to put the calendar. Switch to the HTML view and add thefollowing applet tag into the source code.

(Note: Java is case sensitive)

Save the OrderEntry.htmfile in your training folder, and test.


32/216

SAP xMII Training


Sample: HTML Generated

New Page 1

Order Entry Lab Example

Order Date

Description

Product A

Product B

Product C

Product D


33/216

SAP xMII Training


Price

Ship From

Horsham

Exton

Enter Comments Here


34/216

SAP xMII Training



35/216

SAP xMII Training


Lab 6 Style Sheets

Purpose

The student is introduced to the basics of applying Style Sheets to a web page. Wewill modify the OrderEntry.htmpage font size and color by applying a basic stylesheet.

Topics Covered


Creating a new style sheet

Reviewing style sheet HTML tags (

and )

Linking a style sheet to a HTML page

Applying style sheet classes in an HTML page

Procedure

1. First, well create a new style sheet. From the Filemenu, select New In thepopup toolbar choose More page templates, go to the Style Sheettab, selectthe Normal Style Sheettemplate, and select OK.


36/216

SAP xMII Training


Next, well add a tag to define the font information. Add the following

tag and {classes} to the new style sheet. Type code right on the page.

p {font face="BankGothic Md BT"}p.blue {font face="BankGothic Md BT"; font-size:10pt; color="#0000FF"; font

style="bold"}p.red {font face="Verdana"; font-size:15pt; color="#800000"; font style="bold"}p.ucase {font face="BankGothic Md BT";text-transform:uppercase}

Save the page as style.cssin the /Training/folder on your web server, and then close the file.

2.Now we can link a page to the newly created style sheet andapply the styles to our text. Open the OrderEntry.htmwecreated in the previous lab. From the Formatmenu, selectStyle Sheet Links...


37/216

SAP xMII Training


In the Link Style Sheetwindow, click the Add button and select style.css fromyour training folder. Click OK.

3. To apply the style sheet classes, highlight the Order Entry Lab Example textin the OrderEntry.htm page. From the drop-down menu on the FrontPagetoolbar, set the class to Normal.red. You should notice that the text color didnot change. That is because we are still in Normalview. Go to the Previewtab to view the color change.

Continue to apply the classes to the other text on the page as follows


38/216

SAP xMII Training


Text Class

Order Date Normal.Blue

Description Normal.Blue

Quantity Normal.Blue

Ship From Normal.Blue

Horsham Normal.ucase

Exton Normal.ucase

4. Lets review the new HTML code in our page. You will note a link to the stylesheet was added to the heading of OrderEntry.htmsimilar to this

You should also note how the

tags for the text havebeen modified to reflect the classes we applied

Order Date

5.Additional Resources for changing or embedding different font styleswithin a web page can be found at :

www.microsoft.com/typography/web/embedding/weft

The syntax for embedding fonts into a web-browser would looksomething like this

@font-face{font-family:Nueva Roman; src:url(nuevar).eot)}


39/216

SAP xMII Training


Lab 7 SAP xMII Installation Guide

IntroductionOne of the key benefits of the SAP xApp Manufacturing Integration andIntelligence (SAP xMII) is its ultra-thin client architecture that requireszero client administration. SAP xMII clients require a standard Web

browser only which minimizes installation and management. No SAP xMIIsoftware needs to be installed on any of the client systems. Setup andinstallation of SAP xMII is performed entirely on your Web server. Theclient browser does require that a Java Runtime Environment (JRE) plug-

in to be installed in order to use the full set of user interface objects. Thesupported JRE for a client machine is version 1.4.2 from Sun

Microsystems, Inc. (the latest release of 1.4.2 is recommended for theclient).

Note: It is not recommended that the server application be

installed on a server with a JSDK/JRE version greater than1.4.2_07.

This SAP xMII installation is optimized to support Microsoft InternetInformation Services (IIS) on Microsoft Windows 2003; however,

Microsoft Windows 2000 Server may also be used. Support for any non-Windows platforms and/or support for any servlet engine other than thatsupplied with the product requires special licensing arrangements. There

is no end user support for these other platforms.

SPC data analysis requires a database to be installed and configured. The

recommended configuration is to install Microsoft SQL Server directly onthe Web server.

Note: You do not need a database if you are not using SPC dataanalysis. The core SAP xMII functionality stores its

configuration data in operating system files.

The SPC data analysis option benefits from a high performance CPU.

SAP xMII includes an add-in for Microsoft FrontPage and one for MacromediaDreamweaver that enables the use of these tools as a unified developmentenvironment for your SAP xMII application. Refer to the Installing the FrontPageAdd-In section of this topic for more information. If you are using MacromediaDreamweaver, refer to the Installing the Dreamweaver Add-In section of thistopic for more information.


40/216

SAP xMII Training


System Requirements

Prior to installing SAP xMII, you must ensure that your server meets the following minimum

requirements:

For 1-

10 Co n c u r r e n t

U s e r s

For 11-100

Concurrent Users

For 101-500

Concurrent Users

For 501+

Concurrent Users

Processor 1.8 GHz or faster 1.8 GHz or faster;dual processor

recommended

dual processor, 1.8

GHz or faster

dual processor, 1.8

GHz or faster

RAM See Web Server

Documentation

(512 MB minimumrecommended)

See Web Server

Documentation

(1024 MB minimum

recommended)

See Web Server

Documentation

(4096 MBytes

minimum

recommended)

See Web Server

Documentation

(8192 MBytes

minimum

recommended)

Operating System Windows 2003Server

-or-

Windows 2000

Professional withService Pack 4 or

greater

Windows 2003Server

-or-

Windows 2000

Server with ServicePack 4 or greater

Windows 2003Server

-or-

Windows 2000


Windows 2003Server

-or-

Windows 2000


Web Server

Software

IIS 6.x or 5.x IIS 6.x or 5.x IIS 6.x or 5.x IIS 6.x or 5.x

Java Virtual Machine Sun JSDK 1.4.2_07 Sun JSDK 1.4.2_07 Sun JSDK 1.4.2_07 Sun JSDK 1.4.2_07

File System NTFS NTFS NTFS NTFS

The required system resources vary based on your applications; however, for sizing purposes, an

estimated 2-4 MB per simultaneously connected user can be used.

Virtually any Web browser, including Microsoft Internet Explorer, Netscape Navigator, Netscape

Communicator, Opera, and Mozilla Firefox, can be used with SAP xMII. We recommend that you

use the most recent versions of these products. As stated above, the client should have the Sun JREplug-in installed to the browser.

The Sun Java Runtime Environment (JRE) must be installed on the server prior to the SAP xMII

installation (It is recommended that you download and install the full JSDK, instructions can be foundbelow).

Note: Turn off the Java automatic update mechanism via the Java Plug-in Control Panel.

It is strongly recommended, although not required by SAP xMII, that the local volume where you are

installing SAP xMII be formatted with the NTFS file system. This will enable a high degree of securitycontrol over your Web page content via direct integration with the Windows NT or Windows 2000 and

IIS security and authentication subsystems.

If you will be using the SAP xMII FrontPage add-in, you must be running Microsoft FrontPage 2000

and must have the FrontPage 2000 server extensions installed on your Web server. Refer to the

FrontPagesection for detailed instructions on how to install these products.


41/216

SAP xMII Training


System Installation Prerequisites

You will need to obtain a license file in order to run SAP xMII. You may

request a license file at http://support.lighthammer.com, or [email protected]. See the license managersection of the helpfor more information.

The Sun JSDK 1.4.2_07 must also be downloaded and installed on theserver prior to installing SAP xMII. You can download the JSDK directlyfrom

http://java.sun.com/products/archive/j2se/1.4.2_07/index.html. Press onthe "Download J2SDK" link on this page, save it to disk, and install the

JSDK. A link to this site is also available on the xMIIInstall.htm on theroot directory of the installation media (see below step by step

instructions for more information).

Windows NT

You must install a Web server prior to installing SAP xMII. Microsoft WebServer 4.0 is available as a free add-on to Windows NT Server or

Workstation as part of the Windows NT 4.0 Option Pack. You candownload the option pack or get it on CD-ROM from your local Microsoftreseller. If you are installing SAP xMII on an Windows NT Server system,

you will install IIS 4.0. If you are installing SAP xMII on a Windows NTWorkstation machine, you will install Personal Web Server (PWS) 4.0.

Detailed information on installing IIS is provided with the Windows NTOption Pack. During the NT Option Pack installation it is important to

select the Custom installation option and verify that the followingcomponents are selected for install:

Internet Information Server (IIS)

Internet Service Manager

If you will be using ODBC data sources, it is suggested that you obtain thelatest Microsoft Data Access Components from the Microsoft Data AccessWeb siteand install them on your Web server. Note that these are not

required to access Microsoft SQL Server or Oracle, as SAP xMII will installdirect, high-performance drivers for these databases.

If you are running Windows NT 4.0 and Internet Explorer 4.x on your Webserver, it is recommended that you update certain system files before

installing SAP xMII. It is advised that you run a Windows Update andinstall all recommended updates before proceeding.

Note: Installation of IIS may cause the removal or overwriteof some of the Windows NT Service Packcomponents. It is recommended that you reinstall

Service Pack 6a or greater on NT systems, prior toproceeding to the installation of the SAP xMII

application.


42/216

SAP xMII Training


Windows 2000

If you are installing SAP xMII on an MS Windows 2000 Serversystem,you will install IIS 5.0. If you are installing SAP xMII on an MS Windows2000 Professionalsystem, then you will install Personal Web Server

(PWS) version 5.0. Microsoft Windows 2000 will typically install the IIS5.0 components you will need to run SAP xMII.

The Microsoft Web servers for Windows 2000 systems are available aspart of the installation process of the operating system. If you already

have the operating system installed, without the Web server, you may runthe additional setup required by choosing "Add/Remove WindowsComponents" after starting the Add/Remove Programs service availablewithin Control Panel (Internet Information Services (IIS) is the required

component).

If you will be using ODBC data sources, it is suggested that you obtain thelatest Microsoft Data Access Components from the Microsoft Data AccessWeb siteand install them on your Web server. Note that these are notrequired to access Microsoft SQL Server or Oracle, as SAP xMII will install

direct, high-performance drivers for these databases.

Note:Installation of IIS may overwrite or cause the removalof some of the Windows 2000 service packcomponents. It is recommended that you reinstall

Service Pack 4 or greater on Windows 2000 systems,prior to proceeding to the installation of the SAP xMIIapplication.

Windows 2003

By default, Windows 2003 Server has certain locked capabilities that mustbe changed after SAP xMII installation in order for SAP xMII to run. Youmust create a virtual directory in IIS with the proper privileges so that theservlet engine will run. Complete the Additional Steps for Windows 2003

section after the Step-by-step Installation.

Windows XP Professional

Microsoft Windows XP Professional is not a supported server platform forproduction environments. It should be used for demonstrations and

limited evaluations only.

If you are installing SAP xMII on a Microsoft Windows XP Professional

system, you will install IIS 5.1. IIS is not installed by default with theoperating system. You will have to go to the Add/Remove WindowsComponents section and choose to install it. Select the World Wide Web

Service and press Details, then check the Scripts Virtual Directory.


43/216

SAP xMII Training


When installing IIS, you MUST do a custom install and choose toinstall the Scripts Virtual Directory. Without this virtual directorySAP xMII WILL NOT run. Additionally, if you have installed anyWindows XP Service Packs, it will be necessary to reinstall them

after adding IIS.

If you are using SQL Server 2000, you should have Windows XPservice pack 2 and SQL Server 2000 service pack 3 installed.

Step-by-step Installation

Note: If an error occurs during the install, please review the installlogsfor more information.

1. Make sure you are logged on to the server machine with anAdministrator account.

2. If you are running Windows NT, stop the Web server and IIS via the

Control Panel's Services applet.If you are running Windows 2000 or Windows 2003, stop the Webserver and IIS via Start | Programs | Administrative Tools |Services by stopping the IIS Admin Service.

This process automatically stops dependent services such as theWorld Wide Web Publishing service, FTP service, and SMTP service.

3. If you have physical CD media, insert the SAP xMII CD into yourCD-ROM drive. Auto-run opens the SAP xMII Installation page inyour default browser. If you downloaded the software from the

SAP Service Marketplace, extract the downloaded archive to a localdirectory and then open the xMIIInstall.htm page in the chosendirectory.

Note: If you are using physical media and auto-run fails, you can

open the xMIIInstall.htm page from the CD root to install SAPxMII. A link to the Sun Java 2 SDK installation is also availableon this page if you did not yet download and install it. Once the

JSDK is installed, you can run SETUP.EXE directly from theinstall folder.


44/216

SAP xMII Training


4. If you already installed the Sun JSDK 1.4.2_07 on the server,continue to step 5.ORIf the Sun JSDK 1.4.2_07 is not installed, download the JSDK

directly fromhttp://java.sun.com/products/archive/j2se/1.4.2_07/index.html. Click the "Download J2SDK" link, save the file to disk, and run thesetup from the local disk.

ORIf a prior version of the Sun JDK or JRE is installed, uninstall theJDK/JRE and all references to Sun Java products including thefollowing:

Java 2 Runtime Environment (JRE)

Java 2 Software Development Kit (SDK)

Residual folders and files under the root directory (i.e.,C:\jdk1.3.1_01) or under \Program Files\Java

Registry entries (via Start | Run, enter Regedit in the Openfield, select HKEY_LOCAL_MACHINE\SOFTWARE, and deletethe JavaSoft folder and all its sub-directories)

Then install the Sun JSDK 1.4.2_07.

5. Select the SAP xMII 11.5 installation link. The InstallShield Wizardfor SAP xMII window appears. If you did not stop the IIS Admin

service, the following window appears. Click the Yes button to stopthe service. Click the No button to exit the install.

To continue, click the Next button. You may click the Cancel button

at any time during the process in order to stop the installation.

6. The License Agreement window appears. Please read the licenseagreement carefully.If you accept the license agreement, click the Yes button tocontinue the SAP xMII installation.

ORIf you do not accept the license agreement, click the No button. Thesetup stops and InstallShield Wizard closes.


45/216

SAP xMII Training


7. The Choose Destination Location window appears and prompts youto select a destination folder where the setup will install the SAPxMII application. The default destination folder is usuallyacceptable, although it is recommended that you install the

Lighthammer directory to the same drive on which you installedIIS. The Lighthammer directory should be installed on the root ofthe drive you select. You should not install it at locations such asProgram Files, etc. Click the Next button to continue the

installation.


46/216

SAP xMII Training


8. Another window appears and prompts you to choose a destinationlocation for the Web root directory for the Web server. The defaultlocation for Microsoft IIS is C:\InetPub\wwwroot and is usuallyacceptable. If you moved your default Web root, indicate it here.

Click the Next button to continue the installation.

9. If you are upgrading from a version prior to version 11.0, the

following window appears. Click the Yes button to continue theinstallation as an upgrade. Click the No button to exit theinstallation. If you are not upgrading a version prior to 11.0, skip tostep 10.


47/216

SAP xMII Training


10.Confirm the location of your Illuminator directory. The correctlocation should default.

11.If your previous version was installed with the ServletExec ISAPI

filter, it must be uninstalled in order to continue with your currentinstallation. To correctly uninstall the ISAPI filter, the SAP xMIIinstall must reinstall the ISAPI filter. Follow the ISAPI filter installinstructions and accept all defaults. If your previous install did not

include the ISAPI filter, you may skip to step 13.


48/216

SAP xMII Training


12.Once the ISAPI install completes, you must uninstall it. Click the OKbutton to uninstall the ISAPI filter.

Click Yes to uninstall ServletExec ISAPI

Click the Yes button to stop the IIS Admin service.

Click the Yes button to delete the ServletExec ISAPI installdirectory.

After the ISAPI uninstall is complete, install ServletExec ApplicationServer.

13.A window appears noting that the ServletExec Application Server

(AS) install is about to be launched. Please make special note ofthe instructions on this dialog before proceeding with the ASinstallation.


49/216

SAP xMII Training


14.Select the AS instance option button when you are asked what typeof installation you wish to perform.


50/216

SAP xMII Training


15.Select a folder for the Application Server installation. It issuggested that you install to the same root drive that you chose forSAP xMII. Click the Browse button, and enter thefollowing: :\ServletExec AS. See below.


51/216

SAP xMII Training


16.When the AS install is launched, you are asked to select an ASinstance name for SAP xMII. Type "LHCMS" over the default name.


52/216

SAP xMII Training


17.Choose IIS as the Web server.


53/216

SAP xMII Training


18.If the Scripts Virtual Directory does not exist, the following windowappears.

19.Enter a port number for the Application Server.

Note: This is an internal port only, and IIS will continue to run onport 80. All SAP xMII content will still be accessed through port80. In order for the application to operate properly, other

applications should not be using the port number you enter.


54/216

SAP xMII Training


If you want to change this port number at a later time, see Changing

the Application Server Port Number.

After you confirm the selections you made above, you can select apassword for the ServletExec admin account or you can leave thepassword blank. Then, click the Yes button to install ServletExec AS

as an NT service.

20.You do not need to view the ServletExec install log or the readme

file. When the ServletExec install is complete, it will open anExplorer window. Close this window.


55/216

SAP xMII Training


21.When the Servlet Exec AS installation is complete, the SAP xMIIinstallation asks for the AS installation location so that the SAP xMIIwebapp files can be copied to the correct location. The file transfermay take a few minutes. The default location should be the correct

location.


56/216

SAP xMII Training


22.Select an option button for the amount of RAM that you wish todesignate to SAP xMII via ServletExec AS.

Note: Once the installation is complete and SAP xMII is operatingproperly on ServletExec Application Server, it is no longernecessary to restart IIS in order to restart the SAP xMII

application. Simply go to the Services console, and restart theServletExec- service. That process will reload SAP

xMII.


57/216

SAP xMII Training


23.Enter the fully qualified machine name (e.g.,MACHINE_NAME.Domain.com) of the machine on which you areinstalling SAP xMII. It is required to identify the location of thesecurity server in a multiple domain and/or third-party single sign-

on scenario. If you are not implementing across domains or usingthird-party single sign-on, the machine name (without the domainname) is sufficient.


58/216

SAP xMII Training


24.Enter the anonymous IIS user account (e.g., IUSR_Machine_Name)of the machine on which you are installing SAP xMII. Theanonymous IIS user account is used to set permissions on SAP xMIIinstall directories.

The installation begins copying files and installing. If an erroroccurs, the InstallShield stops and the setup does not continue.

25.If you are upgrading from a previous version, the following windowappears. Click the Yes button to run the 11.5 migration tool. Themigration tool upgrades your system configurations from yourprevious version to the current. If you click No, you can run the

migration from the Start menu after the installation.


59/216

SAP xMII Training


26.Click the OK button to run the system migration. When themigration is complete, click the Cancel button to close the window.

27.If you are upgrading from a version prior to 11.0, the following

window appears. Click the Yes button to run the security migration.The security migration does not have an interface like the systemmigration. A DOS window appears; close it to run the securitymigration. If you are upgrading from 11.0 or 11.0.1, the security

migration window does not appear since there is no migration fromthose versions. If you choose not to run the security migration atthis time, you can run it from the Start menu.


60/216

SAP xMII Training


28.If this is a new installation, once all files have been copied, thefollowing window appears. Click the OK button to choose atemplate. If this is an upgrade, this step is skipped and yourexisting default template styles remain.


61/216


62/216

SAP xMII Training


30.The SAP xMII installation is complete. Click the Finish button toclose the InstallShield Wizard.

31.After the installation is complete but before using SAP xMII, stop

the IIS Admin Service and then restart the Web server. There aretwo methods for stopping/starting the IIS Admin Service and WorldWide Web Publishing Service.From the Start menu, select Programs | Lighthammer | Illuminator

and either the Stop IIS or Start IIS batch file options.ORIn Windows NT, open the Windows Control Panel and select theServices option, or in Windows 2000, choose Start | Programs |

Administrative Tools | Services. Highlight the IIS Admin and click

the Stop button to stop this service and all dependent services.Then restart the World Wide Web Publishing Service (and any othernecessary Web services such as FTP or SMTP) which automatically

restarts the IIS Admin Service. In Windows 2000, all Web servicescan also be managed through Start | Programs | Administrative

Tools | Internet Services Manager.

32.Before accessing SAP xMII you need to set up your license. To do

this, copy your lhcms.lic license file into theC:\Lighthammer\License directory and then restart yourServletExec-{InstanceName} NT service in the WindowsServices window.


63/216

SAP xMII Training


Note: It usually takes several minutes to restart the applicationinstance, so you will not be able to access the application until itis finished.

Additional Steps for Windows 2003

Complete the following steps to allow the servlet engine to run as arecognized Web service extension.

1. Select the Web Service Extensionsfolder.

2. Click the Add a new Web service extensionlink. The New WebService Extensionwindow appears.

3. Enter ServletExecas the new Web service name.

4. Browse to the C:\Inetpub\Scripts location and select

ServletExec_Adapter.dll as the required file.


64/216

SAP xMII Training


5. Select the Set extension status to Allowedcheck box.

6. Click the OKbutton.

Installing the FrontPage Add-in

The SAP xMII add-in for Microsoft FrontPage 2000 and Microsoft

FrontPage 2002 is installed in the \Lighthammer\Illuminator\Wizardsdirectory on the drive on which you installed the SAP xMII application.

In order to use the add-in, it must be installed on each PC that will berunning FrontPage. On computers other than the Web server, a Webpackage installation is available on the SAP xMII Web server:http:///Lighthammer/WizardInstall/IlluminatorWizard.exe.

You can save the file locally and run it, or you can select Open and run itdirectly from the Web server.

Note: Windows 2003 Server requires the FrontPage 2002 Serverextensions.

Once the file is installed (the default is

:\Lighthammer\Illuminator\Wizards), open FrontPage. Selectthe /Tools/Add-Ins menu option. If you already had a previous version ofthe Add-in installed (prior to Illuminator 9.5) highlight the SAP xMIIWizard selection and press the Remove button. If this is a new install,

skip to the enable step below.


65/216

SAP xMII Training


To enable the new add-in, click the Add button, and browse to the locationwhere the Illum95FPWizard.dll file resides (default is:\Lighthammer\Illuminator\Wizards). After clicking the OKbutton, you should see the SAP xMII add-in installed as shown in the

following dialog:

The add-in is automatically loaded each time FrontPage is started. The

add-in includes the SAP xMII Object, the Script Assistant, and links to theSAP xMII Template Editor and the System Administration Editor.

Installing the Dreamweaver Add-in

The SAP xMII add-in for Macromedia Dreamweaver is installed in the\Lighthammer\Illuminator\Wizards directory on the drive on which youinstalled the SAP xMII products.

NOTE: In order to use the add-in, this file must be installed on each PC

that will be running Dreamweaver. On computers other than the Webserver, a Web package installation is available from the SAP xMII Webserver:http:///Lighthammer/WizardInstall/IlluminatorWizard.exe

Use the following steps to enable the Dreamweaver add-in:

1. Copy the C:\Lighthammer\Illuminator\Wizards\IllumDWWizard.dllfile to your local installation of the Dreamweaver MX program,JSExtensions directory (the default is C:\ProgramFiles\Macromedia\Dreamweaver MX\Configuration\JSExtensions).

2. Copy the C:\Lighthammer\Illuminator\Wizards\IlluminatorObject.htm file to C:\Program Files\Macromedia\Dreamweaver

MX\Configuration\Commands.

3. Copy the C:\Lighthammer\Illuminator\Wizards\Illuminator ScriptAssistant.htm file to C:\Program Files\Macromedia\DreamweaverMX\Configuration\Commands.


66/216

SAP xMII Training


You should then be able to go into Dreamweaver and find the links at thebottom of the Command menu. If selecting SAP xMII Object does notdisplay the plug-in, open a command prompt and type"cd\Lighthammer\Illuminator\Wizards" to navigate to the folder where the

DLLs are located. Then type "regsvr32 IllumDWWizardGUI.dll" whichshould register the dll. Dreamweaver should then prompt you for the SAPxMII server name or internet protocol (IP) address (it defaults tolocalhost) when calling up the plug-in; this is similar to the standalone

version of the plug-in.

You can then configure Dreamweaver for editing SAP xMII Report pages(.irpt).

Initialization

By default, SAP xMII starts up (initializes) when the NT Service starts

up. There is a time delay for the initialization in order for various systemservices to start up as before SAP xMII initializes. It is important that thetiming is correct. The default delay is 30 seconds. This can easily be

changed if it is causing problems. A symptom of this problem is a classnot found error in the Servlet Exec logs, because not all systems wereinitialized before SAP xMII was started, causing some paths to be

incorrect.

Until the delay time is complete, it is recommended that you do notattempt to query SAP xMII. This includes accessing the SAP xMII mainmenu. Keep in mind that the delay is in addition to the delay caused by

the NT Service start up time. See the Server Logging section to see howto access the Servlet Exec Logs. See the section on SAP xMIIInitializationin the system configuration guide for more information onthis topic.

Time Synchronization of Servers and Clients

In order for SAP xMII to operate correctly, the system clocks on the Webserver, data servers, and client browsers should be maintained inreasonably close synchronization.

In the case where other applications on the Web server prevent the

enabling of automatic daylight savings time adjustment, you mustconfigure the time zone to use the option that does not include the autoadjust checkbox [e.g., use the (GMT-05:00) Bogota, Lima, Quito time

zone instead of the (GMT-05:00) Eastern Time (US & Canada) time zone].

Installation Log Files

There are three installation logs created when installing SAP xMII. If you

experience problems during your installation or have questions aboutinstallation locations, you can review these log files.

SAP_xMII_Install_date_time.log is an overall general log file for the

installation located in the Lighthammer\Logs directory.


67/216

SAP xMII Training


CMSServicesInstall_date_time.log contains details relating to theinstallation of your SAP xMII services and is located in theLighthammer\Logs directory.

xMIISecurityInstall_date_time.log contains details relating to the

installation of Security Manager and is located in theLighthammer\Logs directory.


68/216

SAP xMII Training



69/216

SAP xMII Training


Lab 8 Getting Connected

Purpose

The student will learn how to connect to various data sources and verify theirconnection status through the configuration of the SAP xMII Connectors andServers. Data sources will include: Microsoft SQL, InSQL, AlarmSuite, PI (via UDS)and Virtual SQL.

Topics Covered

This lab will cover

xMII Administration Menu

Connectors: Types, Configuration

Adding/Configuring/Editing servers Verifying Connector / Server status

Procedure

To access the SAP xMII Administration Menu, in your browser navigate to

http:///Lighthammer/

NOTE: Your instr uct or w il l pr ovide you wi t h the server name and your

login credent ia l s

After you login your screen should look similar to this


70/216

SAP xMII Training


**The Instructor will perform the next steps to connect to a series of datasources. Please be aware that any changes to configuration settings on theserver affect the entire class.

1. To Configure our Servers (connections), under Data Services select DataServers.

2. Uncheck the Show Only Enabled Servers box to show all the defaultServers.

3. Select InSQLOleDB and verify that the URLvalue (in the Server Parametersbox) is correctly entered:

a. Edit the proper nodename of the InSQLOleDB server used in thetraining class by highlighting the ServerURLline in the ServerParameters window and making the appropriate changes . Bydefault, the nodename listed is localhost,which represents the localmachine. Since InSQL is may not be running on the local machineyou need to point to the correct server - verify the IP address with

the instructor.b. Verify the TCP/IP port. (Note: The configured InSQLOleDB port is

typically 1433).

c. Verify the database name for InSQL Server is Runtime. The databasename for the InSQL connectors will always be Runtime.

d. Click the Enabled checkbox.


71/216

SAP xMII Training


4. For our next server select MSSQL_Database in the Servers list, clickCOPY. Enter PlasticResinfor the server name.

5. Now edit the URL nodename to (or which isthe default) and the database name to PlasticResin. Verify the port is setfor 1433(MS SQL Server). Since there is a PlasticResin database running onthe local computer the nodename can be localhost. Click OK.

6. Click the Enabled checkbox

7. Similarly, create a new MSSQL connection. Select MSSQL_Database in theServers list, click COPY. Enter Alarms for the server name. Verify thenodename is pointing at the proper server, and the database name isAlarmSuite. Click the Enabled checkbox. See next page.


72/216

SAP xMII Training


8. Now edit the URL nodename to (or which isthe default) and the database name to PlasticResin. Verify the port is setfor 1433(MS SQL Server). Since there is a PlasticResin database running onthe local computer the nodename can be localhost. Click OK.

9. Click the Enabled checkbox.

10.After configuring the Servers, click the Savebutton. After saving, selectthe Statusbutton to verify whether or not you have connected to your datasources.

See next page:


73/216

SAP xMII Training


A value of 1 in the Connections Availablecolumn indicates that the serverconfiguration is complete and a successful connection to the data source hasbeen made.

A value of 0 in the Connections Available column indicates there is either aproblem in the configuration or the specified data source is not available.


74/216

SAP xMII Training



75/216

SAP xMII Training


Lab 9a Building Queries Using the Template Editor

Purpose

The purpose of this lab is to introduce the basics for creating and customizing dataqueries using the SAP xMII Template Editor.

Topics Covered


Tag Queries

SQL Queries

Procedure

First, we will create a series of Query Templates that will be used to extract datafor the Java Applets. From the SAP xMII CMS Menu, under Data Services click theQuery Templatesicon.


76/216

SAP xMII Training


CREATING A TAG QUERY

1. Current Mode:

a. Select the New button,

then select Tag Query from the Template Type drop-down menu. SelectOK.


77/216

SAP xMII Training


b. In the Data Source tab, select InSQLOLEDB Server and Current Mode.

c. Switch to the Tag Query Details tab. Note the Available Tags list.

d. Use the Tag Selection Mask field to limit the Available Tags listed to onlythose you wish to view. In the example below, enter %speedand select

the Apply button. This will limit the tags in the Available Tags field toonly those tags that include speed in their tagname.

e. Use the >>, >,


78/216

SAP xMII Training


f. Once you have selected the desired tags, click the Test button to verifythat you have a connection to the data source and that the desired datais returned. Clicking the Test button pops-up the Select Content Typebox choose text/html (default) and click OK.

g. Use the Save As button to save the template as InSQLCurrentQueryinyour Training folder.

*If you dont have a training folder use the New Folder button to createit within the existing Training folder.

h. You will see a confirmation dialog box stating that the template wassuccessfully saved.

Once saved, we can use the InSQLCurrentQuery file as a template to createadditional Tag Query templates that use the same tags, but utilize differentModes (e.g. History, Statistic).


79/216

SAP xMII Training


2. History Mode:

a. switch back to the Data Source tab and select the History Mode. Clickthe Test button to verify the data. Use the SAVE ASbutton and Save

the template as InSQLHistoryQuery in your Training folder.

3. Statistics Mode:

a. Change the Modeto Statistics. In the Methodfield, select MIN,MAX,TWAfrom the drop-down menu. Click the Test button to verify data and usethe SAVE ASbutton to save the template as InSQLStatQuery in yourTraining folder.


80/216

SAP xMII Training



81/216

SAP xMII Training


CREATING A SQL QUERY

1. Query Mode:

a. Select the New button, then SQL Query from the Template Type drop-down menu. Select OK.

b. In the Data Source tab, select the PlasticResin Server and Query Mode.

c. Switch to the SQL Query Details tab, select the PlasticBottleBatchData

table, and add all Columns (Hint: use the > and >> buttons to selectthe desired Tables and Columns).


82/216

SAP xMII Training


d. In the Sort Expression:field, add PlasticBottleBatchData.OrderNo ASC.

(HINT: select OrderNo from the Available Columns: field and use thePaste button to the left of the Sort Expression: field then select the ASC

button to the right of the Sort Expression: field)

e. Use the Test button to verify that the proper data is returned.f. Save the templatein your training folder as BatchListQuery.


83/216

SAP xMII Training


g. Using the same Data Source settings, well create a new SQL Query.From the Available Tables: select two tables; Sublotand Lot.

h. Select the appropriate columns from each of the tables (see below).

Use the > button to move the selected columns and use the UpandDownbuttons to order the columns as below. The Selected Columnsshould be in the following order:

Sublot.LotID

Lot.MaterialName

Sublot.Location

Sublot.QueuedQty

Lot.HoldStatus

Lot.QuarantineStatus

**Note: To populate expression boxes, highlight an Available Table and anAvailable Column and click the Paste button next to the expression box youwould like to populate.

i. In the Join Expression:field, add Lot.LotID=Sublot.LotID.

j. In the Filter Expression: field, add Lot.LotID LIKE [Param.1]

k. In the Sort Expression:field, sort on SubLot.LotID.

l. On the Parameterstab, enter a % (percent sign) in the ParameterValue: field and click Set

m. Use the Testbutton to verify the proper data is returned.

n. Save the templatein your training folder as LotListQuery.

o. Create a new SQL Query using the same PlasticResin data source andQuery Mode.

p. Select thePlasticBottleTrendDatatable and the Operatorcolumn.


84/216

SAP xMII Training


q. In the Filter Expressionfield, enter:PlasticBottleTrendData.BatchNo LIKE [Param.1].

r. On the Parameterstab, enter a % (percent sign) in the ParameterValue: field and click Set

s. Use the test button to verify that the proper data is returned.t. Save the templatein your Training folder as OperatorScoreboardQuery.

**Note - Parameters (used in the Filter Expression) provide an alternative tochanging other SQL, Alarm, or XML properties at runtime and provide a cleanermechanism for changing query behaviors dynamically based on filtering or othercriteria.


85/216

SAP xMII Training


Create a new SQL Query using the same PlasticResinData Source and Query Mode.Select the PlasticBottleTrendDatatable and select all columns (use the >>button to move all the column names).

u. Click the Date Rangetab and set the Start Date:08/01/2003 06:45:00and the End Date: 08/01/2003 20:45:00.

v. Under the SQL Query Detailstab In Available Columns: highlight theDateTimecolumn. Select the Setbutton next to the Date Column:field.

w. In the Filter Expressionfield, enter: BatchNo LIKE '[Param.1]'.

x. On the Parameterstab, enter a % (percent sign) in the ParameterValue: field and click Set

y. Click Testto verify the proper data is returned. Notice the Date-Timeparameters are passed into the SQL Statement.

z. Save the templatein your training folder as BatchTrendQuery.


86/216

SAP xMII Training


aa.Create a new SQL Query using the same PlasticResinData Source andQuery Mode. Under the SQL Details Tab select the KPIDataandKPIConfigtables.

bb.Select all Columns from both tables (use the >> button to move all thecolumn names).

cc.In the Join Expression:field, addKPIData.KPIName=KPIConfig.KPIName (this will join the tables on theKPIName).

dd.In the Filter Expression:field, add KPIConfig.KPIName =Yield (thiswill cause the query to return only yield data).

ee.Save the templatein your training folder as KPIQuery.


87/216

SAP xMII Training


2. Fixed Query Mode:

a. Create a new SQL Query using the same PlasticResinserver, but changethe Mode to FixedQuery.

b. In the Fixed Querytab, enter the following SQL Statement:

Select BatchID, Color, MeltingPt, ChipsPerGram, OrderNo, BatchStart,BatchEnd, LotID from PlasticBottleBatchData order by OrderNo

c. Test and Save the templatein your Training folder asBatchListFixedQuery.


88/216

SAP xMII Training


d. Once again create a new SQL Query with the PlasticResinserver, Mode =FixedQuery.

e. Enter the following SQL Statement:

(Hint: Try highlighting the table name and column that you want to insertand click the Paste button next to the Available Columns window thiswill insert the table name and column. To just insert the table name,highlight the table name and click the Paste button next to the AvailableTables window)

Select PlasticBottleTrendData.DateTime,PlasticBottleTrendData.BatchNo, PlasticBottleTrendData.Pressure,PlasticBottleTrendData.Temperature, PlasticBottleTrendData.MixSpeed,PlasticBottleTrendData.Operator from PlasticBottleTrendData Where(PlasticBottleTrendData.DateTime >= [SD] ANDPlasticBottleTrendData.DateTime


89/216

SAP xMII Training


h. Create a new SQL Query - Select the same Data Source Server and Mode.

i. Enter the following SQL Statement:

execute BatchList

j. Test and Save the templatein your Training folder asStoredProcedureQuery.

k. Create one final SQL Query Select the Alarms server, and QueryMode.l. Click on the SQL Query Detailstab and select the AlarmSummary table.

m. Select all available columns using the >> button.

n. In the Sort Expression field, enter LastEvent DESC

Verify your settings are correct via the screen shot on the next page:


90/216

SAP xMII Training


o. Test and Save the query in your training folder as AlarmQuery .


91/216

SAP xMII Training


Lab 9b Building Displays Using the Template Editor

Purpose

The purpose of this lab is to introduce the basics of the using the Visualization

Services for creating and customizing display templates used for visualizing thedata queried.

Topics Covered


Display Template Editor

iCharts, iGrids, iBrowsers, and iTicker display applets

Procedure

iChart Display Templates

The iChart display template can be used to create many different charts including:

- Line - Floating Bar - Regression - Pie

- Stacked Bar - XY Regression - Polar - Event Horizon

- XY - Group Bar - Strip Chart - Radar

- Bar - Variability Bar - Gauge - Waterfall

- Custom - Horizontal Bar- Horizontal GroupBar

We will begin by creating a new iChartDisplay template using the Line displaymode.

iChart Display Templates

a. From the SAP xMII Admin Menu, under Visualization Servicesclick the Display Templates icon.

b. Select the Newbutton, then iChartfrom the Template Typedrop-down menu. Select OK.

c. In the Chart Type: drop-down box, select Line.

d. In the Title text box, enter iChart Line Chart Type.

e. Save the template as iChartLinein your training folder.


92/216

SAP xMII Training


Note: Before continuing, review the parameters available in each of the DisplayTemplate tabs (e.g. General, Legend, Xaxis, Yaxis, Pen Details, Behaviors, DataMapping, and Refresh). After we are finished creating Display Templates, we willrevisit a few samples to discuss the effect of the various parameters available.

f. In the same iChartLinetemplate, change the Chart Type to Barand the Chart Title to iChart Bar Chart Type. Save thetemplate as iChartBar.

Using the table below as a guide, create these additional Display Templates:

Chart Type Title Save As

GroupBar iChart Group Bar Chart Type iChartGroupBar

Polar iChart Polar Chart Type iChartPolar

FloatingBar iChart Floating Bar Chart Type iChartFloatingBar

Gauge ** iChart Gauge Chart Type iChartGauge

**Not e: For Gauge, set bot h t he Hori zontal and Vert ical Gri d Line Count = 2

pr i or t o sav ing


93/216

SAP xMII Training


Create a new iChart Line for a SQL Trend:

a. Select the New button, then iChart from the Template Typedrop-down menu. Select OK.

General tab:

b. In the Chart Type: drop-down box, select Line.

c. In the Title text box, enter Profile for BATCH00018.

d. Set the Title Font: to Helvetica 16 Bold Italic, Title Color: toYellow.

e. Check appropriate boxes per screen print below


94/216

SAP xMII Training


Legend tab

a. Set Background Color: black, Border Color:White, SelectionBorder Color: gray, Label Color: White, Font: Helvetica 12.

b. Check Legend on Top?Box.c. Set Legend Width: 25, Legend Height: 0.


95/216

SAP xMII Training


Pen Details tab

a. In the Pen Details tab, change the Pen settings as follows:

Pen # Scale Pen Color

1 Auto / Zero base Yellow

2 Auto / Zero base Cyan

3 Auto / Zero base Red

* Make sure Global Server Scaling is unchecked


96/216

SAP xMII Training


Data Mappingtab

a. In the Value Columns:box, addPressure,Temperature,MixSpeed (Hint: use the button toconnect to the BatchTrendQuery, highlight a column name andclick the


97/216

SAP xMII Training


Finally we will create a Custom iChart:

a. Select the New button, then iChart from the Template Typedrop-down menu. Select OK.

General tab:

b. In the Chart Type: drop-down box, select Custom.

c. In the Title text box, enter Key Performance Indicator forYield.

d. Verify settings per the screen shot below.


98/216

SAP xMII Training


Data Mapping tab:

e. Set the Value Columns, Axis Label Columns, and Axis ValueColumnto the appropriate values using the KPIQuery that wealready created.

Verify the following settings in the Legend, X Axis, and Y Axistabs:


99/216

SAP xMII Training



100/216

SAP xMII Training


Pen Detailstab

f. In the Pen Details tab, change the Pen settings as follows:

Pen # Scale Pen type Marker Style Pen Color

1 Global Auto Scale Bar 0 - none Yellow

2 Global Auto Scale Line 5 - X Cyan

3 Global Auto Scale Line 5 - X Red


101/216

SAP xMII Training


Verify the following settings for the Behaviorsand Refresh Pagetabs:

Save this display template as KPIChart in your training folder.


102/216

SAP xMII Training



103/216

SAP xMII Training


iGrid Display Templates

The iGrid display template can be used to create many different grids including:

Grid Lights Column Lights Multi-Lights

Scoreboard Vertical Grid Vertical Scoreboard Embedded Lights

1. We will begin by creating a new iGridDisplay template using the Grid displaytype

a. Select the Newbutton, then iGridfrom the Template Typedrop-down menu. Select OK.

b. In the Grid Type: drop-down box, select Grid.

c. Save the template as iGridGridin your training folder.


104/216

SAP xMII Training


2. Using the iGridGrid as a template, change the Grid Type to Scoreboardandsave the template in your Training folder as iGridScoreboard.

3. Using the iGridScoreboard as a template, change the Grid Typeto Lights then:

a. Switch over to the Data Mappingtab (this is where we will assign the

columns to display).b. Click on the button and select the AlarmQuerytemplate from

your training folder (this is the Query we want to be displayed).

c. Highlight the following Column Names from the Column Nameswindow AlarmType, GroupName, LastEvent, Operator andTagNameand click the


105/216

SAP xMII Training


e. Save the template in your training folderas iGridLights.

4. Using the same Layout and Color Context settings, switch to the General taband update the Grid Type to MultiLights. Save the template in your training

folder as iGridMultiLights.


106/216

SAP xMII Training


5. Create a New iGrid template named BatchListGrid with the followingparameters:

Generaltaba. Grid Type: Grid, Text Font: Helvetica 10, Header Font: Helvetica 12 Bold,

Selected Font: Helvetica 10 Bold, Grid Color:Gray, Text Color:White, RowSelection Color: Yellow, Row Selection Border Color:Royal Blue.

b. Check appropriate boxes


107/216

SAP xMII Training


Data Mappingtab

a. Add appropriate Display Columns, see figure below (Hint: use the button to link to the BatchListQuerytemplate).

Layouttab

a. Add the appropriate Column Headings by typing into the text box andclicking the SET button.

b. Verify that the Auto Resize Columnsbox is checked.

c. Save template in your training folder as BatchListGrid.

6. Create a New iGrid template named LotListGrid with the following parameters:


108/216

SAP xMII Training


Generaltab

a. Set the parameters to - Grid Type: Grid, Text Font: Helvetica 14, HeaderFont: Helvetica 14 Bold, Selected Font: Helvetica 14, Grid Color:Gray, TextColor:White, Row Selection Color: White, Row Selection Border Color:White.

b. Check appropriate boxes

Data Mappingtab

c. Use the button next to the Query Template Name box to browse for the

LotListQuery template.d. Choose all the columns to be displayed by clicking the


109/216

SAP xMII Training


Layouttab

a. Add appropriate Headings (see table and screen shot).

b. Verify that the Auto Resize Columns box is checked.

Column Name Heading

Lot ID Lot Identification

MaterialName Material Name

QueuedQty QTY

Location Location

HoldStatus Hold Status

QuarantineStatus Quarantine Status


110/216

SAP xMII Training


Color Contexttab:

a. Apply the appropriate color context to the data by matching the ColumnNames and Values to the following colors:

Color HoldSt at us Quara nt ineSt at us

Lime Green Released ACTIVE

Yellow Released QUARANTINED

Pink ON_HOLD ACTIVE

Red ON_HOLD QUARANTINED

b. Save template in your training folder as LotListGrid.

7. Create a New iGrid template named OperatorScoreboard with the followingparameters:


111/216

SAP xMII Training


Generaltab

a. Set the parameters to - Grid Type: Scoreboard, Text Font: Helvetica 12,Header Font: Helvetica 12 Bold, Selected Font: Helvetica 12, Grid Color:Gray, Text Color:White, Row Selection Color: White, Row Selection BorderColor:White.

b. Check appropriate boxes:


112/216

SAP xMII Training


Layouttab

a. In Row Headings: add Operator.

b. Uncheck the Auto Resize Columns?box.

c. Set Row Height = 15 and Row Heading Width= 8.

d. Save template in your training folder as OperatorScoreboard.


113/216


114/216

SAP xMII Training


c. Switch to the Data Mappingtab and add the following Display Columns.(Use the column names from the InSQLCurrentQuery).

d. Switch to the Color Contexttab and update it like the following (Note:Colors, top to bottom, are Yellow, Orange, Lime Green, and Red).

e. Select the Match Mode: Number radio button.


115/216

SAP xMII Training


f. Switch to the Refreshtab and verify that automatic refresh is ENABLED andthe Refresh Rate is set to 60.

g. Save the template in your training folder as iTickerCurrent.


116/216

SAP xMII Training



117/216

SAP xMII Training


iBrowser Display Templates

The iBrowser is used to display a hierarchical view of tags, columns, etc.:

a. Select the New button, then iBrowser from the Template Type drop-down

menu. Select OK.b. Save the template in your training folder as iBrowser.


118/216

SAP xMII Training



119/216

SAP xMII Training


Lab 9c Using the Dynamic Page Generator

Purpose

The purpose of this lab is to introduce the basics of the using the SAP xMII DynamicPage Generator to build a dynamic Java Applet for data visualization.

Topics Covered


Generating Dynamic Pages using Query and Display Templates

Generating GIF Charts using the Query and Display Templates

Embedding the generated HTML code into a web-authoring tool (e.g.FrontPage)

Procedure

1. Return to the SAP xMII Admin Menu, under Visualization Services, select theDynamicPage Generatoricon. This will open up the Dynamic Page Generatorform

2. To generate a Page or a GIF Chart, we must select a QUERY templatecontaining the information for extracting data, and a DISPLAY templatecontaining information on how the data will be displayed.

3. We will use the folders in the top-left window to navigate and select our Query

Template files. (Note: the radio buttons on the right can be used to filter QueryTypes).


120/216

SAP xMII Training


4. We will use the folders in the bottom-left window to navigate and select ourDisplay Template files. (Note: the radio buttons on the right can be used tofilter Display Types).

5. From your training folder select the Query template InSQLCurrentQueryandthe Display template iChartBar. Selecting the Generate Pagebutton shouldgenerate a page similar to the one below


121/216

SAP xMII Training


6. The page includes the HTML code for the Applet, which we will use in our web-page design. From your browsers Viewmenu, select Source. A pop-up windowwill appear containing the HTML source code that was generated by the CMSDynamic Page Servlet. The HTML code should look something like this

Auto-Generated Page

7. Highlight the Applet tag code (HTML code between and including the

and the tags) and copy to the clipboard (Ctrl+C).

8. Open Page1.htm in FrontPage. Edit the title of the page and add some text atthe top of the page to read iChart Applet Sample Displays.

9. Switch to the HTML view and paste (Ctrl+V) the tag code into theHTML Body of the document.

10.REPEATthe procedure of Generating Pages, copying the HTML code and pastingit in the of Page1.htm for all of the iChart templates using the tablebelow as a guide for pairing Query and Display templates.

Query Template Display Template

Training\\InSQLStatQuery Training\\iChartFloatingBar

Training\\InSQLCurrentQuery Training\\iChartGauge

Training\\InSQLStatQuery Training\\iChartGroupBar

Training\\InSQLHistoryQuery Training\\iChartLine

Training\\InSQLHistoryQuery Training\\iChartPolar

11.Open Page2.htm in FrontPage. Edit the title of the page and add some text at

the top of the page to read iGrid Applet Sample Grids.


122/216

SAP xMII Training


12.Repeat the generate page, copy and paste procedure for all of the iGridtemplates using the table below as a guide for template selection.


Training\\AlarmQuery Training\\iGridGrid

Training\\AlarmQuery Training\\iGridLights

Training\\AlarmQuery Training\\iGridMultiLights

Training\\InSQLCurrentQuery Training\\iGridScoreboard

13.In FrontPage, create a MiscPage.htm for the remaining applet examples. Usethe following table as a guide for selecting Query Template and DisplayTemplate pairs.


Training\\InSQLCurrentQuery Training\\iTickerCurrent

Training\\LotListQuery Training\\iBrowser


123/216

SAP xMII Training


Lab 10a Web Page Design

Purpose

The purpose of this lab is to use the SAP xMII Object Wizard for Microsoft FrontPageto create applets for use in a web page.

Topics Covered


Incorporating SAP xMII Applets within a web page

Using xMIIs FrontPage Object Wizard

Documents

SAP_xMII_part_I