Web Environment Web Environment Framework & Framework & System System ManagementManagement

TIPTOP Product CenterDigiWinMay 14, 2013

Host FrameworkHost Framework

TIPTOP HostAP + DB

dsds1ds2……

dsds1ds2……

TIPTOP Host before B2B installed

TIPTOP B2B HostAP

After B2B installed

+ wds

B2B System Base Management DB

Standard Accounts Standard Accounts Management for Shipment Management for Shipment

• TIPTOP accounts and B2B accounts are controlled separately. The former are created via “p_zx (zx_file)” in the TIPTOP host, the later are via p_webuser (wzx_file) in the B2B host.

• Rights over multiple plants allowed for TIPTOP accounts, just switch to the plant you want when logging in udm_tree; When creating a B2B account, please assign 1. A “default database” (Mandatory) and 2. Multiple “Specific databases” (Optional) (Please refer to <Maintain Logistic Basic Data> for plants available for both systems).

• After adding a logistic in “Maintain Group Structures” (aooi931), for the formal area, please copy fglprofile.prod to the directory B2B 的 $FGLDIR/etc manually.

• A TIPTOP account can be mapped to multiple right groups (p_zw), operations available are set based on groups (p_zy); a B2B account can be mapped to multiple right groups too (p_webauthcol) but only one operation available (p_webauth)

• There are two standard accounts for shipment: supplier, tiptop

supplier – Vendor Demo Account No

tiptop – Administration Account No

TIPTOP B2BTIPTOP

ds1

Standard Accounts Standard Accounts Management for Shipment Management for Shipment

Account Management before Account Management before Running OnlineRunning Online

• Add more formal databases for vendors based on their needs.

• Databases are created via aooi931 or createdb. Tables are as those in ds.

• The vendor accounts can be added via p_webuser directly or use [Import TIPTOP Users] to import accounts in TIPTOP to B2B.

• Assign each account with a mapped database (Select in a popup window).

• Set various right groups to separate operations available by different vendor levels.

• Assign a right group or single operation for each account.

Apache（ httpd-fastcgi.conf ）

<IfModule mod_fastcgi.c> FastCgiServer /u6/bsframework/gas/bin/wrapper-b2b.fcgi -idle-timeout 300 -initial- Alias /b2b /u6/bsframework/gas/bin/wrapper-b2b.fcgi

<Directory "/u6/bsframework/gas/bin/">

<IfModule mod_fastcgi.c> FastCgiServer /u6/bsframework/gas/bin/wrapper-mclient.fcgi -idle-timeout 300 -initial- Alias /mc /u6/bsframework/gas/bin/wrapper-mclient.fcgi

<Directory "/u6/bsframework/gas/bin/">

<IfModule mod_fastcgi.c> FastCgiServer /u6/bsframework/gas/bin/wrapper-pos.fcgi -idle-timeout 300 -initial- Alias /mc /u6/bsframework/gas/bin/wrapper-pos.fcgi

<Directory "/u6/bsframework/gas/bin/">

# Launch GAS programexec "$FGLASDIR"/bin/fastcgidispatch -f as-b2b.xcf

# Launch GAS programexec "$FGLASDIR"/bin/fastcgidispatch -f as-mclient.xcf

# Launch GAS programexec "$FGLASDIR"/bin/fastcgidispatch -f as-pos.xcf

GAS（ bin/wrapper*.fcgi ）

GAS 2.3 GAS 2.3 FrameworkFramework

<ENVIRONMENT_VARIABLE Id="WPRODUCT">B2B</ENVIRONMENT_VARIABLE><RESOURCE Id="res.ic.port.offset" Source="INTERNAL">71</RESOURCE><GROUP Id="wtopprod-wag">$(res.wtopprod.config)/app/wag</GROUP><GROUP Id="wtopprod-wep">$(res.wtopprod.config)/app/wep</GROUP><GROUP Id="wtopprod-wzz">$(res.wtopprod.config)/app/wzz</GROUP>…

