Friday, 08-Sep-2006 00:17:14 EEST    

Frequently Asked Questions (FAQ)

Commercial
 How much does Smilehouse Workspace Commercial version cost?
Where can I buy commercial version of Smilehouse Workspace?
Can I use free Workspace Developer Edition to build commercial end-user service for some 3rd party if they acquire commercial licence?
I am a teacher in a school, can I use Workspace Developer Edition for educational purposes?
 
General Information
 How do I get the latest version of this FAQ?
What is Java 2 Standard Edition (J2SE)?
What is a Java Application Server?
What is Tomcat?
What is MySQL?
What are server software requirements for Workspace Developer Edition installation?
Which operating systems are supported?
Which hardware is recommended?
Where do I get information about known bugs?
What's the difference between Standard Edition and Developer Edition?
I can't download Workspace Developer Edition from link received in e-mail?
 
Payments
 What payment methods does Workspace Developer Edition support?
Why Luottokunta credit card payment requires Workspace Developer Edition v1.0.2 or higher to work properly?
Why Order Manager's payment check function doesn't confirm payments, which have been paid in bank?
Why order's payment status is not "Paid", if customer has completed payment process successfully in bank?
Why older versions of Workspace will not support Sampo payment after 21.9.2004 any more?
How to create shop without payment methods
 
Technical
 Can I use other Database than MySQL that you recommend in your website?
Can I use DB2 database?
Do I need J2EE application server?
I could not find any manual or installation instructions from installation package, where can I find it?
What has to be done before installation of Workspace Developer Edition?
How do I start the Installation of Workspace Developer Edition?
How can I access my shop's Administration?
I already have Workspace installed. How do I upgrade it to a newer version?
Why my Workspace performance suffers under high user loads?
I couldn't add a new product group under the existing group in product management, What wrong with my Workspace?
Special characters are not displayed correctly. Whats wrong?
What are the recommendations for J2SE and Tomcat?
Why do I get a message, that Internet Explorer was unable to open the site, when I'm trying to download a CSV-file
When upgrading to a new version, Installer throws OutOfMemoryError!
 
Use cases
 With Workspace, can I build a Webshop with product catalog, shopping basket, multiple payment options and personal site design?
With Workspace, can I build an Extranet ordering system with authentication and customer database?
With Workspace, can I build a plain multilevel product catalog?
Is there an open interface where I can build integrations to local payment gateway?
How can I integrate an e-commerce solution built with Workspace to back-end systems (ERP, Financial, CRM)?
Is there an open interface where I can build integration to my custom made supply chain management solution?
 

  


Commercial

How much does Smilehouse Workspace Commercial version cost?
Answer:Workspace Small Business: 950 eur.
Workspace Standard: 6.000 eur.

Workspace Enterprise: from 15.000 eur
Workspace Operator: from 1.500 eur

22% VAT will be added.

You can find detailed pricing information from: http://www.smilehouse.com/pricelist.shtml


Where can I buy commercial version of Smilehouse Workspace?
Answer:By contacting sales@smilehouse.com or from our webshop http://shop.smilehouse.com


Can I use free Workspace Developer Edition to build commercial end-user service for some 3rd party if they acquire commercial licence?
Answer:Yes, you can. You can use Developer Edition to build a webshop but without a commercial lisence you are not allowed to publish it.


I am a teacher in a school, can I use Workspace Developer Edition for educational purposes?
Answer:It is not allowd to use Workspace Developer Edition for educational purposes. We have a separate pricing for schools. Please contact sales@smilehouse.com



  

General Information

How do I get the latest version of this FAQ?
Answer:Latest FAQ can be found on our website. http://workspace.smilehouse.com


What is Java 2 Standard Edition (J2SE)?
Answer:J2SE is Sun's Java programming platform, aimed at network oriented enterprise applications. J2SE comprises the Java 2 Software Development Kit (SDK) and Java 2 Run-time Environment. Get the J2SE from http://java.sun.com/j2se


What is a Java Application Server?
Answer:Java application server is a sophisticated software system that provides a runtime environment for executing components written in Java.


What is Tomcat?
Answer:Tomcat is the free, open-source implemenation of Java Servlet and JavaServer technologies developed under the Jakarta project at the Apache Software Foundation. Get the latest version of tomcat http://jakarta.apache.org/tomcat


