{"id":5663,"date":"2018-12-20T00:12:16","date_gmt":"2018-12-20T00:12:16","guid":{"rendered":"https:\/\/zappysys.com\/blog\/?p=5663"},"modified":"2023-09-25T15:25:25","modified_gmt":"2023-09-25T15:25:25","slug":"read-sap-s4-hana-data-ssis-cloud-odata-rest-api","status":"publish","type":"post","link":"https:\/\/zappysys.com\/blog\/read-sap-s4-hana-data-ssis-cloud-odata-rest-api\/","title":{"rendered":"Read SAP S4 \/ HANA data in SSIS (OData REST API)"},"content":{"rendered":"

Introduction<\/h2>\n

\"\"<\/a>In our previous post, we saw how to call REST API in SSIS<\/a>. Now let’s learn how to read data from SAP S4 \/ HANA OData Service (i.e. S\/4HANA). SAP HANA provides an OData REST API interface to access data in your application using HTTP Protocol. We will use the\u00a0SSIS XML Source<\/a>\u00a0component to read SAP data and load it into the SQL Server Table in a few clicks.<\/p>\n

 <\/p>\n

Prerequisites<\/span><\/h2>\r\nBefore we perform the steps listed in this article, you will need to make sure the following prerequisites are met:\r\n
    \r\n \t
  1. SSIS<\/abbr> designer installed.\u00a0Sometimes it is referred to as BIDS<\/abbr> or SSDT<\/abbr> (download it from the Microsoft site<\/a>).<\/li>\r\n \t
  2. Basic knowledge of SSIS package\u00a0development using\u00a0Microsoft SQL Server Integration Services<\/em>.<\/li>\r\n \t
  3. Make sure\u00a0ZappySys SSIS PowerPack<\/a><\/span>\u00a0is installed (download it<\/a>, if you haven't already).<\/li>\r\n \t
  4. (Optional step<\/em>).<\/em>\u00a0Read this article<\/a>, if you are planning to deploy packages to a server and schedule their execution later.<\/li>\r\n<\/ol><\/div>\n

    About SAP HANA \/ OData REST API Service<\/h2>\n

    You can expose your SAP Data using ODATA REST API Service. Here is a good article<\/a> that shows how to expose data as an OData Service. For more information on the SAP OData Service feature check the\u00a0SAP help page<\/a>. If you are new to OData standard then read an article<\/a>\u00a0to learn more about it. If you need an XML-based OData Service then use the test URLs below:<\/p>\n

    https:\/\/services.odata.org\/Northwind\/Northwind.svc\/\r\nhttps:\/\/services.odata.org\/Northwind\/Northwind.svc\/Customers\r\nhttps:\/\/services.odata.org\/Northwind\/Northwind.svc\/Orders\r\nhttps:\/\/services.odata.org\/Northwind\/Northwind.svc\/Invoices\r\nhttps:\/\/services.odata.org\/Northwind\/Northwind.svc\/Products<\/pre>\n
    Now let’s look at how to read SAP Data in SSIS. At this point, we assume you have exposed your data as OData Endpoint.<\/p>\n
    Step-by-Step Instructions<\/h2>\n
    Let’s look at the step-by-step approach to how to read SAP data using SSIS components. Then we will load SAP HANA data into SQL Server.<\/p>\n
    Read SAP HANA data using XML Source<\/h3>\n
    First, let’s look at the steps on how to configure XML Source. We will read data from SAP S4 \/ HANA OData Service and then we will look at how to load data into SQL Server in the next section.<\/p>\n
      \n
    1. Open an SSIS package.<\/li>\n
    2. Drag Data Flow Task<\/strong> from SSIS Toolbox <\/em>and\u00a0double-click it to open it.<\/li>\n
    3. From the SSIS Toolbox<\/em> drag ZS XML Source<\/strong> onto the background of Data Flow (in the designer). Double-click it to open the XML Source<\/em> configuration window.<\/li>\n
    4. Change Data Format<\/em> to OData<\/strong>. Selecting this option will take care of\u00a0REST API pagination<\/a> too.<\/li>\n
    5. Enter your OData Service URL. <\/em>Its format looks similar to the one shown below.\u00a0Replace 3 parts with your own value (i.e. replace {MY-INSTANCE}, {MY-PROJECT}, {MY-TABLE}):\n
      https:\/\/{MY-INSTANCE}\/sap\/opu\/odata\/sap\/{MY-PROJECT}\/{MY-TABLE}<\/pre>\n
      For example, if you are hosting SAP HANA in a cloud instance then your URL may look like this:<\/p>\n
      https:\/\/myXXXXXX-api.s4hana.ondemand.com\/sap\/opu\/odata\/sap\/MyTestProject\/PurchaseOrders<\/pre>\n<\/li>\n
    6. Check the\u00a0Use Credentials<\/strong>\u00a0checkbox and select the\u00a0New ZS-HTTP Connection<\/strong>\u00a0option.<\/li>\n
    7. In HTTP Connection Manager<\/em>\u00a0select the\u00a0Basic Authentication<\/a>\u00a0option and enter your SAP HANA UserID \/ Password.\n
    8. Let’s get back to the\u00a0XML Source<\/em> connector we created in the previous stage. Press the\u00a0Select Filter<\/strong>\u00a0button or directly type $.feed.entry[*]<\/span>\u00a0 into the field as shown below:\n
    9. Click Preview<\/strong> to make sure you can see the records.<\/li>\n
    10. Click OK to save the configuration and close the configuration window.<\/li>\n<\/ol>\n
      In the next section, we will configure the target to load SAP data into SQL Server using the\u00a0ZappySys Upsert Destination<\/a>\u00a0Data Flow component.<\/p>\n
      Load SAP HANA data into SQL Server using Upsert Destination<\/h3>\n
      ZappySys SSIS PowerPack makes it easy to load data from various sources such as REST, SOAP, JSON, XML, CSV or from other source into SQL Server, or PostgreSQL, or Amazon Redshift, or other  targets. The Upsert Destination<\/strong> component allows you to automatically insert new records and update existing ones based on key columns. Below are the detailed steps to configure it.<\/p>\r\n
      Step 1: Add Upsert Destination to Data Flow<\/h3>\r\n
        \r\n
      1. Drag and drop the Upsert Destination<\/strong> component from the SSIS Toolbox.<\/li>\r\n
      2. Connect your source component (e.g., JSON \/ REST \/ Other Source) to the Upsert Destination.<\/li>\r\n<\/ol>\r\n
        \r\n\r\n\"\"<\/a>\r\n
        SSIS - Data Flow - Drang and Drop Upsert Destination Component<\/p>\r\n<\/div>\r\n
        Step 2: Configure Target Connection<\/h3>\r\n
          \r\n
        1. Double-click the Upsert Destination<\/strong> component to open the configuration window.<\/li>\r\n
        2. Under Connection<\/strong>, select an existing target connection or click NEW<\/strong> to create a new connection.\r\n