Articles | SBC Online Help

Purpose

An Article contains one or several Products available to users. They act as items that end users can order or subscribe to via a subscription.

Overview page

The overview page displays all articles in a table. You can create, edit, delete, and view articles here. The default article, “All products (default),” is view-only and cannot be modified.

Parameter	Description
Shop Order	Defines the order in which the articles appear in the Shop. The lower the rank number, the higher up in the article will be shown in the list of articles in the Shop.
Status	There are four statuses, each identified by an icon and tooltip: – All, includes all Products and updates automatically when a product is created or changed. This default article is not visible in the Web Shop. – Public, visible in the Shop and available for user subscription. – Private, not visible in the Web Shop; accessible only to SBC administrators. – Inactive, not visible in the Web Shop and unavailable for use.
Article name	The article name is displayed throughout SBC, and it must be unique.
Article number	It identifies an article by an ID alongside its name, which is not necessarily unique or numeric.
Subscription period	Specifies the time period during which the Article can be accessed. Subscription period can be: 7 or 14 days, 1, 3, 6 or 9 months, 1, 2, 3 or 5 years, Unlimited. Note that months equal multiples of 30 days (regardless of calendar month length) and years equal multiples of 365 days.
Consumption limit	Options available are: Unlimited: when empty, no restrictions apply; both RTK and RINEX are available if specific products exist. RINEX (number of epochs): limit measured in epochs (each epoch equals one GNSS observation time). RTK (number of hours): limit measured in hours; SmartNet only. See “Consumption limit” from https://hexagon.atlassian.net/wiki/spaces/GSOH/pages/46023804175/Articles#Details for more info.
Regional Restriction	The following options are supported: Restricted: Display numbers specifying the maximum regions assigned per article, defining the working area for all subscriptions. Unrestricted: If empty, users subscribed to the article can work in any area where they receive data. See “Restriction” from https://hexagon.atlassian.net/wiki/spaces/GSOH/pages/46023804175/Articles#Details for more info.
Type	There are two types available for an article: Individual Enterprise subscription (SmartNet only) See “Enterprise subscription” from https://hexagon.atlassian.net/wiki/spaces/GSOH/pages/46023804175/Articles#Details for more info.
Description	This information is shown on the user portal and the Web Shop as additional information describing the article in more detail.

Create Article

Click the “+ Add article” icon at the top right of the Article overview page to create a new article. Enter the required information, then press “Save” to store the data in the database.

There are three subtabs: Details, Products, Organisations.

Details

The first tab contains details for defining an article. In addition to the parameters listed already in the the table above (from https://hexagon.atlassian.net/wiki/spaces/GSOH/pages/46023804175/Articles#Overview-page), it includes the following:

Parameter

Description

Enterprise subscription

Defines if subscriptions are valid for multiple consumers (an enterprise) or for individual users only.

When this option is selected for the article, each subscription created with this article will be an enterprise subscription. Such an enterprise subscription is not assigned to a single user but to an organisation, and all users that are members of that organisation can consume the subscription.

Additional details

On creation of a subscription to this article, a new Organisation is created (named after the user's Company) and placed as a child under the user's current Organisation. The user's role is changed to Organisation Admin and the user is assigned to the new organisation.

Afterwards, this subscription will be available to all users within this organisation. With his role Organisation Admin he can create new users within his organisation that will all be able to consume the subscription.

When this option is enabled, the following additional properties can be defined:

Parameter	Description
Maximum simultaneous consumer connections	Defines the maximum number of simultaneous real-time rover connections for this enterprise subscription.

This feature is only available for Hexagon SmartNet.

Consumption limit

Two options besides None are explained in detail:

When RTK is selected, these sub-options appear:
- Hours: must be a positive integer. Limits total connection time to this value.
- Ignore quota overrun: unchecked by default.
  - Checked: subscription remains usable even if consumption exceeds the limit.
  - Unchecked: subscription becomes unusable once consumption exceeds the limit.
- Transfer remaining quota to next subscription period:
  
  unchecked by default.
  - Checked: if renewal occurs before reaching the limit, the remaining quota transfers to the next period.
  - Unchecked: no quota carries over to the next renewal.
When RINEX is selected, these sub-options appear:
- Epochs: must be a positive integer. Limits total consumption to this value.
- Allow quota overrun by one last request: unchecked by default.
  - Checked: permits a final request which exceeds the remaining quota but allows to use the quota up to the very last epoch.
  - Unchecked: quota cannot be overrun.
- Transfer remaining quota to next subscription period:
  
  unchecked by default.
  - Checked: if renewal occurs before reaching the limit, the remaining quota transfers to the next period.
  - Unchecked: no quota carries over to the next renewal.

Pricing

This will be shown as the article’s price in the shop after configuration as a text string, supporting both numeric and non-numeric characters.

Promotional picture

The promotional picture appears on the Shop as the article's key visual.

Use for automatic subscription

This option is disabled by default. When enabled, it automatically assigns all articles with this setting as subscriptions to users whose status changes from Inactive or Pending to Active.

This applies only to newly activated users and does not affect existing users.

Restriction

The option is disabled by default. Toggle the button to enable regional restriction and display the fields below:

Number of regions per subscription
- Defines the maximum regions assignable to a
  
  subscription.
- The final region assignment is part of the subscription creation.
All configured Regions are available on the right side with their metadata, e.g., names:
- You can manually select, click Select All or Unselect All
- You can always modify it regardless of article status.
- This number cannot be lower than the previous number; otherwise, an error occurs.
After selections, those regions display on the left-side map.

Products

On the Products tab, click the “Select products” icon at the top right of the Product overview page to add Products. From this tab, you can perform the following actions.

Assign products to an article

Click the “Select products” icon in the top-right corner of the Articles Overview to open the full product list. The list shows headers: Status, Network Server host, Product type, and RT product name.
Select one or more products, then click “Close” to confirm.

Delete products from article

Click the “Delete” icon on the right to remove a product.

An article can exist without products but lacks functionality.

Organisations

On the Organisations tab, click the “Select organisations” icon at the top right to add this article to certain organisations, see also Organisations | Article Rules.

Only “Sales Organisations”, i.e. level 1 organisations, can be selected. The article will only be visible and available for subscription for the selected Sales Organisations. This allows creating articles targeted at different user groups or distribution channels.

From this tab, you can perform the following actions.

Assign Sales Organisations to an Article

Click the “Select organisations” icon in the top-right corner of the Articles Overview to open the list of all Level 1 Organisations.
Select one or multiple Organisations, then click “Close” to confirm your selection.

By default, the “Direct” Sales Organisation is assigned. An article can exist without any Sales Organisation assigned.

Delete Sales Organizations from an Article

Click the “Delete” icon on the right to remove a Sales Organisation.
- Click “Save” to apply the changes and update the database.

Update Article

You can update nearly all fields, including subtabs like Products and Organisations with their assignments or removals, regardless of the article assigned in a subscription.
Exceptions when articles are in use by subscriptions:

The "Restriction" field is blocked once set in a subscription.
- If disabled, you cannot turn it on.
- If enabled, the "Number of regions per subscription" is fixed and cannot be modified.

You cannot remove an organisation from an article if it is used in a subscription.

Delete Article

You can delete articles not linked to any subscription.

You cannot delete an article linked to a subscription. To delete it, first remove the subscription.