What is MySQL?
Answer: MySQL is database server, available for free under the GNU General Public License Get the latest version of MySQL from http://www.mysql.com


What are server software requirements for Workspace Developer Edition installation?
Answer:Requirements:
  • Apache Tomcat 4
  • J2SE (JDK 1.4.X)
  • For SSL support JSSE 1.0.2 or higher need to be installed
  • MySQL 3 or higher.


Which operating systems are supported?
Answer:Following operating systems are supported:
  • Linux
  • BSD,
  • Windows NT/2k/XP
  • Solaris
  • Mac OS X.


Which hardware is recommended?
Answer:For example: Intel/AMD 500 MHz processor, 256 MB of RAM memory, 100 MB of hard disk space.
For high loads, high availability and fault tolerance, more sophisticated infrastructure recommended.


Where do I get information about known bugs?
Answer:We have listed information about bugs at 'known bugs' section at our website. http://workspace.smilehouse.com


What's the difference between Standard Edition and Developer Edition?
Answer:Standard Edition is the commercial version of the Workspace software. Developer Edition is free, but can only be used for non-commercial and non-educational purposes.


I can't download Workspace Developer Edition from link received in e-mail?
Answer:Notice, that link you receive in e-mail, can be used only once. If you're trying to download from link twice, link has been already expired and page with further instructions displayed. Fill the register form, to get new download link. If you have already registered, you only have to insert your email address to get the download site address for the latest version.
When you get download link into your e-mail, left-click on it. Before download, you have to accept SOFTWARE LICENSE AGREEMENT displayed. Do not try to save link with "Save As" -method. This will cause download to fail and link will expire.
If you have problems with registration or download, please contact: workspace.support@smilehouse.com



  

Payments

What payment methods does Workspace Developer Edition support?
Answer:Workspace Developer Edition v1.1 supports now 7 different finnish payment methods:
  1. Invoice
  2. Cash on delivery payment
  3. Nordea
  4. Sampo
  5. Osuuspankki
  6. Sp/pop
  7. Luottokunta credit card payment system
4 primary Estonian payment methods:
  1. U-POS
  2. Hanza.net
  3. Sampo
  4. Krediidipank
and 2 international credit card payments:
  1. ITransact
  2. PayPal
For earlier versions of Workspace Developer Edition check the manual to see which payments supported.


Why Luottokunta credit card payment requires Workspace Developer Edition v1.0.2 or higher to work properly?
Answer:Luottokunta payment services has been updated by Luottokunta in fall 2003. Improvments has been made and payment is now more secure as "Verified by Visa" -service is available for Luottokunta members. Also Visa Electron credit card payments now supported.
URL into Luottokunta payment form has been changed and old URL stops working in 5.9.2003. Luottokunta's own administration URL has been changed as well. New administration URL is https://dmp.luottokunta.fi.
In order to use Luottokunta credit card payment, you have to upgrade into Workspace Developer Edition v.1.0.2 or higher.


Why Order Manager's payment check function doesn't confirm payments, which have been paid in bank?
Answer:In case bank supports payment checking function,like Osuuspankki and Nordea do, you may have to open account for payment check in bank. Without payment check account this function doesn't work properly. For more information about payment checking, contact bank's helpdesk.


Why order's payment status is not "Paid", if customer has completed payment process successfully in bank?
Answer:One main reason why Workspace Order Manager is unable to confirm order - payment status is set to "no status" - is that customer hasn't returned from bank to merchant service or shop, after completing payment process in bank. Order Manager has no way to know, if payment process was successful in case customer for example closes the browser after finishing the payment process in bank. Some banks will automatically redirect customers back to merchant service, but if not, customers have to hit the "Return to merchant's service" -button.


Why older versions of Workspace will not support Sampo payment after 21.9.2004 any more?
Answer:Due to Sampo payment system update, v1.2.3 does not support Sampo payment until 23.8.2004. Older versions of Workspace should be upgraded to version 1.2.3 not later than 21.9.2004. After 21.9.2004 previous versions of Workspace will not support Sampo payment any more.


How to create shop without payment methods
Answer:It's quite difficult to do a shop without a payment method, because payment is mandatory in Workspace and you can't do an order without it. But you can mask it.

