Time Bank Online System/Browser Requirements

Integrated Design, Inc.

Time Bank Online

System/Browser Requirements

March 27, 2017 ii

March 2017

Copyright © 2017 Integrated Design, Incorporated

Printed in the U.S.A.

All rights reserved. Reproduction in whole or part by mechanical, electronic, or any other means requires permission in

writing from Integrated Design, Incorporated, 3768 Plaza Drive, Ann Arbor, Michigan 48108.

Time Bank is a trademark of Integrated Design, Inc.

Time Bank Online

System/Browser Requirements

March 27, 2017 iii

Table of Contents 1 Introduction ................................................................................................................................................ 1 2 System Settings/Requirements ................................................................................................................... 1 3 Supported Browsers ................................................................................................................................... 1 Browser Settings ........................................................................................................................................... 2

3.1 Internet Explorer ................................................................................................................................. 2 3.1.1 Trusted site ................................................................................................................................... 2 3.1.2 Security ........................................................................................................................................ 3 3.1.3 Compatibility Mode ..................................................................................................................... 4 3.1.4 Allow pop-ups .............................................................................................................................. 4

3.2 Edge .................................................................................................................................................... 5 3.2.1 Security Settings .......................................................................................................................... 5 3.2.2 Allow pop-ups .............................................................................................................................. 6

3.3 Firefox ................................................................................................................................................. 7 3.3.1 Extension ...................................................................................................................................... 7 3.3.2 Allow Pop-ups ............................................................................................................................. 8

4 Troubleshooting ......................................................................................................................................... 8 4.1 Time Bank hangs on the read/write operation .................................................................................... 8 4.2 Error communicating with host........................................................................................................... 8 4.3 Incorrect Screen upon login ................................................................................................................ 9 4.4 The '' action(Request.Query.String[‘wa’]) is unexpected ................................................................... 9 4.5 Cannot continue. The application is improperly formatted. ............................................................... 9 4.6 Firefox “Cannot Start Application” .................................................................................................. 10 4.7 Other Errors ...................................................................................................................................... 10

Time Bank Online

System/Browser Requirements

March 27, 2017 1

1 Introduction Time Bank Online requires access to your local PC to read and write files. The ClickOnce application is

used to provide the ability to read and write data. Your browser must have a supported ClickOnce

application.

2 System Settings/Requirements Time Bank Online requires the following software:

Microsoft .NET Framework 4.6.1 (required for the ClickOnce application). Note: .NET

Framework 4.6.1 is not supported on Windows XP. If your system does not have this software,

please contact your IT department to get it loaded.

Click Once: A request to install occurs when Time Bank Online has a link that reads/writes a file

in the local environment. This may require any firewall or virus checker is setup to allow:

o TBClient.exe

o https://www.timebankonline.com/TBCFGWEB/TBRTService.svc

Please forward this email to your IT staff so they can determine if virus or firewall changes are

needed.

3 Supported Browsers Internet Explorer 11+

Edge

Firefox

Time Bank Online

System/Browser Requirements

March 27, 2017 2

4 Browser Settings

4.1 Internet Explorer

4.1.1 Trusted site On the security tab, select Trusted Sites, then select Sites. The Time Bank Online web site,

https://www.timebankonline.com/, must be marked as a trusted site:

Time Bank Online

System/Browser Requirements

March 27, 2017 3

4.1.2 Security

The Security level for trusted sites must be set to Medium-low:

Time Bank Online

System/Browser Requirements

March 27, 2017 4

4.1.3 Compatibility Mode

The new Silverlight Free Time Bank Online requires Compatibility View to be turned off. If you are

connecting to Time Bank Online with Internet Explorer, turn off Compatibility View.

1. Open Internet Explorer

2. Select Tools -> Compatibility View settings or select -> Compatibility View settings

3. If timebankonline.com appears in the “Websites you’ve added to Compatibility View:” section

a. Select timebankonline.com

b. Select Remove.

4.1.4 Allow pop-ups

Time Bank Online

System/Browser Requirements

March 27, 2017 5

4.2 Edge

4.2.1 Security Settings To access the Microsoft Edge Security settings, Press Windows key + R and type ‘inetcpl.cpl’ and press

