Tools → Business Schema Manager

About the Business Schema Manager

The Business Schema Manager allows a tenant user with the necessary access rights to search for, create, and manage one or more business schemas. A business schema represents a runtime, logical schema of one or more entity objects.

To learn more about how to design a business schema, review Tools → Business Schema Designer.

Business Schema Manager access rights

A user that belongs to a group with the Schema Manager or the SuperRole role can access the Business Schema Manager. To access the Business Schema Manager for a given tenant, in the Navigation bar, select Business Schema.

Business Schema Manager anatomy

The Business Schema Manager consists of the following:

  • Action bar
  • Search bar
  • List view

Action bar

The Action bar shows the page title.

+ New in the Action bar opens the Add New menu. The Add New menu options are:

  • Create Business Schema
  • Import Business Schema

The Search bar contains a search text box. Search for any part of a given search term. The Search bar shows:

  • The number of items in the result list
  • The number of selected items in the result list with the option (x) to deselect the items
  • With select items in the List view, the More Options (⋮ vertical ellipsis) appears. The available options are:
  • Export: use to export the selected business schemas to an .zip file
  • Delete: use to delete all selected business schemas
Note

You can delete only items that you have Edit access rights to.

List view

The List view shows all results for a given search term and search context. By default, the list view only shows items where the given user has at least view access rights to the items.

Note

Only the SuperUser tenant administrator can view all items, regardless of the access rights to the objects.

The List view shows a up to 40 items of items at a time. For lists with more than this number of items, the List view contains page controls. The page controls allow the user to navigate pages forwards or backwards as well as to the first page or to the last page of items.

Business schemas list view

By default, the Business Schema items appear in alphabetical, ascending order. To sort the items by the column values in either ascending or descending order, select a specific column header except for Description. Select an item to open the business schema in the Business Schema Designer.

For Schemas, the List view shows the following properties:

Property Control Description
Select All check box Header control to add or remove all list view page items to a group for deletion, export, or email notification creation
Select Item check box Select to add or remove an individual item to a group of zero or more items for deletion
Name text The name of the business schema
Description text The description from the business schema
Permission text The access rights for business schema: View, Share, or Edit.
Owner text The display name of the user creator
More Options → Edit Description menu link Opens the Edit Description dialog
More Options → Share menu link Opens the Share dialog
More Options → Export menu link Opens the Export Schema(s) dialog
More Options → Delete menu link Opens the confirmation dialog for the physical schema deletion

Business Schema Manager actions for business schemas

With the Business Schema Manager, you can perform the following actions for business schemas:

Business Schema Manager access rights matrix

As a user that belongs to a group with the Schema Manager or the SuperRole role, you can access the Business Schema Manager. The following table shows the required access rights for each item the Business Schema Manager:

Action/Access Rights Owner/Edit Share View
Business Schema → View as list
Business Schema → Search for
Business Schema → Open in Business Schema Designer
Business Schema → View Description
Business Schema → Edit Description
Business Schema → Export
Business Schema → Share
Business Schema →

Create a business schema

You can create a business schema using the Business Schema Manager. Once created, you can design the business schema using the Business Schema Designer.

Here are the steps to create a business schema using the Business Schema Manager:

  • In the Navigation bar, select Business Schema.
  • In the Action bar, select + NewCreate Business Schema.
  • In the Create Business Schema dialog, specify the following:
  • the Name of the business schema
  • an optional Description for the business schema
  • In dialog, select Save.
Important

Validation Rules for a business schema name A business schema name…

  • Must be unique
  • Must be between 1 and 250 characters in length
  • Must begin with an alpha character, lower or upper case
  • After the first alpha character, can contain zero or more alphanumeric characters in lower, upper, or mixed case
  • After the first alpha character, can contain zero or more underscore (_) or Dollar sign ($) characters
  • Besides underscore (_) and Dollar sign ($), cannot contain special characters, symbols, or spaces

To learn more about to create a business schema view and an Incorta View using the Business Schema Designer, please review Tools → Business Schema Designer

Import one or more business schemas

  • In the Navigation bar, select Business Schema.
  • In the Action bar, select + NewImport Business Schema.
  • In the Import Business Schema dialog, optionally select the Overwrite existing business schema check box to overwrite existing business schemas that share the same name.
  • Do one of the following:

    • Drag the .zip file that contains the business schema(s) that you want to import to the Import Business Schema dialog.
    • Select Click or drag a file here to upload to select the .zip file, and then select Open.
  • In the Import Results dialog, review the status of the import operation for the business schema(s).
  • Select Close.

The following are the details in the Import Results dialog:

Property Description
Name Name of the business schema
Type The type of the imported item: Schema. Schema means business schema.
Status The status of the import operation. It can be one of the following:
  • Created
  • Overwritten
  • Failed
    If the import operation fails, the reason is displayed.
  • View a list of business schemas

    • In the Navigation bar, select Business Schema.
    • Review the list view of business schemas.

    Search for a business schema

    • In the Navigation bar, select Business Schema.
    • In the Search bar, enter a search term.
    • Review the list view of business schemas.

    To reset the search, in the Search bar, in the search box, select the remove button (x).

    View a business schema

    • In the Navigation bar, select Business Schema.
    • In the list view of business schemas, for a given business schema that you own or have access rights to, select any part of the row to open the Business Schema Designer.
    • Depending on your access rights, in the Business Schema Designer, you can do the following:

      • add a new folder
      • add a new view
      • edit an existing business schema view
      • edit an existing Incorta View
      • delete a folder, business schema view, or Incorta View

    To learn more about to create a business schema view and an Incorta View using the Business Schema Designer, please review Tools → Business Schema Designer

    Edit a business schema description

    • In the Navigation bar, select Business Schema.
    • In the list view of business schemas, for a given business schema row, select More Options (⋮ vertical ellipsis).
    • Select Edit Description.
    • In the Edit Description dialog, enter or update the schema description. You can enter up to 500 alphanumeric characters, including spaces and special characters.
    • Select Save.

    Share a business schema

    • In the Navigation bar, select Business Schema.
    • In the list view of business schemas, for a given business schema row, select More Options (⋮ vertical ellipsis).
    • Select Share.
    • In the Share dialog, you can do the following:

      • remove an existing user or group
      • modify the existing access rights for a user or group
      • add a new user or group with the access rights

    Export a business schema

    • In the Navigation bar, select Business Schema.
    • In the list view of business schemas, for a given business schema row, select More Options (⋮ vertical ellipsis).
    • Select Export. The exported business schema .zip file is downloaded to your default Downloads folder.

    Export one or more business schemas

    • In the Navigation bar, select Business Schema.
    • In the list view of business schemas, for each business schema that you want to export, select the check box.
    • In the Search bar, next to Selected, select More Options (⋮ vertical ellipsis).
    • Select Export. The exported business schema(s) .zip file is downloaded to the Downloads folder.

    Delete a business schema

    • In the Navigation bar, select Business Schema.
    • In the list view of business schemas, for a given business schema row, select More Options (⋮ vertical ellipsis).
    • Select Delete.
    • In the dialog, select Delete.

    Delete one or more business schemas

    • In the Navigation bar, select Business Schema.
    • In the list view of business schemas, for each business schema that you want to delete, select the check box.
    • In the Search bar, next to Selected, select More Options (⋮ vertical ellipsis).
    • Select Delete.
    • In the dialog, select Delete.
    © Incorta, Inc. All Rights Reserved.