Skip to main content

Create a New Ouvvi App

Ouvvi Apps can be created from Ouvvi or from Data Sync.

If you have never created an Ouvvi App before, you will need to create at one from Ouvvi before you can create any Apps using the Data Sync quick function.

Create from Ouvvi

To create an Ouvvi App in Ouvvi open the Settings menu and select Apps.

Apps Menu

This will open the Ouvvi Apps page. If you do not currently have any apps then you can click either Add App or New in the sub menu. If you already have an Ouvvi app then you can simply click New.

New Ouvvi App

This will open the app configuration page.

Here you need to enter a name, an optional description, and then enter the column names. Make sure to select the correct data type for each column from the dropdown list and set the length for any string columns.

To finish you need to identify a key column that should hold a unique value for each record and make sure to uncheck the checkbox so that null values are not allowed in that column. Then click Save``` to create the App.

App Configuration

You app is now created and ready to have data synchronised to it.

Ouvvi Products App

Create In Data Sync

Data Sync has a built in function to create a new Ouvvi App based off of your source schema.

In order to be able to use this function you need to have saved the connection to your Ouvvi Apps to your connection library, and you need to have added the columns you want to include from your source data to the schema map.

note

You will need to save the connection to Apps even if you are connected to Ouvvi in Data Sync.

Below we will cover how to save the connection and then we will cover using the quick create function.

Connecting to Ouvvi Apps in Data Sync

To connect to Ouvvi Apps and create the connection start by opening a new data sync project. Then open the connection window and go to Simego > Simego Ouvvi App.

Enter in the URL to your Ouvvi App API. It should look something like http://localhost:8080/app, you can get this URL by opening an app in Ouvvi and selecting API from the sub-menu. The url will then be highlighted in the call-out in the API section.

Apps API URL

You then need to enter in the credentials to sign into Ouvvi, and select an app from the ListName dropdown menu.

Save the connection by selecting Connect & Create Library Connection.

Connect to an Ouvvi App

Once that has been saved you can refresh the connection library and you should be able to view the connection under Ouvvi Connections. From here you can access and connect to any Ouvvi Apps you have in your tenant within Data Sync.

Using the Quick Function

Once you have saved a connection to your Ouvvi Apps you can go ahead and open a new project in Data Sync.

You then need to load your source data into the data source A window, and add the columns you want to be included in the Ouvvi App to the schema map.

Then open the Tools menu and select Create Ouvvi App.

Create Ouvvi App Tools Menu

Choose your Ouvvi Connection from the dropdown list if it has not been pre-populated into the Ouvvi Connection field, and enter in a name for the App to be called. When you are done click OK to create the app.

New Ouvvi App Function

The App will have now been created in Ouvvi, with all the columns in the schema map having been configured to match the source schema.

App Created Ouvvi

You can now either run the project in Data Sync to sync the data or you can save the project to run from Ouvvi later.

Copy an App

You can copy an existing app so that it can act as a template for a new app.

To do this navigate to the app you want to copy, in this example we are using an app named products. Then click onto the Copy button in the sub-menu.

Copy App

This will open a new app configuration page with the description, column names and lengths all pre-configured. You can now make any changes, such as adding or removing columns, changing the data lengths etc so that it meets your needs. To finish make sure you have entered in a name for the app and click Save to create it.

Copied App Config