To have the code please mailto Muthu Kumar Mani 

# ===============================================================================
# Application/URL:  RoleStartup
# Type:   Generic
# Script Version:  1.0.0.0
# Written:  Date[yyyy/mm/dd] By Name of the Team/Person
# Last Updated:  Date[yyyy/mm/dd] By Name of the Team/Person
#
# Purpose:  This definition invokes at SSO startup and displays the role picker to
#   the end user. Then it invokes the applications set for the role that
#   they selected.
#
#   Note : For Every Application File there has to be an XML file with samename.xml
# ===============================================================================

# –Benchmark Timing: Shows time to show pick list and time to launch all applications
 Local ?TimeA
 Local ?TimeB
 Local ?TimeC
 Local ?TimeD

# — Set to ‘false’ to hide MessageBox
 Set ?ShowBenchmarkTimes “false”
 Set ?TimeA ?CurrTime(system)

#=====================
# List of Applications included
#=====================

# –Contains code to log the event
# Include “logEvent”

# –Contains definitions for all available roles
 Include “RoleDefinition”

# –Contains subs that set the application list for selected role
 Include “RoleLaunch”

#=====================
# Defining the Global Varaibles
#=====================

# –The number of selectable roles in the pick list
 Set ?SelectableRoleCount  “0″

# –The counter for role PickListAdd
 Set ?RoleIndex  “1″

# –Can set to ?RoleIndex here, but for clarity, do it later
 Set ?SelectedRole “”

# –Unless changed at runtime, launch NO scripts
 Set ?RoleApplicationCount  “0″

#=====================================================
# Repeat as many times as there are Roles
# Any over 16 causes the Repeat to break (escape)
#
# NOTE: CANNOT use variables with Repeat block must use the If-Break
#    construct with an escape case (the variable quirk problem)
#=====================================================

Repeat
# –Escape Case
 If ?RoleIndex  GT ?RoleDefCount
  Break
 EndIf

 If ?RoleIndex  EQ “1″
  # –if there is a role 1, add the prompt for it
  PickListAdd ?RoleDefPrompt_1 ”1″
 Else  
  If ?RoleIndex  EQ “2″
   # –if there is a role 2, add the prompt for it
   PickListAdd ?RoleDefPrompt_2 ”2″
  Else  
    PickListAdd ?RoleDefPrompt_3 ”3″
   Else  

    If ?RoleIndex  EQ “4″
     PickListAdd ?RoleDefPrompt_4 ”4″
    Else  

     If ?RoleIndex  EQ “5″
      PickListAdd ?RoleDefPrompt_5 ”5″
     Else  
      # throw away any over 17
      Break

    EndIf
   EndIf
  EndIf
 EndIf

Increment ?RoleIndex

EndRepeat

#=====================================================
# If more than one possible role then let the user pick one, otherwise we will
# use the first one we added to the list.
#=====================================================

# –Benchmark Timing
 Set ?TimeB ?CurrTime(system)

If ?RoleDefCount GT 1
 # –more than one case, show role picker
 PickListDisplay  ?SelectedRole  “Please SELECT your role.” -NoEdit
Else
 If ?RoleDefCount LT 1
  # –no roles defined case, quit
  EndScript
 Else
  # –one role defined case
  Set ?SelectedRole “1″
 EndIf
EndIf

# –Benchmark Timing
 Set ?TimeC ?CurrTime(system)

#======================================
# Call the sub for each role if that role was selected
#======================================

If ?SelectedRole  EQ “1″
 # –if role one was selected, set the application variables for the LaunchProgram part
 Call “RoleLaunch1″
Else
 If ?SelectedRole  EQ “2″
  # –if role two was selected…
  Call “RoleLaunch2″
 Else
  If ?SelectedRole  EQ “3″
   Call “RoleLaunch3″
  Else
   If ?SelectedRole  EQ “4″
    Call “RoleLaunch4″
   Else
    If ?SelectedRole  EQ “5″
     Call “RoleLaunch5″
    Else
     # –this should never be invoked
     EndScript
    EndIf
   EndIf
  EndIf
 EndIf
