Create a New Web App

The current version of App Studio creates a single-page search application that you can further customize through the built-in code editor.

Prerequisites

The instructions in this topic assume that you have a running instance of Fusion Server, with one or more collections of indexed data and at least one query profile.

See Installation for App Studio system requirements and installation instructions.

How to create a new Web app

  1. Verify that Fusion is running.

  2. From the app-studio directory, start App Studio:

    ./app-studio.sh start

    App Studio automatically opens in your browser at http://localhost:8080.

  3. On the Connect to Data Source page, enter the hostname and port of your Fusion Server instance:

    Connect to Data Source

  4. Click Connect.

    App Studio displays "Connected" if the connection succeeds.

    If the connection fails, verify that Fusion is running, adjust the host and port settings if needed, then click Connect to try again.

  5. Click Next.

  6. On the Authenticate Connection page, enter your Fusion username and password, usually for the admin account:

    Authenticate Connection

  7. Click Authenticate

    When authentication succeeds, App Studio displays "Authenticated":

    Authenticated

  8. Click Next.

  9. On the Set Application Data page, select the collection and query profile to use for your application:

    Set Application Data

  10. Click Configure.

    If your collection and query profile are reachable, App Studio displays "Configured".

  11. Click Next.

    App Studio connects to the specified collection and query profile to analyze your searchable data:

    Analysis Complete

  12. Click Next.

  13. On the Set Result Title page, select the field to use as the title of each search result:

    Set Result Title

    Optionally, you can select a Target URL field, which contains the URL to use as the link in each search result.

  14. Click Next.

  15. On the Set Result Description page, select the field to use as the description of each search result:

    Set Result Description

  16. Click Next.

  17. On the Set Facets and Additional Fields page, select one or more multi-valued fields to use as facets:

    Set Facets and Additional Fields

    Note
    In some cases, facet fields aren’t selectable in the wizard. In this case, you can define facets later using markup.

    Optionally:

    • Enter a user-friendly label for each facet field, such as "Genre" instead of "genres_ss".

    • Select Include in results as Additional Field to display the values of the facet fields within each search result.

  18. Click Next.

  19. On the Customize Application page, enter a title and select a color theme:

    Customize Application

  20. Click Save and Launch App.

    A preview of your search interface and data appear:

    Default search page

    Note
    It can take about a minute for the preview to appear. If the preview doesn’t appear, refresh the browser tab.

The next time you open your search app, you might be prompted to log in. Use the Fusion login credentials you entered in step 6.

What’s next