Informatica Cloud (Version Spring 2017) Microsoft Dynamics 365 for Operations Connector Guide

Transcription

1 Informatica Cloud (Version Spring 2017) Microsoft Dynamics 365 for Operations Connector Guide

2 Informatica Cloud Microsoft Dynamics 365 for Operations Connector Guide Version Spring 2017 July 2017 Copyright Informatica LLC 2017 This software and documentation contain proprietary information of Informatica LLC 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 LLC. This Software may be protected by U.S. and/or international Patents and other Patents Pending. 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 (1)(ii) (OCT 1988), FAR (a) (1995), FAR , or FAR (ALT III), as applicable. The information in this product or documentation is subject to change without notice. If you find any problems in this product or documentation, please report them to us in writing. Informatica, Informatica Platform, Informatica Data Services, PowerCenter, PowerCenterRT, PowerCenter Connect, PowerCenter Data Analyzer, PowerExchange, PowerMart, Metadata Manager, Informatica Data Quality, Informatica Data Explorer, Informatica B2B Data Transformation, Informatica B2B Data Exchange Informatica On Demand, Informatica Identity Resolution, Informatica Application Information Lifecycle Management, Informatica Complex Event Processing, Ultra Messaging, Informatica Master Data Management, and Live Data Map are trademarks or registered trademarks of Informatica LLC 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. U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation is subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR , Commercial Computer Software License. Portions of this software and/or documentation are subject to copyright held by third parties, including without limitation: Copyright DataDirect Technologies. All rights reserved. Copyright Sun Microsystems. All rights reserved. Copyright RSA Security Inc. All Rights Reserved. Copyright Ordinal Technology Corp. All rights reserved. Copyright Aandacht c.v. All rights reserved. Copyright Genivia, Inc. All rights reserved. Copyright Isomorphic Software. All rights reserved. Copyright Meta Integration Technology, Inc. All rights reserved. Copyright Intalio. All rights reserved. Copyright Oracle. All rights reserved. Copyright Adobe Systems Incorporated. All rights reserved. Copyright DataArt, Inc. All rights reserved. Copyright ComponentSource. All rights reserved. Copyright Microsoft Corporation. All rights reserved. Copyright Rogue Wave Software, Inc. All rights reserved. Copyright Teradata Corporation. All rights reserved. Copyright Yahoo! Inc. All rights reserved. Copyright Glyph & Cog, LLC. All rights reserved. Copyright Thinkmap, Inc. All rights reserved. Copyright Clearpace Software Limited. All rights reserved. Copyright Information Builders, Inc. All rights reserved. Copyright OSS Nokalva, Inc. All rights reserved. Copyright Edifecs, Inc. All rights reserved. Copyright Cleo Communications, Inc. All rights reserved. Copyright International Organization for Standardization All rights reserved. Copyright ejtechnologies GmbH. All rights reserved. Copyright Jaspersoft Corporation. All rights reserved. Copyright International Business Machines Corporation. All rights reserved. Copyright yworks GmbH. All rights reserved. Copyright Lucent Technologies. All rights reserved. Copyright University of Toronto. All rights reserved. Copyright Daniel Veillard. All rights reserved. Copyright Unicode, Inc. Copyright IBM Corp. All rights reserved. Copyright MicroQuill Software Publishing, Inc. All rights reserved. Copyright PassMark Software Pty Ltd. All rights reserved. Copyright LogiXML, Inc. All rights reserved. Copyright Lorenzi Davide, All rights reserved. Copyright Red Hat, Inc. All rights reserved. Copyright The Board of Trustees of the Leland Stanford Junior University. All rights reserved. Copyright EMC Corporation. All rights reserved. Copyright Flexera Software. All rights reserved. Copyright Jinfonet Software. All rights reserved. Copyright Apple Inc. All rights reserved. Copyright Telerik Inc. All rights reserved. Copyright BEA Systems. All rights reserved. Copyright PDFlib GmbH. All rights reserved. Copyright Orientation in Objects GmbH. All rights reserved. Copyright Tanuki Software, Ltd. All rights reserved. Copyright Ricebridge. All rights reserved. Copyright Sencha, Inc. All rights reserved. Copyright Scalable Systems, Inc. All rights reserved. Copyright jqwidgets. All rights reserved. Copyright Tableau Software, Inc. All rights reserved. Copyright MaxMind, Inc. All Rights Reserved. Copyright TMate Software s.r.o. All rights reserved. Copyright MapR Technologies Inc. All rights reserved. Copyright Amazon Corporate LLC. All rights reserved. Copyright Highsoft. All rights reserved. Copyright Python Software Foundation. All rights reserved. Copyright BeOpen.com. All rights reserved. Copyright CNRI. All rights reserved. This product includes software developed by the Apache Software Foundation ( and/or other software which is licensed under various versions of the Apache License (the "License"). You may obtain a copy of these Licenses at Unless required by applicable law or agreed to in writing, software distributed under these Licenses is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the Licenses for the specific language governing permissions and limitations under the Licenses. This product includes software which was developed by Mozilla ( software copyright The JBoss Group, LLC, all rights reserved; software copyright by Bruno Lowagie and Paulo Soares and other software which is licensed under various versions of the GNU Lesser General Public License Agreement, which may be found at The materials are provided free of charge by Informatica, "as-is", without warranty of any kind, either express or implied, including but not limited to the implied warranties of merchantability and fitness for a particular purpose. The product includes ACE(TM) and TAO(TM) software copyrighted by Douglas C. Schmidt and his research group at Washington University, University of California, Irvine, and Vanderbilt University, Copyright ( ) , all rights reserved. This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (copyright The OpenSSL Project. All Rights Reserved) and redistribution of this software is subject to terms available at and This product includes Curl software which is Copyright , Daniel Stenberg, <daniel@haxx.se>. All Rights Reserved. Permissions and limitations regarding this software are subject to terms available at Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. The product includes software copyright ( ) MetaStuff, Ltd. All Rights Reserved. Permissions and limitations regarding this software are subject to terms available at license.html. The product includes software copyright , The Dojo Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to terms available at This product includes ICU software which is copyright International Business Machines Corporation and others. All rights reserved. Permissions and limitations regarding this software are subject to terms available at This product includes software copyright Per Bothner. All rights reserved. Your right to use such materials is set forth in the license which may be found at kawa/software-license.html. This product includes OSSP UUID software which is Copyright 2002 Ralf S. Engelschall, Copyright 2002 The OSSP Project Copyright 2002 Cable & Wireless Deutschland. Permissions and limitations regarding this software are subject to terms available at This product includes software developed by Boost ( or under the Boost software license. Permissions and limitations regarding this software are subject to terms available at /

3 This product includes software copyright University of Cambridge. Permissions and limitations regarding this software are subject to terms available at This product includes software copyright 2007 The Eclipse Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to terms available at and at This product includes software licensed under the terms at license.html, httpunit.sourceforge.net/doc/ license.html, license.html, license-agreement; /copyright-software ; forge.ow2.org/projects/javaservice/, license.html; protobuf.googlecode.com/svn/trunk/src/google/protobuf/descriptor.proto; current/doc/mitk5license.html; blob/master/license; page=documents&file=license; blueprints/blob/master/license.txt; twbs/bootstrap/blob/master/license; master/license, and This product includes software licensed under the Academic Free License ( the Common Development and Distribution License ( the Common Public License ( the Sun Binary Code License Agreement Supplemental License Terms, the BSD License ( the new BSD License ( licenses/bsd-3-clause), the MIT License ( the Artistic License ( and the Initial Developer s Public License Version 1.0 ( This product includes software copyright Joe WaInes, XStream Committers. All rights reserved. Permissions and limitations regarding this software are subject to terms available at This product includes software developed by the Indiana University Extreme! Lab. For further information please visit This product includes software Copyright (c) 2013 Frank Balluffi and Markus Moeller. All rights reserved. Permissions and limitations regarding this software are subject to terms of the MIT license. See patents at DISCLAIMER: Informatica LLC provides this documentation "as is" without warranty of any kind, either express or implied, including, but not limited to, the implied warranties of noninfringement, merchantability, or use for a particular purpose. Informatica LLC does not warrant that this software or documentation is error free. The information provided in this software or documentation may include technical inaccuracies or typographical errors. The information in this software and documentation is subject to change at any time without notice. NOTICES This Informatica product (the "Software") includes certain drivers (the "DataDirect Drivers") from DataDirect Technologies, an operating company of Progress Software Corporation ("DataDirect") which are subject to the following terms and conditions: 1. THE DATADIRECT DRIVERS ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. 2. IN NO EVENT WILL DATADIRECT OR ITS THIRD PARTY SUPPLIERS BE LIABLE TO THE END-USER CUSTOMER FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL OR OTHER DAMAGES ARISING OUT OF THE USE OF THE ODBC DRIVERS, WHETHER OR NOT INFORMED OF THE POSSIBILITIES OF DAMAGES IN ADVANCE. THESE LIMITATIONS APPLY TO ALL CAUSES OF ACTION, INCLUDING, WITHOUT LIMITATION, BREACH OF CONTRACT, BREACH OF WARRANTY, NEGLIGENCE, STRICT LIABILITY, MISREPRESENTATION AND OTHER TORTS. Publication Date:

4 Table of Contents Preface Informatica Resources Informatica Network Informatica Knowledge Base Informatica Documentation Informatica Product Availability Matrixes Informatica Velocity Informatica Marketplace Informatica Global Customer Support Chapter 1: Introduction to Microsoft Dynamics 365 for Operations Connector... 7 Microsoft Dynamics 365 for Operations Connector Overview Microsoft Dynamics 365 for Operations Connector Task and Object Types Administration of Microsoft Dynamics 365 for Operations Connector Register a Native Application with Azure Active Directory Configure the -Dlog4j.configuration Property Chapter 2: Microsoft Dynamics 365 for Operations Connections Microsoft Dynamics 365 for Operations Connection Overview Microsoft Dynamics 365 for Operations Connection Properties Chapter 3: Data Synchronization Tasks with Microsoft Dynamics 365 for Operations Connector Microsoft Dynamics 365 for Operations Sources in Data Synchronization Tasks Microsoft Dynamics 365 for Operations Lookups in Data Synchronization Tasks Chapter 4: Mappings and Mapping Configuration Tasks with Microsoft Dynamics 365 for Operations Connector Mappings and Mapping Configuration Tasks with Microsoft Dynamics 365 for Operations Overview Microsoft Dynamics 365 for Operations Sources in Mappings Microsoft Dynamics 365 for Operations Lookups in Mappings Microsoft Dynamics 365 for Operations Mapping Example Appendix A: Data Type Reference Data Type Reference Overview Microsoft Dynamics 365 for Operations and Transformation Data Types Index Table of Contents

5 Preface The Informatica Cloud Microsoft Dynamics 365 for Operations Connector Guide provides information about how to read data from Microsoft Dynamics 365 for Operations and write data to other applications, databases, or flat files. This guide explains how organization administrators can configure the Microsoft Dynamics 365 for Operations Connector, and business users can use Microsoft Dynamics 365 for Operations Connector to create connections, develop mappings, and run Data Synchronization and Mapping Configuration tasks. This guide assumes you have knowledge of Microsoft Dynamics 365 for Operations and Informatica Cloud. Informatica Resources Informatica Network Informatica Network hosts Informatica Global Customer Support, the Informatica Knowledge Base, and other product resources. To access Informatica Network, visit As a member, you can: Access all of your Informatica resources in one place. Search the Knowledge Base for product resources, including documentation, FAQs, and best practices. View product availability information. Review your support cases. Find your local Informatica User Group Network and collaborate with your peers. Informatica Knowledge Base Use the Informatica Knowledge Base to search Informatica Network for product resources such as documentation, how-to articles, best practices, and PAMs. To access the Knowledge Base, visit If you have questions, comments, or ideas about the Knowledge Base, contact the Informatica Knowledge Base team at KB_Feedback@informatica.com. Informatica Documentation To get the latest documentation for your product, browse the Informatica Knowledge Base at 5

6 If you have questions, comments, or ideas about this documentation, contact the Informatica Documentation team through at Informatica Product Availability Matrixes Product Availability Matrixes (PAMs) indicate the versions of operating systems, databases, and other types of data sources and targets that a product release supports. If you are an Informatica Network member, you can access PAMs at Informatica Velocity Informatica Velocity is a collection of tips and best practices developed by Informatica Professional Services. Developed from the real-world experience of hundreds of data management projects, Informatica Velocity represents the collective knowledge of our consultants who have worked with organizations from around the world to plan, develop, deploy, and maintain successful data management solutions. If you are an Informatica Network member, you can access Informatica Velocity resources at If you have questions, comments, or ideas about Informatica Velocity, contact Informatica Professional Services at ips@informatica.com. Informatica Marketplace The Informatica Marketplace is a forum where you can find solutions that augment, extend, or enhance your Informatica implementations. By leveraging any of the hundreds of solutions from Informatica developers and partners, you can improve your productivity and speed up time to implementation on your projects. You can access Informatica Marketplace at Informatica Global Customer Support You can contact a Global Support Center by telephone or through Online Support on Informatica Network. To find your local Informatica Global Customer Support telephone number, visit the Informatica website at the following link: If you are an Informatica Network member, you can use Online Support at 6 Preface

7 C H A P T E R 1 Introduction to Microsoft Dynamics 365 for Operations Connector This chapter includes the following topics: Microsoft Dynamics 365 for Operations Connector Overview, 7 Microsoft Dynamics 365 for Operations Connector Task and Object Types, 7 Administration of Microsoft Dynamics 365 for Operations Connector, 8 Microsoft Dynamics 365 for Operations Connector Overview You can use Microsoft Dynamics 365 for Operations Connector to connect to Microsoft Dynamics 365 for Operations from Informatica Cloud. Use Microsoft Dynamics 365 for Operations Connector to securely read data from Microsoft Dynamics 365 for Operations. After you read data from Microsoft Dynamics 365 for Operations, write the data to other applications, databases, or flat files for analyzing the data. You can use Microsoft Dynamics 365 for Operations objects as sources in Data Synchronization tasks, mappings, and Mapping Configuration tasks. When you run a Data Synchronization task or a Mapping Configuration task, the agent uses the OData API to perform the specified operation and read data from Microsoft Dynamics 365 for Operations. Microsoft Dynamics 365 for Operations Connector Task and Object Types When you create a Microsoft Dynamics 365 for Operations connection to perform a task, you can select the objects supported by Microsoft Dynamics 365 for Operations Connector for the task. 7

8 The following table provides the list of tasks and object types supported by Microsoft Dynamics 365 for Operations Connector: Task Type Source Target Lookup Data Synchronization Yes NA Yes Mapping Yes NA Yes Mapping Configuration Yes NA Yes Administration of Microsoft Dynamics 365 for Operations Connector You can use Microsoft Dynamics 365 for Operations Connector after the organization administrator performs the following tasks: Register a native application with Azure Active Directory Configure the log4j.configuration property Register a Native Application with Azure Active Directory Azure Active Directory is a cloud-based directory that provides identity management services. You can use Azure Active Directory to securely communicate with cloud-based applications. To use Microsoft Dynamics 365 for Operations Connector, the organization administrator needs to register a native application with Azure Active Directory. After the organization administrator registers the native application with Azure Active Directory, you can communicate with the services of Microsoft Dynamics 365 for Operations. To register a native application with Azure Active Directory, see Configure the -Dlog4j.configuration Property 1. Copy the log4j.properties file from <Secure Agent installation directory>\downloads\package- MSDAX7.<version>\package\plugins\ directory and place it in a location in the Secure Agent machine. 2. Set the JVM option for type DTM to -Dlog4j.configuration=<log4j.propertyfile location> \log4j.properties in the system configuration details of the Secure Agent. 3. Restart the Secure Agent. 8 Chapter 1: Introduction to Microsoft Dynamics 365 for Operations Connector

9 C H A P T E R 2 Microsoft Dynamics 365 for Operations Connections This chapter includes the following topics: Microsoft Dynamics 365 for Operations Connection Overview, 9 Microsoft Dynamics 365 for Operations Connection Properties, 9 Microsoft Dynamics 365 for Operations Connection Overview Create a Microsoft Dynamics 365 for Operations connection to securely read data from Microsoft Dynamics 365 for Operations. You can use Microsoft Dynamics 365 for Operations connections to specify sources 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 properties to read data from Microsoft Dynamics 365 for Operations. You can create a Microsoft Dynamics 365 for Operations connection on the Connections page. The connection becomes available to the entire organization. Microsoft Dynamics 365 for Operations Connection Properties When you set up a Microsoft Dynamics 365 for Operations connection, you must configure the connection properties. 9

10 The following table describes the Microsoft Dynamics 365 for Operations connection properties: Connection Property Runtime Environment Service URL Username Password Application ID Description The name of the runtime environment where you want to run the tasks. Enter the URL of the Microsoft Dynamics 365 for Operations service in the following format: http/ number> If you do not specify the port number in the URL, the agent uses port number 443 in the query. The user name to connect to Microsoft Dynamics 365 for Operations account. The password to connect to Microsoft Dynamics 365 for Operations account. Microsoft Dynamics 365 for Operations native application ID. 10 Chapter 2: Microsoft Dynamics 365 for Operations Connections

11 C H A P T E R 3 Data Synchronization Tasks with Microsoft Dynamics 365 for Operations Connector This chapter includes the following topics: Microsoft Dynamics 365 for Operations Sources in Data Synchronization Tasks, 11 Microsoft Dynamics 365 for Operations Lookups in Data Synchronization Tasks, 12 Microsoft Dynamics 365 for Operations Sources in Data Synchronization Tasks You can use a Microsoft Dynamics 365 for Operations object as a single source in a Data Synchronization task. You can configure the Microsoft Dynamics 365 for Operations source properties on the Source page of the Data Synchronization Task wizard. The following table describes the Microsoft Dynamics 365 for Operations source properties: Property Connection Source Type Source Object Display technical names instead of labels Display source fields in alphabetical order Description The source connection for the task. Type of the source object. Select Single to read data from a single source. The source object for the task. Select the source object for a single source. Displays technical names instead of business names. Displays source fields in alphabetical order instead of the order returned by the source system. You can configure the advanced source properties on the Schedule page of the Data Synchronization Task wizard. 11

12 The following table describes the Microsoft Dynamics 365 for Operations advanced source properties: Advanced Property Number of rows to read Number of rows ro skip Description Sets the number of rows that the agent must read from the Microsoft Dynamics 365 for Operations source. Sets the number of rows you can skip. For example, you can set this property to n to skip the first n rows in a source and read from the (n+1) row. Page Size Size of the page set to retrieve the maximum number of entries for each page. Default value is 100. Microsoft Dynamics 365 for Operations Lookups in Data Synchronization Tasks You can create lookups for objects in Microsoft Dynamics 365 for Operations connection. You can retrieve data from a Microsoft Dynamics 365 for Operations lookup object based on the specified lookup condition. When you configure a lookup in Microsoft Dynamics 365 for Operations, you select the lookup connection and lookup object. You also define the behavior when a lookup condition returns more than one match. The following table describes the Microsoft Dynamics 365 for Operations lookup object properties that you can configure in a Lookup transformation in Data Synchronization tasks: Property Lookup Connection Lookup Object Number of rows to read Number of rows to skip Page Size Display technical names instead of labels Display fields in alphabetical order Lookup Fields Description Name of the lookup connection. Name of the lookup object for the Data Synchronization task. Fetches the number of rows specified. Sets the number of rows you can skip. Size of the page set to retrieve the maximum number of entries for each page. Displays technical names instead of business names. Displays lookup fields in alphabetical order instead of the order returned by the source system. The fields used to define the lookup condition. Select Source Fields and Lookup Fields. The Data Synchronization task compares the value of the source field against the lookup field, and then returns a value based on the match. You can define multiple conditions in a lookup. If you define more than one lookup condition, all lookup conditions must be true to find the match. 12 Chapter 3: Data Synchronization Tasks with Microsoft Dynamics 365 for Operations Connector

13 The following table describes the lookup return value properties that you can configure: Lookup Return Value Property Output Field Multiplicity Expression Description The field from the lookup table that you want to use. How the Data Synchronization task handles multiple return values. Select one of the following values: - Error, if more than one output value. Select if the Data Synchronization task should display an error when the lookup condition returns multiple values. The Data Synchronization task rejects rows when multiple matches are found, writing them to the error rows file. This is the default. - Randomly pick one output value. Select if the Data Synchronization task should choose the first returned value when a lookup condition returns multiple values. Different systems might use different orders to return lookup values. A simple expression that uses $OutputField to represent the selected output field. By default, Data Synchronization tasks pass the lookup return value without alteration with the following expression: $OutputField Microsoft Dynamics 365 for Operations Lookups in Data Synchronization Tasks 13

14 C H A P T E R 4 Mappings and Mapping Configuration Tasks with Microsoft Dynamics 365 for Operations Connector This chapter includes the following topics: Mappings and Mapping Configuration Tasks with Microsoft Dynamics 365 for Operations Overview, 14 Microsoft Dynamics 365 for Operations Sources in Mappings, 14 Microsoft Dynamics 365 for Operations Lookups in Mappings, 15 Microsoft Dynamics 365 for Operations Mapping Example, 16 Mappings and Mapping Configuration Tasks with Microsoft Dynamics 365 for Operations Overview Use the Informatica Cloud Mapping Designer to create a mapping. When you create a mapping, you configure a source or target to represent a Microsoft Dynamics 365 for Operations object. Describe the flow of data from the source to the target along with the required transformations. When you create a Mapping Configuration task, select the mapping that you want to use. Use the Mapping Configuration Task wizard to create a Mapping Configuration task. The Mapping Configuration task processes data based on the data flow logic you define in the mapping. Microsoft Dynamics 365 for Operations Sources in Mappings In a mapping, you can configure a Source transformation to represent a Microsoft Dynamics 365 for Operations source. 14

15 The following table describes the Microsoft Dynamics 365 for Operations source properties that you can configure in a Source transformation: Property Connection Source Type Object Filter Sort Description Name of the source connection. Select Single Object or Parameter. Name of the source object for mapping. Filter value in a read operation. You can add conditions to filter records and reduce the number of rows that the Secure Agent reads from the source. Sorts records based on the conditions you specify. Click Configure to add conditions to sort records and reduce the number of rows that the Secure Agent reads from the source. The following table describes the Microsoft Dynamics 365 for Operations advanced properties that you can configure in a Source transformation: Advanced Property Number of rows to read Number of rows to skip Description Fetches the number of rows specified. Sets the number of rows you can skip. For example, you can set this property to n to skip the first n rows in a source and read from the (n+1) row. Page Size Size of the page set to retrieve the maximum number of entries for each page. Default value is 100. Tracing Level Sets the amount of detail that appears in the log file. You can choose terse, normal, verbose initialization, or verbose data. Default is normal. Microsoft Dynamics 365 for Operations Lookups in Mappings You can create lookups for objects in Microsoft Dynamics 365 for Operations connection. You can retrieve data from a Microsoft Dynamics 365 for Operations lookup object based on the specified lookup condition. When you configure a lookup in Microsoft Dynamics 365 for Operations, you select the lookup connection and lookup object. You also define the behavior when a lookup condition returns more than one match. The following table describes the Microsoft Dynamics 365 for Operations lookup object properties that you can configure in a Lookup transformation: Property Connection Source Type Description Name of the lookup connection. Type of the source object. Select Single Object. Microsoft Dynamics 365 for Operations Lookups in Mappings 15

16 Property Lookup Object Multiple Matches Filter Sort Description Name of the lookup object for the mapping. Behavior when the lookup condition returns multiple matches. Select Return any row, Return all rows, or Report error. Not supported. Not supported. The following table describes the Microsoft Dynamics 365 for Operations lookup object advanced properties that you can configure in a Lookup transformation in mappings: Advanced Property Description Number of rows to read Fetches the number of rows specified. Default value is 0. Number of rows to skip Sets the number of rows you can skip. Default value is 0. Page Size Size of the page set to retrieve the maximum number of entries for each page. Default value is 100. Microsoft Dynamics 365 for Operations Mapping Example You are a sales manager in a manufacturing organization and your sales team needs details of potential customers. You want to review the customer activities in an analytics tool. Create a Mapping Configuration task to use the insert operation. You use the following objects in the Microsoft Dynamics 365 for Operations mapping: Source Object The source object for a Mapping Configuration task is Customer. Use the Microsoft Dynamics 365 for Operations connection to read customer data from Microsoft Dynamics 365 for Operations. The Customer object is a single source in the Mapping Configuration task. Target Object Use a.csv file as the target object in the Mapping Configuration task. The target in a Mapping Configuration task is a flat file. The target includes the AddressCity, AddressCounty, BirthPlace, CreditLimit, CustomerAccount, InvoiceAccount, InvoiceAddress, and Name fields. Mapping Map the fields of the Microsoft Dynamics 365 for Operations Customer source to the flat file target. 16 Chapter 4: Mappings and Mapping Configuration Tasks with Microsoft Dynamics 365 for Operations Connector

17 The following image shows the Microsoft Dynamics 365 for Operations mapping: The following image shows the mapped fields of Microsoft Dynamics 365 for Operations source with the flat file target object: When you run the mapping, the agent writes the Customer details to the flat file. The following image shows the Customer details that the agent writes based on the fields you mapped in the Mapping Configuration task: Microsoft Dynamics 365 for Operations Mapping Example 17

18 A P P E N D I X A Data Type Reference This appendix includes the following topics: Data Type Reference Overview, 18 Microsoft Dynamics 365 for Operations and Transformation Data Types, 18 Data Type Reference Overview Informatica Cloud uses the following data types in Microsoft Dynamics 365 for Operations mappings, Data Synchronization and Mapping Configuration tasks: Microsoft Dynamics 365 for Operations native data types appear in the source transformations when you choose to edit metadata for the fields. Transformation data types. Set of data types that appear in the transformations. These are internal data types based on ANSI SQL-92 generic data types, which the Secure Agent uses to move data across platforms. They appear in all transformations in a mapping. When the Secure Agent reads source data, it converts the native data types to the comparable transformation data types before transforming the data. When the Secure Agent writes to a target, it converts the transformation data types to the comparable native data types. Microsoft Dynamics 365 for Operations and Transformation Data Types The following table lists the Microsoft Dynamics 365 for Operations data types that Informatica Cloud supports and the corresponding transformation data types: Microsoft Dynamics 365 for Operations Data Type date enum guid Transformation Data Type date/time string string 18

19 Microsoft Dynamics 365 for Operations Data Type int32 int64 real string UtcDateTime Transformation Data Type integer bigint decimal string date/time Microsoft Dynamics 365 for Operations and Transformation Data Types 19

20 I n d e x A admin tasks configuration property 8 log4j.configuration 8 register a native application 8 administration 8 azure active directory 8 C Configuration -Dlog4j.configuration Property 8 connections application ID 9 connection properties 9 overview 9 service URL 9 connector overview 7 D data synchronization tasks advanced source properties 11 lookup overview 12 lookup properties 12 number of rows to read 11 number of rows to skip 11 source properties 11 sources 11 data types native data types 18 overview 18 transformation data types 18 L log4j.properties file 8 lookup expression 12 lookup (continued) lookup fields 12 multiple matches 15 multiplicity 12 output field 12 M mapping configuration tasks advanced source properties 14 Number of rows to read 14 Number of rows to skip 14 overview 14 source properties 14 sources 14 mappings advanced source properties 14 example 16 lookup overview 15 lookup properties 15 Number of rows to read 14 Number of rows to skip 14 overview 14 source properties 14 sources 14 Microsoft Dynamics 365 for Operation connector 7 Microsoft Dynamics 365 for Operations connections 9 data synchronization tasks 11 object types 7 tasks 7 R register a native application 8 S set JVM option 8 20