<ENVIRONMENT_VARIABLE Id="WPRODUCT">M-Client</ENVIRONMENT_VARIABLE><RESOURCE Id="res.ic.port.offset" Source="INTERNAL">70</RESOURCE><GROUP Id="wtopprod-wag">$(res.wtopprod.config)/app/wmb</GROUP><GROUP Id="wtopprod-wzz">$(res.wtopprod.config)/app/wzz</GROUP>…

<ENVIRONMENT_VARIABLE Id="WPRODUCT">POS</ENVIRONMENT_VARIABLE><RESOURCE Id="res.ic.port.offset" Source="INTERNAL">72</RESOURCE><GROUP Id="wtopprod-wag">$(res.wtopprod.config)/app/wpos</GROUP><GROUP Id="wtopprod-wzz">$(res.wtopprod.config)/app/wzz</GROUP>…

GAS（ etc/as-*.xcf ）

http://<IP Address>/b2b/b2b_wtopprod/…http://<IP Address>/b2b/b2b_wtoptest/…

http://<IP Address>/mc/mclient.htmlhttp://<IP Address>/mc/mclient-test.html

http://<IP Address>/pos/pos.html

Web Address

GAS 2.3 FrameworkGAS 2.3 Framework

Environment Framework & Environment Framework & Naming PolicyNaming Policy

Installation Structure Directory Structure, Files Naming Policy Environment Variables

Installation Structure – Web Kit Installation

The kit can be installed on a non-TIPOP host dependently Genero version installed on the B2B host should be 2.21 above Standard database is wds For details, please refer to the installation documents

Installation Structure – Web Kit Structure

Web Directory Structure

Directory Structure – Config Structure & Naming Policy

4ad: Include language-based folders to place standards and Action Default files for each program Ex. $WTOPCONFIG/4ad/0/tiptop.4ad

$WTOPCONFIG/4ad/0/wag/wagt001.4ad

4tb: Include module-based folders to place standards and ToolBar files for each program

Ex. $WTOPCONFIG/4tb/tiptop_m.4tb $WTOPCONFIG/4tb/wag/wagt001.4tb

4st : Place shared StyleList files Ex. $WTOPCONFIG/4st/tiptop.4st

Include:If the syntax &include is used to link to segments, segment files will be placed here

top.global: Shared variables top.global includes required shared variables in Web-based modules and original shared ones in TIPTOP, Add GLOBALS "../../config/top.global“ in them

Directory Structure – Config Structure & Naming Policy

App: Divide into folders by modules and application profiles (.xcf) for each program placed here; Data can be auto-generated via

[Maintain Program & Application Profiles (p_webprog)] File Naming Policy [applicationCode] + “.xcf”Ex. $WTOPCONFIG/app/wag/wagt001.xcf

tpl: Divide into a style code folder to place shared Template and Snippet files

Web Style Folder Naming Policy: [User Agent Type] + “_tpl” + Serial No

Template File Fixed Name: main.xhtmlSnippet File Naming Policy: [Widget Name].xhtml

Ex. $WTOPCONFIG/tpl/ajax_html_tpl1/main.xhtml (template) For IE$WTOPCONFIG/tpl/ajax_html_tpl1/Button.xhtml (snippet) For IE$WTOPCONFIG/tpl/ajax_tpl1/main.xhtml (template) For Firefox$WTOPCONFIG/tpl/ajax_tpl1/Button.xhtml (snippet) For Firefox

Graphics, CSS and Javascript files for each template will be placed here by foldersEx. $WTOPCONFIG/tpl/ajax_html_tpl1/css CSS files for the template

$WTOPCONFIG/tpl/ajax_html_tpl1/js Javascript files for the template

$WTOPCONFIG/tpl/ajax_html_tpl1/img Graphics files for the template

Directory Structure – Customize Config Structure & Naming Policy

4ad 、 4tb 、 app：Via ［ Program and Applicatioin Setting Maintain （ p_webprog ）］ Produce