Enter or go to Control Panel -> Network and Internet -> Internet Options. This will launch the Internet

options to manage trusted sites. Select the Security tab to access the security settings.

4.2.1.1 Trusted site

The Time Bank Online web site, https://www.timebankonline.com/, must be marked as a trusted site:

Time Bank Online

System/Browser Requirements

March 27, 2017 6

4.2.1.2 Security

The Security level for trusted sites must be set to Medium-low:

4.2.2 Allow pop-ups

Time Bank Online

System/Browser Requirements

March 27, 2017 7

4.3 Firefox

4.3.1 Extension With Firefox, the FxClickOnce extension is needed.

1. Install the extension/add-on using the following link:

https://addons.mozilla.org/en-US/firefox/addon/fxclickonce/?src=search

a. Select “Add to Firefox”

b. Once installed, FxClickOnce will show up under the Firefox Extensions:

2. Note, when running with Firefox, the FxClickOnce popup will always require permission to run.

On each read/write from your local system, it is necessary to select “ClickOnceInstall”. “Save

File” will result in errors.

Time Bank Online

System/Browser Requirements

March 27, 2017 8

4.3.2 Allow Pop-ups

1. Open Options window

2. Select Content tab.

3. Select “Exceptions” tab next to “Block pop-up windows”.

4. Enter https://www.timebankonline.com.

5 Troubleshooting

5.1 Time Bank hangs on the read/write operation Time Bank uses the ClickOnce application to read files from/write files to the local environment. When

the read fails, it is typically due to the click once application not being able to run.

Verify browser settings in sections above.

Verify pop-up blockers are turned off.

Verify .Net Framework 4.6.1 is installed.

If the above options do not resolve your issue, work with the client’s IT department to determine what is

blocking the ClickOnce software (TBClient.exe) from running. This application gets downloaded and run

from the local environment during a read/write process. Things to check:

- Check event log

- verify they can get to the service:

https://www.timebankonline.com/TBCFGWEB/TBRTService.svc

- firewall

- virus checker

5.2 Error communicating with host

The “Error communicating with host” message can be the result of different issues. To resolve this issue:

Verify the software did not time out. Log in and run again.

Verify .Net Framework 4.6.1 is installed.

For IE, verify the settings in sections 4.1.1, 4.1.2 and 4.1.4

If the above options do not resolve your issue, work with the client’s IT department to determine

what is blocking the software from running.

The ClickOnce application will not run, if the PC time is not within a minute or 2 of the hosted

server time (time zone independent). In Time Bank Online you would notice the run time does

not match the PC time. Update the PC time to reflect the correct actual time.

If the above options do not resolve your issue, work with the client’s IT department to determine what

is blocking the ClickOnce software (TBClient.exe) from running.

- Check event log

- verify they can get to the service:

https://www.timebankonline.com/TBCFGWEB/TBRTService.svc

- firewall

- virus checker

Time Bank Online

System/Browser Requirements

March 27, 2017 9

5.3 Incorrect Screen upon login After login, if the tabs are displayed as a list, Compatibility View must be turned off. The new Silverlight

Free Time Bank Online requires Compatibility View to be turned off. If you are connecting to Time Bank

Online with Internet Explorer, turn off Compatibility View (see section 4.1.3 above).

5.4 The '' action(Request.Query.String[‘wa’]) is unexpected The Full error message is:

Integrated Design - Secure Login Web Site

The action '' (Request.QueryString['wa']) is unexpected. Expected actions are: 'wsignin1.0' or 'wsignout1.0'.

The resolution is to make sure you are logging in with the following link:

https://www.timebankonline.com/TBCFGWEB/

5.5 Cannot continue. The application is improperly

formatted.

Verify .Net Framework 4.6.1 is installed.

Time Bank Online

System/Browser Requirements

March 27, 2017 10

5.6 Firefox “Cannot Start Application”

When running with the Firefox, the FxClickOnce popup will always require permission to run. On each

read/write from your local system, it is necessary to select “ClickOnceInstall”. “Save File” will result in

the “Cannot Start Application” error.

5.7 Other Errors 1. Verify browser settings

2. The client must work with their IT to determine what is preventing the software from running.