This example shows how to change the payment method to a "Gender" question

  1. Remove the delivery cost question
    Customers -> Settings -> Customers questions
  2. Change payment method question name to "Gender"
  3. Delete all payments methods
    Payments -> Payments -> General
  4. Add two custom payment methods
  5. Name those "male" and "female"
  6. Add "Intra/Extra" checkboxes
  7. Clear "Display price at payment method menu" and "Display VAT at payment method menu" checkboxes



  

Technical

Can I use other Database than MySQL that you recommend in your website?
Answer:MySQL http://www.mysql.com is strongly recommended DBMS in Beta stage. Other DBMS are untested. We welcome reports of your experiences with other DBMS and systems.


Can I use DB2 database?
Answer:You can use DB2 database, because DB2 is JDBC-compatible. However systems reliability with DB2 database haven't been tested.


Do I need J2EE application server?
Answer:No. You need Java 2 Platform, Standard Edition (J2SE) 1.3.1. J2EE is not necessary. You can get J2SE from http://java.sun.com/j2se


I could not find any manual or installation instructions from installation package, where can I find it?
Answer:All manuals and installation instructions can be found on our website http://workspace.smilehouse.com


What has to be done before installation of Workspace Developer Edition?
Answer:Before you can start installing Workspace you should have a running version of the Tomcat servlet container version 4, http://jakarta.apache.org/tomcat and a JDBC-compatible database installed. MySQL http://www.mysql.com is recommended DBMS because it was used during the development of the software. You should also have a JDBC-driver for your database. You can download a driver for MySQL from http://www.mysql.com/downloads/api-jdbc.html. Be prepared to give the usual JDBC parameters such as host, port and database username and password during the Workspace installation (see the installation questions-section below).

The server should support the use of Java AWT libraries if you want to access the application's statistics graphs. For example, in a Unix/linux server with no X server the support could be provided with some X server emulator such as Xvfb.


How do I start the Installation of Workspace Developer Edition?
Answer:When you run the installer, make sure that you have writing rights to the directories where the files are installed (mainly under the Tomcat home directory) and you have your JDBC driver on the classpath. Start the installer from the command line by running the installation script (install.sh unix/linux or install.bat on Windows) from the directory where they are located. You should have JAVA_HOME environment variable set up correctly.


