2024 May Release

Basic FunctionalityPermanent link for this heading

An OData service can be created in apps that have reporting enabled (e.g. Scrum). The OData service contains the definition of the object classes and properties that are exposed via the OData API.

Depending on where you create the OData service, various source objects can be used. For example, in order to gain access to your contracts, create an OData service inside your Contract Manager app.

Having created an OData service, you receive a URL which can then be used to access the data via a client like Microsoft Power BI. The OData protocol is a standardized protocol which is understood by any client - even a web browser.

Aside from the OData URL, you require the “Access for Applications” password for authentication.

Creating an OData ServicePermanent link for this heading

Once reporting has been enabled in the app of your choice, you need to create the OData service in the context where your data is stored so that it can be queried.

To create an OData service, proceed as follows:

  1. Navigate into the desired app configuration or app room, then into the “Reports and OData Services” area.
  2. Click the “Create OData Service” action.
  3. Define the following settings and click “Next”.
    • Name
      The name of the OData service.
    • Language
      Multilingual strings are provided in the defined language in the data source.
    • Use Programming Name
      If enabled, object classes and properties will not be translated and the programming names are used instead.
    • Cache Duration
      Defines how long the data is cached. Defining longer time intervals will increase performance during subsequent calls.
  4. Choose the object class of which you want to add properties to the model for the OData service and click “Next”.
  5. Select the desired properties and click “Next”.
    Note: You need to consider that adding a great number of properties will require additional resources to load. It is recommended to add the minimum required number of classes and properties.
  6. Click “Next”.
  7. If needed, you can add further properties of other object classes by clicking “Add Entry”.
  8. Click “Next”.
  9. Copy the provided link to the OData service and click “Next”.
    Note: You will be able to copy this link later as well by clicking on the generated OData service.

Query TypesPermanent link for this heading

For each entity you can select between found objects, referenced objects and user query. For “Found Objects” a query is defined where these objects are searched for. Referenced Objects are just objects referenced by another attribute.

There the following restrictions are applied: for the object classes #Object, #User and #Group only “Referenced Objects” is possible. In general, also the permission #AccTypeSearch must be given to be able to select “Found Objects”.

Found ObjectsPermanent link for this heading

For “Found Objects” a predefined query will be executed and all the objects are searched for.

Referenced ObjectsPermanent link for this heading

Referenced objects are objects which are referenced by another object in all the other entities. You could for example, search for (“Referenced Objects”) your documents and add there an attribute “Created by”. These users can then be found in the “User” entity.

User QueryPermanent link for this heading

The user query enables you to create own queries which narrows down the found objects.

Example:

SELECT * FROM COMPONENT@100.200:EntityType WHERE .FSCTEAMROOM@1.1001:objteamroom IN (COO.100.200.300.xxxx,COO.100.200.300.xxxx) AND .objexternalkey LIKE 'x1%'

This query would narrow down the objects to a Teamroom and looks through the attribute objexternalkey. The referenced objects will work the same, just with the objects which were filtered with the user query.

Examples Found Objects vs. Referenced ObjectsPermanent link for this heading

These examples should demonstrate the decision between “Found Objects” and “Referenced Objects”. In general, if you are unsure, “Found Objects” can be a good start as you will get data there. Only if you want to restrict the found objects, switch to the option “Referenced Objects”.

Example 1: Books used by Machines

Imagine there are 10 000 registered books in my organization. Some books (like manuals, about 100) are for maintaining my machines.

I want to find with OData my machines and the books used for their maintenance.

So, I define an OData Service with restriction to my whole organization with two entities:

  1. Machine with option “Found Objects” because I want that all my machines are found via query.
    1. I add there the attribute “Manual” which refers to the book used for maintenance.
  2. Book with option “Referenced Objects” because I only want to get books which are referenced by the “Manual” attribute from my machines.

The outcome is that the “Machine” entity contains all my machines and the “Book” contains all manuals referenced in my machines (about 100).

Example 2: Full list of Books and Machines

In comparison to the first example, I want to do statistics on my inventory. For that I need all machines and all books I have in the Fabasoft Cloud.

So, I define both entities with the option “Found Objects”. The result will be all my machines and all my books (about 10 000). Further filters I could apply with my Business Intelligence Tool like Microsoft Power BI.

Creating a Password for ApplicationsPermanent link for this heading

You need a password for applications to access your OData service. Create a password by opening the account menu (your user name) and clicking “Advanced Settings” > “Access for Applications”. Create a password valid for “Open Data Protocol (OData)”.

LicensingPermanent link for this heading

OData licenses are available in 10M and 100M versions.

OData volume licenses are checked when

  • the table overview for an OData service is retrieved.
  • actual rows for a certain entity are retrieved.

The overview does not lower the number of available objects but the overview is not shown if there is no amount of any OData volume left.

When retrieving rows for a certain entity the OData volume is lowered by the number of rows retrieved. That means you are charged exactly by the number of rows retrieved no matter which filters are applied and how many data rows there are in original.