tpl：（ Does not provide customized ,now）

Web Style Folders Naming Rule ： [User Agent Type] + “_ctpl” + 3 digits Serial numberTemplate File Fix Naming ： main.xhtmlSnippet File Naming Rule ： [Widget Name].xhtmlEx. xhtml/ajax_html_ctpl1/main.xhtml (template)

xhtml/ajax_html_ctpl1/Button.xhtml (snippet)

xhtml/ajax_ctpl1/main.xhtml (template)xhtml/ajax_ctpl1/Button.xhtml (snippet)

cust.global：Customized global Variable 。Customized Program ：

GLOBALS "../../../wtiptop/config/top.global"GLOBALS "../../config/cust.global"

Directory Structure – Standard Module Structure & Naming Policy

Web Standard Modules: WXX （ $WTOP/wxx）Naming Policy: [wxx] + Operation Type + Serial No in 3 digitsEx. $WAG/4gl/wagt001.4gl

$WAG/4fd/wagt001_1.4fd$WAG/4fd/wagt001_2.4fd

Shared programs naming policy: [swxx] + Operation Type +

Serial No in 3 digits

Directory Structure – Customized Module Structure & Naming Policy

Customized Web modules: CWXX （ $WCUST/cwxx）

Customized standard programs: Keep old namesEx. $CWAG/4gl/wagt001.4gl

$CWAG/4fd/wagt001_1.4fd$CWAG/4fd/wagt001_2.4fd

New customized programs:Naming Policy: [cwxx] + Operation Type + Serial No in 3 digitsEx. $CWAG/4gl/cwagt020.4gl

$CWAG/4fd/cwagt020_1.4fd$CWAG/4fd/cwagt020_2.4fd

Directory Structure – Shared Module Structure & Naming Policy

Shared modules （ $WTOP/wlib,lib,sub,qry）Shared modules for Web modification or additionNaming Policy: “cl_web_” + [Usage in Brief] + “.4gl” “cl_” + [Usage in Brief] + “.4gl”

“s_” + [Usage in Brief] + “.4gl” “q_” + [Table Name] + “.4gl”

Ex.$WTOP/wlib/4gl/cl_web_ui_init.4gl

TIPTOP Shared Programs: Move to shared folders in the Web structure, and keep old namesModify programs:

Definition of DATABASE ds in the initial, and modify to DATABASE wds File path with the initial GLOBALS “global File Path”,

modify to GLOBALS “../../config/top.global”

Use (Maintain Program Linkage File (p_weblink)) to register shared programs and repack 42x files42x files packed are as follows:

$WTOP/lib/42m/lib.42x$WTOP/sub/42m/sub.42x$WTOP/qry/42m/qry.42x

Directory Structure – Customized Shared Module Structure & Naming Policy

Customize shard modules （ $WCUST/cwlib,clib,csub,cqry）

Shared modules for Web modification or additionNaming Policy: “ccl_web_” + [Usage in Brief] + “.4gl” “ccl_” + [Usage in Brief] + “.4gl”

“cs_” + [Usage in Brief] + “.4gl” “cq_” + [Usage in Brief] + “.4gl”

Ex.$WCUST/cwlib/4gl/ccl_web_ui_init.4glUse old customized programs directly:Move to shared folders in the Web structure, and keep old namesModify programs:

Definition of DATABASE ds in the initial, and modify to DATABASE wds

File path with the initial GLOBALS “global File Path”,Modify to GLOBALS “../../../wtiptop/config/top.global”

Use (Maintain Program Linkage File (p_weblink)) to register or modify modules and pack 42x files with standard shared programs to the following:

$WTOP/lib/42m/lib.42x$WTOP/sub/42m/sub.42x$WTOP/qry/42m/qry.42x

Directory Structure – Work Directory & Development Tools

Tool Method Usage

r.cw r.cw program_name Edit programs, generate 42m

