Informatica Cloud (Version Winter 2016) Magento Connector User Guide

Transcription

1 Informatica Cloud (Version Winter 2016) Magento Connector User Guide 1

2 Table of Contents Preface.. 3 Chapter 1: Introduction to Magento Connector. 3 Magento Connector Overview 3 Magento Connector Implementation... 3 Magento Connector Example... 3 Administration of Magento Connector.. 3 Example 3 Rules and Guidelines for Magento Connector 4 Chapter 2: Magento Connection. 4 Connection Overview 4 Magento Connection Properties 4 Chapter 3: Data synchronization Tasks with Magento Connector Magento Sources in Data Synchronization Tasks.. 4 Read Capacity Unit.. 6 Magento Targets in Data Synchronization Tasks 6 Chapter 4: Mappings.. 9 Magento Sources in Mappings.. 9 Magento Target in Mappings.. 9 Magento Lookups in Mappings. 10 Appendix A 11 Magento Datatype Reference Overview.. 11 Magento and Transformation Datatypes

3 P R E F A C E The Informatica Cloud Magento Connector Guide contains information about how to setup and use Magento Connector. The guide explains how organization administrators and business users can use Magento Connector to publish data to Magento. C H A P T E R 1 Introduction to Magento Connector This chapter includes the following topics: Magento Connector Overview Magento Connector Implementation Magento Connector Example Administration of Magento Connector Example Rules and Guidelines for Magento Connector Objects Magento Connector Overview You can use Magento connector to connect Informatica cloud and Magento Framework e commerce applications. Magento connector helps to read data from and write data into Magento applications. Magento framework is internally using MySQL database to store data and retrieve data. Magento Connector Implementation: When you read data from or write data to Magento tables, you can specify the Informatica Cloud Hosted Agent or the Informatica Cloud Secure Agent. Create a Unico Magento connection to specify the location of Magento sources, lookups, and targets you want to include in a task. You can use the Magento connection in data synchronization and mapping configuration tasks. Create a data synchronization task to synchronize data between a source and target. Create a mapping configuration task to process data based on the data flow logic defined in a mapping or integration template. Magento Connector Example: If you want to retrieve the sales inventory report based on the location create a source and target for Sales Inventory and write into Flat file and analysis the data. If you want to export the Customer information records create a source and target for Customers object and export the data into Flat File. Administration of Magento Connector: As a user, you can use Magento Connector after the organization administrator performs the following tasks: Provide user access to the Secure Agent directory that contains the success and error files. This directory path must be the same on each Secure Agent machine in the runtime environment. Create an Access Key ID and Secret Access Key in AWS. You can provide these key values when you create a Magento connection. Create an Rest Consumer Key, Consumer Secret, OAuth token key, OAuth Secret Login in Magento Admin console and generate those key before create an connection Informatica cloud. Example: 3

4 Rules and Guidelines for Magento Connector Objects: Consider the following rules and guidelines for Magento Connector objects when you configure source, target, and lookup objects in data synchronization or mapping configuration tasks: When you specify the create a Magento target option in Data Synchronization tasks and mappings, ensure that the source object contains only one primary key. While creating the table, the Secure Agent uses the primary key as the hash key in the Magento table. Magento Connector parses only the first 100 rows in a Magento table. In the Field Mapping tab, you can view and map the fields available in the first 100 rows with the source and target objects. You cannot change the precision or data type for fields in the Magento tables. You can change the scale of numeric data type fields in Magento tables. You cannot specify multi valued attributes and document data types as Magento objects. C H A P T E R 2 Magento Connections This chapter includes following topics, Connections Overview Magento Connections Properties Connections Overview Magento connections enable you to read data from or write data to Magento tables. You can use Magento connections to specify sources and targets in data synchronization tasks and mapping configuration tasks. Create a connection and associate it with a Data Synchronization Task, Mapping, or Mapping Configuration Task. Define the source and target properties to read data from or write data to Magento tables. You create a Magento connection on the Connections page. Use the connection in the Mapping Designer when you create a mapping or in the Data Synchronization Task wizard when you create a task. You can specify the Magento connection as source, target, or lookup in the data synchronization tasks and mappings. Magento Connection Properties: When you set up a Magento connection, you must configure the connection properties. The following table describes the Magento connection properties. Connection Properties Runtime Environment API endpoint Rest Consumer Key The name of the runtime environment where you want to run the tasks Magento REST URL endpoint ie. One time generated key to access RESTful services ie. d f b87472e49c1 Customers Secret Oauth Token Oauth Token Secret This is also expected encrypted key when make the rest connection Oauth Token for another kind of security for access the webservices Secret is also additional security for breaking the RESTFul services C H A P T E R 3 Data synchronization Tasks with Magento Connector This chapter includes following topics: Magento Sources in Data Synchronization Tasks, Magento Targets in Data Synchronization Tasks, 4

