Getting Started Configuring Fluent OMS (webapps)

Accessing the baseline Fluent OMS

The Fluent OMS app is available on the following URL:

`https://<ACCOUNT_ID>.sandbox.apps.fluentcommerce.com/oms/`

Enter your existing retailer username and password that you have been using to access the Webapps OMS.

Additional Information

• You will not be required to set up any additional users to access Fluent OMS.
• All the data available in the Admin Console will also be available in the Fluent OMS. 
• You can customize the UI according to your business requirements using the OMX UX framework.
• All user actions in the Admin Console will be available in Fluent OMS.
• You can still access the Admin Console using the same credentials in a separate browser tab.
• The workflow modeler will remain in the Admin Console.

Before you start using Fluent OMS on your account in production, we would highly recommend the following actions:

• Migrate any custom elements from your ADMIN_CONSOLE_MANIFEST to the relevant manifest fragment in Fluent OMS. Here is a step-by-step guide to configure the missing elements in the manifest.
• Configure the mutation actions you would like to use that are not present in the default Fluent OMS. How to configure mutation actions.
• Test your workflow user actions along with the manifest.

Prerequisite

You must have an existing FluentCommerce Account with at least one Retailer setup to be able to configure Fluent OMS.

Configuring Fluent OMS

Should you wish to tailor the Fluent OMS app for Client specific needs, you should override the default Fluent OMS template by adding your own manifest to the Account Settings.

How to override a default manifest document

By default, the UX Framework will check to see if there are any manifests configured in the Account settings. If no settings exist, Fluent OMS will be loaded using the baseline manifests within the platform.

The setting name for the main web app manifest file should match the following convention:

`fc.mystique.manifest.<web-app-name>`

Fragment manifest names are not enforced, however, typically use the following convention:

`fc.mystique.manifest.<web-app-name>.fragment.<fragment-name>`

Should you wish to customize any part of the default Fluent OMS web app, you can override the relevant manifest by copying the base manifest fragment into an account setting, and then modify it.

To access the baseline manifests, see the table below:

For details on how to configure the components and the manifest document, see the Config Guide and the Component Library.

Editing Manifest documents

It is recommended to use a text editor that provides JSON syntax highlighting and validation to modify the JSON values, before saving in an Account setting.

Some suggested editors / IDEs include:

• Sublime Text
• Visual Studio Code
• IntelliJ

Saving the manifests to your account

Manifest documents should be stored as a JSON Setting in the Account context. Settings can be created and updated in either of the following ways:

• Manually via the Admin Console
• Via the GraphQL Settings API

An example setting:

`fc.mystique.manifest.oms.fragment.dashboard`

`{ ... <YOUR MANIFEST JSON HERE> ... }`

When loading the web app in the browser, the UX Framework identifies if there are any referenced manifest settings on the account, and overrides the baseline manifests to load your tailored configuration.

Adding new fragments to your web app

You may also wish to add completely new fragments to your web app. To do this, you will need to override the main web app manifest and add a new reference route to the manifest setting.

Read more about configuring Reference Routes here.

Accessing Workflow Builder

The Workflow Builder can still be accessed in the existing Admin Console web app. You can login with the same credentials as before and use the Workflow Builder.