FactoryTalk Transaction Manager
CD Welcome Screen Requirements
Purpose
Define the requirements for the “autorun” (CD Welcome Screen) for FactoryTalk Transaction Manager.
Revision History
Date / Comments2003-07-10 / Initial pass based on meeting with Myron, Mike, Dave
2003-07-11 / Add “document” mappings; drop .Net Framework (it is included with FTAP); added title bar info; add “Note:” section for each page.
2003-07-16 / Add View Documents… to the Required Steps
2003-07-23 / Added the ‘what it does’ information; and the information on the .INI file information used to populate the “badge” and other areas of the user interface
2004-06-04 / Added discussion of patch addition, a description of the shortcut keys for the menu items, and added a number ot each menu item.
2004-06-30 / Changes per comments from Dave Babuder.
2005-11-16 / Changes for CPR 9.
2006-05-11 / Changes for CPR 9. Include Rename to FactoryTalk Transaction Manager and inclusion of how to Activate FactoryTalk Transaction Manager link (Required Steps).
2006-05-31 / Updated graphics. Integrated relative information from the Rebranding spec.
2006-05-31 / Updated graphics to reflect current Rebranding spec from Laura Schilling.
2006-07-05 / Changed to AdbeRdr708_en_US_distrib.exe.
2006-07-18 / Change log paths on the Required pages - DFCTS00085332
2006-11-17 / Change to How to Activate Rockwell Software products link directly from Required steps (launch FTACTIVATEINS_CPR9.htm) – DFCTS00087837
2007-01-04 / Updates per revisions to MR 44 (removal of Reliance and Dodge from splash screens and autorun screens)
2007-03-21 / Removed View Oracle 7.3 ReadMe from Documentation and extras page (per Brian Porter)
2007-07-11 / Changed from AdbeRdr80_en_US.exe to AdbeRdr810_en_US.exe (per Teresa King) - DFCTS00052836
2007-09.05 / Resolved DFCTS00094677 and DFCTS00094548. Updated all launch paths in sections 2.1 and 3.1.
1 Main Window
The Main window should use the standard autorun template for opening screen usage (large Data Management graphic down the left side) and contain the following:
· The main window should have a title bar. The title should be: FactoryTalk Transaction Manager Welcome Page.
· At the top of the main window, the FactoryTalk Transaction Manager product graphic and tagline (embedded graphic) should be displayed.
· On the second line, the version number and CPR number should be displayed.
For example:
9.00.00 (CPR 9)
Note: For non-release builds, the build number should also appear on the opening screen.
· At the right of the main window, a gray graphic badge should be displayed (with text overlaying the graphic). The text should update according to the cursor’s position over the main menu selections. This control should be populated using text from the associated .ini file (see section 1.5).
1.1 Main Window Selections
· Required Steps
Links to Required Steps window, see section 2.
· Documentation and Extras
Links to Documentation and Extras window, see section 3.
1.2 Font size and family
To promote consistency, the desired fonts on the first screen are as follows (see graphic above).
· Step or bullet text - Arial 11 point Bold.
· Version text - Arial 7 point Normal.
· Gray badge text - Arial 9 point Normal.
Note: For step or bullet text, the font size depends on the amount of content that has to fit on the screen. If there is a lot of text, the step or bullet font size can be reduced by one point.
1.3 Miscellaneous
If the selections on this screen must be completed in a specific sequence, each of those text elements should be listed in the appropriate order and prefaced with the appropriate step number (see graphic above). Step number should be flushed left and line up with the “T” in the FactoryTalk logo; the top margin of the numbered text should match the top margin of the gray badge.
If it is not necessary for the selections on this screen to be completed in a specific sequence, use the standard bullets provided, followed by the associated text. The text of the bullet should be flushed left and line up with the “T” in the FactoryTalk logo; the bullet should reside to the left of the text, centered top and bottom with the text that follows it.
The steps or bullets, as well as the associated text, should be clickable targets. Hovering over these elements should display the hand graphic and the elements should turn blue in color.
1.4 Other Requirements
· Buttons and menu items should both be clickable targets. Hovering over these elements should display the hand graphic and the elements should turn blue in color.
· Turn on the title bar capability.
· Remove all sounds.
1.5 Badge Text
Hover text is enabled for each menu choice. That text should appear in the gray graphic badge at the right side of the dialog. The badge text will be populated with the following information from a file (“.\data\data.ini”) located off the root of the CD image.
[Versions]
; expecting build to append this info:
; AlphaBetaBuild=0 or 1, 1 means its Alpha, and the display string should be shown on the Welcome page, 0 means hide it
; Display String is text that will be shown - versions of:
; FACTORYTALK TRANSACTION MANAGER, FTAP, IE, and Adobe
; RSSqlRev=7.05.00 (Build x)
; AlphaBetaBuild=1
; DisplayString=FactoryTalk Transaction Manager 7.05.00 (Build x), FTAP 1.07.00 (Build y), IE 6.0 SP1, Adobe 5.1
1.5.1 Badge Text When the Mouse is Not Hovering Over Menu Items
The following text must appear in the graphic badge when the mouse is not hovering over any menu item:
WelcomeDefault=Welcome to FactoryTalk Transaction Manager. Hover over any option in the list at the left for more details about that option.
1.5.2 Badge Text for Specified Menu Items
The following text must appear in the badge when the mouse is hovering over the specified menu item:
WelcomeRequired=Displays the required steps for installing this version of FactoryTalk Transaction Manager.
WelcomeOptional=Displays optional information (including the FactoryTalk Transaction Manager User's Guide and other product documentation) related to this version of FactoryTalk Transaction Manager.
1.5.3 Additional Navigation Button
Additional navigation button (placed at lower right of the dialog): Exit.
The Exit button should appear right-justified in the bottom right corner, right aligned with the right margin of the gray badge (see graphic, above).
Clicking the Exit button should exit the first screen.
2 Required Steps Window
The Required Steps window should use the standard autorun template for secondary screen usage (smaller Data Management graphic at the top and smaller product name) and contain the following:
· The main window should have a title bar. The title should be: FactoryTalk Transaction Manager Required Steps.
· At the top of the Required Steps window, the FactoryTalk Transaction Manager product graphic and tagline (embedded graphic) should be displayed.
· At the right of the Required Steps window, a gray graphic badge should be displayed (with text overlaying the graphic). The text should update according to the cursor’s position over the menu selections. This control should be populated using text from the associated .ini file (see section 2.3).
2.1 Required Steps Window Selections
1. Check Operating System
File.Run(sPath .. "RSBizWareSysCheck.exe", "", "", SW_SHOWNORMAL, false);
2. Install Microsoft Internet Explorer
File.Run(sPath .. "microsoft\\internet explorer\\IE60_SP1\\ie6setup.exe", "", "", SW_SHOWNORMAL, false);
3. View Release Note
File.Open(sPath .. "Documentation\\RSSqlrnotes.chm", "", SW_SHOWNORMAL);
NOTE: No changes necessary to support common help directory. This path is not where it gets installed on the user machine, but where it appears in the install image.
4. Install FactoryTalk™ Services Platform
File.Run (sPath .. "\\FTAP\\setup.exe", "", "", SW_SHOWNORMAL, false);
5. Install FactoryTalk™ Activation Client
File.Run (sPath .. "\\redist\\FTActivation\\FTClient\\setup.exe", "", "", SW_SHOWNORMAL, false);
6. Install FactoryTalk Transaction Manager
File.Run (sPath .. "\\install\\rssql\\setup.exe", "", "", SW_SHOWNORMAL, false);
7. View "How to Activate Rockwell Software products"
File.Open(sPath .. "Documentation\\FTACTIVATEINS_CPR9.htm", "", SW_SHOWNORMAL);
8. Check for Product Updates
File.Open(sPath .. "Patches\\Index.htm", "", SW_SHOWNORMAL);
This will launch either Update.htm (updates included) or UpdateInfo.htm (no updates), renamed to Index.htm
9. View Documentation and Extras
[link to Documents and Extras]]
2.2 Font size and family
To promote consistency, the desired fonts on the first screen are as follows (see graphic above).
· Titles - Arial 11 point Bold.
· Step or bullet text - Arial 10 point Normal.
· Gray badge text - Arial 9 point Normal.
Note: For step or bullet text, the font size depends on the amount of content that has to fit on the screen. If there is a lot of text, the step or bullet font size can be reduced by one point.
2.3 Miscellaneous
If the selections on this screen must be completed in a specific sequence, each of those text elements should be listed in the appropriate order and prefaced with the appropriate step number (see graphic above). Step number should be flushed left and line up with the “T” in the FactoryTalk logo; the top margin of the numbered text should match the top margin of the gray badge.
If it is not necessary for the selections on this screen to be completed in a specific sequence, use the standard bullets provided followed by the associated text. The left margin of the bulleted text should line up with the ‘T’ in “FactoryTalk”; the bullet should reside to the left of the text, centered top and bottom with the text that follows it.
The steps or bullets, as well as the associated text, should be clickable targets. Hovering over these elements should display the hand graphic and the elements should turn blue in color.
2.4 Other Requirements
· The steps or bullets, as well as the associated text, should be clickable targets. Hovering over these elements should display the hand graphic and the elements should turn blue in color.
· Turn on the title bar capability.
· Remove all sounds.
2.5 Badge Text
Hover text is enabled for each menu choice. That text should appear in the gray graphic badge at the right side of the dialog. The badge text will be populated with the following information from a file (“.\data\data.ini”) located off the root of the CD image.
2.5.1 Badge Text When the Mouse is Not Hovering Over Menu Items
The following text must appear in the graphic badge when the mouse is not hovering over any menu item:
RequiredDefault=This page provides you with the necessary steps and required sequence for a successful FactoryTalk Transaction Manager installation.
2.5.2 Badge Text for Specified Menu Items
The following text must appear in the graphic badge when the mouse is hovering over the specified menu item:
RequiredDefault=This page provides you with the necessary steps and required sequence for a successful FactoryTalk Transaction Manager installation.
RequiredCheckOS=Runs an executable that indicates the compatibility of your operating system and Internet Explorer versions with this version of FactoryTalk Transaction Manager.
RequiredInternetExplorer=Installs Microsoft's Internet Explorer(tm) (you must have version 6.0 or later installed to run FactoryTalk Transaction Manager).
RequiredReleaseNote=Displays the FactoryTalk Transaction Manager Release Notes that contain the latest information for this version of the software.
RequiredFTAP=Installs the Rockwell Software FactoryTalk(tm) Services Platform (required on Windows Server 2000 Server [SP4], Windows 2003 Standard Server, and Windows XP [SP2]).
RequiredFTActivation=Installs the Rockwell Software FactoryTalk(tm) Activation Client.
RequiredRSSql=Installs FactoryTalk Transaction Manager.
RequiredHowToAct= Displays information on activating Rockwell Software products.
RequiredPatch=Displays the FactoryTalk Transaction Manager Product Updates page so you can update the software (if any updates are available).
RequiredOptional=Displays the Documentation and Extras page.
2.6 Additional Navigational Buttons
The following buttons should appear at the bottom right corner, from left to right (see graphic, above).
Button / ActionHome / Returns to first screen (welcome)
Back / Returns to previous screen
Exit / Exits this screen
3 Documentation and Extras Window
The Documentation and Extras window should use the standard autorun template for secondary screen usage (smaller Data Management graphic at the top and smaller product name) and contain the following:
· The main window should have a title bar. The title should be: FactoryTalk Transaction Manager Documentation and Extras.
· At the top of the Documentation and Extras window, the FactoryTalk Transaction Manager product graphic and tagline (embedded graphic) should be displayed.
· At the right of the Documentation and Extras window, a gray graphic badge should be displayed (with text overlaying the graphic). The text should update according to the cursor’s position over the menu selections. This control should be populated using text from the associated .ini file (see section 3.3).
3.1 Documentation and Extras Window Selections
1. Install Adobe Acrobat Viewer
File.Run(sPath .. "Adobe\\AdbeRdr810_en_US.exe", "", "", SW_SHOWNORMAL, false);
2. View Release Note
File.Open(sPath .. "Documentation\\RSSqlrnotes.chm", "", SW_SHOWNORMAL);
NOTE: No changes necessary to support common help directory. This path is not where it gets installed on the user machine, but where it appears in the install image.
3. View FactoryTalk Transaction Manager User’s Guide
File.Open(sPath .. "Documentation\\RSSql Users Guide.pdf", "", SW_SHOWNORMAL);
NOTE: No changes necessary to support common help directory. This path is not where it gets installed on the user machine, but where it appears in the install image.
4. View Application Trigger Example
File.Open(sPath .. "Documentation\\extras\\extras_help.htm", "", SW_SHOWNORMAL);
5. View the FactoryTalk Administration Tool Help
File.Open(sPath .. "Documentation\\FTAdminEn.chm", "", SW_SHOWNORMAL);
6. Install the FactoryTalk LiveData Migration Tool
File.Open(sPath .. "Support\\FactoryTalk Transaction Manager Live Data Migration Tool 9.00 (CPR 9).msi", "", SW_SHOWNORMAL, false);
3.2 Font size and family
To promote consistency, the desired fonts on the first screen are as follows (see graphic above).
· Titles - Arial 11 point Bold.
· Step or bullet text - Arial 10 point Normal.
· Gray badge text - Arial 9 point Normal.
Note: For step or bullet text, the font size depends on the amount of content that has to fit on the screen. If there is a lot of text, the step or bullet font size can be reduced by one point.
3.3 Miscellaneous
If the selections on this screen must be completed in a specific sequence, each of those text elements should be listed in the appropriate order and prefaced with the appropriate step number (see graphic above). Step number should be flushed left and line up with the “T” in the FactoryTalk logo; the top margin of the numbered text should match the top margin of the gray badge.