5 Magento Lookups in Data Synchronization Tasks, Data Synchronization Example Magento Sources in Data Synchronization Tasks When you configure a data synchronization task to use a Magento source, you can configure the source properties. The source properties appear on the Source page of the Data Synchronization Task wizard when you specify a Magento connection. Look at the following steps to configure the Data Synchronization Task Step 1: To specify the Definition for Tasks, Step 2: Specify the Source in this step, The following table describes the Magento source properties: Source Properties Connection Source Type Source Object Name of the Source Connection Source type. Select Single for a single source object. Select the source object for the task. You can also configure advanced source properties when you schedule the data synchronization task. Advanced source properties appear on the Schedule page of the Data Synchronization Task wizard. 5

6 Read Capacity Unit: When you create or update a table, you can configure the provisioned throughput capacity using the read capacity unit for read operations. As your application data and access requirements change, you can increase or decrease your provisioned throughput by updating the read capacity unit. Magento Connector supports eventually consistent reads and not strongly consistent reads. For Magento Connector, the read capacity unit represents the number of reads per second of items up to 8 KB in size per second. For example, if you specify 10 read capacity units, you are requesting a throughput of 10 eventually consistent reads per second of 8 KB for that table. To modify the read capacity unit, specify a percentage increment of the read capacity unit when you configure the advanced source properties. For example, if the existing read capacity unit is 100, you can read 100 *8 KB of data per second from a table. To increase the number of reads by 20%, specify a value of 20 in the Read Capacity Unit field. You can now read 120 * 8 KB of data per second, which is 20% of existing unit of read capacity plus existing unit of read capacity. Magento Targets in Data Synchronization Tasks: When you configure a data synchronization task to write to a Magento target, you can configure the target properties. The target properties appear on the Target page of the Data Synchronization Task wizard when you specify a Magento connection. The following table describes the Magento target properties: Source Property Connection Type Target Object Create Target Name of the target connection. Specify the target object for the task Creates a target. Enter a name for the target object and select the source fields that you want to use. Default name is the source object name and by default, all source fields are used. The target name can contain alphanumeric characters and the period and the underscore special characters. It cannot begin with a numeric character. Note: You can create a target table only when the source table contains a single primary key You can also configure advanced target properties when you schedule the data synchronization task. Advanced target properties appear on the Schedule page of the Data Synchronization Task wizard. The following table describes the Magento advanced target properties: Advanced Target Property 6

7 Write Capacity Unit Success File Directory Error File Directory The percentage increment of the write capacity unit. A unit of write capacity represents one write per second for items as large as 1 KB. Note: When you create a table during the Data Synchronization task, the default unit of write capacity is 1 Directory for the success file. Specify a directory path that is available on each Secure Agent machine in the runtime environment. By default, Informatica Cloud writes the success file to the following directory: /main/ rdtmdir/success Directory for the error rows file. Specify a directory path that is available on each Secure Agent machine in the runtime environment. By default, Informatica Cloud writes the error rows file to the following directory: / main/rdtmdir/error Create New Target: Target Creation for Data Synchronization: Step 3: Create Data Filter if required, over here you can specify whether you want to export all the records from the Selected Object/Table or specify number of records. 7

8 Step 4(Field Mapping): In this step, we can specify the mapping between Source to Target Objects and we can specify manual or auto match. Step 6(Schedule): In this step we can specify the tasks whether we want to execute it in timely basis or on demand. Once we created a task we can Save it and Run it.once the Task is execute successfully we can see the Task Completion status under Activity Log. 8

