Force User to View Software License Agreement on First Startup

OO.org 2.0 and StarOffice 8

Document - ID	Specification Owner	Last Change	Status
	Frank Loehmann	18.05.04	Draft
Conforms to	
Applies to	Appwide
Task ID(s)	116803
Category	Bug Fix

Abstract

OO.org has to show the user the license agreement dialog before running a user installation when starting OpenOffice.org 2.0 for the first time for that user. This is needed due to the new native installer support and the changed installation behavior itself. The native installer do not support own license dialogs so the ones of the current system have to be used. Furthermore a user installation has to be made for every single user before starting OO.org 2.0. Therefore the license dialog of the OO.org 1.1 Setup application is reworked to meet this new situation.

i-Team Members (The specification owner is part of the i-Team)

	Name	E-mail Address
User Experience	Frank Loehmann (FL)	frank.loehmann@sun.com
Development	Lars Oppermann	lars.oppermann@sun.com
Quality Assurance	Andreas Treumann (ATR)	andreas.treumann@sun.com
Documentation	Uwe Fischer (UFI)	uwe.fischer@sun.com

Approved for Implementation

	Approved by	Date
User Experience	<Name>	<Date>
Development		
Quality Assurance		
Documentation		
String Review		

Document Change History

Rev. Level	Change	Initials	Date
1.0	First Draft	FL	13.05.04
1.1	Added comments from Uwe Fischer	FL	13.05.04
1.2	Overworked new dialog mockups (comments from MMP)	FL	13.05.04
1.3	Use "Scroll Down" instead of "Page Down"	FL	18.07.04

Contents

Glossary	1

1	Motivation	1

2	User Scenarios	1

3	Goals	1

4	Requirements and Dependencies	1

4.1	Requirements	1

4.2	Technical Dependencies	1

5	Competitive Analyses	2

5.1	OpenOffice.org 1.1	2

5.2	Current (Preliminary) Implementation in OO.org 2.0 (Pre-Alpha Build 680m36 )	5

6	Detailed Specification	7

6.1	New Startup Procedure	7

6.2	New License Dialog on First Startup (User Installation)	8

6.3	G11n	9

6.4	Error Conditions	9

7	Notes	9

8	References	9

Glossary

Term	Description
Native installer	Each single operating system offers a common way of distributing new programs the system. OO.org 2.0 uses these native installation processes a system offers. OO.org 1.1 and before were using their own installation programs.

Motivation

The new native installer feature and the user installation made for each user, requires that the license has to be accepted before doing a user installation and running OO.org 2.0 for the first time for a user.

User Scenarios

OpenOffice.org 2.0 had been installed on a Windows system. The user who installed the software was the Administrator (i.e. a the computer manufacturer). User "Timm" logs on to the new system and tries to run OO.org 2.0 from the Start menu.

The system has to create a user installation for user "Timm" first, before OO.org can run, because the install of the Administrator creates only a kind of server installation. Therefore the user has to accept the license agreement before the user installation can be made.

OO.org 2.0 uses it's own license dialog, because the user should be forced to read thru the entire license text and accept it when he at least had scrolled down the complete license text.

Goals

Please see scenario section for goal.

Requirements and Dependencies

Requirements

Show own license dialog already used for OO.org 1.1 on first startup

for each new user

to interrupt installation process

and to force user to read and agree license before installing the software

Rework license dialog design to meet the new position on startup.

Define application startup behavior to avoid unclear states on startup

Technical Dependencies

none

Competitive Analyses

OpenOffice.org 1.1

The following text in this section describes the license dialog behavior as implemented in the Setup application of OO.org 1.1:

The idea behind this dialog is to help the user with a step by step instruction.

General specification:

Active step of instruction is marked with an arrow

Please note that the arrow must be vertically mirrored in an Arabic version if VCL does not handle this.