EndIf

#=========================================
# Lanuching the Applications based on the Role Selected
#=========================================

 Include “RoleProgramLauncher”

#========================================
# Wait for applications to respond to the run command
# or they will pop back up after Minimize All
#========================================

# –Benchmark Timing
 Set ?TimeD ?CurrTime(system)

# –Wait 1 second for each application launched
 Multiply 1000 ?RoleApplicationCount ?WaitToMinimize
 Delay ?WaitToMinimize

# –Press the Windows key and ‘d’
# Type \LWin+\|68

# –ShowBenchmarkTimes
If ?ShowBenchmarkTimes EQ “true”
 Local ?PickListTime
 Local ?ApplicationLaunchTime

 # –Get difference
 Subtract ?TimeB ?TimeA ?PickListTime
 Subtract ?TimeD ?TimeC ?ApplicationLaunchTime

 # –Show
 MessageBox “Time to show picklist: ” ?PickListTime ” second(s)    –” ?RoleDefCount ” role(s) shown”
 MessageBox “Time to launch applications: ” ?ApplicationLaunchTime  ” second(s)    –” ?RoleApplicationCount ” application(s) launched”
EndIf
EndScript

To have the code please mailto Muthu Kumar Mani

To have the code please mailto Muthu Kumar Mani

# =================================================================
# Application/URL:  RoleLaunch
# Type:   Generic
# Script Version:  2.0.0.0
# Written:  Date By Name of the Team/Person
# Last Updated:  Date[yyyy/mm/dd] By Name of the Team/Person
#
# Purpose:  This definition is included in RoleStartup. RoleStartup calls the appropriate RoleLaunch sub for whatever role
#   is selected by the user.
#
#   Note: It is not necessary to maintain all 5 subroutines. You must, however, have as many as roles are defined.
#   Note : For Every Application File there has to be an XML file with samename.xml
# =================================================================

# –NOTE: code is currently limited to 5 roles
# –NOTE: code is currently limited to 16 applications per role

#=====================================
#  Subroutine for invoking Each Application in Role1
#=====================================

Sub RoleLaunch1

# –Number of applications you want to launch (very important)
 Set ?RoleApplicationCount  “1″

# –Applications to launch

# Set ?RoleLaunchTitle  Name of application (for log)
# Set ?RoleLaunchRun_x  Name of executable to call
# Set ?RoleLaunchArguments_x  Any arguments that need to be passed to the application
# Set ?RoleLaunchDelay_x   delay in milliseconds to wait before launching

 Set ?RoleLaunchTitle  ”PPMWeb”
 Set ?RoleLaunchRun_1  ”C:\Program Files\Internet Explorer\iexplore.exe”
 Set ?RoleLaunchArguments_1  ”http://dev-ppmtrac“ 
 Set ?RoleLaunchDelay_1   ”0″

 Set ?RoleLaunchTitle  ”PPMWeb”
 Set ?RoleLaunchRun_2  ”C:\Program Files\Internet Explorer\iexplore.exe”
 Set ?RoleLaunchArguments_2  ”http://dev-ppmtrac“ 
 Set ?RoleLaunchDelay_2   ”0″
EndSub

#=====================================
#  Subroutine for invoking Each Application in Role2
#=====================================

Sub RoleLaunch2

# –Number of applications you want to launch (very important)
 Set ?RoleApplicationCount  “2″

# –Applications to launch (see Sub RoleLaunch1 for convention)

 Set ?RoleLaunchTitle  ”Lotus Notes 6.5″
 Set ?RoleLaunchRun_1  ”C:\Notes\notes.exe”
 Set ?RoleLaunchArguments_1  ”"
 Set ?RoleLaunchDelay_1   ”0″
 
 Set ?RoleLaunchTitle  ”Google Talk”
 Set ?RoleLaunchRun_2  ”C:\Program Files\Google\Google Talk\googletalk.exe”
 Set ?RoleLaunchArguments_2  ”"
 Set ?RoleLaunchDelay_2   ”0″

