Informatica Cloud Platform Building Connectors with the Toolkit Student Lab: Informatica Cloud Connector Toolkit Architecture

Size: px

Start display at page:

Download "Informatica Cloud Platform Building Connectors with the Toolkit Student Lab: Informatica Cloud Connector Toolkit Architecture"

Carmel Richards
6 years ago
Views:

1 Informatica Cloud Platform Building Connectors with the Toolkit Student Lab: Informatica Cloud Connector Toolkit Architecture Version Connectors Toolkit Training

2 Informatica Cloud Platform Building Connectors with the Toolkit Lab Guide Building Connectors with the Toolkit Version Copyright (c) Informatica Corporation. All rights reserved. Printed in the USA. This software and documentation contain proprietary information of Informatica Corporation and are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright law. Reverse engineering of the software is prohibited. No part of this document may be reproduced or transmitted in any form, by any means (electronic, photocopying, recording or otherwise) without prior consent of Informatica Corporation. Use, duplication, or disclosure of the Software by the U.S. Government is subject to the restrictions set forth in the applicable software license agreement and as provided in DFARS (a) and (a) (1995), DFARS (c)(1)(ii) (OCT 1988), FAR (a) (1995), FAR , or FAR (ALT III), as applicable.. The information in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. Informatica Corporation does not warrant that this documentation is error free. Informatica, PowerMart, PowerCenter, PowerChannel, PowerCenter Connect, MX, and SuperGlue are trademarks or registered trademarks of Informatica Corporation in the United States and in jurisdictions throughout the world. All other company and product names may be trade names or trademarks of their respective owners. DISCLAIMER: Informatica Corporation provides this documentation as is without warranty of any kind, either express or implied, including, but not limited to, the implied warranties of non-infringement, merchantability, or use for a particular purpose. The information provided in this documentation may include technical inaccuracies or typographical errors. Informatica could make improvements and/or changes in the products described in this documentation at any time without notice. 2

3 Informatica Cloud ToolKit Architecture Scenario The Informatica Cloud Connector Toolkit provides the framework to develop connectors for Informatica Cloud. The Informatica Cloud Connector Toolkit uses the following high-level interfaces: Goals In this document you will understand the following concepts: Overview Informatica Secure Agent Informatica Cloud Repository External & Internal Endpoints IPlugin - Top level interface.- IExtWrtPlugin - Enables the use of IWrite2 to perform midstream and endstream writes. IRegistrationInfo - Defines connector metadata. IMetadata - Retrieves metadata from the endpoint. IExtWrtMetadata - Retrieves metadata from the endpoint for a midstream or endstream target. IExplicitMultiObjectMetadata - Enables the selection of related source objects. ITypeSystem - Retrieves datatypes from the endpoint and their mappings to Java datatypes. IConnection - Defines connection actions and properties. IDataOperation - Defines data operation information used by the IRead and IWrite interfaces. IRead - Defines how to read data from the endpoint for single source. IMultiObjectRead - Defines how to read data from the endpoint for related sources. IWrite2 - Defines how to write data to the endpoint. Also allows midstream writes. Use for all new development. IWrite - This interface is depreciated. Use IWrite2 for all new development. IDefineMetadata - Enables the creation of a target object in a target system. IValidateRead - Validates relationships and filters. Tasks and Toolkit Interfaces When you work in Informatica Cloud, the following interfaces and methods are called in the Informatica Cloud Connector Toolkit: Cloud Interaction Create or edit connection: Test connection Select source: Browse the source object list Select target: Browse the target object list Toolkit Interface IConnection > connect IMetadata > getallrecords IMetadata > getallrecords 3

4 Data preview: Displays the first 50 fields of the selected source or target Field mapping: Refresh fields Run task: Extracts data from a single source Run task: Extracts data from multiple sources Run task: Performs insert/update/delete on the target, optionally performs midstream writes. IMetadata > getdatapreview IMetadata > getfields IRead IMultiObjectRead IWrite2 Additional Functionality You can configure additional functionality in the Informatica Cloud Connector Toolkit. Related Source Selection You can configure an Informatica Cloud Connector to allow the selection of related sources when the source system uses primary key-foreign key relationships. To enable related source selection, perform the following steps: 1. Implement the IExplicitMultiObjectMetadata interface. 2. Specify the MULTI_OBJECT_READ_WITH_PREDEFINED_RELATIONSHIP capability or the MULTI_OBJECT_READ_WITH_USER_DEFINED_JOIN capability. 3. Implement the IValidateRead interface and specify the VALIDATE_READ capability to validate relationships and filters. 4. Implement the IMultiObjectRead interface instead of the IRead interface. Midstream Writes You can configure an Informatica Cloud Connector to allow midstream writes. A midstream write allows the user to write data to a target in the middle of the data flow, and to retrieve information to return to the data flow for further processing.to allow midstream writes, perform the following steps: 1. Implement the IExtWrtPlugin interface to call the IWrite2 interface. Use IExtWrtPlugin to call the write interface instead of the IPlugin getwriter method. 2. Implement the IExtWrtMetadata interface to define the output fields and error information for a midstream target. 3. Implement the IWrite2 interface. 4. Specify the EXTENDED_WRITE capability. Target Creation You can configure an Informatica Cloud Connector to create targets. When you enable target creation for a connector, the user can configure a task to create the target on the Targets page of the task wizard.to enable target creation, perform the following steps: 1. Specify the SUPPORTS_CREATE_RECORD capability. 2. Implement the IDefineMetadata interface. 4

5 Validation You can configure an Informatica Cloud Connector to validate reads. Use the IValidateRead interface to validate relationships and filters.ivalidateread can validate predefined and user-defined relationships. 5

Informatica Cloud Platform Building Connectors with the Toolkit Student Lab 6: Working with Lookups. Version Connectors Toolkit Training

Informatica Cloud Platform Building Connectors with the Toolkit Student Lab 6: Working with Lookups Version Connectors Toolkit Training 2015-01 Informatica Cloud Platform Building Connectors with the Toolkit