The Print... button dumps the license file on the printer. (calls the system's print dialog). Printing the license has no effect to the license acceptance process. The user has to scroll down the license. (will be implemented until 6.1 Beta)

The button Cancel or Decline (same button, different label) exits the setup application (with current request dialog).

Step 1

Legal hint: The accept term has to be “I accept the terms of the Agreement” (with a capital “A”)

Illustration 1 Final Solution (Step 1)

Page Down button (same “label” as the page down key on the keyboard). If the user presses the button for more than on second, the page down function will automatically be repeated as long as the button is pressed.

The focus rectangle will be set to the license list box so that the user can navigate with cursor keys and page down button This focus rectangle moves to the “I accept the terms of ...” checkbox as soon as this control will be enabled (when the user has scrolled down the license text one time).

The default focus (Return key) is always on the “Next >>” button.

Page Down key on keyboard has the same functionality as the button described above

Step 2 and the “I accept...” check box will be disabled as longs as the license file hasn't been completely scrolled down one time

Cancel button changes to Decline as long as the user has not accepted the license terms

Next >> Button is disabled (to interrupt the user) as long as the user hasn't accepted the license terms

Step 2

The text “Decline” on the button (marked green in Illustration 1 Final Solution (Step 1) on page 2) will change back to Cancel

Next >> button will be enabled as soon and as long the terms have been accepted by checking the “I accept the terms of the Agreement” check box.

The Page down button will be disabled as soon and as long as the list box view has been completely scrolled down.

Decline button changes back to Cancel as soon and as long the “I accept” checkbox is checked.

Illustration 2 Final Solution (Step 2)

Final String List for current OO.org 1.1 Dialog

String	German translation	comment
Please follow these steps to proceed with the installation:	Bitte führen Sie die folgenden Schritte aus, um mit der Installation fortzufahren:	
Read the complete License Agreement. Please use the scroll bar or the 'Page Down' button in this dialog to view the entire license text.	Lesen Sie den gesamten Lizenzvertrag. Verwenden Sie die Bildlaufleiste oder die 'Bild ab' Schaltfläche in diesem Dialog um den gesamten Text sichtbar zu machen.	The German license is called: "BINÄRCODE-LIZENZVERTRAG" so we should use "Lizenzvertrag".
Accept the License Agreement.	Akzeptieren Sie den Lizenzvertrag.	
I accept the terms of the Agreement.	Ich akzeptiere die Bedingungen des Vertrags.	Eng.: Agreement must be capitalized due to legal reasons
Decline	Ablehnen	Text on the Cancel button. Please see table below for exact translation.
Page Down	Bild ab	Like the key on the keyboard

Fixed translation for Decline Button in setup:

The decline button has to be translated as written below, because it will be named in the license file.
Note for 81, 82, 86, 88 Translators: Please take the “decline” translation directly from the first paragraph of the license as pasted in the table below. I couldn't extract just the string due to language problems ;-) Please delete the text in the table below, which is not needed.

Language No.	Language Name	Translation for the Decline button
01	English-US	Decline
33	French	Refuser
34	Spanish	No Aceptar
39	Italian	Non Accetto
46	Swedish	Acceptera Inte
49	German	Ablehnen
81	Japanese	このソフトウェア製品のパッケージを開封する前に、この契約書の条項と補足ライセンス条項（以下「本契 約」といいます）をよくお読みください。ソフトウェア製品のパッケージを開封すると、本契約の条項を同 意したものとみなされます。電子的な手段でこのソフトウェアにアクセスしている場合は、本契約の末尾に ある「同意する」ボタンを選択して同意してください。これらの条項に同意できない場合は、未使用のソフ トウェアを購入店にただちに返却し、代金の払い戻しを受けてください。電子的な手段でソフトウェアにア クセスしている場合は、本契約の末尾の「同意しない」ボタンを選択してください。
82	Korean	본 소프트웨어 매체의 포장을 개봉하기 전에 본 계약서 및 별도로 제공되는 '라이센스 약정서 추록' (이하 양자를 통칭하여 "본 계약"이라고 합니다.)의 모든 조항을 자세히 읽으십시오. 사용자인 귀하(이하 "귀하") 께서 소프트웨어 매체의 포장을 개봉하면 본 계약의 모든 조항에 동의하는 것으로 간주됩니다. 귀하가 본 소프트웨어에 전자적으로 접근(Access)하고 있는 경우에는 본 계약서 문구의 최하단에 있는 "승인" 단추 (Button)를 눌러 본 계약에 대한 승인을 표시해야 합니다. 귀하께서 본 계약에 동의하지 않는다면, 본 소 프트웨어를 사용하지 않은 채로 구입처에 즉시 반환하여 환불을 받으시고, 만약 본 소프트웨어에 전자적 으로 접근하고 있는 경우에는 이 계약서 문구의 최하단에 있는 "거부" 단추를 누르십시오.
86	Chinese Simplified	请在打开本软件介质包之前，仔细阅读本协议条款以及所提供的所有补充许可条款（统称 “协议”）。打开本软件介质包，即表明您已接受本协议的条款。如果您正任以电子方式访 问本软件，则选择本协议结尾处的“接受”按钮，即表明您接受本文的条款。如果您不接 受上述任何条款，请立即将未使用的本软件退回购买处要求退款；如果以电子方式访问该 软件，则选择本协议结尾处的“拒绝”按钮。
88	Chinese Traditional	在開.本軟體媒體包裝前，請仔細.讀本合約各項條款及任何規定之補充授權條款(總稱為 「合約」)。若.開.本軟體媒體包裝，即表示.同意本合約之條款。若.以電子方式存取 本軟體，請按下於本合約結尾處的「接受」按鈕，以表明.接受各項條款。若.不同意所 有條款，請立即將未使用之本軟體退還予購買處並要求退款，或若業經以電子方式存取本 軟體，請按下本合約結尾處之「拒.」按鈕。

Current (Preliminary) Implementation in OO.org 2.0 (Pre-Alpha Build 680m36 )

The current OO.org 2.0 preliminary implementation has the be reworked, because the dialog is shown in a different context and does not meet user expectations.

The following issues have to be addressed for the final dialog design:

Accept and Decline buttons are permuted, because Decline is equal to a Cancel and Accept is equal to a OK button.

"I accept the terms of the Agreement" checkbox has to be removed, because currently the user has to accept the license two time before she can proceed.

Optical divider is missing above Accept and Decline buttons.

The startup procedure is currently not optimal (please see for new process description 6.1 New Startup Procedure on page 7 for corrected behavior):

Step: Splash is shown for a second

Step: License dialog shows up

Step: No splash is shown after accepting the license. So the user gets no feedback for about 7 seconds before OO.org user installation has been finished and the backing window shows up.

Other Known Issues:

Blinking cursor is misleading, because license could not be edited.

The arrow graphic is jumping when changing to step 2

Screenshots of Current Dialog Design (Pre-Alpha Build 680m36 )

Illustration 3 Current Dialog with Errors - step 1

Illustration 4 Current Dialog with Errors - step 2

Detailed Specification

The current license dialog and startup process of OO.org 2.0 changes as described in the following. The general specification (please see 5.1 OpenOffice.org 1.1 on page 2) forthe dialog behavior is still valid, if it is not changed in the following.

Note: Please solve the known issues stated in chapter 5.2 "Other Known Issues:" on page 6.

New Startup Procedure

Show License Dialog if no user installation is present for the current user starting OO.org.

Close dialog and abort startup process if the Decline or dialog close button is pressed in the License Agreement dialog.

Start user installation and show Splash screen simultaneously (with the build in progress indicator) after the user had accepted the terms of the license agreements by pressing the Accept button.

New License Dialog on First Startup (User Installation)

The following has changed:

The buttons are enlarged because we had problems with translations of "Accept" and "Decline" in some languages.

Text for 1) has been corrected ("read" instead "view")

