Skip to main content
Version: 3.0
info

You are currently viewing documentation for CompuTec AppEngine 3.0 (.NET 8).

If you are working with older environments, you may need the documentation for CompuTec AppEngine 2.0 based on .NET Framework, which is still supported: https://learn.computec.one/docs/appengine/2.0/.

As CompuTec AppEngine 3.0 introduces a new architecture, all CompuTec components must be updated together to ensure full compatibility.

Please review the CompuTec AppEngine 3.0 documentation before starting your installation or upgrade process.

Source Manager

Source Manager is the place where you add and manage the data sources used in your analytics reports. A data source defines where your report data comes from.

There are two types of data sources:

  • Custom Data Sources: You create these yourself by importing a JSON file, entering your own SQL statement, or adding an OData endpoint (a web service URL that provides data).

    screen showing custom data source in source manager

  • Predefined Data Sources: These are added automatically when you install a plugin. They are ready to use, but you can’t edit them. You can easily identify them by spotting a plugin icon next to the source name.

    screen showing custom data source in source manager

Access Source Manager

You can access Source Manager, following these steps:

  1. Log in to CompuTec AppEngine Launchpad.

    screen showing custom data source in source manager

  2. Click the Analytics icon.

    screen showing custom data source in source manager

  3. Click Go to Source Manager.

    screen showing clicking on the go to source manager button

  4. Done! You will now see a list of all available data sources. From here, you can:

    • Add a new data source: Create a new source of data to use in your reports. Data can be added using an SQL statement, an OData endpoint, or by importing a JSON file.
    • Edit existing sources: Modify existing data sources to adjust them to your reporting needs.
    • Generate data parts: Use this option when a date field is configured to use Date Parts. The system generates additional date-related fields (such as year, month, or day) for a selected date range, based on the scope you define.

    screen showing clicking on the go to source manager button

Add a source

To add a new source, follow these steps:

  1. Log in to CompuTec AppEngine Launchpad.

    screen showing custom data source in source manager

  2. Click the Analytics icon.

    screen showing custom data source in source manager

  3. Click Go to Source Manager.

    screen showing clicking on the go to source manager button

  4. Here you can see the list of all your data sources. Click + Add New Source.

    screen showing clicking on the go to source manager button

  5. Enter the source name.

    screen showing clicking on the go to source manager button

  6. Now you can add your own SQL Statement or OData Endpoint.

    screen showing clicking on the go to source manager button

    info

    If you want to find OData endpoints, you can use our WebAPI documentation. You can find it in the CompuTec AppEngine login screen after clicking the help icon in the upper right corner and selecting Explore WebAPI.

    screen showing clicking on the go to source manager button

    After selecting a definition from the list, you cand find the OData endpoints you can use in Source Manager when creating a new data source.

    Just make sure that it returns correct List OData format. Example: odata/ProcessForce/AcceptanceQualityLimit.

    screen showing clicking on the go to source manager button

  7. Click Show Preview to check how your data looks in the reports.

    screen showing clicking on the go to source manager button

  8. In preview mode, you can adjust how your data appears in the analytics report. This allows you to review and refine the presentation of the data before it is used in reports.

    screen showing clicking on the go to source manager button

    info

    In this article, you can learn more about how to edit your table and chart settings.

  9. If all the data is correct, click Add Source.

    screen showing clicking on the go to source manager button

  10. After you add a source, you can click Open Analytics to see your data in reports.

    screen showing clicking on the go to source manager button

  11. Done! You’ve successfully added a new data source.

    screen showing clicking on the go to source manager button

Import a source

To import a new source from a Json file, follow these steps:

  1. Log in to CompuTec AppEngine Launchpad.

    screen showing custom data source in source manager

  2. Click the Analytics icon.

    screen showing custom data source in source manager

  3. Click Go to Source Manager.

    screen showing clicking on the go to source manager button

  4. Here you can see the list of all your data sources. Click + Add new Source.

    screen showing clicking on the go to source manager button

  5. Enter the source name.

    screen showing clicking on the go to source manager button

  6. Click More and choose Import from the list.

    screen showing clicking more icon next to the source list

  7. Select the Json file and click Accept.

    screen showing clicking more icon next to the source list

  8. Check the Preview of your reports and edit it if you need to.

    screen showing clicking more icon next to the source list

    info

    In this article, you can learn more about how to edit your table and chart settings.

  9. If all the data is correct, click Add Source.

    screen showing clicking more icon next to the source list

  10. After you add a source, you can click Open Analytics to see your data in reports.

    screen showing clicking more icon next to the source list

  11. Done! You’ve successfully added a new data source.

    screen showing clicking more icon next to the source list

Edit a source

To edit an existing data source, follow these steps:

  1. Log in to CompuTec AppEngine Launchpad.

    screen showing custom data source in source manager

  2. Click the Analytics icon.

    screen showing custom data source in source manager

  3. Click Go to Source Manager.

    screen showing clicking on the go to source manager button

  4. Here you can see the list of all your data sources. Choose the source you want to edit.

    screen showing clicking on the go to source manager button

  5. Click the edit icon to enter the edit mode.

    screen showing clicking on the go to source manager button

  6. In edit mode, you can modify the table and chart settings, and manage analytics actions and variants. Read more

    screen showing clicking on the go to source manager button

  7. After editing your settings, click Save Changes.

    screen showing clicking on the go to source manager button

  8. Done! Now you know how to edit your existing data sources.