Important

You are browsing upcoming documentation for version 6.0 of OroCommerce, OroCRM, and OroPlatform, scheduled for release in 2024. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Configure Entity and System Capabilities in the Back-Office 

Note

The Entity and System Capabilities topic is part of the section on Understanding Roles and Permissions, and provides the list of capabilities that you can enable or disable when creating or modifying roles in OroCommerce.

Access to different capabilities in the back-office depends on the capabilities enabled for a specific user role. In the application, these capabilities are grouped under categories, such as accounts management, orders or system capabilities. An example of a capability is enabling a selected user to manage menus or passwords.

You can enable or disable entity-specific and system-specific capabilities in the Entity section when creating or updating a role in your application, as illustrated below:

Warning

Keep in mind that capabilities available in your instance depend on the Oro application installed.

../../../../../../_images/all_capabilities.png

Read on to learn more about the capabilities available for users in the back-office.

Account Management 

In the Account Management section, the following capabilities are available:

  • Access System Information — Enables a user to view the system information page under System > System Information in the main menu. This page contains the list of Oro packages and third-party packages that are installed, and is usually only used by system administrators and integrators.

    ../../../../../../_images/system_information_enabled.png
  • Enter The Billing Address Manually — Enables a user to provide the billing address manually.

  • Enter The Shipping Address Manually — Enables a user to provide the shipping address manually.

  • Override Customer Payment Term

  • Login as Customer User — Enables a back-office user to access and operate the OroCommerce storefront as if they were logged in as a specific customer user. Keep in mind that this feature is available in the Enterprise edition.

    User impersonation button
  • Receive Notification Messages For The System Mailboxes That Were Configured Incorrectly — Enable this option to receive an email notification if synchronization of the system mailbox is unsuccessful as the result of incorrect credentials.

  • Use Any Billing Address From The Customer User’s Address Book — Enables a user to select any billing address available in the customer user’s address book from the list.

  • Use Any Billing Address From The Customer’s Address Book — Enables a user to select any billing address available in the customer’s address book from the list.

  • Use Any Shipping Address From The Customer Address Book — Enables a user to select any shipping address available in the customer’s address book from the list.

  • Use Any Shipping Address From The Customer User’s Address Book — Enables a user to select any shipping address available in the customer user’s address book from the list.

  • Use The Default Billing Address From The Customer User’s Address Book — Enables a user to select the default billing address from the customer user’s address book.

  • Use The Default Shipping Address From The Customer User’s Address Book — Enables a user to select the default shipping address from the customer user’s address book.

  • Work With Payments

Catalog 

In the Catalog section, the following capabilities are available:

  • [Product Attribute] Create Attribute — Enables a user to create product attributes in the application.

    ../../../../../../_images/create_attribute_enabled.png
  • [Product Attribute] Edit Attribute — Enables a user to edit product attributes in the application.

  • [Product Attribute] Remove Attribute — Enables a user to remove product attributes from the application.

  • [Product Attribute] View Attributes — Enables a user to view product attributes in the application.

  • [Related Products] Edit Related Products — Enables a user to view, add and edit related products.

    ../../../../../../_images/related_products_enabled.png
  • [Up-Sell Products] Edit Up-Sell Products — Enables a user to view, add and edit up-sell products.

    ../../../../../../_images/upsell_products_enabled.png

    Note

    When both Edit Related Products and Edit Up-sell Products are disabled for a role, the Related Items section disappears from the product page.

Quotes 

In the Quotes section, the following capabilities are available:

  • Add Free-Form Items — Enables a user to provide product details (SKU, product name) using free-form entry when creating a quote in the back-office.

    ../../../../../../_images/free_form_entry1.png
  • Enter The Shipping Address Manually — Enables a user to provide the shipping address for quotes manually when creating or editing a quote in the back-office.

    ../../../../../../_images/shipping_address_quote.png
  • Override Customer Payment Term

  • Override Quote Prices — Enables a user to override prices in quotes. When disabled, the price fields on quote edit pages are inactive.

    ../../../../../../_images/override_quote_price_disabled.png
  • Review And Approve Quotes — Enables a user to manage quotes (e.g. sent to customer) without approval. When disabled, the user has to submit quotes for review first. This capability affects quotes when Backoffice Quotes Flow with Approvals is enabled in the application.

    ../../../../../../_images/approve_quotes_disabled.png
  • Use Any Shipping Address From The Customer Address Book — Enables a user to select any shipping address available in the customer’s address book from the list.

  • Use Any Shipping Address From The Customer User’s Address Book — Enables a user to select any shipping address available in the customer user’s address book from the list.

  • Use The Default Shipping Address From The Customer User’s Address Book — Enables a user to select the default shipping address from the customer user’s address book from the list.

Marketing 