Text of no. 2) is new to better fit the new situation

The known issues stated in chapter 5.2 "Other Known Issues:"

Maybe we have to make the license listbox a little bit smaller to get one extra row between the two text paragraphs. This would help the translation.

Step 1 - Initial Dialog Status

Illustration 5 New License dialog on first startup - step 1

Step 2 - Status after the user had scrolled down the entire license

Illustration 6 New license dialog on startup - step 2

String list

Only already present strings are used.

Item	English	German	Comments
Text	Read the complete License Agreement. Please use the scroll bar or the 'Scroll Down' button in this dialog to view the entire license text.	Lesen Sie den gesamten Lizenzvertrag. Verwenden Sie die Bildlaufleiste oder die 'Blättern' Schaltfläche in diesem Dialog um den gesamten Text sichtbar zu machen.	This text is left unchanged from OO.org 1.1 one. The current dialog uses a sligtly different one with view instead read. Please correct.
Text	Accept the License Agreement by pressing the button labeled "Accept"	Akzeptieren Sie den Lizenzvertrag indem Sie die "Akzeptieren" Schaltfläche betätigen.	FL->EM: Please check Eng. and Ger. because we have changed the text.
Button	~Scroll Down	~Blättern	

G11n

none

Error Conditions

none

Notes

none

References

Native Installer Specifications:

http://specs.openoffice.org/installation/native_installer/NativeInstallerPackagingSpec.sxw

http://specs.openoffice.org/installation/native_installer/networker_spec.sxw

http://specs.openoffice.org/installation/native_installer/networker2_spec.sxw

http://specs.openoffice.org/installation/native_installer/networker3_spec.sxw

http://specs.openoffice.org/installation/native_installer/WindowsInstallerGUISpec.sxw

http://specs.openoffice.org/installation/native_installer/WindowsInstallerBootstapping.sxw

Force User to View Software License Agreement on First Startup

Page 9

http://specs.openoffice.org/installation/license/license_dialog_on_first_startup.sxw

Frank Loehmann

2004-05-13T16:19:02