r.lw r.lw program_name Generate a .exe (.42r)

r.fw r.fw form_name Edit the screen file, generate 42f

r.gw r.gw form_namePreview the screen, and add the component to [Maintain Multi-Language in Screens] (p_webform) to maintain multi-language titles

r.rw r.rw program_name Running Program

exew exew program_nameSimulate web modes and run via environment variables shell

r.dw+ r.dw+ program_name Graphic-Interface Debug

r.rwd r.rwd program_name Generate SQL Log

r.sw r.sw wds Combine ds.sch with wds.sch to wds.sch

wrebuild wrebuildSelect a module or full-system editing program or screen file

Confirm the command xcf retrieved from apache > ps -ef|grep 'fastcgi' (Check if as-b2b.xcf is activated): Delete processes of as-b2b.xcf, apache will be auto-retrieved

Environment VariablesEnvironment Variables

Usage

$WTOP Web Standard Directory Path, Ex. /u1/topprod/wtiptop

$WCUST Web Customized Directory Path, Ex. /u1/topprod/wtopcust

$WTOPCONFIG Standard CONFIG Directory Path, Ex. /u1/topprod/wtiptop/config

$WCUSTCONFIGCustomized CONFIG Directory Path, Ex. /u1/topprod/wtopcust/config

$WTOOL Tools Directory Path, Ex. /u1/topprod/wtiptop/tool

$FGLDBPATH

Schema PathInstalled with TIPTOP, Ex. /u1/topprod/tiptop/shemaWeb Directory Standalone Installation, Ex. /u1/topprod/wtiptop/schema

$WAG Path of Each Module ， Ex. /u1/topprod/wtiptop/wag

$WAGi.exe File Folder Path for Each Module, Ex. /u1/topprod/wtiptop/wag/42r

$TEMPDIR Place Temporary Files

$FGLASDIR Gasd server Installation Directory

Operation DescriptionOperation Description

Web Operation DescriptionGDC Operation Description

Web Operation Description – Logging Systems & Running Programs (GAS 2.30)

Please confirm as-b2b.xcf has been retrieved by apache, the confirmation method is

> ps -ef|grep 'fastcgi'

Check if as-b2b.xcf is activated

How to re-activage: Delete process of as-b2b.xcf and apache will be auto-retrieved

Formal area address

http://<AP Server IP>/b2b/b2b_wtopprod/index.html Test area address

http://<AP Server IP>/b2b/b2b_wtoptest/index.html Standard area address

http://<AP Server IP>/b2b/b2b_wtopstd/index.html

Select to log on internally or externally from the <AP Server IP> above

GDC Operation Description – For Testing

Please install GDC version above 2.21X

Use r.rw or exew to run programs

Logon accounts will be taken as users

[Specific Database] or [Default Database]

