# SAP BO Universe OvalEdge uses APIs to connect to the data source, crawl data objects such as Reports, and build Lineage.

## **Connector Characteristics** | Connector Category | Reporting Systems | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | | Connectivity | REST APIs | |

Connector Version

\[OvalEdge Connector Version Information]

| 6.3.1 | |

SAP BO Versions Supported

\[Data Source Version from which OvalEdge started providing support]

| Depends on the client's request. | |

OvalEdge Releases Supported (Available From)

\[OvalEdge Release Version in which the connector was included in the OvalEdge Application]

| 5.0 onwards | ## **Connector Features** | Crawling of Metadata Objects | Supported | | ------------------------------------------------- | ------------- | | **Data Objects** | | | Reports | | | Profiling | Not Supported | | Report Preview | Supported | | Lineage | Supported | | **Lineage Levels Supported** | | |

Report lineage

Report Column lineage

| | | Data Quality | Not Supported | | DAM (Data Access Management) | Not Supported | | Authentication via Credential Manager | Supported | | Bridge | Supported | ## **Prerequisites** The following are the prerequisites required for establishing a connection: A few libraries need to be installed in the OvalEdge instance, as shown below: * OE\_SAP\_UNIVERSE\_HOME.zip * sapbo-utility-0.0.1-SNAPSHOT.jar ### **Service Account Permissions** The administrator needs to create a SAP BO account to connect to OvalEdge with the View Object Permission to crawl metadata and build the lineage in OvalEdge. ### **Data Source Configuration** | Connector Creator privileges are required for data source connection configuration. | | ----------------------------------------------------------------------------------- | 1. Log into OvalEdge, go to Administration > Connectors, click **+ (New Connector)**, search for **SAP BO**, and complete the specific parameters. {% hint style="success" %} ***Note:** Fields marked with an asterisk (**\***) are mandatory for establishing a connection.* {% endhint %}


Field Name	Description
Connector Type	By default, "SAP BO" is displayed as the selected connector type.
Connector Settings
Credential Manager*	Select the desired credentials manager from the dropdown list. Relevant parameters will be displayed based on your selection. Supported Credential Managers: OE Credential Manager AWS Secrets Manager HashiCorp Vault Azure Key Vault
License Add Ons	OvalEdge connectors have a default license add-on for data crawling and profiling. Select the checkbox for Auto Lineage Add-On to construct data lineage automatically.
Connector Name*	Enter a unique connector name for the SAP BO connection. Example: "SAPBO_Prod"
Connector Environment	Select the environment (e.g., PROD, STG) configured for the connector.
Filter	Users need to add the list of comma-separated folders to filter out.
Base URL	Add the Base URL as the entry point for the SAP BO RESTful Web Services (or API) to interact with the SAP BusinessObjects system.
Authentication Type	Add the Authentication Type method to specify how users authenticate themselves to the SAP BusinessObjects server. Example: secEnterprise
Include Folder Path	It is a path of text file where each line in the text file is a folder name to ignore during crawling.
RPT Folder Path	It is a folder where all the RPT Files are present.
Username*	A username is required to connect to the SAP BO.
Password*	A password is required to connect to the SAP BO server.
SAP BO RPT Remote Base Url	Specify the REST API endpoint URL to connect to the OvalEdge SAP BO project.
Default Governance Roles
Default Governance Roles*	Select the appropriate users or teams for each governance role from the dropdown list. All users and teams configured in OvalEdge Security are displayed for selection.
Admin Roles
Admin Roles*	Select one or more users from the dropdown list for Integration Admin and Security and Governance Admin. All users configured in OvalEdge Security are available for selection.
No of Archive Objects*	It indicates the number of recent metadata changes to a dataset at the source. By default, it is off. Users can enable it by toggling the Archive button and specifying the number of objects to archive. Example: Setting it to 4 retrieves the last 4 changes, shown in the 'version' column of the 'Metadata Changes' module.
Select Bridge*	The dropdown displays the bridges set up in Manage Bridge. Select the appropriate bridge that enables seamless connectivity between data sources without altering firewall rules.