How can I access my shop's Administration?
Answer:After completeing installation, start (or re-start) your Tomcat and Workspace administration will be available at
http://www.yourcompany.com:8180/workspace.admin/Login
(if your Tomcat is located at http://www.yourcompany.com:8180/)
By default the login name is 'user' and password is 'password'. After logging in you should change these from the System module.


I already have Workspace installed. How do I upgrade it to a newer version?
Answer:Run the installer just like when installing for the first time.


Why my Workspace performance suffers under high user loads?
Answer:You can increase your Workspace performance by setting up CATALINA_OPTS environment variable for Tomcat 4, with value like CATALINA_OPTS="-Xmx256MB".
This will specify how much memory the Java Virtual Machine will use. In this example we gave 256 MB memory for JVM to use, but amount of memory should be set of course according to amount of your server's physical RAM. The default value for this parameter is 64 MB.


I couldn't add a new product group under the existing group in product management, What wrong with my Workspace?
Answer:This is caused by set of MySQL connector drivers, which is not compatible with Workspace and can cause some malfunctioning in other parts of Workspace as well. Try a different version of drivers. We recommend version 2.0.14, which you can download from http://www.mysql.com/downloads/api-jdbc-old.html


Special characters are not displayed correctly. Whats wrong?
Answer:Workspace is using UTF-8 charset encoding. You have to configure your tomcat server by adding following line into tomcat configuration file:
LANG=en_US.UTF-8. Your operating system's locales must contain the same charset. For more information, contact your operating system's manual about setting up locales.


What are the recommendations for J2SE and Tomcat?
Answer:If using J2SE 1.4 or higher, Tomcat 4 CoyoteConnector is recommended. Workspace can be unstable with IE 5.5, if other Tomcat Connectors used. CoyoteConnector is not optimized for older versions of J2SE. For older versions of J2SE, CatalinaConnector recommended.


Why do I get a message, that Internet Explorer was unable to open the site, when I'm trying to download a CSV-file
Answer:You get the message, when trying to download CSV-file with Internet Explorer (IE) over Secure Sockets Layer (SSL).
The problem occurs if the server is using SSL and has added one or both of the following HTTP headers to the response message:
- Pragma: no-cache
- Cache-control: no-cache,max-age=0,must-revalidate

In order for Internet Explorer to open documents in Office (or any out-of-process, ActiveX document server), Internet Explorer must save the file to the local cache directory and ask the associated application to load the file. If the file is not stored to disk, this operation fails. When Internet Explorer communicates with Web server through SSL, Internet Explorer enforces any no-cache request. If the header or headers are present, Internet Explorer does not cache the file. Consequently, CSV-file cannot be downloaded.

To resolve this problem, contact Microsoft Product Support Services to obtain the fix - http://support.microsoft.com/default.aspx?kbid=323308

Related issues:is duplicated by WS-16


When upgrading to a new version, Installer throws OutOfMemoryError!
Answer:Try adding -Xmx512M (or preferred memory value) to last row of install.sh or install.bat, for example: $JAVA_HOME/bin/java -cp $CLASSPATH -Dterminal.lines=$ROWS -Dterminal.columns=$COLUMNS -Dcatalina.home=$CATALINA_HOME smilehouse.workspace.installer2.Installer en ISO-8859-1 $1



  

Use cases

With Workspace, can I build a Webshop with product catalog, shopping basket, multiple payment options and personal site design?
Answer:Yes.

Smilehouse Workspace includes all the basic features needed to build e-commerce solutions.

With Workspace Visual module you can easily and quickly build a webshop with custom design. Product module provides you tools for managing product groups and product information. Different payment systems are available, and through Payment Gateway you can define which ones are in use for customers.


With Workspace, can I build an Extranet ordering system with authentication and customer database?
Answer:Yes.

Smilehouse Workspace includes all the required features for b-to-b e-commerce.

Workspace Visual module provides efficient tools for building authenticated services targeted only for registered customers. All data about customers is accessible through Customer Manager module.

You can build 7 different shop outlooks (themes) for different customer groups. Each theme can have different products visible for certain customer groups only.


With Workspace, can I build a plain multilevel product catalog?
Answer:Yes.

With Workspace you can create product catalogs of many different product groups and product levels. If You choose, you do not need to enable shopping cart features.


Is there an open interface where I can build integrations to local payment gateway?
Answer:At this time there is no open interface for adding new payment gateways.

However if there is a certain payment gateway / payment processor you would like us to add to Workspace, please contact workspace.support@smilehouse.com


How can I integrate an e-commerce solution built with Workspace to back-end systems (ERP, Financial, CRM)?
Answer:To integrate Smilehouse Workspace to other applications, you basically have two options.

1) For easy integration, we encourage you to use OpenSyncro data integration middleware. It includes ready-made interface to Workspace and enables building integrations easily. Read more: http://www.opensyncro.com/

2) Or if You prefer using any other integration toolkit, you can connect it to the built in WebServices API that is included in Smilehouse Workspace. You can download Workspace WebServices API from the download section: http://workspace.smilehouse.com/download.shtml

note: Smilehouse Workspace Small Business Edition does not include the WebServices API or the OpenSyncro interface. Only Workspace Standard and Enterprise Editions are suitable for building integrated e-business solutions.


Is there an open interface where I can build integration to my custom made supply chain management solution?
Answer:Yes there is.

To integrate Smilehouse Workspace to other applications, you basically have two options.

1) For easy integration, we encourage you to use OpenSyncro data integration middleware. It includes ready-made interface to Workspace and enables building integrations easily. Read more: http://www.opensyncro.com/

2) Or if You prefer using any other integration toolkit, you can connect it to the built in WebServices API that is included in Smilehouse Workspace. You can download Workspace WebServices API from the download section: http://workspace.smilehouse.com/download.shtml

note: Smilehouse Workspace Small Business Edition does not include the WebServices API or the OpenSyncro interface. Only Workspace Standard and Enterprise Editions are suitable for building integrated e-business solutions.



  

 

New Downloads
Workspace Developer Edition 1.11.1

Online demo
You can test latest Smilehouse Workspace Developer running in Smilehouse hosting facilities online

HOWTO
Learn how to use Workspace more efficient! Find latest tips and tricks from here


 
© Smilehouse