BQE Knowledgebase



How do I set up iPhone/Android components in Web Suite?

First step is to check if the following requirements are met:

Note: We have used Web Suite 20xx in the below article. Please replace the appropriate xx with the version number that is relevant to your product installation. Users must upgrade to the latest version of Web Suite 2012 or later in order to use the mobile apps.

The following requirements must be met for the device application to connect with Web Suite:

* Web Suite 20xx version is on the latest build. (download latest patch from BQE Support)

* Web Suite 20xx is using SQL backend

* Web Suite 20xx is running and accessible via browser as Internet application

* Web Suite User ID that is being used in iPhone /Android application is also able to login to Web Suite 20xx application from the browser and has permissions to access time and expense modules

Once above conditions are met, you can proceed to troubleshoot whether the iPhone / Android component is properly installed and configured on the web server. You need to browse to the Web Suite 20xx URL with “bqoapi2” appended to it on the server computer.

For example:

http://www.mycompany.com/ws20xx/bqoapi2/bqoservice.svc

OR

http://time.mycompany.com/bqoapi2/bqoservice.svc

If the component has been set up correctly on the web server, a page titled “BQOService Service” should display. Otherwise, it will display an error, page not found or file/directory not found. In case of error, see the section below for troubleshooting:

Issue 1: iPhone application is not able to connect. When I try to go to the “bqoapi2” URL, I get this error:

ws 404 error.png

It seems that you have created a separate web site on the web server and device component is not properly configured.

Solution: Here are the steps to follow:

1. You need to connect to the server using Windows Remote Desktop Connection.

2. Login as an Administrator on the server.

3. Open the IIS Web Server by typing inetmgr command in Run Windows

4. In IIS Web Server, you need to find the site that is pointing to http://time.mycompany.com.

5. Under this site, you will have “bqoapi2” folder. Right-click on it and select 'Convert to Application' (see screen shot below).

ws bqoapi.png

Now you can try again to access the URL via browser on your server computer.

Issue 2: iPhone application is not able to connect. When I try to go to the “bqoapi2” URL I get this error message:

Server Error in '/WS20xx/bqoapi2' Application.
________________________________________

Could not find a base address that matches scheme https for the endpoint with binding WebHttpBinding. Registered base address schemes are [http].

Description: An unhandled exception occurred during the execution of the current web request. Please review the stack trace for more information about the error and where it originated in the code.

Exception Details: System.InvalidOperationException: Could not find a base address that matches scheme https for the endpoint with binding WebHttpBinding. Registered base address schemes are [http].

Source Error: An unhandled exception was generated during the execution of the current web request. Information regarding the origin and location of the exception can be identified using the exception stack trace below.

Stack Trace: [InvalidOperationException: Could not find a base address that matches scheme https for the endpoint with binding WebHttpBinding. Registered base address schemes are [http].] System.ServiceModel.ServiceHostBase.MakeAbsoluteUri(Uri relativeOrAbsoluteUri, Binding binding, UriSchemeKeyedCollection baseAddresses) +11737095 [ServiceActivationException: The service '/WS20xx/bqoapi2/BQOService.svc' cannot be activated due to an exception during compilation. The exception message is: Could not find a base address that matches scheme https for the endpoint with binding WebHttpBinding. Registered base address schemes are [http]..]

--------------------------------------------------------------

Solution: The error message indicates that SSL support is not configured on the web server. To overcome this issue, please do the following:

1. Make sure user is the latest build of Web Suite 20xx. (Always download latest version from Support.)

2. Go to the server that is hosting Web Suite 20xx.

3. Open the Windows Explorer and go to C:\Program Files\BillQuick Web Suite\Web Suite 20xx\Public\bqoapi2\

4. On Windows 2008 or Windows 7 You need to select DisableSSLBinding.bat file and right click on it and select "Run as Administrator". In some scnerios double clicking on DisableSSLBinding.bat file will work. (see screen shot).

ws bqoapi2.png

Now user should be able to use BillQuick Mobile application.

Issue 3: How do I assign a port number to Web Suite and make my device applications connect to it.

Solution: You need to configure your device component web.config file. The web.config file is under the Web Suite 20xx\public\bqoapi2\ folder.

1. Look for host in the section in web.config file. If this section is missing, you can add it under services.

2. 
Add the below section with correct baseAddress that points to Web Suite 20xx instance.

http://yourwebsite:portnumber/WS20xx/" />

If you are running SSL site then use:

https://yourwebsite:portnumber/WS20xx/" />

e.g:

ws baseaddress code.png

Issue 4: When we try to access device component on Web Suite instance via http://www.mycompany.com/ws20xx/bqoapi2/bqoservice.svc it throws a message “404.3 – Not found “ and detailed message which reads at the end as “add a MIME map”.

ws 404.3 error.png

Solution:

1. Please confirm in Windows Server 2008's Features for .NET Framework 3.0 as shown below.

ws win server 208.png

2. If it is a 64-bit machine then try running this command from

“C:\Windows\Microsoft.NET\Framework64\v3.0\Windows Communication Foundation\ServiceModelReg” –i

If it is a 32-bit machine then try running this command from

“C:\Windows\Microsoft.NET\Framework\v3.0\Windows Communication Foundation\ServiceModelReg” –i
 
ws command.png 

Steps to run the above command:

Note: Make sure to log in to server as an Administrator.

1) Select "Run" from the Start menu.

2) Enter "cmd" and click OK.

ws run command.png

3) Enter "cd c:\windows\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\" and press Enter.

4) Enter "ServiceModelReg -i" and press Enter.

Web configuration file will now be installed.



Related Articles

Attachments

No attachments were found.

Visitor Comments

Article Details

Last Updated
1st of October, 2013

Product
Web Suite

Would you like to...

Print this page  Print this page

Email this page  Email this page

Post a comment  Post a comment

 Subscribe me

Subscribe me  Add to favorites

Remove Highlighting Remove Highlighting

Edit this Article

Quick Edit

Export to PDF


User Opinions

No users have voted.

How would you rate this answer?




Thank you for rating this answer.

Continue