2. After entering all connection details, you can perform the following actions: 1. Click **Validate** to verify the connection. 2. Click **Save** to store the connection for future use. 3. Click **Save & Configure** to apply additional settings before saving. 3. The saved connection will appear on the Connectors home page. ## **Errors & Resolution** If incorrect parameters are provided, you may encounter error messages. To resolve these issues, ensure all input is correct. If problems persist, contact your assigned **OvalEdge support** team.


S. No.	Error Message(s)	Error Description / Resolution
1	Invalid Username or Password"	Description: This error usually occurs when a user provides incorrect credentials (username or password) for authentication in the SAP BO environment. It can happen during login attempts or when the connector is trying to access data from an external system. Resolution: Verify credentials: Double-check the username and password. Account lockout: Ensure the account is not locked due to too many failed login attempts. If it’s locked, reset the account. Case-sensitivity: Remember that passwords in SAP BO are case-sensitive. Expired password: If the password has expired, reset it and update the credentials accordingly.
2	Connection Timeout	Description: This error occurs when the connection to the SAP BO server takes too long and times out. Resolution: Ensure the SAP BO server is running and accessible. Check if there is any network latency or firewall blocking the connection. Increase the timeout settings in the connector configuration. Verify that the network port required for the BO server is open.

S. No.

Error Message(s)

Error Description / Resolution

Invalid Username or Password"

Description: This error usually occurs when a user provides incorrect credentials (username or password) for authentication in the SAP BO environment. It can happen during login attempts or when the connector is trying to access data from an external system.

Resolution:

Verify credentials: Double-check the username and password.
Account lockout: Ensure the account is not locked due to too many failed login attempts. If it’s locked, reset the account.
Case-sensitivity: Remember that passwords in SAP BO are case-sensitive.
Expired password: If the password has expired, reset it and update the credentials accordingly.

Connection Timeout

Description: This error occurs when the connection to the SAP BO server takes too long and times out.

Resolution:

Ensure the SAP BO server is running and accessible.
Check if there is any network latency or firewall blocking the connection.
Increase the timeout settings in the connector configuration.
Verify that the network port required for the BO server is open.

## **Connector Settings** The SAP BO connector offers various settings to customize data crawling and build lineage. These include: * **Crawler:** Configure how data is discovered and extracted. * **Access Instructions:** Specify how data can be accessed. * **Business Glossary Settings:** Manage term associations at the connector level. * **Lineage:** Configure multiple dialects to build the lineage. * **Others:** Sending metadata change notifications. ### **Crawl/Profile** | Integration Admin privileges are required for Crawl/Profile operations. | | ----------------------------------------------------------------------- | Crawl and Profile operations enable you to select one or more reports from a list of all available reports within a specific reports group. This allows you to customize the crawling and building the lineage according to your requirements. ### **Manage Connector** The **Connectors page** in OvalEdge provides a centralized view of all configured connectors, including their health status. You can view, edit, validate, build lineage, and delete connectors using the **Nine Dots** menu. #### Managing connectors includes: * **Connectors Health**: Displays performance with a green (active) or red (inactive) icon, helping monitor data flow and address issues early. * **Viewing**: Shows connector details (e.g., domains, reports) via the **View** icon. #### **Nine Dots Menu Options**: * **Edit Connector**: Update and revalidate the data source. * **Validate Connector**: Check the connection's integrity. * **Settings**: Modify connector settings. * **Build Lineage**: Automatically build data lineage. * **Delete Connector**: Remove connectors or report group with confirmation. ## **FAQ’s** 1. What should I do if I encounter authentication errors?\ A: Verify that the username and password are correct. 2. Do we need to install any other software when OvalEdge is installed on Linux?\ A: Yes, there are some libraries that should be installed and running on Windows. We need to configure the SAP BO project URL in the OvalEdge application. ## **Planned Upgrades** | **S.No.** | **Expected Date** | **Upgrade Version** | **Description** | | -------------------------- | ----------------- | ------------------- | --------------- | | **NONE planned as of now** | | | | *** Copyright © 2025, OvalEdge LLC, Peachtree Corners GA USA