EndSub

#=====================================
#  Subroutine for invoking Each Application in Role3
#=====================================

Sub RoleLaunch3

# –Number of applications you want to launch (very important)
 Set ?RoleApplicationCount  “2″

# –Applications to launch (see Sub RoleLaunch1 for convention)

 Set ?RoleLaunchTitle  ”Lotus Notes 6.5″
 Set ?RoleLaunchRun_1  ”C:\Notes\notes.exe”
 Set ?RoleLaunchArguments_1  ”"
 Set ?RoleLaunchDelay_1   ”0″
 
 Set ?RoleLaunchTitle  ”Google Talk”
 Set ?RoleLaunchRun_2  ”C:\Program Files\Google\Google Talk\googletalk.exe”
 Set ?RoleLaunchArguments_2  ”"
 Set ?RoleLaunchDelay_2   ”0″

EndSub

#=====================================
#  Subroutine for invoking Each Application in Role4
#=====================================

Sub RoleLaunch4

# –Number of applications you want to launch (very important)
 Set ?RoleApplicationCount  “2″

# –Applications to launch (see Sub RoleLaunch1 for convention)

 Set ?RoleLaunchTitle  ”Lotus Notes 6.5″
 Set ?RoleLaunchRun_1  ”C:\Notes\notes.exe”
 Set ?RoleLaunchArguments_1  ”"
 Set ?RoleLaunchDelay_1   ”0″
 
 Set ?RoleLaunchTitle  ”Google Talk”
 Set ?RoleLaunchRun_2  ”C:\Program Files\Google\Google Talk\googletalk.exe”
 Set ?RoleLaunchArguments_2  ”"
 Set ?RoleLaunchDelay_2   ”0″

EndSub

#=====================================
#  Subroutine for invoking Each Application in Role5
#=====================================

Sub RoleLaunch5

# –Number of applications you want to launch (very important)
 Set ?RoleApplicationCount  “2″

# –Applications to launch (see Sub RoleLaunch1 for convention)

 Set ?RoleLaunchTitle  ”Lotus Notes 6.5″
 Set ?RoleLaunchRun_1  ”C:\Notes\notes.exe”
 Set ?RoleLaunchArguments_1  ”"
 Set ?RoleLaunchDelay_1   ”0″
 
 Set ?RoleLaunchTitle  ”Google Talk”
 Set ?RoleLaunchRun_2  ”C:\Program Files\Google\Google Talk\googletalk.exe”
 Set ?RoleLaunchArguments_2  ”"
 Set ?RoleLaunchDelay_2   ”0″

EndSub

To have the code please mailto Muthu Kumar Mani

Scope

The goal of this document is to provide guidelines on how to build, not code, an SSO script.

Comments

1. A header at the top of the document should specify the Application name that the script is going to interact with,
2. The file path to launch the Application or the URL, of a website or a Web Application.
3. This header should also provide the name of the script Author and the last modified date.
4. More information could be added but those are the basic four pieces of information that should be in every script.
5. Code blocks such as Dialog/Endialog, Site/Endsite and Sub/Endsub should also have a header describing what it what it does.
6. Most code should not need comments, however sometimes when there is some non-standard code then comments would be useful.

Variables and Sub-Procedure Naming

1. Variable names should be meaningful as to describe what kind of data is contained within.
2. Avoid using abbreviations – DepartmentLocation is easier to understand then DeptLoc.
3. The same applies to Sub-procedure naming; it should describe what it does.

The one plus four blocks

As a guideline, and for most scripts, we should have one block of comments at the top,

which I refer to above, and four other blocks these are:
-  Login
-  Detect incorrect login
-  Re-login
-  Password change

Think of these as event handlers, and these are the things that we want SSO to handle. There could be more or there could be less. For windows applications the re-login event handler may not be needed. For an application that the agent may have more then one login (representing different roles) we may need another block that would handle the role selection.

Additionally

These are guidelines and bound to change as we move along. If you have any comments please contact jose.f.martins@convergys.com and cc to yogesh.balodi@convergys.com