Supplement for Adapters DP Bridge, Hive, HTTP, JDBC, JMS, Mongodb, Odata, Salesforce.Com, Shapefile, and Successfactors Company
Total Page:16
File Type:pdf, Size:1020Kb
PUBLIC SAP Data Services Document Version: 4.2 Support Package 12 (14.2.12.0) – 2020-02-06 Supplement for Adapters DP Bridge, Hive, HTTP, JDBC, JMS, MongoDB, OData, Salesforce.com, Shapefile, and SuccessFactors company. All rights reserved. All rights company. affiliate THE BEST RUN 2020 SAP SE or an SAP SE or an SAP SAP 2020 © Content 1 Naming Conventions......................................................... 5 2 Data Services adapters....................................................... 9 2.1 Adapter required knowledge and expertise...........................................11 3 Adapter installation and configuration...........................................12 3.1 Adding an adapter instance.....................................................13 3.2 Adapter Configuration options ...................................................14 JDBC adapter-specific configuration settings......................................19 DP Bridge runtime configuration options.........................................23 HTTP adapter specific configuration settings......................................24 JMS adapter-specific configuration settings.......................................25 3.3 Starting and stopping the adapter instance..........................................27 3.4 Monitoring the adapter instances and operations..................................... 28 3.5 Viewing adapter instance statistics................................................29 4 Creating an adapter datastore................................................. 31 5 Adapter datastore configuration options.........................................33 5.1 DP Bridge for SDI Outlook adapter datastore options...................................33 5.2 Hive adapter datastore configuration options........................................ 35 5.3 JDBC adapter datastore configuration options....................................... 37 5.4 MongoDB adapter datastore configuration options....................................38 5.5 OData adapter datastore configuration options.......................................45 5.6 Salesforce.com adapter datastore configuration options................................ 49 5.7 Shapefile adapter datastore configuration options.....................................51 5.8 SuccessFactors adapter datastore configuration options................................54 6 Browse and import metadata..................................................55 7 Adapter metadata mapping...................................................56 7.1 Metadata mapping for DP Bridge for SDI Outlook data ..................................57 7.2 Metadata mapping for Hive.....................................................58 Apache Hive data type conversion..............................................59 7.3 Metadata mapping for JDBC....................................................60 7.4 Metadata mapping for MongoDB.................................................62 7.5 Metadata mapping for OData....................................................63 7.6 Metadata mapping for Salesforce.com.............................................64 7.7 Metadata mapping for SuccessFactors.............................................65 Supplement for Adapters 2 PUBLIC Content 8 The DP Bridge adapter.......................................................67 8.1 SDI Outlook mail attachment table................................................67 8.2 SDI Outlook mail message table..................................................68 9 Hive adapter datastores......................................................70 9.1 Hive adapter source options.....................................................71 9.2 Hive adapter target options.....................................................72 9.3 Hive adapter datastore support for SQL function and transform...........................73 9.4 Pushing the JOIN operation to Hive................................................73 9.5 About partitions.............................................................74 9.6 Previewing Hive table data......................................................74 9.7 Using Hive template tables......................................................75 9.8 SSL connection support for Hive adapter........................................... 76 10 HTTP adapter..............................................................77 10.1 HTTP adapter datastore.......................................................78 10.2 HTTP adapter architecture..................................................... 79 10.3 HTTP adapter operations......................................................80 10.4 Configuring an HTTP operation instance............................................81 10.5 HTTP adapter operation instance configuration options.................................82 Target URL for HTTP requests.................................................87 10.6 Operation instance invocation...................................................87 Importing functions........................................................88 10.7 Testing the HTTP operations....................................................88 Files and settings for testing Request/Reply operation...............................89 Files and settings for testing the Request/Acknowledge operation.......................92 10.8 Configure SSL for the HTTP adapter...............................................94 10.9 Error handling and tracing......................................................95 11 JMS adapter .............................................................. 97 11.1 Scope of the JMS adapter......................................................98 11.2 JMS adapter functional overview.................................................98 11.3 Design considerations........................................................100 11.4 Configuring a JMS adapter—overview.............................................101 JMS adapter operations....................................................102 Adding an operation to an adapter instance...................................... 105 JMS adapter operation options...............................................106 11.5 JMS adapter datastore........................................................111 Import message functions and outbound messages to the datastore.....................111 11.6 Testing the JMS adapter and operations............................................113 Configure the JMS provider..................................................115 Using MQ instead of JNDI configuration......................................... 116 Supplement for Adapters Content PUBLIC 3 JMS adapter sample files....................................................117 Test Get: Request/Reply....................................................118 Test Get: Request/Acknowledge.............................................. 120 Test GetTopic: Request/Acknowledge...........................................122 Test PutGet: Request/Reply................................................. 124 Test Put: Request/Acknowledge...............................................127 Test PutTopic: Request/Acknowledge...........................................129 11.7 WebLogic as JMS provider.....................................................132 11.8 Error handling and tracing.....................................................133 12 MongoDB adapter..........................................................134 12.1 MongoDB metadata......................................................... 134 13 OData adapter ............................................................136 13.1 OData as a source...........................................................136 OData Depth level.........................................................137 13.2 OData as a target........................................................... 138 13.3 OData pushdown behavior.....................................................141 14 Salesforce.com adapter..................................................... 143 14.1 The Salesforce.com DI_PICKLIST_VALUES table..................................... 144 14.2 The CDC datastore table......................................................144 14.3 Use Salesforce.com for changed data .............................................145 Reading changed data from Salesforce.com......................................146 Using check points........................................................150 Using the CDC table source default start date.....................................150 Limitations..............................................................151 14.4 Salesforce.com error messages................................................. 152 14.5 Administering the Salesforce.com adapter..........................................154 15 SuccessFactors adapter.....................................................155 15.1 SuccessFactors push-down operations............................................155 15.2 SuccessFactors ID field.......................................................156 15.3 SuccessFactors as a source....................................................156 15.4 SuccessFactors as a target.....................................................157 15.5 CompoundEmployee API......................................................159 Importing data from an .xsd file...............................................160 Specify filters for CompoundEmployee as a source.................................160 Retrieve information from CompoundEmployee................................... 163 16 SSL connection support.....................................................165