9 Magento Lookups in Data Synchronization Tasks: When you configure field mappings in a data synchronization task, you can create a lookup to a Magento object. When you use a Magento object as a lookup, you do not need to configure specific Magento properties. Data Synchronization Example: If business want to analysis the most selling products in a particular branch or city, they can take the consolidated Orders through the mapping and create the report. You use Magento Connector to consolidate the orders from various users and store the unstructured data in Magento tables. Configure a data synchronization task to consolidate the tweets based on username and store them in an existing Magento table. Your perform the following data synchronization task. Configure a data synchronization task to use the upsert operation. Create a Order source object. The source for the mapping is a Orders object that contains the order details. The Order object is a single source in the data synchronization task. The Order object includes the OrderId, Product, and Order source columns. Specify Order as the resource for the source object. Create a Flat File target object. The target for the mapping is a Flat File table. The Magento object includes the Order ID and Orders target columns. Provide a order id Test_Order for the target object and specify the connection type as Magento. Specify a data filter for the Order source object. Define a data filter for the Tweets source object. For example, you can filter by NoneOfTheseWords Equals 'Watch'. Configure a field mapping. Map the fields under Orders source data to the fields in the test_orders target object. To consolidate the orders based on user name, enter the following lookup expression: concat((lookup( UserName=username ):test_order.orders), Order When you run the task, the Data Synchronization application writes the mapped source data to the target Flat File table C H A P T E R 4 Mapping and Mapping Configuration Tasks with Magento Connector This chapter includes the following topics: Magento Sources in Mappings Magento Targets in Mappings Magento Lookups in Mappings Magento Sources in Mappings To read data from a Magento table, configure a Magento object as the Source transformation in a mapping. Specify the name and description of the Magento source. Configure the source and advanced properties for the source object. The following table describes the source properties that you can configure in a Source transformation: Property Connection Name Source Type Name of the source connection. Source type. Select one of the following types: 9

10 Single Object. Parameter. Select Parameter to define the source type when you configure the mapping configuration task. Source Object Source object for the mapping. The following table describes the advanced source properties that you can configure in a Source transformation: Advanced Property Row Count Read Capacity Unit Tracing Level The maximum number of rows to retrieve from a Magento table The percentage increment of the read capacity unit Sets the amount of detail that appears in the log file. You can choose terse, normal, verbose initialization or verbose data. Default is normal. Magento Targets in Mappings To write data to a Magento table, configure a Magento object as the Target transformation in a mapping. Specify the name and description of the Magento target. Configure the target and advanced properties for the target object. The following table describes the target properties that you can configure in a Target transformation: Property Connection Target Type Object Operation Name of the target connection. Target type. Select one of the following target types: Single Object. Parameter. Select Parameter to define the target type when you configure the task. Name of the target object Target operation. Select one of the following operations: Insert. Update. Upsert. Delete. Data Driven. Configure an expression to specify an update strategy based on the data. You can use one of the following constants in an expression: DD_INSERT DD_UPDATE DD_REJECT DD_DELETE Note: If you use the Data Driven operation, you cannot upsert. The following table describes the advanced target properties that you can configure in a Target transformation: Property 10

11 Write Capacity Unit Success File Directory Error File Directory Forward Rejected Rows The percentage increment of the write capacity unit. Directory for the success file. Specify a directory path that is available on each Secure Agent machine in the runtime environment. By default, Informatica Cloud writes the success file to the following directory: /main/ rdtmdir/success Directory for the success file. Specify a directory path that is available on each Secure Agent machine in the runtime environment. By default, Informatica Cloud writes the success file to the following directory: /main/ rdtmdir/success Determines whether the transformation passes rejected rows to the next transformation or drops rejected rows. By default, the Mapping Configuration application forwards rejected rows to the next transformation. Magento Lookups in Mappings In a mapping, you can configure a Lookup transformation to represent a Magento object. When you use a Magento object as a lookup, you do not need to configure specific Magento properties. A P P E N D I X A Magento Data Type Reference This appendix includes the following topics: Magento Data Type Reference Overview Magento and Transformation Data Types Magento Data Type Reference Overview Informatica Cloud uses the following data types in mappings, data synchronization tasks, and mapping configuration tasks with Magento: Magento native data types Magento data types appear in the Fields tab for Source and Target transformations when you choose to edit metadata for the fields. Transformation data types Set of data types that appear in the remaining transformations. They are internal data types based on ANSI SQL 92 generic data types, which Informatica Cloud uses to move data across platforms. Transformation data types appear in all remaining transformations in a mapping, data synchronization task, or mapping configuration task. When Informatica Cloud reads source data, it converts the native data types to the comparable transformation data types before transforming the data. When Informatica Cloud writes to a target, it converts the transformation data types to the comparable native data types. Magento and Transformation Data Types The following table lists the Magento data types that Informatica Cloud supports and the corresponding transformation data types: Magento Native Data Type Transformation Data Type Number Decimal Precision 1 to 28, scale 0 to 28 11

12 Magento Native Data Type Transformation Data Type String Varchar 1 to 104,857,600 characters Boolean Small Integer Precision 5, scale 0 12