set in [User Basic Data (p_webuser) will be used as the database

The language is the default one set in [User Basic Data (p_webuser)]

The Web module is developed for each kind of User Agent Browser,

GDC is used to check logic-based data during the developing process only

Developing Procedures for Developing Procedures for OperationsOperations

Web screens Creating Web Program Data Maintaining Web Directory Menus Creating Web Users Maintaining Web User Rights

TIPTOP Web Screen Developing Procedures

Use Genero Studio to edit 4fd

r.fw [form_name] – File extension not required

– Use 4fd, if it doesn't exist, edit per instead

Step 1 - Editing Screen Files

r.gw [form_name] [012..] [p/c] [Y/N]

– File extension not required for form_name

– The second parameter is for the language code

– The third parameter “p” refers to the screen file under the standard directory; “c” is that under the customized directory

– The fourth parameter “Y” refers to preview screen, “N” do not preview screen but add the screen component to [Maintain Screens in Multi-Language (p_webform)]

Step 2 - Preview Screen Files

Links [Maintain Screens in Multi-Language (p_webform)]

Step 3 - Maintain Screens in Multi-Language

Maintain titles on screens in multiple

languages

Maintain titles on screens in multiple

languages

Creating Web Program Creating Web Program Data Data

p_webprogp_webprog WebWebWebWeb

1. Create basic data for a program

2. Set a display style 3. Create a xcf file 4. Add rights

1. Create basic data for a program

2. Set a display style 3. Create a xcf file 4. Add rights

p_weblinkp_weblink

1. Create links for a program 1. Create links for a program

p_weblangp_weblang

1. Maintain group rights for the program

1. Maintain group rights for the program

p_webprogact

p_webprogact

1. Maintain basic data for function keys in the program & ToolBar

1. Maintain basic data for function keys in the program & ToolBar

p_webprogp_webprog

1. Create links for the program 1. Create links for the program

Links [Maintain Programs & Application Profiles (p_webprog)]

Create Program Basic Data 1 – Create Basic Data

– Add program codes

– The web code will be the same as the program code by default

– Select a module

– Select a program type (i. General program) Select a

ToolBar type 0. Not used;

1. Standard ToolBar (By the program type)

2. Customize the program (Link to “Maintain Toolbar”)

– Link to “Set Screen Settings”

– The web style for each browser

– Click [OK] to finish

Create Program Basic Data 1 – Create Basic Data

[Maintain Programs & Application Profiles (p_webprog)]

11

33

22

If no error found when running the program, go back to set basic data

Please select "Run Application via Shell" (This is mandatory for TIPTOP Web modules)

If no web style selected, the GWC default values will be applied as the Web screen layout

Press [Create xcf] to create the application profile in the folder of the program under $WTOPCONFIG/app/

To process data found in batches, press [Generate in Batches]

Link to [Maintain Program Links (p_weblink)] – Press [Maintain Links]

Create Program Basic Data 2 – Create Links

Link to [Maintain Program Links (p_weblink)]– Retrieve the basic file 42m, to add other 42m files, please access the details

– Press [Generate .exe] to auto-generate a 42r file

– If 42r cannot be generated, an error message will be popup

– Then, go back to the basic data page and press [Previous]

Create Program Basic Data 2 – Create Links

[Maintain Programs & Application Profiles (p_webprog)]– Click [Update] and link to [Maintain Functions in Multi-Languages

(p_weblang)] to enter languages for the program

– After finished, click [OK] -> [Previous] to go back to previous basic data page

Create Program Basic Data 3 – Create Program Names in Multi-

Language

11 22

33

Link to [Maintain Actions Mapped to Programs and ToolBar (p_webprogact)]

– If the type selected is 2. Customize ToolBar by Programs”, you can link to

the toolbar for entries

Create Program Basic Data 4 – Maintain ToolBar

Create Program Basic Data 4 – Maintain Functions

– After accessing, all actions will be auto-retrieved

Create Program Basic Data 4 – Maintain ToolBar

– All Action items are listed in the table on the right; to move them to the ToolBar, use the right/left arrows to put an Action into the ToolBar or remove from it

– Items on the ToolBar are listed on the right; use up/down arrows to adjust their display sequence

– After finished, click [Generate 4ad and 4tb Files], so that they can be auto-imported when activating programs

11 22

33

Create Program Basic Data 5 – Maintain Group Rights

Maintain “Set Group Rights” for programs

Create Program Basic Data 5 – Maintain Group Rights

Directory MenusDirectory Menus

Sub-Directory Directory Levels User Directories

Maintain Web Directory Menus - 1

Sub-DirectorySub-Directory

Maintain Web Directory Menus (p_webmenu)]

Maintain Directory menus and sub-menus.

Place the sub-directory under

“tiptop-web”

Place the sub-directory under

“tiptop-web”

User Directory “tiptop-web”User Directory “tiptop-web”

A Directory name must be given or it cannot be

displayed

A Directory name must be given or it cannot be

displayed

Maintain Web Directory Menus - 2

After selecting a color, press

After selecting a color, press

Maintain Web Directory Menus - 3

Creating Web Creating Web Users Users

