Przejdź do głównej zawartości
Wersja: 3.0
informacja

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 Predefined Data Sources in source manager

Access Source Manager

You can access Source Manager, following these steps:

  1. Log in to CompuTec AppEngine Launchpad.

    screen showing Logging into CompuTec AppEngine Launchpad

  2. Click the Analytics icon.

    screen showing entering Analytics module in CompuTec AppEngine

  3. Click Go to Source Manager.

    screen showing clicking 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 the view with all available data sources in CompuTec AppEngine Analytics Source Manager

Add a source

To add a new source, follow these steps:

  1. Log in to CompuTec AppEngine Launchpad.

    screen showing logging into CompuTec AppEngine Launchpad

  2. Click the Analytics icon.

    screen showing entering the Analytics Module of the CompuTec AppEngine Launchpad

  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 the view with all available data sources in CompuTec AppEngine Analytics Source Manager and where to click to add a new source

  5. Enter the source name.

    screen showing how to enter the source name

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

    screen showing how to add a sql statement or odata endpointn

    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 where to find the list of the available odata endpoints

    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 an example of correctly retuerned lost odata format

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

    screen showing where to enable preview mode

  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 cthe preview mode

    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 where to click to add a new source

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

    screen showing how to see your source in analytics reports by clicking open analytics button in source manager

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

    screen showing successfully added data source

Import a source

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

  1. Log in to CompuTec AppEngine Launchpad.

    screen showing logging into CompuTec AppEngine Launchpad

  2. Click the Analytics icon.

    screen showing entering analytics module in CompuTec AppEngine

  3. Click Go to Source Manager.

    screen showing entering the source manager in CompuTec AppEngine Analytics

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

    screen showing the list of all available data sources

  5. Enter the source name.

    screen showing where to enter the source name

  6. Click More and choose Import from the list.

    screen showing what to click to import a new data source to source manager

  7. Select the Json file and click Accept.

    screen showing how to add a json file with a data source

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

    screen showing enabling preview mode of the report

    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 how to confirm adding a new data source

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

    screen showing how to enter analytics to see your newly imported data source in the reports

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

    screen showing the newly added data source

Edit a source

To edit an existing data source, follow these steps:

  1. Log in to CompuTec AppEngine Launchpad.

    screen showing logging into compuTec appengine launchpad

  2. Click the Analytics icon.

    screen showing entering analytics module

  3. Click Go to Source Manager.

    screen showing navigating to the source manager

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

    screen showing the list of all available data sources

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

    screen showing where to click to edit your data source in analytics ource manager

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

    screen showing the edit mode in source manager

  7. After editing your settings, click Save Changes.

    screen showing how to save changes after data source edits

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