Skip to main content
Skip table of contents

Connect to the OData API

The steps in this article can be skipped by downloading the Power BI template from the Gimmal Records download site. If you don’t have access to this site, please contact Gimmal Support.

The Gimmal Records OData API allows you to access reporting data in your Gimmal Records cloud tenant from reporting tools such as Excel, Tableau, and Power BI. This article walks you through connecting to the API with Power BI Desktop.

Currently reporting data is only available for production tenants, and is not available on test tenants.

Prerequisites

  • Access to the Gimmal Records cloud service.

  • The user name and password to a Service Account in the Gimmal Records cloud service.

  • Advanced knowledge of Power BI Desktop.

Loading Data into Power BI

  1. From the Home ribbon select Get Data | OData feed.

  2. The OData feed window appears.

  3. Enter the Uri for the Gimmal Records base OData endpoint (https://records.gimmal.cloud/odata) and click OK.
    Note: For our customers in the Canadian Cloud, please use https://records-ca.gimmal.cloud/odata for the URI

  4. The authentication window will appear.

  5. Select Basic authentication and enter the user name and password for a service account.

  6. Ensure https://records.gimmal.cloud/odata is selected (rather than https://records.gimmal.cloud/) and click Connect.
    Note: If you are on the Canadian cloud tenant, please use https://records-ca.gimmal.cloud/odata for the URI

  7. The Navigator windows will appear.

  8. Select the tables needed and click Load. If this is your first time connecting, it may be best to load all tables to get an understanding of the data.

Loading related tables

The default OData API will give you basic information in Gimmal Records, however, there are also some related tables you may want to connect to. Use any of the following URLs to connect to the related data. The ODataAPI is https://records.gimmal.cloud/odata, or https://records-ca.gimmal.cloud/odata for Canadian cloud tenants.

URL

Description

ODataAPI/recordclasses?$expand=classificationrules

Record Class classification rules

ODataAPI/lifecycles?$expand=phases

Lifecycle phases

ODataAPI/legalcases?$expand=holdrules

Legal hold rules

ODataAPI/triggers?$expand=triggerrules

Trigger rules

ODataAPI/recordclasses?$expand=approvalgroups($expand=users)

Record Class approval groups and users

ODataAPI/destructioncertificates?$expand=approvals

Destruction Certificate approvals

ODataAPI/destructioncertificates?$expand=content

Destruction Certificate content

Follow these steps to load a related table in Power BI Desktop:

  1. From the Home ribbon select Get Data | OData feed (just like step one above.)

  2. Enter the URL of the related table you need from the table above (ODataAPI is the base URL for the OData API) and click OK.

  3. If you are asked for authentication, see step 4 above.

  4. The following window will appear:

  5. Select Transform Data.

  6. The Power Query Editor will open. For any related table, you will need to expand the column listed in the URL, in this case, ClassificationRules.

  7. Click the highlighted button to expand the column. The following window will appear:

  8. Unselect any columns you do not want to expand, however, if this is your first time using this data, it may be best to select them all. Click OK.

  9. We recommend you rename the table (likely Query1) to something more user-friendly, such as classificationrules.

  10. Click Close and Apply from the Home Ribbon in the Power Query Editor.

  11. Your new table will be loaded into Power BI Desktop.

  12. Repeat these steps for the other tables as necessary.

Managing Relationships

When loading the tables, Power BI Desktop will attempt to automatically create relationships. Unfortunately, it will most likely do this incorrectly for Gimmal Records. You will likely have to remove, modify, and create relationships manually. The correct relationships for all tables, including related tables should look similar to the following:

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.