Crawl SAP S/4HANA
Once you have configured the SAP S/4HANA access permissions, you can establish a connection between Atlan and your SAP S/4HANA system.
To crawl metadata from your SAP S/4HANA system, review the order of operations and then complete the following steps.
Select the source
To select SAP S/4HANA as your source:
- In the top right corner of any screen, navigate to New and then click New Workflow.
- From the list of packages, select SAP S/4HANA Assets, and click Setup Workflow.
Provide credentials
Atlan supports using a Secure Agent for fetching metadata from SAP S/4HANA. To use a Secure Agent, follow these steps:
- Select the Agent tab.
- Add secret keys for your SAP S/4HANA credentials in the linked secret store.
- Complete the Secure Agent configuration by following the instructions in the How to configure Secure Agent for workflow execution guide.
- The SAP S/4HANA agent configuration requires the following parameters:
- SAP Host Name: The hostname or IP address of your SAP S/4HANA system
- SAP User Name: The dedicated user account for metadata extraction
- SAP Password: The password for the user account
- Connection Type: Choose between Application Server or Message Server. If you have chosen Message server, provide below details:
- Port: Port number (required if using Message Server)
- Group: Group number (required if using Message Server)
- SAP System Number: Two-digit system identifier (00-99)
- SAP Client Number: Three-digit client identifier (001-999)
- Use SAP Router: Choose Yes, if using a SAP Router, and provide the SAP Router String.
- Click Next after completing the configuration.
Configure the connection
To complete the SAP S/4HANA connection configuration:
-
Provide a Connection Name that represents your source environment. For example, you might want to use values like
production
,development
,gold
, oranalytics
. -
(Optional) To change the users able to manage this connection, change the users or groups listed under Connection Admins.
dangerIf you don't specify any user or group, nobody can manage the connection - not even admins.
-
Use Secure Network Connection: Choose Yes to use secure communication. When using a secure connection, prvoide below details:
- SNC Name: Your SNC name
- SNC Partner: Partner SNC name
- SNC Security Level: Security level
- SNC Library Path: Path to SNC library
-
At the bottom of the screen, click the Next button to proceed.
Configure the crawler
Before running the SAP S/4HANA crawler, you can configure which components to include or exclude:
- To select the components you want to include in crawling, click Include Components and use the dropdown to select specific SAP components and their subcomponents. You can search for components using the search bar or use the advanced search option.
- To select the components you want to exclude from crawling, click Exclude Components and use the dropdown to select specific SAP components and their subcomponents to exclude from the crawl.
- The component selection supports hierarchical browsing, allowing you to expand and collapse component categories to select specific subcomponents.
- You may choose to configure the crawler to use advance settings by providing below details:
- SAP Language: Language code (default: EN)
- SAP Codepage: Character encoding (default: 0)
- SAP Unicode System: Choose Yes to use unicode
- Unicode Support: Choose Yes to enable Unicode support
- SAP Trace: Choose Yes to enable trace logging for debugging
- Connection Pool Size: Maximum number of connections (default: 5)
Run the crawler
Follow these steps to run the SAP S/4HANA crawler:
- You can either:
- To run the crawler once immediately, at the bottom of the screen, click the Run button.
- To schedule the crawler to run hourly, daily, weekly, or monthly, at the bottom of the screen, click the Schedule Run button.
Once the crawler has completed running, you see the assets in Atlan's asset page! 🎉