EN    FR   IT

Try it out (free)

Where can I download the trial from?

Click here to download Userware API Server v1.3.1 trial (20MB)

After you have downloaded the file above, extract it, run Setup.exe, and follow the on-screen instructions. If you get any error messages, please try restarting the Setup. If the error persists, please contact support.

Note: if you are interested in the .NET-based version (instead of the Silverlight-based version) of Userware API, please contact us.

What are the prerequisites (system requirements)?

  • Windows language: English or French.
    Note: The download above is NOT compatible with other languages of Windows. To get a version of Userware API that is compatible with a different language of Windows, please contact us.
  • Silverlight plugin v3 (or newer) (download here)
  • Microsoft SQL Server 2003 or 2008 (download free trial here)
  • .NET Framework v4.0 (or newer) (download here)
  • Internet Information Services v6 or v7 (available from the Windows installation)
  • Recommended OS's: Windows Server 2003 or 2008 (download free trial here).
    Windows 7 Professional/Enterprise/Ultimate are also supported.

What are the limitations of the trial?

  • It stops working after 90 days. Note: you can get 30 additional days by purchasing the product. It is risk-free, since we offer an unconditional 30-day money back guarantee.
  • It displays a popup on startup.

How to get started?

  1. Download Userware API Trial from the link above, then extract the downloaded file and run Setup.exe
  2. Follow the on-screen instructions. If you get an error message, try restarting the Setup. If you still get any errors, please contact support.
  3. When the installation is complete, open your web browser and navigate to:
    http://localhost/Userware_API_Server_v131/WikiOS.aspx
  4. A Wiki-OS-like environment will appear. You can sign in using the following default credentials:
       LOGIN (or "email"): admin
       PASSWORD: admin
  5. You can now launch applications and make changes, just like on Wiki-OS.org. For example, open the Calculator, click "Edit Source Code" from the top-right corner of the window, then make a change and click "Save All And Run".
  6. You can now experiment with integrating Userware API into your own application or into a new Visual Studio solution. To do so, read the following paragraph.

How to integrate Userware API into my Silverlight application?

Integrating Userware API into a Silverlight-based application is very easy:

  1. Launch Visual Studio 2010 (or newer) and open an existing Silverlight Application project (or create a new Silverlight Application project). All versions of Silverlight are supported.
    Note: if you create a new project, make sure to check the option "Host the Silverlight application in a new Web site".
  2. Add the following references to the Silverlight Application project:

         SilverlightCore.dll
         SilverlightCommon.dll
         System.Windows.Controls.Toolkit.dll

    These files can be found in c:\inetpub\wwwroot\Userware_API_Server_v131\
  3. Add the following code to the beginning of the class where you want the Userware API control to appear (for example, if you have created a new project, add it to MainPage.cs):

    using WikiwinCommon;
  4. Copy/paste the following code into that class (i.e. into the same class as the previous step):

    public void MyStartupMethod()
    {
      this.Content = new TextBlock() { Text = "Opening session..." };
      Core.WebServiceResolver.WebServiceBaseUri = new Uri("    http://localhost/Userware_API_Server_v131/"); // Make sure that this URL is correct.
      Core.Session.StartSessionAsGuest(OnSessionCreated, OnSessionFailed);
    }

    private void OnSessionCreated(AccountInfo accountInfo)
    {
      this.Content = new TextBlock() { Text = "Loading..." };
      Core.Instantiator instantiator = new Core.Instantiator();
      instantiator.CreateInstanceCompleted += new Core.Instantiator.CreateInstanceCompletedEventHandler(OnInstanceCreated);
      instantiator.CreateInstanceAsync(new Guid("D4D54E96-B2AB-06C2-94E3-5E671B0B7966"));
    }

    private void OnSessionFailed(FailureDescription e)
    {
      if (e.FailureType == FailureTypes.NetworkConnectionError)
        MessageBox.Show("Cannot access the Userware API Web Service at the following URL:\r\n" + new Uri(Core.WebServiceResolver.WebServiceBaseUri, "Service.asmx").ToString() + "\r\n\r\nIf the Userware API Web Service is located in a different folder, please set the \"Core.WebServiceResolver.WebServiceBaseUri\" property to point to that folder.");
      else
        MessageBox.Show("Unable to start session: " + e.ToString());
    }

    private void OnInstanceCreated(object sender, Core.Instantiator.CreateInstanceCompletedEventArgs e)
    {
      this.Content = (UIElement)e.Result;
    }

    Make sure to change the URL in red if the Userware API Web Service is located at a different URL (note: this should be the same URL that contains the files "WikiOS.aspx" and "Service.asmx").

    Make sure to replace this.Content with the code that defines the place where you want to display the Userware API code editor and/or the application launcher.
  5. Call the method MyStartupMethod() (which is defined in the code above) to start loading the Userware API control and to display it. For example, if you have put the code in MainPage.cs, you may call that method in the constructor of that class (after the InitializeComponent();).
  6. Build the solution.
  7. Copy the HTML and XAP files to the same web site that contain the Userware API Web Service.

    Note: it is important that the HTML and XAP files are executed from the same URL domain (or "site of origin") as the Userware API Web Services, otherwise you may get cross-domain errors.
  8. Test your application by navigating to it with the web browser.

    For example, if you have copied your HTML and ClientBin/XAP files into c:\inetpub\wwwroot\Userware_API_Server_v131\
    you will be able to launch your application from:
    HTTP://localhost/Userware_API_Server_v131/MYAPPLICATION.html
    (where you must replace "MYAPPLICATION.html" with the name of the HTML file that you have copied)

    Please note that navigating to a local file (i.e. navigating to a URL that starts with "file://...") is not supported.

How to interact with the host application?

Interaction between the host application (i.e. the application that contains the Userware API control) and the hosted applications (i.e. the applications created using the built-in code editor) is done by having both applications reference some common assemblies.

To do so, go to the server where you have installed Userware API Server, and browse with Explorer the folder that contains the Userware API Compiler Service. It is usually located at the following path:
c:\Program Files\Userware API Server v1.3.1\Compiler

Then, inside that folder, you will see another folder named "AdditionalReferences". Open that folder, and open its sub-folder named "Silverlight3". The full path is usually:
c:\Program Files\Userware API Server v1.3.1\Compiler\AdditionalReferences\Silverlight3

The folder should already contain several assemblies, which correspond to the Silverlight runtime assemblies, the "Core" namespace, and the Silverlight Toolkit.

This is the place where you should put all the assemblies that you want the code to reference. All the code that you write inside Wiki-OS or inside Userware API will reference those assemblies.

You can add to that folder all the assemblies that you want to share between your host application and your hosted applications.

How to get support?

Please click here for Tech Support.

How to uninstall the Trial?

  1. Manually stop the Userware API Compiler Service that runs in the background.
    To do so, launch "services.msc", then right-click on the service named "Userware API Compiler", and click "Stop".
  2. Run Setup.exe (the same one that you used to install the solution) and choose "Uninstall".
  3. Follow the on-screen instructions.