{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/cpm/reporting/configure/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Configure a Reporting API request

\n

Configure an extractor using a template

\n

Jumpstart your configuration by creating a custom extractor by uploading the extractor template in Celonis that you can download here. If you do not want to use the extractor template in Celonis and prefer to manully configure your extractor, proceed to the next section.

\n

In the New custom REST API extractor window, select the \"Import From File\" option and upload the template.

\n

\n \n \n

\n

To create the connection with your environment, go to the “Data connection” tab and fill in the empty fields using the values listed below.

\n

\n \n \n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Field NameDetailsExpected Value
NameThe name of your connection.Not prefilled, free-text value.
API URLURL that identifies the API provider.Enter the URL for your specific region:
- https://api-reporting.symbio.cloud/ - Europe region (default)
- https://api-reporting.us-1.symbio.cloud/ - U.S. region
- https://api-reporting.jp-1.symbio.cloud/ - Japan region
Tenant IDThis is a unique ID to identify your data location. Currently it can only be found by opening either the Navigator or Admin App and checking the URL of the page after it has fully loaded.Not prefilled, you can find it via:

the first GUID of the Navigator URL: https://navigator.symbio.cloud/celonis/c592ade4-4a5a-4804-a6e0-267f6a164fc6
or
the “tenant” section of the Admin App URL: https://admin.symbio.cloud/?company=celonis&tenant=c592ade4-4a5a-4804-a6e0-267f6a164fc6
API KeyThe API key can be generated using the Admin App within the “Reporting” section.Not prefilled, API key format.
\n

Once your connection is configured, you will need to wait for the fullfetch cycle to run overnight before any data is shown or the nested tables are displayed. See After the connection is created below for more inforation.

\n

For more information on setting up this connection, see Creating a custom REST API extractor / using a pre-built template.

\n

Configure an extractor using an API connection

\n

This section provides an example of how a custom connection would look when using the Reporting API.

\n

In Data integration, the user can go to the Extractor builder and build their own extractor based on an API. Here, we will use our API to set up the connection.

\n

To use the API connection, your configuration should look like this:

\n

Select “API Key Authentication” as the Authentication Method.

\n

\n \n \n

\n

\n \n \n

\n

In the API URL field, add the applicable value from the table below based on your region.

\n

Available API Domains

\n

The server region of the reporting API will match the region of your Admin App URL.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Domain RegionValueDescription
Europehttps://api-reporting.symbio.cloud/For customers deployed to the Europe region.
U.S.https://api-reporting.us-1.symbio.cloud/For customers deployed to the US region.
Japanhttps://api-reporting.jp-1.symbio.cloud/For customers deployed to the Japan region.
\n

\n \n \n

\n

In the Pagination Method section, enter \"skip\" as Offset Parameter and \"take\" as Limit Parameter. Then set a default limit. Note that the maximum limit is 100, which will be applied if no limit is set.

\n

\n \n \n

\n

After the connection is created

\n

After creating a successful connection, you will initially not see any data and you will not find all the nested tables. Since the API is based on the fullfetch cycle, you will need to wait overnight before you start to see data coming through. Make sure to check the extractor after this cycle has run and click the Generate Response button to see all nested tables.

\n

\n \n \n

\n

In some cases, you might see that your extraction failed even though your extraction connection test was successful. You might see a warning in your logs that looks like this:

\n

\n \n \n

\n

Example Data transformation

\n

With this data connection, you can then create transformation to make usable data tables. Here is an example transformation script:

\n
\n
\n
Copy
\n
Copied
\n
\n 
CREATE OR REPLACE VIEW Element AS\nSELECT\n   -- Unique ID for the Element\n   CASE\n       WHEN T.source_table = 'elements' THEN T.original_id                  -- For non-versionable elements\n       WHEN T.source_table = 'elements$versions' THEN T.original_version_id -- For versionable elements\n       WHEN T.source_table IN ('elements$content', 'elements$versions$content') THEN T.original_id -- For content items (their own 'id' is unique GUID)\n   END AS _id,\n   T.source_table, -- Helps identify where the record originated ('elements', 'elements$versions', 'elements$content', 'elements$versions$content')\n   T.original_id, -- Original 'id' from the source table (PK for elements and content)\n   T.original_version_id, -- Original 'versionId' from elements$versions (PK for versions)\n   T.parent_fk_id, -- Original FK from content tables to their parent element/version\n\n   T.supportsVariants,\n   T.supportsVersions, -- FALSE for content objects\n   T.containerPermaLink,\n   T.facetName,\n   T.permaLink,\n   T.type,\n   T.variantId,\n   T.creationId,\n\n   -- Common Attributes (renamed for consistency)\n   T.attributes_changedOn,\n   T.attributes_createdOn,\n   T.attributes_gotoUrl,\n   T.attributes_name,\n   T.attributes_state1,\n   T.attributes_description,\n\n   -- Attributes specific to elements$versions (will be NULL for non-versioned elements and all content)\n   T.attributes_isReleased,\n   T.attributes_isLastInProcessOrReleased,\n   T.attributes_majorVersion,\n   T.attributes_minorVersion,\n   T.attributes_reviewDate,\n   T.attributes_validFrom,\n   T.attributes_validUntil,\n   T.attributes_version,\n   T.attributes_reasonForRevision,\n   T.attributes_imageUrl,\n   T.attributes_stereotype,\n   T.attributes_id_from_version, -- The 'id' attribute from versions\n   T.stereotype -- The 'stereotype' column from elements$versions\n\nFROM (\n   -- Data from 'elements' table (non-versionable parent elements)\n   SELECT\n       'elements' AS source_table,\n       e.id AS original_id,\n       NULL AS original_version_id,\n       NULL AS parent_fk_id,\n       e.supportsVariants,\n       e.supportsVersions,\n       e.containerPermaLink,\n       e.facetName,\n       e.permaLink,\n       e.type,\n       e.variantId,\n       e.creationId,\n       e.\"attributes$changedOn$127\" AS attributes_changedOn,\n       e.\"attributes$createdOn$127\" AS attributes_createdOn,\n       e.\"attributes$gotoUrl$1033\" AS attributes_gotoUrl,\n       e.\"attributes$name$1033\" AS attributes_name,\n       e.\"attributes$state1$127\" AS attributes_state1,\n       e.\"attributes$description$1033\" AS attributes_description,\n       NULL AS attributes_isReleased,\n       NULL AS attributes_isLastInProcessOrReleased,\n       NULL AS attributes_majorVersion,\n       NULL AS attributes_minorVersion,\n       NULL AS attributes_reviewDate,\n       NULL AS attributes_validFrom,\n       NULL AS attributes_validUntil,\n       NULL AS attributes_version,\n       NULL AS attributes_reasonForRevision,\n       NULL AS attributes_imageUrl,\n       NULL AS attributes_stereotype,\n       NULL AS attributes_id_from_version,\n       NULL AS stereotype\n   FROM\n       elements AS e\n   WHERE\n       e.supportsVersions IS FALSE -- Only non-versionable top-level elements\n\n   UNION ALL\n\n   -- Data from 'elements$versions' table (versionable parent elements - specific versions)\n   SELECT\n       'elements$versions' AS source_table,\n       ev.id AS original_id, -- This is the FK to elements.id, but versionId is the primary identifier for this record\n       ev.versionId AS original_version_id,\n       NULL AS parent_fk_id,\n       NULL as supportsVariants,\n       NULL as supportsVersions,\n       ev.containerPermaLink,\n       ev.facetName,\n       ev.permaLink,\n       ev.type,\n       ev.variantId,\n       ev.creationId,\n       ev.\"attributes$changedOn$127\" AS attributes_changedOn,\n       ev.\"attributes$createdOn$127\" AS attributes_createdOn,\n       ev.\"attributes$gotoUrl$1033\" AS attributes_gotoUrl,\n       ev.\"attributes$name$1033\" AS attributes_name,\n       ev.\"attributes$state1$127\" AS attributes_state1,\n       ev.\"attributes$description$1033\" AS attributes_description,\n       ev.\"attributes$isReleased$127\" AS attributes_isReleased,\n       ev.\"attributes$isLastInProcessOrReleased$127\" AS attributes_isLastInProcessOrReleased,\n       ev.\"attributes$majorVersion$127\" AS attributes_majorVersion,\n       ev.\"attributes$minorVersion$127\" AS attributes_minorVersion,\n       ev.\"attributes$reviewDate$127\" AS attributes_reviewDate,\n       ev.\"attributes$validFrom$127\" AS attributes_validFrom,\n       ev.\"attributes$validUntil$127\" AS attributes_validUntil,\n       ev.\"attributes$version$127\" AS attributes_version,\n       ev.\"attributes$reasonForRevision$127\" AS attributes_reasonForRevision,\n       ev.\"attributes$imageUrl$127\" AS attributes_imageUrl,\n       ev.\"attributes$stereotype$127\" AS attributes_stereotype,\n       ev.\"attributes$id$127\" AS attributes_id_from_version,\n       ev.stereotype\n   FROM\n       \"elements$versions\" AS ev\n   WHERE\n       ev.versionId IS NOT NULL -- Only valid versions\n...\n\n) AS T;\n\nCREATE OR REPLACE VIEW Content AS\nSELECT\n   -- Parent Element's _id (from 'elements' or 'elements$versions' in the unified Element view)\n   (SELECT _id FROM Element WHERE source_table = 'elements' AND original_id = ec.elements_id) AS parent__id,\n   -- Content Element's _id (from 'elements$content' in the unified Element view)\n   (SELECT _id FROM Element WHERE source_table = 'elements$content' AND original_id = ec.id) AS content__id\nFROM\n   \"elements$content\" AS ec\nWHERE\n   ec.elements_id IS NOT NULL -- Only include if it has a valid parent link\n\nUNION ALL\n\nSELECT\n   -- Parent Element's _id (from 'elements$versions' in the unified Element view)\n   (SELECT _id FROM Element WHERE source_table = 'elements$versions' AND original_version_id = evc.\"elements$versions_versionId\") AS parent__id,\n   -- Content Element's _id (from 'elements$versions$content' in the unified Element view)\n   (SELECT _id FROM Element WHERE source_table = 'elements$versions$content' AND original_id = evc.id) AS content__id\nFROM\n   \"elements$versions$content\" AS evc\nWHERE\n   evc.\"elements$versions_versionId\" IS NOT NULL; -- Only include if it has a valid parent link
\n
\n

Example Report building

\n

With the connection and transformation set up, you then are able to make use of the data within your Analytical tools. Here is an example of how it could look like using Celonis Views.

\n

\n \n \n

","headings":[{"value":"Configure a Reporting API request","depth":1},{"value":"Configure an extractor using a template","depth":2},{"value":"Configure an extractor using an API connection","depth":2},{"value":"Available API Domains","depth":3},{"value":"After the connection is created","depth":2},{"value":"Example Data transformation","depth":2},{"value":"Example Report building","depth":2}]},"contentItem":{"data":{"lastModified":"2025-12-04T21:38:34.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"aac8af1a-3a2b-58dd-ac62-cca534007e40__redocly content/cpm/reporting/configure/","seo":{"title":"Configure a Reporting API request","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"cpm/reporting/configure.md","pageBaseUrl":"/cpm/reporting/configure","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Configure a Reporting API request","id":"configure-a-reporting-api-request"},{"depth":2,"value":"Configure an extractor using a template","id":"configure-an-extractor-using-a-template"},{"depth":2,"value":"Configure an extractor using an API connection","id":"configure-an-extractor-using-an-api-connection"},{"depth":3,"value":"Available API Domains","id":"available-api-domains"},{"depth":2,"value":"After the connection is created","id":"after-the-connection-is-created"},{"depth":2,"value":"Example Data transformation","id":"example-data-transformation"},{"depth":2,"value":"Example Report building","id":"example-report-building"}]},"data":{"title":""},"catalogInfo":null,"link":"/cpm/reporting/configure/","sidebarName":"celonis","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}