In the Marketing section, the following capabilities are available:

  • Send Campaign Emails — Enables a user to launch a campaign manually. When the capability is enabled, the user can send emails specified by the campaign which is not scheduled to send emails at a specific time (campaigns that have Manual selected for Schedule). This capability does not affect the user’s ability to define and edit campaign settings and create templates.

    ../../../../../../_images/email_campaign_emabled.png

System Capabilities 

In the System Capabilities section, the following capabilities are available:

Application 

  • Access Job Queue — Enables a user to review jobs that have been started in the system, as well as view their current status and their performance log (by default, this information can be found by navigating to System > Jobs in the main menu).

  • Access Personal Configuration — Enables a user to access their profile configuration settings where they can localize the application, change the display settings, and otherwise modify how the application will appear to them. Changes made by a user on the personal configuration page do not affect other users.

    ../../../../../../_images/user_level_config.png
  • Access System Configuration — Enables a user to access system configuration settings under System > Configuration in the main menu.

    ../../../../../../_images/sys_config.png
  • Debug Prices – Enables a user to access the Price Calculation Details menu under Sales to understand how prices for a particular product are created, what the current prices are for a given customer and website, and what the prices will be for a specific date.

    Illustration of the permission that enables Pricing Debug Menu
  • Assign/Unassign Tags — Enables a user to assign/unassign tags to records.

  • Connect to Mailchimp — Enables a user to map the contents of a marketing list in OroCommerce to use a segment of the subscribers list in Mailchimp. When the capability is enabled, the Connect to Mailchimp button appears on the page of the selected marketing list. Make sure that the integration between OroCommerce and Mailchimp is configured for the capability to work.

  • Export Grid View — Enables a user to export the grid views that they have configured.

  • Manage Menus — Enables a user to access menus configuration at different levels.

    Important

    The ability to configure menus is controlled by the two capabilities: Manage Menus and Access System Configuration.

    • To enable a user to personalize menus for themselves and configure menus for each organization individually, include the Manage Menus capability into the user role.

    • To enable a user to configure menus for the whole enterprise (all organizations that exist in the Oro application) at once, in addition to the Manage Menus capability, include also the Access System Configuration capability into the user role.

    Warning

    for the Enterprise Edition only:

    • If your enterprise includes several organizations, changes made at System > Menus affect all organizations.

    • To apply changes only to a specific organization, make changes at the organization level.

  • Manage Passwords — Enables a user to change passwords of other users. See the User Management section for more information.

    Hint

    This capability does not influence a user’s ability to edit their own password from the My User page.

    ../../../../../../_images/manage_passwords.png
  • Share Data View — Enables a user to share and unshare the grid views that they have configured.

    ../../../../../../_images/grid_share.png ../../../../../../_images/grid_unshare.png
  • Update User Profile — Enables a user to update their own profile regardless of which permission for the Edit action on the User entity the user’s role includes. That is, when the Update User Profile capability is included in the user’s role, even if the role has None selected for the Edit action on the User entity, the user will be able to update their profile.

  • View SQL Query of a Report/Segment — Enables a user to review the SQL request that is sent to the system for a report/segment. When the capability is enabled, the Show SQL Query link appears below the report.This capability is usually only granted to system administrators, so they can check if a report has been developed correctly.

    ../../../../../../_images/user_configuration_showsql.png

    Hint

    This capability must be also enabled in the report settings. For this, in the main menu, navigate to System Configuration > Display Settings > Report settings, and select the Display SQL in Reports And Segments checkbox.

Calendar 

  • Assign Calendar Events — Enables a user to assign calendar events to the calendars of other users.

  • Manage Organization Calendars (and their events) — Enables a user to manage organization-wide calendars in the application (create, view, edit and delete). Organization calendars are system calendars with Organization selected for Scope.

    Hint

    When this capability is disabled, users can still view organization-wide calendars, add them to their own calendar views, and copy related events to their own calendars.

  • Manage System Calendars (and their events) — Enables a user to manage system-wide calendars in the application (create, view, edit and delete). System calendars have System selected for Scope.

    Important

    When both Manage Organization Calendars and Manage System Calendars capabilities are disabled, the System Calendar menu disappears from under System in the main menu. When at least one capability is enabled, the System Calendars menu appears under System.

    ../../../../../../_images/system_calendars_enabled.png

Entity 

  • Access Entity Management — Enables a user to access entity management section under System > Entities > Entity Management in the main menu. Many entities in OroCommerce can be configured from the interface, as described in the Entity Management topic and Entity Fields topics.

  • Merge Entities — Enables users to merge several records of the same entity.

  • Search — Enables users to search for specific records within the application. The setting does not influence the user’s ability to search by tag.

  • Export Entity Records — Enables users to export entity records. When the capability is enabled, the Export button appears on the top right of the page with the table of selected records.

    ../../../../../../_images/export_data.png
  • Import Entity Records — Enables users to import records from a file to OroCommerce. When the capability is enabled, the Import File button appears on the top right of the page with the table of selected records.

    ../../../../../../_images/import_data.png

Related Articles