p_zwp_zw p_zyp_zy TIPTOPTIPTOPTIPTOPTIPTOP

Add a Web right category Add a Web right category 1.Set functions and data rights available1.Set functions and data rights available

p_zxp_zx

1.Create users' basic data 1.Create users' basic data

p_zxwp_zxw

1.Create special right categories for users 1.Create special right categories for users

p_zxyp_zxy

1.Create user rights on multiple logistics 1.Create user rights on multiple logistics

Creating Web Users 1 – Creating Web Users 1 – Add Web Right CategoriesAdd Web Right Categories

[Create Program Data (p_zw)]

Creating Web Users 2 – Creating Web Users 2 – Maintain Right Categories Maintain Right Categories

[Set Execution Rights (p_zy)]

Creating Web Users 2 – Create User Basic Data

[User Basic Data (p_zx)]

Creating Web Users 4 – Create Special User Right Categories

[Set User Right Categories (p_zxw)]

Add rights for the category user_web

Creating Web Users 5 – Create User Right for Multi-Logistics [Set User Rights for Logistics (p_zxy)]

Maintain Web User Maintain Web User RightsRights

p_zwp_zw p_zyp_zy

p_webuserp_webuser

p_webauthp_webauth

p_webprogp_webprog

TIPTOPTIPTOPTIPTOPTIPTOP

WebWebWebWeb

1.Maintain right categories 1.Maintain right categories

1.When setting rights, please assign right categories, programs and databases to users.

2.Set mapped databases by functions (For Web area only)

1.When setting rights, please assign right categories, programs and databases to users.

2.Set mapped databases by functions (For Web area only)

Add programs to right categories Add programs to right categories

Maintain right categories Maintain right categories

Maintain rights on programs by categories Maintain rights on programs by categories

Maintain User Rights - Databases and Programs Default right category:

user_webDefault logistic:The same as the “default database” in the user basic data

Maintain User Rights - User Basic Data

Set specific databases (Optional): Set Specific Databases for Users

•Priority: Set specific databases > Rights Specific databases will be prior to others if the setting is done

Maintain User Rights - User Basic Data

System Management System Management

Set Overall ParametersMaintain ModulesMaintain Dynamic Pop-upsMaintain Functions in Multi-Languages

Link [Set Overall Parameters (p_webparam)] Basic settings

– Inquire if users want to delete processes in the same program:

– When activating the same program twice, if a hint about deleting programs opened last time will be shown

System Management - Set Overall Parameters

Link [Set Overall Parameters (p_webparam)] Settings about B2B

System Management - Set Overall Parameters

– Since there is no closing function provided for Web operations, after linked, processes will be ended after time out only. Setting the limit on number of processes can auto-close the number of processes specified here for each user

– Idle Processing can log out users idle for a specific time

– Set seconds to detect messages by [Seconds to Check Messages] for the function [Message] in the right corner

– Load a webpage after logon: Enter an address directly or select B2B

System Management - Maintain Modules

Link [Maintain Modules (p_webmodule)]

– This is the default value

Link ［ Dynamic Query Maintain （ p_webqry ）］– To set dynamic

popup used in the

primary programs

– Use cl_web_create_qry() to generate a popup; dynamic popup codes can be the same as those in

TIPTOP

– Use the data in Web first, if no data found, dynamic popup (p_qry) in TIPTOP

will be used instead

System Administration – Maintain Dynamic Popup

Links (Maintain Functions in Multi-Language) (p_weblang)

System Management – Maintain Functions in Multi-Language

• Entries of function titles in multiple languages

– Program Codes (wzz_file.wzz01)

– Directory Codes (wzd_file.wzd01)

– Module Codes (wzo_file.wzo01)

– Field Codes (gaq_file.gaq01)

– Message Codes (ze_file.ze01)

– Table Codes (gat_file.gat01)

• Message codes will be retrieved from the Web standard database (wds), then the TIPTOP database if no data found

Q & A