イド PowerCenter ユーザーガ...イド PowerCenter ユーザーガ ... 12

Informatica® PowerExchange for Salesforce10.4.0

PowerCenter ユーザーガイド

Informatica PowerExchange for Salesforce PowerCenter ユーザーガイド10.4.02019 年 12 月© 著作権 Informatica LLC 2009, 2020本ソフトウェアおよびマニュアルは、使用および開示の制限を定めた個別の使用許諾契約のもとでのみ提供されています。本マニュアルのいかなる部分も、いかなる手段（電子的複写、写真複写、録音など）によっても、Informatica LLC の事前の承諾なしに複製または転載することは禁じられています。Informatica、Informatica ロゴ、PowerCenter、および PowerExchange は、米国およびその他の国における Informatica LLC の商標または登録商標です。Informaticaの商標の最新リストは、Web（https://www.informatica.com/trademarks.html ）にあります。その他の企業名および製品名は、それぞれの企業の商標または登録商標です。本ソフトウェアまたはドキュメントの一部は、次のサードパーティが有する著作権に従います（ただし、これらに限定されません）。Copyright DataDirect Technologies. All rights reserved. Copyright (C) Sun Microsystems.All Rights Reserved.Copyright (C) RSA Security Inc. All rights reserved. Copyright (C) Ordinal Technology Corp. All rights reserved.Copyright (C) Aandacht c.v. All rights reserved. Copyright Genivia, Inc. All rights reserved. Copyright Isomorphic Software. All rights reserved. Copyright (C) Meta Integration Technology, Inc. All rights reserved. Copyright (C) Intalio. All Rights Reserved.Copyright (C) Oracle. All Rights Reserved.Copyright (C) Adobe Systems Incorporated. All rights reserved. Copyright (C) DataArt, Inc. All rights reserved. Copyright (C) ComponentSource. All rights reserved. Copyright (C) Microsoft Corporation. All Rights Reserved.Copyright (C) Rogue Wave Software, Inc. All rights reserved. Copyright (C) Teradata Corporation. All Rights Reserved.Copyright (C) Yahoo! Inc. All rights reserved. Copyright (C) Glyph & Cog, LLC. All rights reserved. Copyright (C) Thinkmap, Inc. All rights reserved. Copyright (C) Clearpace Software Limited. All rights reserved. Copyright (C) Information Builders, Inc. All rights reserved. Copyright (C) OSS Nokalva, Inc. All rights reserved. Copyright Edifecs, Inc. All rights reserved. Copyright Cleo Communications, Inc. All rights reserved. Copyright (C) International Organization for Standardization 1986. All rights reserved. Copyright (C) ej-technologies GmbH. All rights reserved. Copyright (C) Jaspersoft Corporation. All rights reserved. Copyright (C) International Business Machines Corporation.All rights reserved. Copyright (C) yWorks GmbH. All rights reserved. Copyright (C) Lucent Technologies. All rights reserved. Copyright (C) University of Toronto. All rights reserved. Copyright (C) Daniel Veillard. All rights reserved. Copyright (C) Unicode, Inc. Copyright IBM Corp. All rights reserved. Copyright (C) MicroQuill Software Publishing, Inc. All rights reserved. Copyright (C) PassMark Software Pty Ltd. All rights reserved. Copyright (C) LogiXML, Inc. All rights reserved. Copyright (C) 2003-2010 Lorenzi Davide, All rights reserved. Copyright (C) Red Hat, Inc. All rights reserved. Copyright (C) The Board of Trustees of the Leland Stanford Junior University. All rights reserved. Copyright (C) EMC Corporation. All rights reserved. Copyright (C) Flexera Software. All rights reserved. Copyright (C) Jinfonet Software. All rights reserved. Copyright (C) Apple Inc. All rights reserved. Copyright (C) Telerik Inc. All rights reserved. Copyright (C) BEA Systems. All rights reserved. Copyright (C) PDFlib GmbH. All rights reserved. Copyright (C) Orientation in Objects GmbH. All rights reserved. Copyright (C) Tanuki Software, Ltd. All rights reserved. Copyright (C) Ricebridge. All rights reserved. Copyright (C) Sencha, Inc. All rights reserved. Copyright (C) Scalable Systems, Inc. All rights reserved. Copyright (C) jQWidgets. All rights reserved. Copyright (C) Tableau Software, Inc. All rights reserved. Copyright (C) MaxMind, Inc. All rights reserved. Copyright (C) TMate Software s.r.o. All rights reserved. Copyright (C) MapR Technologies Inc. All rights reserved. Copyright (C) Amazon Corporate LLC. All rights reserved. Copyright (C) Highsoft. All rights reserved. Copyright (C) Python Software Foundation. All rights reserved. Copyright (C) BeOpen.com. All rights reserved. Copyright (C) CNRI. All rights reserved. 本製品には、Apache Software Foundation（http://www.apache.org/）によって開発されたソフトウェア、およびさまざまなバージョンの Apache License（まとめて「License」と呼んでいます）の下に許諾された他のソフトウェアが含まれます。これらのライセンスのコピーは、http://www.apache.org/licenses/ で入手できます。適用法にて要求されないか書面にて合意されない限り、ライセンスの下に配布されるソフトウェアは「現状のまま」で配布され、明示的あるいは黙示的かを問わず、いかなる種類の保証や条件も付帯することはありません。ライセンス下での許諾および制限を定める具体的文言については、ライセンスを参照してください。本製品には、Mozilla（http://www.mozilla.org/）によって開発されたソフトウェア、ソフトウェア Copyright (c) The JBoss Group, LLC, all rights reserved、ソフトウェア Copyright (c) 1999-2006 by Bruno Lowagie and Paulo Soares および GNU Lesser General Public License Agreement のさまざまなバージョン（http://www.gnu.org/licenses/lgpl.html で参照できる場合がある）に基づいて許諾されたその他のソフトウェアが含まれています。資料は、Informatica が無料で提供しており、一切の保証を伴わない「現状渡し」で提供されるものとし、Informatica LLC は市場性および特定の目的の適合性の黙示の保証などを含めて、一切の明示的及び黙示的保証の責任を負いません。製品には、ワシントン大学、カリフォルニア大学アーバイン校、およびバンダービルト大学の Douglas C.Schmidt および同氏のリサーチグループが著作権を持つ ACE（TM）および TAO（TM）ソフトウェアが含まれています。Copyright (C) 1993-2006, All rights reserved.本製品には、OpenSSL Toolkit を使用するために OpenSSL Project が開発したソフトウェア（copyright The OpenSSL Project.All Rights Reserved）が含まれています。また、このソフトウェアの再配布は、http://www.openssl.org および http://www.openssl.org/source/license.html にある使用条件に従います。本製品には、Curl ソフトウェア Copyright 1996-2013, Daniel Stenberg, <[email protected]>が含まれます。All rights reserved. 本ソフトウェアに関する許諾および制限は、http://curl.haxx.se/docs/copyright.html にある使用条件に従います。すべてのコピーに上記の著作権情報とこの許諾情報が記載されている場合、目的に応じて、本ソフトウェアの使用、コピー、変更、ならびに配布が有償または無償で許可されます。本製品には、MetaStuff, Ltd.のソフトウェアが含まれます。Copyright 2001-2005 (C) MetaStuff, Ltd. All Rights Reserved.本ソフトウェアに関する許諾および制限は、http://www.dom4j.org/license.html にある使用条件に従います。製品には、The Dojo Foundation のソフトウェアが含まれます。Copyright (C) 2004-2007.All rights reserved. 本ソフトウェアに関する許諾および制限は、http://dojotoolkit.org/license にある使用条件に従います。本製品には、ICU ソフトウェアおよび他のソフトウェアが含まれます。Copyright International Business Machines Corporation.All rights reserved. 本ソフトウェアに関する許諾および制限は、http://source.icu-project.org/repos/icu/icu/trunk/license.html にある使用条件に従います。本製品には、Per Bothner のソフトウェアが含まれます。Copyright (C) 1996-2006.All rights reserved. お客様がこのようなソフトウェアを使用するための権利は、ライセンスで規定されています。http://www.gnu.org/software/kawa/Software-License.html を参照してください。本製品には、OSSP UUID ソフトウェアが含まれます。Copyright (C) 2002 Ralf S. Engelschall, Copyright (C) 2002 The OSSP Project Copyright (C) 2002 Cable & Wireless Deutschland.本ソフトウェアに関する許諾および制限は、http://www.opensource.org/licenses/mit-license.php にある使用条件に従います。本製品には、Boost（http://www.boost.org/）によって開発されたソフトウェア、または Boost ソフトウェアライセンスの下で開発されたソフトウェアが含まれます。本ソフトウェアに関する許諾および制限は、http://www.boost.org/LICENSE_1_0.txt にある使用条件に従います。本製品には、University of Cambridge のが含まれます。Copyright (C) 1997-2007.本ソフトウェアに関する許諾および制限は、http://www.pcre.org/license.txt にある使用条件に従います。本製品には、The Eclipse Foundation のソフトウェアが含まれます。Copyright (C) 2007.All rights reserved. 本ソフトウェアに関する許諾および制限は、http://www.eclipse.org/org/documents/epl-v10.php および http://www.eclipse.org/org/documents/edl-v10.php にある使用条件に従います。本製品には、http://www.tcl.tk/software/tcltk/license.html、http://www.bosrup.com/web/overlib/?License、http://www.stlport.org/doc/license.html、http://www.asm.ow2.org/license.html、http://www.cryptix.org/LICENSE.TXT、http://hsqldb.org/web/hsqlLicense.html、http://httpunit.sourceforge.net/doc/license.html、http://jung.sourceforge.net/license.txt、http://www.gzip.org/zlib/zlib_license.html、http://www.openldap.org/software/release/license.html、http://www.libssh2.org、http://slf4j.org/license.html、http://www.sente.ch/software/OpenSourceLicense.html、http://fusesource.com/downloads/license-agreements/fuse-message-broker-v-5-3-license-agreement、http://antlr.org/license.html、http://aopalliance.sourceforge.net/、http://www.bouncycastle.org/licence.html、http://www.jgraph.com/jgraphdownload.html、http://www.jcraft.com/jsch/LICENSE.txt、http://jotm.objectweb.org/bsd_license.html に基づいて許諾されたソフトウェアが含まれています。http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231、http://www.slf4j.org/license.html、http://nanoxml.sourceforge.net/orig/copyright.html、http://www.json.org/license.html、http://forge.ow2.org/projects/javaservice/、http://www.postgresql.org/about/licence.html、http://www.sqlite.org/copyright.html、http://www.tcl.tk/software/tcltk/license.html、http://www.jaxen.org/faq.html、http://www.jdom.org/docs/

faq.html、http://www.slf4j.org/license.html、http://www.iodbc.org/dataspace/iodbc/wiki/iODBC/License、http://www.keplerproject.org/md5/license.html、http://www.toedter.com/en/jcalendar/license.html、http://www.edankert.com/bounce/index.html、http://www.net-snmp.org/about/license.html、http://www.openmdx.org/#FAQ、http://www.php.net/license/3_01.txt、http://srp.stanford.edu/license.txt、http://www.schneier.com/blowfish.html、http://www.jmock.org/license.html、http://xsom.java.net、http://benalman.com/about/license/、https://github.com/CreateJS/EaselJS/blob/master/src/easeljs/display/Bitmap.js、http://www.h2database.com/html/license.html#summary、http://jsoncpp.sourceforge.net/LICENSE、http://jdbc.postgresql.org/license.html、http://protobuf.googlecode.com/svn/trunk/src/google/protobuf/descriptor.proto、https://github.com/rantav/hector/blob/master/LICENSE、http://web.mit.edu/Kerberos/krb5-current/doc/mitK5license.html、http://jibx.sourceforge.net/jibx-license.html、https://github.com/lyokato/libgeohash/blob/master/LICENSE、https://github.com/hjiang/jsonxx/blob/master/LICENSE、https://code.google.com/p/lz4/、https://github.com/jedisct1/libsodium/blob/master/LICENSE、http://one-jar.sourceforge.net/index.php?page=documents&file=license、https://github.com/EsotericSoftware/kryo/blob/master/license.txt、http://www.scala-lang.org/license.html、https://github.com/tinkerpop/blueprints/blob/master/LICENSE.txt、http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/intro.html、https://aws.amazon.com/asl/、https://github.com/twbs/bootstrap/blob/master/LICENSE、および https://sourceforge.net/p/xmlunit/code/HEAD/tree/trunk/LICENSE.txt。本製品には、Academic Free License（http://www.opensource.org/licenses/afl-3.0.php）、Common Development and Distribution License（http://www.opensource.org/licenses/cddl1.php）、Common Public License（http://www.opensource.org/licenses/cpl1.0.php）、Sun Binary Code License Agreement Supplemental License Terms、BSD License（http:// www.opensource.org/licenses/bsd-license.php）、BSD License（http://opensource.org/licenses/BSD-3-Clause）、MIT License（http://www.opensource.org/licenses/mit-license.php）、Artistic License（http://www.opensource.org/licenses/artistic-license-1.0）、Initial Developer’s Public License Version 1.0（http://www.firebirdsql.org/en/initial-developer-s-public-license-version-1-0/）に基づいて許諾されたソフトウェアが含まれています。本製品には、ソフトウェア copyright (C) 2003-2006 Joe WaInes, 2006-2007 XStream Committers が含まれています。All rights reserved. 本ソフトウェアに関する許諾および制限は、http://j.org/license.html にある使用条件に従います。本製品には、Indiana University Extreme! Lab によって開発されたソフトウェアが含まれています。詳細については、http://www.extreme.indiana.edu/を参照してください。本製品には、ソフトウェア Copyright (C) 2013 Frank Balluffi and Markus Moeller が含まれています。All rights reserved. 本ソフトウェアに関する許諾および制限は、MIT ライセンスの使用条件に従います。特許については、https://www.informatica.com/legal/patents.html を参照してください。免責: 本文書は、一切の保証を伴わない「現状渡し」で提供されるものとし、Informatica LLC は他社の権利の非侵害、市場性および特定の目的への適合性の黙示の保証などを含めて、一切の明示的および黙示的保証の責任を負いません。Informatica LLC では、本ソフトウェアまたはドキュメントに誤りのないことを保証していません。本ソフトウェアまたはドキュメントに記載されている情報には、技術的に不正確な記述や誤植が含まれる場合があります。本ソフトウェアまたはドキュメントの情報は、予告なしに変更されることがあります。NOTICESこの Informatica 製品（以下「ソフトウェア」）には、Progress Software Corporation（以下「DataDirect」）の事業子会社である DataDirect Technologies からの特定のドライバ（以下「DataDirect ドライバ」）が含まれています。DataDirect ドライバには、次の用語および条件が適用されます。1. DataDirect ドライバは、特定物として現存するままの状態で提供され、商品性の保証、特定目的適合性の保証および法律上の瑕疵担保責任を含むすべての明示

もしくは黙示の保証責任を負わないものとします。国または地域によっては、法律の強行規定により、保証責任の制限が禁じられる場合、強行規定の制限を受けるものとします。

2. DataDirect または第三者は、予見の有無を問わず発生した ODBC ドライバの使用に関するいかなる直接的、間接的、偶発的、特別、あるいは結果的損害に対して責任を負わないものとします。本制限事項は、すべての訴訟原因に適用されます。訴訟原因には、契約違反、保証違反、過失、厳格責任、詐称、その他の不法行為を含みますが、これらに限るものではありません。

本マニュアルの情報は、予告なしに変更されることがあります。お客様が本書内に問題を発見された場合は、書面にて当社までお知らせください。Informatica LLC 2100 Seaport Blvd.Redwood City, CA 94063。Informatica LLC は、商品性、特定目的への適合性、非侵害性の保証等を含めて、明示的または黙示的ないかなる種類の保証をせず、本マニュアルの情報を「現状のまま」提供するものとします。発行日: 2020-01-16

https://www.informatica.com/legal/patents.html

目次序文. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Informatica のリソース. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Informatica Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Informatica ナレッジベース. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Informatica マニュアル. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Informatica 製品可用性マトリックス. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Informatica Velocity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Informatica Marketplace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Informatica グローバルカスタマサポート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

第 1 章 : PowerExchange for Salesforce について. . . . . . . . . . . . . . . . . . . . . . . . . . 9PowerExchange for Salesforce の概要について. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9PowerCenter と Salesforce の統合. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Designer と Salesforce の統合. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10PowerCenter Integration Service と Salesforce の統合. . . . . . . . . . . . . . . . . . . . . . . . . . 10

第 2 章 : 設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12設定の概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12プラグイン登録. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

コマンドラインインタフェースを使用したプラグインの登録. . . . . . . . . . . . . . . . . . . . . . . 13Salesforce API のバージョン. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

サポートされている Salesforce のバージョン. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13一括 API ターゲットセッションの Java 要件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Java ヒープサイズの設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14HTTP プロキシオプション. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

PowerCenter クライアントの HTTP プロキシオプションの設定. . . . . . . . . . . . . . . . . . . . . 15PowerCenter Integration Service の HTTP プロキシオプションの設定. . . . . . . . . . . . . . . . 16

第 3 章 : Salesforce のソースおよびターゲット. . . . . . . . . . . . . . . . . . . . . . . . . . . 18Salesforce のソースおよびターゲットの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18関連する Salesforce オブジェクトからのフィールドのインポート. . . . . . . . . . . . . . . . . . . . . . . 18

関連する Salesforce オブジェクトからのフィールドのインポートのルールおよびガイドライン. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Salesforce のソース. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Salesforce のソースのタイムゾーン. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Salesforce のソースからの時間の変換. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Salesforce ターゲット. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Salesforce のターゲットのタイムゾーン. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Salesforce のターゲットの可能なアップデートストラテジの特定. . . . . . . . . . . . . . . . . . . . 21Salesforce のターゲットのアップデートストラテジのルールおよびガイドライン. . . . . . . . . . 22

4 目次

Salesforce のソースまたはターゲット定義のインポート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

第 4 章 : Salesforce ルックアップトランスフォーメーション. . . . . . . . . . . . 24Salesforce ルックアップトランスフォーメーションの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . 24Salesforce ルックアップコンポーネント. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Salesforce ルックアップポート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

ルックアップポート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26パススルーポート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27LKP_FILTER ポート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27LKP_MATCHIDX ポート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Salesforce ルックアップクエリ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Salesforce ルックアップトランスフォーメーションの作成. . . . . . . . . . . . . . . . . . . . . . . . . . . 29

第 5 章 : Salesforce 統合トランスフォーメーション. . . . . . . . . . . . . . . . . . . . . . 30Salesforce 統合トランスフォーメーションの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

サンプルの Salesforce 統合トランスフォーメーション. . . . . . . . . . . . . . . . . . . . . . . . . . . 31Salesforce 統合のコンポーネント. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Salesforce 統合のポート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Salesforce オブジェクトの属性ポート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32ID および SlaveID の入力ポート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32MergedID、MergedSlaveID1、および MergedSlaveID2 の出力ポート. . . . . . . . . . . . . . . . . 32

Salesforce 統合トランスフォーメーションのルールおよびガイドライン. . . . . . . . . . . . . . . . . . . 33Salesforce 統合トランスフォーメーションの作成. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

第 6 章 : Salesforce PickList トランスフォーメーション. . . . . . . . . . . . . . . . . . 35Salesforce PickList トランスフォーメーションの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Salesforce PickList のコンポーネント. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Salesforce PickList のポート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Salesforce PickList トランスフォーメーションのルールおよびガイドライン. . . . . . . . . . . . . . . . 37Salesforce PickList トランスフォーメーションの作成. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

第 7 章 : Salesforce セッションとワークフロー. . . . . . . . . . . . . . . . . . . . . . . . . . . 39Salesforce セッションとワークフローの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Salesforce 接続. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Salesforce 接続の設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Salesforce のソースとのセッションの設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

ソースデータのフィルタリング. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43削除済みおよびアーカイブ済みの Salesforce レコードのキャプチャ. . . . . . . . . . . . . . . . . . 44変更データのキャプチャ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44継続 CDC セッション. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44時間枠ベースの CDC セッション. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45変更データのキャプチャでの SystemModstamp または LastModifiedDate タイムスタンプの使用. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

目次 5

一括 API ソースセッション. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Salesforce のターゲットとのセッションの設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

ターゲットに対する更新/挿入操作の設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49最大バッチサイズの設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50更新操作および更新/挿入操作での NULL 値の処理. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50PowerExchange for Salesforce セッションのログの詳細. . . . . . . . . . . . . . . . . . . . . . . . . 51更新/挿入用の idLookup による外部 ID のオーバーライド. . . . . . . . . . . . . . . . . . . . . . . . . 52一括 API ターゲットセッション. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52一括 API ターゲットセッションを監視. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52一括 API ターゲットロードタイプ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Bulk API ターゲット成功ファイルおよびエラーファイル. . . . . . . . . . . . . . . . . . . . . . . . . . 53一括 API ターゲットによる物理削除. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

セッションパフォーマンスを最㽩にする設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56DTM バッファサイズの調整. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56文字フィールドの精度の変更. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

付録 A : データタイプリファレンス. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57データタイプリファレンスの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Salesforce データタイプとトランスフォーメーションデータタイプ. . . . . . . . . . . . . . . . . . . . . 57

付録 B : 用語集. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60索引. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

6 目次

序文Informatica® PowerExchange® for Salesforce のユーザーガイドを使用して、PowerCenter Client でSalesforce との間で読み取りまたは書き込みを実行する方法について学びます。Informatica ドメインで、Salesforce 接続を作成し、マッピングを開発し、セッションを実行する方法を学習します。

Informatica のリソースInformatica は、Informatica Network やその他のオンラインポータルを通じてさまざまな製品リソースを提供しています。リソースを使用して Informatica 製品とソリューションを最大限に活用し、その他のInformatica ユーザーや各分野の専門家から知見を得ることができます。

Informatica NetworkInformatica Network は、Informatica ナレッジベースや Informatica グローバルカスタマサポートなど、多くのリソースへの入口です。Informatica Network を利用するには、https://network.informatica.com にアクセスしてください。Informatica Network メンバーは、次のオプションを利用できます。• ナレッジベースで製品リソースを検索できます。• 製品の提供情報を表示できます。• サポートケースを作成して確認できます。• 最寄りの Informatica ユーザーグループネットワークを検索して、他のユーザーと共同作業を行えます。

Informatica ナレッジベースInformatica ナレッジベースを使用して、ハウツー記事、ベストプラクティス、よくある質問に対する回答など、製品リソースを見つけることができます。ナレッジベースを検索するには、https://search.informatica.com にアクセスしてください。ナレッジベースに関する質問、コメント、ご意見の連絡先は、Informatica ナレッジベースチーム

（[email protected]）です。

Informatica マニュアルInformatica マニュアルポータルでは、最新および最近の製品リリースに関するドキュメントの膨大なライブラリを参照できます。マニュアルポータルを利用するには、https://docs.informatica.com にアクセスしてください。

7

https://network.informatica.com

http://search.informatica.com

mailto:[email protected]

https://docs.informatica.com

製品マニュアルに関する質問、コメント、ご意見については、Informatica マニュアルチーム（[email protected]）までご連絡ください。

Informatica 製品可用性マトリックス製品可用性マトリックス（PAM）には、製品リリースでサポートされるオペレーティングシステム、データベースなどのデータソースおよびターゲットが示されています。Informatica PAM は、https://network.informatica.com/community/informatica-network/product-availability-matrices で参照できます。

Informatica VelocityInformatica Velocity は、Informatica プロフェッショナルサービスが開発したヒントとベストプラクティスのコレクションで、多数のデータ管理プロジェクトから得た実体験に基づいています。Informatica Velocityには、世界中の組織と連携してデータ管理ソリューションを計画、開発、デプロイ、管理する Informatica コンサルタントによる集合知を表しています。Informatica Velocity リソースには、http://velocity.informatica.com からアクセスしてください。Informatica Velocity についての質問、コメント、またはアイデアがある場合は、[email protected] からInformatica プロフェッショナルサービスにお問い合わせください。

Informatica MarketplaceInformatica Marketplace は、お使いの Informatica 製品を拡張したり強化したりするソリューションを検索できるフォーラムです。Marketplace で、Informatica デベロッパーやパートナーからの多数のソリューションを活用すれば、生産性を向上したり、プロジェクトでの実装時間を短縮したりできます。Informatica Marketplace は、https://marketplace.informatica.com からアクセスしてください。

Informatica グローバルカスタマサポート電話または Informatica Network からグローバルサポートセンターに連絡できます。各地域の Informatica グローバルカスタマサポートの電話番号は、Informatica Web サイト

（https://www.informatica.com/services-and-training/customer-success-services/contact-us.html）を参照してください。Informatica Network でオンラインサポートリソースを見つけるには、https://network.informatica.com にアクセスし、eSupport オプションを選択します。

8 序文


https://network.informatica.com/community/informatica-network/product-availability-matrices

http://velocity.informatica.com


https://marketplace.informatica.com

https://www.informatica.com/services-and-training/customer-success-services/contact-us.html

http://network.informatica.com

第 1 章

PowerExchange for Salesforceについて

この章では、以下の項目について説明します。• PowerExchange for Salesforce の概要について, 9 ページ• PowerCenter と Salesforce の統合, 10 ページ

PowerExchange for Salesforce の概要についてPowerExchange for Salesforce は、PowerCenter と Salesforce を統合することによって Salesforce のソースからデータを抽出し、データを Salesforce ターゲットに書き出します。 Salesforce のソースとターゲットは、Salesforce オブジェクトモデルのオブジェクトを表します。Salesforce オブジェクトとは、Salesforce Web サイトのタブや他のユーザーインタフェース要素に対応するテーブルです。例えば、Account オブジェクトには、Salesforce の［アカウント］タブのフィールドに表示される情報が含まれます。 Salesforce オブジェクトのデータを表示、更新、および削除できます。PowerExchange for Salesforce では、Salesforce のセキュリティモデルを使用してデータアクセス制御を実行しています。データにアクセスできるかどうかは、Salesforce の組織（org）によって異なります。これは、Salesforce への接続時に使用するユーザーログインに関連付けられています。また、ログインに関連付けられたユーザー権限、フィールドおよび行レベルの権限にも依存します。Workflow Manager で作成するアプリケーション接続オブジェクト内か、もしくは Designer の Salesforce オブジェクトのインポート時に、Salesforce のログインユーザーとパスワードを指定します。 PowerExchange for Salesforce では、Salesforce API を使用して既存のアクセスポリシーを適用し、データアクセスの制限事項を追加しません。PowerExchange for Salesforce には以下の利点があります。• データの統合と移行。他のアプリケーションなど、多種多様なデータソースのデータと Salesforce データ

を統合します。さらに、PowerCenter を使用して各種データソースから Salesforce にデータを移行します。

• データ分析。PowerCenter に内蔵するデータ品質機能を使用して Salesforce データの分析および評価を行います。

• PowerCenter を介した Salesforce の機能へのアクセス。PowerCenter のソースとターゲットとしてSalesforce オブジェクトへのフルアクセスが可能です。

9

PowerCenter と Salesforce の統合PowerExchange for Salesforce によって Salesforce と Designer が統合されるため、Salesforce オブジェクトを PowerCenter にインポートして、マッピングに使用できます。また、Salesforce と PowerCenter Integration Service を統合するため、Salesforce データの抽出、トランスフォーム、ロードを行うワークフローを実行できます。PowerExchange for Salesforce では、Transport Layer Security（TLS）を使用して、インターネットを通過するすべてのデータを暗号化します。暗号化には SHA-256 ビットが使用されます。さらに、ユーザ ID、パスワード、セッション ID をリポジトリや一時的なストレージに保存する前にも 256 ビットの暗号化が使用されます。

Designer と Salesforce の統合Designer を使用して、Salesforce オブジェクトを Salesforce のソース定義またはターゲット定義、Salesforce ルックアップ、統合、または Picklist トランスフォーメーションとしてインポートします。次に、PowerCenter と Salesforce のシームレスな統合のた〿に、マッピングでそれらのオブジェクトを使用できます。標準とカスタムの両方の Salesforce オブジェクトをインポートできます。標準オブジェクトタイプとは、Account、AccountPartner、Event、Opportunity、Product などの、Salesforce で用意されているオブジェクトです。カスタムオブジェクトタイプは、組織固有のデータエンティティを定義することにより、Salesforce データを組織用に拡張します。 Salesforce の管理者は、標準およびカスタムオブジェクトの両方に対してカスタムフィールドを定義できます。Designer は、Salesforce ログインを使用して Salesforce サービスに接続します。次に、インポートに使用可能なオブジェクトのリストを生成します。

PowerCenter Integration Service と Salesforce の統合PowerCenter Integration Service は、Salesforce データの抽出、トランスフォーム、ロードを行うために、Salesforce に接続します。 PowerCenter Integration Service は、Salesforce ログインコールを使用してSalesforce サービスに対する認証を行います。本番環境か、Salesforce Sandbox と呼ばれる特別なテストおよび開発環境のいずれかを使用するように、ログインサーバーを指定できます。接続オブジェクトには、Salesforce のユーザー ID、パスワード、実行時接続のエンドポイント URL 情報が格納されます。また、PowerCenter サーバーの IP アドレスを Salesforce の信頼できる IP リストに追加していない場合には、セキュリティトークンも格納します。マッピングの各 Salesforce のソースまたはターゲットは、Salesforce アプリケーション接続のオブジェクトを参照します。マッピングで複数の Salesforce アプリケーション接続を使用することでソースとターゲットの Salesforce データの異なるセットにアクセスできます。PowerCenter Integration Service は、Salesforce セキュリティメカニズムを使用してユーザーの認証とセッションの管理を行います。 Salesforce API は、実行時セッションの開始時点で、ユーザー ID およびパスワードの認証を行います。セッション実行時に、PowerCenter Integration Service は、マッピング内の Salesforce のソース定義とフィールドプロジェクションに基づく SOQL クエリを生成します。 SOQL 言語は SQL から派生したものです。Salesforce API が、実行時に SOQL 構文検査を実行します。PowerCenter Integration Service では、Salesforce オブジェクトに対する読み出しおよび書き込みを行うために、Salesforce API が使用されます。大量の Salesforce データを読み出すときに、PowerCenter Integration Service はデータを小さなセグメントに分割します。 PowerExchange for Salesforce は、クエリ結果のセット全体が取得されるまで、サブセットに対する順次要求を送信します。

10 第 1 章: PowerExchange for Salesforce について

PowerCenter Integration Service は、SOAP プロトコルを使用し、PowerCenter Integration Service とSalesforce サービス間でデータを送信します。パフォーマンスを改善するために、PowerCenter Integration Service は、HTTP 圧縮を使用して、インターネットで送信される SOAP パケットのサイズを小型化します。PowerCenter Integration Service が Salesforce にデータを書き込むときに、PowerCenter のデータタイプは Salesforce のデータタイプに変換されます。

コードページSalesforce では、UTF-16LE 文字を処理します。 PowerCenter Integration Service では、次のデータ移動モードに基づいて Salesforce データを処理します。• ASCII。PowerCenter Integration Service は ASCII モードで実行しているとき、コードページ検査やデー

タ変換をまったく行いません。 Salesforce ターゲットへの書き込みの際、PowerCenter Integration Service が ASCII モードで動作しているのに ASCII 以外の文字データも処理する場合、整合性が取れない、または切り詰められたデータになる可能性があります。

• Unicode。 PowerCenter Integration Service は、Unicode モードで実行時に、データをソース文字セットから UCS-2 に変換し、データを処理してから、データをロードする前に UCS-2 データをターゲットコードページ文字セットに変換します。セッションが Salesforce ターゲットに書き込む場合、PowerCenter Integration Service は UCS-2 データを UTF-16LE 文字セットに変換します。

PowerCenter と Salesforce の統合 11

第 2 章

設定この章では、以下の項目について説明します。• 設定の概要, 12 ページ• プラグイン登録, 12 ページ• Salesforce API のバージョン, 13 ページ• 一括 API ターゲットセッションの Java 要件, 14 ページ• Java ヒープサイズの設定, 14 ページ• HTTP プロキシオプション, 15 ページ

設定の概要PowerExchange for Salesforce は PowerCenter とともにインストールされます。PowerExchange for Salesforce をインストールした後、以前のバージョンからアップグレードするか HotFixを適用し、PowerExchange for Salesforce プラグインを PowerCenter リポジトリに登録する必要があります。

プラグイン登録PowerExchange for Salesforce をインストールして、以前のバージョンからアップグレードするか、HotFixを適用したら、PowerExchange for Salesforce プラグインを PowerCenter リポジトリにコマンドラインインタフェースで登録することが必須となります。プラグインとは、PowerExchange for Salesforce の機能を定義する XML ファイルです。プラグインを登録するには、リポジトリが排他モードで実行中である必要があります。pmrep RegisterPlugin コマンドを使用してプラグインを登録します。PowerExchange for Salesforce のプラグインファイルは pmsfdc.xml です。Repository コンポーネントをインストールすると、pmsfdc.xml ファイルが次のディレクトリにコピーされます。<Informatica installation directory>/server/bin/native注: プラグインを登録するための適切な特権がない場合は、PowerCenter リポジトリサービスの管理ユーザーに連絡してください。

12

コマンドラインインタフェースを使用したプラグインの登録pmrep registerplugin コマンドを使用して Salesforce プラグインを登録するには、次の手順を実行します。1. PowerCenter リポジトリサービスを無効にします。 2. リポジトリモードを［ノーマル］から［排他］に変更します。 3. PowerCenter リポジトリサービスを有効にします。 4. リポジトリサービスが実行されている PowerCenter サーバーマシンで、<$INFA_HOME>/server/bin に移動

し、pmrep connect -r <repositoryname> -d <domain_name> -n <Repository_user_name> -x <Repository_password>コマンドを実行します。

5. pmrep registerplugin コマンド（pmrep registerplugin -i <$INFA_HOME>/server/bin/native/pmsfdc.xml -e -N）を実行して、Salesforce プラグインを登録します。

6. PowerCenter リポジトリサービスを無効にします。 7. リポジトリモードを［排他］から［ノーマル］に変更します。 8. PowerCenter リポジトリサービスを有効にします。

Salesforce API のバージョンPowerExchange for Salesforce でソースとターゲットのトランスフォーメーションに使用される Salesforce API のバージョンは最大 47.0 です。Salesforce カスタムトランスフォーメーション（ルックアップ、統合、PickList など）をマッピングに含めるには、Salesforce API のバージョン 33.0 以下を使用する必要があります。最新バージョンの Salesforce API を使用するには、アプリケーション接続を作成します。アプリケーション接続内の Salesforce サービスの URL を更新することもできます。バージョン 47.0 の Salesforce API を使用するには、次の Salesforce サービスの URL を使用します。https://login.salesforce.com/services/Soap/u/47.0Salesforce オブジェクトの構造体が以前のバージョンオブジェクトと異なる場合、Salesforce オブジェクトを再度インポートします。オブジェクトをインポートした後、関連するマッピングを分析して、マッピングを更新する必要があるかどうかを判断します。ソースとターゲットのトランスフォーメーションではビッグオブジェクトがサポートされています。

サポートされている Salesforce のバージョン以前のリリースの PowerExchange for Salesforce でサポートされている Salesforce API のバージョンを使用できます。

Salesforce API のバージョン 13

以下の表に、サポートされている各 Salesforce API に対応する Salesforce サービスの URL を一覧で示します。

PowerExchange for Salesforce のバージョン Salesforce サービスの URL10.4.0 https://login.salesforce.com/services/Soap/u/47.0

https://login.salesforce.com/services/Soap/u/46.010.2.0 HotFix 2 https://login.salesforce.com/services/Soap/u/45.0

https://login.salesforce.com/services/Soap/u/44.0https://login.salesforce.com/services/Soap/u/43.0

10.2.0 HotFix1 https://login.salesforce.com/services/Soap/u/42.010.2.0.1.1 https://login.salesforce.com/services/Soap/u/41.010.2 https://login.salesforce.com/services/Soap/u/33.0

一括 API ターゲットセッションの Java 要件Salesforce 一括 API を使用して Salesforce ターゲットにデータを書き込む場合は、PowerCenter 統合サービスマシン上の Java 一時ディレクトリに最低でも 10 MB の空き容量があることを確認してください。推奨される空き容量は 50 MB です。データの書き込み時に、Salesforce 一括 API は各バッチのデータを Java 一時ディレクトリ内のファイルに圧縮し、その圧縮したバッチファイルを Salesforce に処理のために送信します。Java 一時ディレクトリに最低でも 10 MB～50 MB の領域を設定します。Java 一時ディレクトリは、以下の場所にあります。• Windows の場合: C:\Windows\Temp。• UNIX ノードの場合: /tmp。

Java ヒープサイズの設定Salesforce セッションで読み取り操作を正常に実行するには、PowerCenter 統合サービスを実行するノードの Java ヒープサイズのメモリを設定します。Java ヒープサイズを設定するには、次の手順を実行します。1. 管理コンソールで、Java ヒープサイズを変更する PowerCenter 統合サービスに移動します。2. ［プロセス］タブをクリックします。3. ［カスタムプロパティ］をクリックします。［カスタムプロパティの編集］ダイアログボックスが表示され

ます。4. ［新規］をクリックして新しいカスタムプロパティを追加します。以下の表に、プロパティ名とサンプル値

を示します。

14 第 2 章: 設定

5. プロパティ名と値を指定します。

プロパティ名プロパティ値サンプル値JVMOption1 最大ヒープサイズを設定する-Xmx<メモリサイズ> -Xmx1024mJVMOption2 最小ヒープサイズを設定する-Xms<メモリサイズ> -Xms512m

注: 処理するデータに基づいて最大ヒープサイズと最小ヒープサイズを指定します。6. PowerCenter 統合サービスを再起動します。

HTTP プロキシオプションPowerExchange for Salesforce をインストールしていてインターネットのアクセスにプロキシサーバーを使用している場合、HTTP プロキシサーバーの認証設定を行う必要があります。次の PowerCenter コンポーネントに対して HTTP プロキシオプションを設定します。• PowerCenter クライアント• PowerCenter Integration ServicePowerExchange for Salesforce をアップグレードする場合は、各コンポーネントの HTTP プロキシオプションの設定が正しいことを確認します。

PowerCenter クライアントの HTTP プロキシオプションの設定PowerCenter クライアントの HTTP プロキシオプションの設定を行うには、pmsfdc.ini という名前のテキストファイルを使用します。このファイルは、次のディレクトリに配置されています。<PowerCenter Installation Directory>\clients\PowerCenterClient\client\bin\PowerCenter クライアントの HTTP プロキシオプションを設定する手順1. テキストエディタを使用して新しいテキストファイルを作成し、「pmsfdc.ini」という名前で次のディレク

トリに保存します。 <PowerCenter Installation Directory>\clients\PowerCenterClient\client\bin\または、<PowerCenter インストールディレクトリ>\clients\PowerCenterClient\client\bin ディレクトリにある pmsfdc.ini ファイルを、テキストエディタで開いて編集します。

2. テキストファイルに記述される次のパラメータごとに適切な値を指定して設定を行います。

パラメータ必須/オプション

説明

ProxyHost 必須プロキシホスト名。ProxyPort 必須プロキシポート番号。ProxyUser 必須プロキシアカウントのユーザー名。

HTTP プロキシオプション 15

パラメータ必須/オプション

説明

ProxyPassword 必須プロキシアカウントのパスワード。暗号化済みオプションプロキシパスワードが暗号化されている場合に使

用します。PowerCenter コマンドラインプログラム pmpasswd を使用して、プロキシパスワードを暗号化します。次のいずれかのオプションを使用します。- DEFAULT. 暗号化タイプに CRYPT_DATA を使用

して暗号化されたパスワードで使用します。- SYSTEM. 暗号化タイプに CRYPT_SYSTEM を使用

して暗号化されたパスワードで使用します。プロキシパスワードが暗号化されている場合は必須です。

以下に例を示します。ProxyHost=d123456.informatica.comProxyPort=8082ProxyUser=adminProxyPassword=password123

暗号化されたプロキシパスワードの使用PowerCenter Client で HTTP プロキシオプションを設定した場合、セキュリティを高めるために暗号化されたプロキシアカウントのパスワードを使用できます。暗号化されたパスワードを使用するには、次のタスクを実行します。1. PowerCenter コマンドラインプログラム pmpasswd を使用して、プロキシアカウントのパスワードを暗

号化します。pmpasswd は、PowerCenter Integration Service マシンの次のディレクトリにあります。 <InformaticaInstallationDir>/server/binパスワードを暗号化するときに、暗号化タイプとして CRYPT_DATA または CRYPT_SYSTEM を使用できます。

2. 暗号化されたパスワードは、pmsfdc.ini ファイルのプロキシパスワードとして使用できます。3. 暗号化されたパラメータを pmsfdc.ini ファイルに追加し、パラメータを次のように設定します。

• 暗号化タイプが CRYPT_DATA の場合は、暗号化されたパスワードに DEFAULT を指定します。• 暗号化タイプが CRYPT_SYSTEM の場合は、暗号化されたパスワードに SYSTEM を指定します。

PowerCenter Integration Service の HTTP プロキシオプションの設定インターネットへの接続にプロキシサーバーを使用している場合、PowerCenter Integration Service で HTTPプロキシサーバー認証設定を行う必要があります。PowerCenter Integration Service で HTTP プロキシオプションを設定する手順1. 管理者ツールを開きます。 2. ［管理］タブをクリックして、PowerCenter Integration Service を選択します。 3. ［プロパティ］タブをクリックします。 4. ［HTTP プロキシのプロパティ］セクションで［編集］をクリックします。

16 第 2 章: 設定

5. 以下の表に説明する内容に従ってプロパティを設定します。

プロパティ説明HTTP プロキシサーバーのホスト HTTP プロキシサーバ名HttpProxyPort HTTP プロキシサーバーのポート番号。HttpProxyUser HTTP プロキシサーバーの認証ユーザー名。HttpProxyPassword 認証されたユーザーのパスワード。HttpProxyDomain 認証用ドメイン。

HTTP プロキシオプション 17

第 3 章

Salesforce のソースおよびターゲット

この章では、以下の項目について説明します。• Salesforce のソースおよびターゲットの概要, 18 ページ• 関連する Salesforce オブジェクトからのフィールドのインポート, 18 ページ• Salesforce のソース, 20 ページ• Salesforce ターゲット, 20 ページ• Salesforce のソースまたはターゲット定義のインポート, 22 ページ

Salesforce のソースおよびターゲットの概要Designer を使用して、Salesforce のソースおよびターゲット定義を PowerCenter リポジトリにインポートします。Salesforce のユーザアカウントで入手可能な任意の標準またはカスタムの Salesforce オブジェクトからメタデータをインポートできます。ソースとターゲットのトランスフォーメーションではビッグオブジェクトをインポートできます。Salesforce の定義をインポートすると、Salesforce オブジェクトの各フィールドに対して 1 つのポートがDesigner で作成されます。Salesforce の定義をインポートすると、さらに関連オブジェクトのフィールドもインポートできます。Designer では、Salesforce で定義されたリレーションに基づいて関連オブジェクトを特定します。Salesforce の定義を手動で作成する場合、Designer ではフィールドなしの定義が作成され、フィールドを追加することはできません。

関連する Salesforce オブジェクトからのフィールドのインポートSalesforce オブジェクトをインポートする場合、関連する Salesforce オブジェクトのフィールドを同じソース定義、ターゲット定義、またはトランスフォーメーションにインポートできます。フィールドは、子オブジェクトおよび関連する派生オブジェクトからインポートできます。

18

Designer では、Salesforce で定義されたリレーションに基づいて、関連する Salesforce オブジェクトを特定します。関連するオブジェクトには、標準およびカスタムの Salesforce オブジェクトがあります。例えば、商談をソースとしてインポートする場合、以下の関連する子オブジェクトのフィールドもインポートできます。• Account。デフォルトで、Opportunity オブジェクトは、商談の取引先 ID を格納します。関連する

Account オブジェクトをインポートする場合、取引先名、取引先業種、取引先の親など、各アカウントの詳細を表示できます。

• Campaign。デフォルトで、Opportunity オブジェクトは、商談のキャンペーン ID を格納します。関連する Campaign オブジェクトをインポートする場合、キャンペーン名、キャンペーン種別、キャンペーンの説明、キャンペーン開始日とキャンペーン終了日など、各キャンペーンの詳細を表示できます。

この場合、Opportunity オブジェクトは定義のプライマリ Salesforce オブジェクトとなり、Account およびCampaign オブジェクトは関連する子オブジェクトになります。プライマリ Salesforce オブジェクトは、定義の作成に使用されるプライマリオブジェクトです。また、関連する派生オブジェクトをインポートすることもできます。これらのオブジェクトは、プライマリオブジェクトに間接的に関連付けられます。例えば、Opportunity オブジェクトをインポートするときに、関連する Account の子オブジェクトとの Accounts リレーションに基づいて、関連する User の派生オブジェクトもインポートできます。取引先所有者名、取引先所有者電話、取引先所有者、取引先所有者電子メールなど、取引先所有者に関する詳細情報を取得するには、User オブジェクトのフィールドをインポートします。Designer でプライマリ Salesforce オブジェクトをインポートするときに、インポートする関連オブジェクトを指定することもできます。 Designer では、以下の命名規則を使用して関連オブジェクトを表示します。<Relationship name> (<Salesforce object name>)Designer では、Salesforce での定義どおりにリレーション名とオブジェクト名が表示されます。注: Salesforce オブジェクトとその関連オブジェクトをインポートする場合、一部の関連オブジェクトが表示されないことがあります。 Salesforce API は、すべての関連オブジェクトとそのリレーションを公開するわけではありません。

関連する Salesforce オブジェクトからのフィールドのインポートのルールおよびガイドライン関連する Salesforce オブジェクトからフィールドをインポートする場合は、以下のルールおよびガイドラインを使用してください。• 以下の場合、関連オブジェクトのフィールドをインポートして Salesforce のソース定義を作成します。

- Salesforce からのみデータを抽出する。- Salesforce オブジェクトと 1 つ以上の関連オブジェクトのデータをロードする。- ターゲットにロードする前にソースデータのトランスフォーメーションを実行する必要がない。- 複数の Salesforce オブジェクトからデータを結合する場合にセッションのパフォーマンスを向上させる。

ジョイナトランスフォーメーションを使用して複数の Salesforce オブジェクトからのデータを結合する代わりに、Salesforce のソース定義で関連オブジェクトのフィールドをインポートしてパフォーマンスの向上を図ります。

• 関連オブジェクトが親オブジェクトの場合は、関連オブジェクトからフィールドをインポートできません。• 関連オブジェクトがクエリ可能でない場合（添付ファイル、メモまたは活動予定オブジェクトなどの場合）

は、関連オブジェクトからフィールドをインポートできません。クエリ可能でないオブジェクトの詳細については、Salesforce のマニュアルを参照してください。

• レコードを Salesforce ターゲットおよびその関連オブジェクトに更新/挿入する場合は、関連オブジェクトのフィールドをインポートして Salesforce のターゲット定義を作成します。外部 ID または Salesforce

関連する Salesforce オブジェクトからのフィールドのインポート 19

idLookup フィールドを使用して、Salesforce ターゲットまたは関連オブジェクトにレコードを挿入/更新できます。

• 結合を実行することなく、プライマリ Salesforce オブジェクト内のデータと関連オブジェクト内のデータを検索するには、Salesforce ルックアップトランスフォーメーションに対して関連オブジェクトのフィールドをインポートします。例えば、商談オブジェクト内の商談情報のルックアップ検索を実行すると同時に、関連する取引先オブジェクト内の取引先関連情報も取得できます。

• プライマリ Salesforce オブジェクト内のデータを関連オブジェクト内のデータとマージする場合は、Salesforce 統合トランスフォーメーションに対して関連オブジェクトのフィールドをインポートします。

• 関連オブジェクトから選択リストの値を取得する場合は、Salesforce PickList トランスフォーメーションに対して関連オブジェクトのフィールドをインポートします。

Salesforce のソースPowerCenter Integration Service では、データを Salesforce のソース定義から抽出できます。各Salesforce オブジェクトに対して、1 つ以上のソース定義をインポートできます。同じ Salesforce オブジェクトに対して複数のソース定義をインポートする場合、各ソース定義にそれぞれ固有の名前を付ける必要があります。固有の名前が付けられていない場合、Designer はユーザーにその競合を解決するよう要求します。PowerCenter Integration Service では、Salesforce ソースからデータを抽出するときに、そのソースに関連付けられているアプリケーションソース修飾子内のデータタイプに基づいてそのデータが変換されます。

Salesforce のソースのタイムゾーンSalesforce では、複数のタイムゾーンに datetime データを格納できます。 PowerCenter Integration Service では、Salesforce から抽出されたすべての時間のタイムゾーンが、協定世界時（UTC）タイムゾーンに変換されます。

Salesforce のソースからの時間の変換PowerCenter Integration Service が Salesforce オブジェクトの Time フィールドからデータを抽出するとき、時刻に現在の日付が追加されます。例えば、PowerCenter Integration Service が 01/01/2007 に Salesforceのソースの Time フィールドから 10:46:51.9884 を抽出するとします。結果として生じる Date/Time 値は01/01/2007 10:46:51.988400 になります。

Salesforce ターゲットSalesforce のターゲットに対して挿入、更新、削除および更新/挿入操作を実行できます。PowerCenter 統合サービスでは、レコード ID に基づいて、レコードが新規、既存、削除済みのいずれであるかが特定されます。 Salesforce オブジェクト内のレコードを識別するには、以下の ID のタイプを使用できます。• Salesforce ID。Salesforce では、デフォルトで各新規レコードに ID が生成されます。• 外部 ID。外部 ID とは、Salesforce の外部で生成される ID のことです。外部 ID を使用して、Salesforce タ

ーゲットから更新または削除するレコードを識別することはできません。

20 第 3 章: Salesforce のソースおよびターゲット

更新操作または更新/挿入操作中に、Salesforce のターゲットにあるレコードの既存の値を NULL 値に置換するように PowerCenter 統合サービスを設定することもできます。デフォルトでは、PowerCenter 統合サービスは既存の値を NULL 値に置換しません。関連項目：•「更新操作および更新/挿入操作での NULL 値の処理」 (ページ 50)

Salesforce のターゲットのタイムゾーンSalesforce ターゲットは、時間データを協定世界時（UTC）データとして保存します。各マッピングで、ターゲットにデータがロードされる前に、時間データが UTC タイムゾーンに変換されることを確認してください。

Salesforce のターゲットの可能なアップデートストラテジの特定Salesforce ターゲット定義のプロパティを表示して、レコードを Salesforce ターゲットに作成、更新、または更新/挿入できるかどうかを判断できます。オブジェクトについての詳細を表示するには、ターゲットのタイトルバーをダブルクリックし、［属性］タブを選択します。

［属性］タブには、インポートされた Salesforce オブジェクトの各フィールドの属性値が表示されます。次の表に、各フィールドに表示される属性を示します。

属性説明SforceName Salesforce のフィールド名。フィールド名 Salesforce ターゲットで定義されているフィールド名。Createable フィールドにデータを挿入できるかどうかを示します。

- 0。このフィールドにデータを挿入できません。- 1。このフィールドにデータを挿入できます。PowerCenter の挿入は、Salesforce の作成操作に相当します。

Updateable フィールドのデータを更新できるかどうかを示します。- 0。このフィールドのデータを更新できません。- 1。このフィールドのデータを更新できます。

External ID Salesforce カスタムフィールドのみ。フィールドが外部 ID フィールドであるかどうかを示します。- 0。フィールドは外部 ID フィールドではありません。- 1。フィールドは外部 ID フィールドです。各 Salesforce オブジェクトには、外部 ID フィールドとして指定された 1 つのカスタムフィールドを含めることができます。Salesforce では、カスタムフィールド名の語尾に“__c”を追加します。

idLookup フィールドが idLookup フィールドであるかどうかを示します。- 0。フィールドは idLookup フィールドではありません。- 1。フィールドは idLookup フィールドです。idLookup フィールドを使用して、Salesforce 標準オブジェクトの更新/挿入を実行できます。

Salesforce 属性の詳細については、Salesforce のマニュアルを参照してください。

Salesforce ターゲット 21

Salesforce のターゲットのアップデートストラテジのルールおよびガイドラインSalesforce のターゲットに対するアップデートストラテジを設定する場合は、以下のルールおよびガイドラインに従います。• PowerCenter 統合サービスでは、Salesforce のターゲットのレコードにあるシステムフィールドを作成ま

たは更新できません。各 Salesforce オブジェクトには、Salesforce で作成または更新される読み取り専用のシステムフィールドが含まれます。例えば、各 Salesforce オブジェクトには ID システムフィールドがあります。ID フィールドには、レコード固有の識別子が格納されています。Salesforce ターゲット定義を含むセッションを実行する場合、PowerCenter 統合サービスではレコードを Salesforce ターゲットに挿入しますが、Salesforce では ID を生成します。

• Salesforce ターゲット内でレコードの更新や削除を行うセッションを設定するには、マッピングにより各レコードの ID を渡し、それらを Salesforce ターゲット定義の ID 入力ポートにリンクさせる必要があります。Salesforce では、ID フィールドを使用してレコードが更新中、または削除中であることを識別します。

• レコードを更新/挿入するには、外部 ID または Salesforce idLookup フィールドを指定する必要があります。

• レコードを削除するには、SalesforceID を指定する必要があります。• レコードを挿入するセッション用の ID 入力ポートはリンクする必要がありません。Salesforce が新しいレ

コードに対して ID を生成します。外部 ID フィールドを使用して、Salesforce オブジェクトのレコードを識別する場合、更新/挿入操作を使用し、外部 ID に基づいてレコードを挿入および更新できます。Salesforce ターゲットの ID フィールドから ID を取得するのが困難な場合は、外部 ID を使用してレコードを更新または挿入/更新することもできます。

• PowerCenter 統合サービスで更新、更新/挿入、削除のいずれかの操作を実行しているときに一時的なエラーが検出された場合は、操作が再試行されます。 PowerCenter 統合サービスでは、操作が 5 分間隔で 3 回再試行されます。一時的なエラーには、ネットワーク障害や Salesforce からのタイムアウトなどのエラーが含まれます。

• Salesforce ターゲットには XML 文字を含めることができません。 PowerCenter 統合サービスがソースフィールドで XML 文字を検出した場合、XML 文字は Salesfoce ターゲットフィールドをロードする前に削除されます。

Salesforce のソースまたはターゲット定義のインポートSalesforce からソースまたはターゲット定義をインポートする手順1. 定義をインポートします。

• Salesforce のソース定義をインポートするには、［Source Analyzer］で［ソース］-［Salesforce からインポート］をクリックします。

• Salesforce のターゲット定義をインポートするには、［Target Designer］で［ターゲット］-［Salesforce からインポート］をクリックします。

2. ［Salesforce からインポート］ダイアログボックスでは、接続タイプに［標準］または［OAuth］が選択できます。

22 第 3 章: Salesforce のソースおよびターゲット

以下の表に、標準接続のプロパティ一覧を示します。

接続プロパティ説明接続タイプ［標準］を選択します。ユーザー名 Salesforce アカウントのユーザー名。パスワード Salesforce アカウントのパスワード。サービスの URL Salesforce サービスの URL。

https://login.salesforce.com/services/Soap/u/45.0

以下の表に、OAuth 接続のプロパティ一覧を示します。

接続プロパティ

説明

接続タイプ OAuth を選択します。更新トークン Salesforce のリフレッシュトークン。

リフレッシュトークンの生成方法の詳細については、「リフレッシュトークンの生成」 (ページ 41)を参照してください。

コンシューマキー

Salesforce から取得したコンシューマキー。有効なリフレッシュトークンを生成するのに必要です。コンシューマキーの生成方法の詳細については、Salesforce のマニュアルを参照してください。

コンシューマシークレット

Salesforce から取得したコンシューマシークレット。有効なリフレッシュトークンを生成するのに必要です。コンシューマシークレットの生成方法の詳細については、Salesforce のマニュアルを参照してください。

3. ［接続］をクリックします。 Designer が、Salesforce ユーザーが使用できるオブジェクトのリストを表示します。

4. インポートするオブジェクトを選択して［OK］をクリックします。 • 連続した複数のテーブルを選択するには、Shift キーを押したままクリックします。• Ctrl キーを押しながら隣接していないものを選択します。• ［すべて選択］ボタンを使用して、すべてのテーブルを選択します。• ［すべて非選択］ボタンを用いて、選択の反転表示をすべてクリアすることもできます。

5. ［Salesforce オブジェクトのリレーションを含める］ダイアログボックスで、ソース定義に含める関連オブジェクトを選択します。

6. ［OK］をクリックします。

Salesforce のソースまたはターゲット定義のインポート 23

第 4 章

Salesforce ルックアップトランスフォーメーション

この章では、以下の項目について説明します。• Salesforce ルックアップトランスフォーメーションの概要, 24 ページ• Salesforce ルックアップコンポーネント, 25 ページ• Salesforce ルックアップポート, 26 ページ• Salesforce ルックアップクエリ, 28 ページ• Salesforce ルックアップトランスフォーメーションの作成, 29 ページ

Salesforce ルックアップトランスフォーメーションの概要Salesforce ルックアップトランスフォーメーションはアクティブなトランスフォーメーションです。Salesforce ルックアップトランスフォーメーションを使用して、Salesforce オブジェクト内のデータをルックアップします。例えば、従業員 ID が格納されているソーステーブルに対して、ターゲットテーブルに従業員名が含まれるようにすると、要約データが読みやすくなります。Salesforce ルックアップトランスフォーメーションを使用して、Salesforce オブジェクトの従業員名をルックアップできます。Salesforce ルックアップトランスフォーメーションをマッピングに含める際は、Salesforce API のバージョン 33.0 以下を使用します。Salesforce ルックアップトランスフォーメーションは、Salesforce ユーザーアカウントで使用可能な、標準またはカスタムの Salesforce オブジェクトから作成できます。関連する Salesforce オブジェクトからのフィールドを Salesforce ルックアップトランスフォーメーションに含めることもできます。PowerCenter 統合サービスが、トランスフォーメーション内のポートに基づいてルックアップソースを問い合わせます。クエリは、SQL の派生言語である SOQL（sforce Object Query Language）で生成されます。Salesforce ルックアップトランスフォーメーションを入力する各行に対してクエリを生成します。PowerCenter 統合サービスは、SOQL クエリに基づいてトランスフォーメーションポートの値をルックアップソースフィールド値と比較します。Salesforce ルックアップトランスフォーメーションは、ルックアップトランスフォーメーションとは異なります。例えば、Salesforce ルックアップトランスフォーメーションは、ルックアップクエリ条件を満たすすべての行を返します。ルックアップトランスフォーメーションは 1 行を返します。Salesforce ルックアップトランスフォーメーションは、複数の行を返す場合、条件に一致する行それぞれにシーケンス ID を割り当てます。

24

次の表に、Salesforce ルックアップトランスフォーメーションとルックアップトランスフォーメーションの違いを示します。

項目 Salesforce ルックアップトランスフォーメーション

ルックアップトランスフォーメーション

ルックアップオブジェクト

Salesforce オブジェクトフラットファイルまたはリレーショナルテーブル

トランスフォーメーションタイプ

アクティブパッシブ

マッピングでのトランスフォーメーション

接続済接続済または未接続

キャッシュタイプキャッシュなしキャッシュあり/キャッシュなし返される行一致したすべての行一致した 1 行クエリ言語 SOQL クエリ SQL queryクエリ条件の設定接続済みポートに基づくトランスフォーメーションの［条件］タブ

で定義

注: Salesforce ルックアップトランスフォーメーションは、データをリアルタイムで取り出すことができます。Salesforce データをキャッシュするには、Salesforce ルックアップトランスフォーメーションではなくSalesforce ソース定義を使用します。ジョイナトランスフォーメーションを使用すると、2 つのデータソースを結合し、処理中にソースデータをキャッシュできます。データ統合サービスでは、結合クエリに入力した条件は無視されます。

Salesforce ルックアップコンポーネントSalesforce ルックアップトランスフォーメーションの設定時に、以下のコンポーネントを定義します。• ［トランスフォーメーション］タブ。［トランスフォーメーション］タブで、トランスフォーメーションの名

前の変更、および説明の㿽加が行えます。• ［ポート］タブ。Salesforce ルックアップトランスフォーメーションには、ルックアップポート、パススル

ーポート、およびデフォルトポートを含〿ることができます。• ［プロパティ］タブ。トランスフォーメーションのトレースレベルを設定できます。デフォルトのトレース

レベルは Normal です。さらに、セッションの実行ごとに一貫した出力データを生成するかどうかを指定します。デフォルトで、一貫した出力データを生成します。

• ［初期化プロパティ］タブ。Salesforce ルックアップトランスフォーメーションは、初期化プロパティを使用しません。 PowerCenter Integration Service は、初期化情報をベンダ定義のメタデータエクステンションから取り出します。

• ［メタデータエクステンション］タブ。儿利用不可能のメタデータエクステンションを作成して、トランスフォーメーションのメタデータを拡張します。エクステンション名、データタイプ、精度、および値を設定します。メタデータエクステンションをすべてのトランスフォーメーションで利用可能にしたい場合、メタデータエクステンションを儿利用可能に格上げすることもできます。

• ［ポート属性定義］タブ。［ポート属性定義］タブに、Salesforce ルックアップトランスフォーメーションに対して定義されたポート属性が表示されます。ポート属性は、SforceDataType および SforceName のみです。

Salesforce ルックアップコンポーネント 25

トランスフォーメーションには、PowerCenter Integration Service がルックアップに使用しない、設定可能なカスタムトランスフォーメーションプロパティがあります。 PowerCenter Integration Service は、実行時にこれらの設定可能なプロパティを無視します。次の表に、Salesforce ルックアップトランスフォーメーションが使用しない設定可能なプロパティを示します。

プロパティ場所説明実行時位置［プロパティ］タブ。 PowerCenter Integration Service は、実行時位置を無

視します。初期化プロパティ［初期化プロパティ］タ

ブ。PowerCenter Integration Service は、初期化プロパティを無視します。初期化情報をベンダ定義のメタデータエクステンションから取り出します。

ポート属性定義［ポート属性定義］タブ。 Salesforce ルックアップトランスフォーメーションは、SforceDataType という名前のポート属性定義を使用します。㿽加のポート属性定義を設定した場合、PowerCenter Integration Service はそれらを無視します。

Salesforce ルックアップポートSalesforce ルックアップトランスフォーメーションに、以下のタイプのポートを含めることができます。• ルックアップポート。Salesforce ルックアップトランスフォーメーションを作成するときには、

Salesforce オブジェクト定義からルックアップポートをインポートします。 PowerCenter Integration Service は、ルックアップポートを使用してルックアップクエリを生成します。

• パススルーポート。トランスフォーメーションにはパススルーポートを追加できます。 PowerCenter Integration Service は、これらのポートの値を変更することなくトランスフォーメーションを通過させます。

• デフォルトポート。Salesforce オブジェクト定義をインポートするときに、Designer では、LKP_FILTERおよび LKP_MATCHIDX という名前のデフォルトのポートが作成されます。 LKP_FILTER ポートを使用して、ルックアップクエリにフィルタ条件を追加できます。PowerCenter Integration Service では、一致する行にシーケンス ID を割り当てるために、LKP_MATCHIDX ポートが使用されます。

ルックアップポートSalesforce オブジェクトをインポートして Salesforce ルックアップトランスフォーメーションを作成するときには、Designer が、ルックアップクエリで使用するポートを作成します。PowerCenter Integration Service が、接続された入力ポートと出力ポートに基づいてルックアップクエリを生成します。 Salesforce オブジェクトからインポートしたポートの名前を変更すると、PowerCenter Integration Service はルックアップクエリにそのポートを含めません。Salesforce オブジェクトをインポートするとき、Designer が、Salesforce フィールドデータタイプをトランスフォーメーションデータタイプに変換し、Salesforce データタイプをポート属性として格納します。Salesforce ルックアップトランスフォーメーションの［ポート］タブにトランスフォーメーションデータタイプが表示されます。Salesforce データタイプを表示するには、ポートレベル属性を表示します。

26 第 4 章: Salesforce ルックアップトランスフォーメーション

Salesforce ルックアップトランスフォーメーションのポートレベル属性を表示するには、トランスフォーメーションの［ポート］タブをクリックします。次に、［編集］-［ポート属性］をクリックします。ポートのSalesforce データタイプが、ポートレベル属性に表示されます。Salesforce からインポートされたポートの場合、データタイプが、Salesforce データタイプとトランスフォーメーションデータタイプのマッピングに適合している必要があります。関連項目：•「Salesforce ルックアップクエリ」 (ページ 28)•「Salesforce データタイプとトランスフォーメーションデータタイプ」 (ページ 57)

パススルーポートポートを Salesforce ルックアップトランスフォーメーションにパススルーポートとして追加できます。PowerCenter Integration Service は、データでルックアップを実行することなく、これらのポートの値がトランスフォーメーションを通過するようにします。パススルーポートを追加するには、新しいポートを作成するか、ポートをトランスフォーメーションにコピーアンドペーストします。次に、ポートをアップストリームポートとダウンストリームポートに接続します。

LKP_FILTER ポートSalesforce オブジェクトをインポートして Salesforce ルックアップトランスフォーメーションを作成するときには、Designer が、LKP_FILTER という名前のデフォルトポートを作成します。LKP_FILTER ポートを使用して、ルックアップトランスフォーメーションのルックアップ入力ポートの接続では生成できないフィルタ条件をルックアップクエリに追加します。注: LKP_FILTER ポートは、接続されているルックアップ入力ポートと連動して使用できます。マッピングで、定数、レンジ、またはマッピングパラメータや変数値を出力する式トランスフォーメーションなどのトランスフォーメーションを作成できます。次に、トランスフォーメーションの適切な出力ポートをLKP_FILTER 入力ポートに接続できます。ルックアップクエリは、ルックアップクエリの WHERE 句に出力を含めます。例えば、Name ポートの値を定数‘Edge Communications’として出力する式トランスフォーメーションを作成します。’ トランスフォーメーションは、以下の式を使用します。'Name =' || CHR(39) || 'Edge Communications' || CHR(39)次に、Name ポートの式トランスフォーメーション出力を Salesforce ルックアップトランスフォーメーションの LKP_FILTER ポートに投影します。この例では、Salesforce ルックアップトランスフォーメーションは、アカウントという名前の Salesforce オブジェクトに基づいています。接続されているルックアップ入力ポートは、Id、Sale_Amount、Sale_Date です。接続されているルックアップ出力ポートは、Sale_Amount、Sale_Date、Name です。注: デフォルトポートを使用している場合、ポートを変更するかポートの名前を変更すると、予期しない結果になる可能性があります。トランスフォーメーションを通過する各行の SOQL SELECT 文のフォーマットは、以下のとおりです。SELECT Id, Name, Phone FROM Account WHERE Id = '<value of Id>' AND AccountNumber = '<value of AccountNumber>' AND Name = 'Edge Communications'

Salesforce ルックアップポート 27

関連項目：•「Salesforce ルックアップクエリ」 (ページ 28)

LKP_MATCHIDX ポートSalesforce オブジェクトをインポートして Salesforce ルックアップトランスフォーメーションを作成するときには、Designer が、LKP_MATCHIDX という名前のデフォルトポートを作成します。ルックアップクエリが複数の一致を返すときには、LKP_MATCHIDX 出力ポートを使用して一致行を識別します。各一致行に対して、PowerCenter Integration Service が一意のシーケンス ID を割り当てます。値 0 は、入力行に一致が存在しないことを示します。一致行と不一致行に対して以下の規則が適用されます。• 一致。 SOQL クエリは、検出したそれぞれの一致に対して行を返します。1 つの入力行に対して複数の行を

返す場合があります。LKP_MATCHIDX ポートを使用し、クエリが複数の一致を返す場合、PowerCenter Integration Service は、返される各行に対してシーケンス ID を生成します。シーケンス ID の値は、1-nです。

• 不一致。SOQL クエリが行を返さない場合、PowerCenter Integration Service がシーケンス ID 0 の出力行を 1 行生成します。 PowerCenter Integration Service は、パススルーポートの値を保持し、ルックアップ出力ポートの値を NULL に設定します。 NULL 値をターゲットに渡すには、NULL 値を受け入れるようにターゲットを設定する必要があります。NULL 値をターゲットに渡したくない場合、トランスフォーメーションを使用して NULL 値をデフォルト値に変換します。

注: デフォルトポートを使用している場合、ポートを変更するかポートの名前を変更すると、予期しない結果になる可能性があります。

Salesforce ルックアップクエリSalesforce ルックアップトランスフォーメーションの入力ポートと出力ポートにより、ルックアップに使用される SOQL（sforce Object Query Language）クエリが決まります。SOQL 言語は SQL から派生したものです。PowerCenter Integration Service は、トランスフォーメーションに渡るそれぞれの行に対して個別のSOQL クエリを生成します。各行のポートの値によって、クエリで使用される値が決まります。PowerCenter Integration Service は、以下のルールに従って SOQL クエリを生成します。• ルックアップポートは、Salesforce オブジェクトからインポートし、マッピングで接続したポートです。• すべてのルックアップポートは、Salesforce フィールド名に一致し、関連付けられた Salesforce データタ

イプを持つ必要があります。• PowerCenter Integration Service は、接続されているルックアップ出力ポートに基づいて SELECT 文を生

成します。• PowerCenter Integration Service は、接続されているルックアップ入力ポートと LKP_FILTER ポートに基

づいて WHERE 句を生成します。• PowerCenter Integration Service は、接続されている入力ポートの値と等しいかどうかに基づいて、ま

た、追加のフィルタ条件がある場合にはその条件に基づいて行を一致させます。例えば、Salesforce ルックアップトランスフォーメーションは、アカウントという名前の Salesforce オブジェクトに基づいています。接続されているルックアップ入力ポートは、Id と AccountNumber です。接続されているルックアップ出力ポートは、Id、Name、Phone です。SOQL SELECT 文のフォーマットは以下のとおりです。SELECT Id, Name, Phone FROM Account WHERE Id = '<value of Id>' AND AccountNumber = '<value of AccountNumber>'

28 第 4 章: Salesforce ルックアップトランスフォーメーション

注: フィルタトランスフォーメーションまたは式トランスフォーメーションで SOQL クエリを使用した場合、データ統合サービスでは SOQL クエリが無視されます。

Salesforce ルックアップトランスフォーメーションの作成Salesforce ルックアップトランスフォーメーションを作成するには：1. Transformation Developer または Mapping Designer で、［トランスフォーメーション］-［作成］をク

リックします。［トランスフォーメーションの作成］ダイアログボックスが表示されます。

2. トランスフォーメーションタイプとして Salesforce ルックアップを選択して、名前を入力します。 3. ［作成］をクリックします。 4. ［Salesforce からテーブルをインポート］ダイアログボックスで、以下の情報を入力します。

インポート属性説明ユーザー名 Salesforce のユーザ名。パスワード Salesforce ユーザ名のパスワード。パスワードでは、大文字と小文字が区別され

ます。サービスの URL Salesforce サービスの URL。

https://login.salesforce.com/services/Soap/u/33.0テストまたは開発環境で、Salesforce Sandbox テスト環境にアクセスできます。Salesforce Sandbox の詳細については、Salesforce のマニュアルを参照してください。


6. インポートするオブジェクトを選択し、［OK］をクリックします。 7. ［Salesforce オブジェクトのリレーションを含める］ダイアログボックスで、含めるリレーションシップ

を選択し、［OK］をクリックします。競合がない場合、Designer は、選択したオブジェクトおよび関連するオブジェクトに基づいてSalesforce ルックアップトランスフォーメーションを作成します。競合がある場合は、競合を解決してください。

8. ［トランスフォーメーションの作成］ダイアログボックスで［完了］をクリックします。

Salesforce ルックアップトランスフォーメーションの作成 29

第 5 章

Salesforce 統合トランスフォーメーション

この章では、以下の項目について説明します。• Salesforce 統合トランスフォーメーションの概要, 30 ページ• Salesforce 統合のコンポーネント, 31 ページ• Salesforce 統合のポート, 32 ページ• Salesforce 統合トランスフォーメーションのルールおよびガイドライン, 33 ページ• Salesforce 統合トランスフォーメーションの作成, 33 ページ

Salesforce 統合トランスフォーメーションの概要Salesforce 統合トランスフォーメーションは、パッシブトランスフォーメーションです。 Salesforce 統合トランスフォーメーションを使用して、重複レコードをマージします。Salesforce 統合トランスフォーメーションは、Account、Contact、または Lead Salesforce オブジェクトから作成できます。関連する Salesforce オブジェクトからのフィールドを Salesforce 統合トランスフォーメーションに含めることもできます。最大で 3 つの Salesforce レコードを 1 つのレコードにマージできます。Salesforce 統合トランスフォーメーションを作成するときに、マスターレコードおよび最大で 2 つのスレーブレコードを識別します。レコードをマージするときに、Salesforce 統合トランスフォーメーションではマスターレコードが保持され、Salesforceオブジェクトからスレーブレコードが削除されます。子レコードが孤立しないようにするために、Salesforce 統合トランスフォーメーションでは、マスターレコードにスレーブレコードの子レコードが再割り当てされます。例えば、Account Salesforce オブジェクトのレコードを 2 つマージするとします。各アカウントレコードは、Contact Salesforce オブジェクトのレコードの親です。Salesforce 統合トランスフォーメーションでは、アカウントレコードをマージするときに、スレーブアカウントレコードに関連付けられている担当者レコードが、マスターアカウントレコードに割り当てられます。マスターレコードの Salesforce オブジェクトの属性の値をオーバーライドすることができます。属性値をオーバーライドするには、Salesforce オブジェクトの属性に値を指定するようにソースを設定し、Salesforce 統合トランスフォーメーションを介して、マッピング内のソースからターゲットにフィールドをマップします。

30

サンプルの Salesforce 統合トランスフォーメーションAccount Salesforce オブジェクトにある以下のレコードをマージします。

ID アカウント名請求地電話番号0015000000IcEgAAAV ABC Tiles Los Angeles NULL0015000000IcEgBAAV ABC Tiles NULL 310-555-12120015000000IcEgCAAV ABC San Diego 310-555-6666

以下の表に、レコードをマージして Account オブジェクト内のアカウント名を更新するマッピングのソースを示します。

マスターレコード ID スレーブ 1 レコード ID スレーブ 2 レコード ID アカウント名0015000000IcEgAAAV 0015000000IcEgBAAV 0015000000IcEgCAAV Textiles to Go

アカウント名が、ABC Tiles から Textiles to Go に変更されました。［アカウント名］フィールドの値 Textiles to Go を、ソース統合トランスフォーメーションを介してターゲットに射影します。マッピングを含むセッションを実行するときに、PowerCenter 統合サービスでは Account Salesforce オブジェクトからスレーブレコードが削除され、以下のマスターレコードが保持されます。

ID アカウント名請求地電話番号0015000000IcEgAAAV Textiles to Go Los Angeles NULL

Salesforce 統合トランスフォーメーションでは、マスターレコードのアカウントオブジェクトの属性が、スレーブレコードの値でオーバーライドされません。アカウント名属性は、値が指定されているため更新されます。

Salesforce 統合のコンポーネントSalesforce 統合トランスフォーメーションの設定時に、以下のコンポーネントを定義します。• ［トランスフォーメーション］タブ。［トランスフォーメーション］タブで、トランスフォーメーションの名

前の変更、および説明の追加が行えます。• ［ポート］タブ。Salesforce 統合トランスフォーメーションには、Salesforce オブジェクトの属性ポートお

よびデフォルトポートを含めることができます。• ［プロパティ］タブ。トランスフォーメーションのトレースレベルを設定できます。デフォルトのトレース

レベルはノーマルです。さらに、セッションの実行ごとに一貫した出力データを生成するかどうかを指定します。デフォルトで、一貫した出力データを生成します。

• ［初期化プロパティ］タブ。Salesforce 統合トランスフォーメーションは、初期化プロパティを使用しません。 PowerCenter Integration Service は、初期化情報をベンダ定義のメタデータエクステンションから取り出します。

• ［メタデータエクステンション］タブ。再利用不可能のメタデータエクステンションを作成して、トランスフォーメーションのメタデータを拡張します。エクステンション名、データタイプ、精度、および値を設

Salesforce 統合のコンポーネント 31

定します。また、すべてのトランスフォーメーションからメタデータエクステンションを利用できるようにする場合は、メタデータエクステンションを再利用可能なエクステンションに格上げします。

• ［ポート属性定義］タブ。［ポート属性定義］タブに、Salesforce 統合トランスフォーメーションに対して定義されたポート属性が表示されます。ポート属性は、SforceDataType および SforceName のみです。

Salesforce 統合のポートSalesforce 統合トランスフォーメーションには、以下のタイプのポートを含めることができます。• Salesforce オブジェクトの属性ポート。これらのポートを使用して、マスターレコードの Salesforce オブ

ジェクトの属性の値を更新します。これらのポートの値によって、マスターレコードおよびスレーブレコードの値がオーバーライドされます。

• デフォルトポート。Salesforce オブジェクト定義をインポートするときに、Designer では、デフォルトの入力ポート、およびデフォルトの出力ポートである MergedID、MergedSlaveID1、およびMergedSlaveID2 が作成されます。

Salesforce オブジェクトの属性ポートSalesforce 統合トランスフォーメーションには、Salesforce オブジェクトのすべての属性の入力ポートが含まれます。各ポートの値を指定して、マスターレコードの値をオーバーライドします。PowerCenter Integration Service では、Salesforce オブジェクトの各ポートに指定された値でマスターレコードが更新されます。ソースの値をポートにマップするときに、ソースデータおよびポートのデータタイプに互換性があることを確認します。互換性のないデータタイプをマップする場合は、セッションが失敗するか、またはマスターレコードに予想外の値が含まれることがあります。関連項目：•「Salesforce データタイプとトランスフォーメーションデータタイプ」 (ページ 57)

ID および SlaveID の入力ポートマスターレコード ID を ID 入力フィールドにマップします。スレーブレコード ID を入力 SlaveID1 フィールドにマップします。2 番目のスレーブレコード ID がある場合は、入力 SlaveID2 フィールドにマップします。PowerCenter Integration Service では、ソースによって提供された ID を使用して、Salesforce オブジェクトのマスターレコードおよびスレーブレコードが識別されます。

MergedID、MergedSlaveID1、および MergedSlaveID2 の出力ポートSalesforce 統合トランスフォーメーションでは、MergedID フィールドにマスターレコード ID が入力されます。また、PowerCenter Integration Service では、SlaveID1 フィールドおよび SlaveID2 フィールドで識別されているスレーブレコードも削除されます。

32 第 5 章: Salesforce 統合トランスフォーメーション

Salesforce 統合トランスフォーメーションのルールおよびガイドラインSalesforce 統合トランスフォーメーションを設定するには、以下のルールおよびガイドラインに従います。• Salesforce 統合トランスフォーメーションをマッピングに含める際は、Salesforce API のバージョン 33.0

以下を使用します。• マスターレコード ID および少なくとも 1 つのスレーブ ID を指定しない場合、セッションは失敗します。• マスターレコードおよびスレーブレコードの ID は、有効な Salesforce ID である必要があります。• Salesforce 統合トランスフォーメーションにリンクされているフィールドの値によって、マスターレコー

ドに存在している値が上書きされます。ただし、リンクされたフィールドの値が NULL である場合はマスターレコードの有効な値を上書きしません。

• Salesforce 統合トランスフォーメーションでは、マージ中に、マスターレコードに各スレーブレコードの子レコードが再割り当てされます。

• 最大で 2 つのスレーブレコードと 1 つのマスターレコードをマージできます。3 つ以上のスレーブレコードをマージするには、同じマスターレコード ID を使用して、Salesforce 統合トランスフォーメーションの作成および実行を複数回行います。

• PowerCenter Integration Service では、スレーブ ID が空白の場合、Salesforce オブジェクトに存在していない場合、または 18 文字が含まれない場合、スレーブレコードはマージされません。

• Salesforce オブジェクトにマスター ID または少なくとも 1 つのスレーブ ID が存在していない場合、マージは失敗します。

Salesforce 統合トランスフォーメーションの作成Salesforce 統合トランスフォーメーションを作成するには：1. Transformation Developer または Mapping Designer で、［トランスフォーメーション］-［作成］をク


2. トランスフォーメーションタイプとして Salesforce 統合を選択して、名前を入力します。 3. ［作成］をクリックします。 4. ［Salesforce からテーブルをインポート］ダイアログボックスで、以下の情報を入力します。




Salesforce 統合トランスフォーメーションのルールおよびガイドライン 33



を選択し、［OK］をクリックします。競合がない場合、Designer は、選択したオブジェクトおよび関連するオブジェクトに基づいてSalesforce 統合トランスフォーメーションを作成します。競合がある場合は、競合を解決してください。


34 第 5 章: Salesforce 統合トランスフォーメーション

第 6 章

Salesforce PickList トランスフォーメーション

この章では、以下の項目について説明します。• Salesforce PickList トランスフォーメーションの概要, 35 ページ• Salesforce PickList のコンポーネント, 36 ページ• Salesforce PickList のポート, 36 ページ• Salesforce PickList トランスフォーメーションのルールおよびガイドライン, 37 ページ• Salesforce PickList トランスフォーメーションの作成, 37 ページ

Salesforce PickList トランスフォーメーションの概要Salesforce PickList トランスフォーメーションは、パッシブトランスフォーメーションです。 Salesforce PickList トランスフォーメーションを使用すると、Salesforce オブジェクトのフィールドに対して、選択リストの値のリストを取得できます。 Salesforce 選択リストとは、Salesforce フィールドに有効な値のリストのことです。選択リストの値を取得してソースデータを検証できます。Salesforce PickList トランスフォーメーションは、Salesforce ユーザーアカウントで使用可能な、標準またはカスタムの Salesforce オブジェクトから作成できます。関連する Salesforce オブジェクトからのフィールドを Salesforce PickList トランスフォーメーションに含めることもできます。PowerCenter Integration Service は、Salesforce PickList トランスフォーメーションの定義済み選択リストを使って、各フィールドの選択リストを取得できます。マッピングでは、任意のタイプのソースを Salesforce PickList トランスフォーメーションと共に使用できます。選択リストの値のリストを取得するには、ソース修飾子トランスフォーメーションを Salesforce PickList トランスフォーメーションの PickList_Input ポートに接続します。トランスフォーメーションは、ターゲットにリンクされている選択リストフィールドに有効な値のリストをカンマ区切りで出力します。

35

Salesforce PickList のコンポーネントSalesforce PickList トランスフォーメーションの設定時に、以下のコンポーネントを定義します。• ［トランスフォーメーション］タブ。［トランスフォーメーション］タブで、トランスフォーメーションの名

前の変更、および説明の追加が行えます。• ［ポート］タブ。Salesforce PickList トランスフォーメーションには、選択リストポートとパススルーポー

トを含めることができます。• ［プロパティ］タブ。トランスフォーメーションのトレースレベルを設定できます。デフォルトのトレース

レベルは Normal です。さらに、セッションの実行ごとに一貫した出力データを生成するかどうかを指定します。デフォルトで、一貫した出力データを生成します。

• ［初期化プロパティ］タブ。Salesforce PickList トランスフォーメーションは、初期化プロパティを使用しません。 PowerCenter Integration Service は、初期化情報をベンダ定義のメタデータエクステンションから取り出します。

• ［メタデータエクステンション］タブ。再利用不可能のメタデータエクステンションを作成して、トランスフォーメーションのメタデータを拡張します。エクステンション名、データタイプ、精度、および値を設定します。また、すべてのトランスフォーメーションからメタデータエクステンションを利用できるようにする場合は、メタデータエクステンションを再利用可能なエクステンションに格上げします。

• ［ポート属性定義］タブ。［ポート属性定義］タブに、Salesforce PickList トランスフォーメーションに対して定義されたポート属性が表示されます。ポート属性は、SforceDataType および SforceName のみです。

Salesforce PickList のポートSalesforce PickList トランスフォーメーションには、以下のタイプのポートを含めることができます。• PickList_Input ポート。PowerCenter Integration Service で Salesforce 選択リストを取得できるように

するには、ソース修飾子トランスフォーメーション内の任意のフィールドを、Salesforce PickList トランスフォーメーション内の PickList_Input ポートにマップします。 PickList_Input ポートにフィールドをマップしない場合は、セッションが失敗します。

• 出力ポート。Designer では、選択リストの値のある Salesforce オブジェクトの属性に出力ポートがデフォルトで作成されます。 Salesforce オブジェクトのさまざまな属性に対して複数の選択リストを出力するには、属性ごとにソース修飾子トランスフォーメーションを 1 つ設定します。セッションを実行すると、PowerCenter Integration Service では、マッピングに含まれる Salesforce オブジェクトの属性ごとに選択リストの値が出力されます。

• パススルーポート。Salesforce PickList トランスフォーメーションに、ポートをパススルーポートとして追加できます。 PowerCenter Integration Service では、パススルーポートの値がトランスフォーメーションを通過し、ポートがターゲットに接続されている場合はターゲットに渡されます。

36 第 6 章: Salesforce PickList トランスフォーメーション

Salesforce PickList トランスフォーメーションのルールおよびガイドラインSalesforce PickList トランスフォーメーションを設定するには、以下のガイドラインに従います。• Salesforce PickList トランスフォーメーションをマッピングに含める際は、Salesforce API のバージョン

33.0 以下を使用します。• 選択リストのポートのデフォルト長は 512 文字です。PowerCenter Integration Service は、512 文字を超

える値を切り詰めます。切り捨てが行われないようにするには、ポートの長さを増やします。• 少なくとも 1 つのポートを、ソースから Salesforce PickList トランスフォーメーションに接続する必要が

あります。• Salesforce API で公開されないため、Salesforce PickList トランスフォーメーションは制限された選択リ

ストの値を Salesforce から取得しません。• Salesforce PickList トランスフォーメーションは、複数選択の選択リストの値を取得しません。

Salesforce PickList トランスフォーメーションの作成Salesforce PickList トランスフォーメーションを作成するには：1. Transformation Developer または Mapping Designer で、［トランスフォーメーション］-［作成］をク


2. トランスフォーメーションタイプとして Salesforce PickList を選択して、名前を入力します。 3. ［作成］をクリックします。 4. ［Salesforce からテーブルをインポート］ダイアログボックスで、以下の情報を入力します。






を選択し、［OK］をクリックします。

Salesforce PickList トランスフォーメーションのルールおよびガイドライン 37

競合がない場合、Designer は、選択したオブジェクトおよび関連するオブジェクトに基づいてSalesforce PickList トランスフォーメーションを作成します。競合がある場合は、競合を解決してください。


38 第 6 章: Salesforce PickList トランスフォーメーション

第 7 章

Salesforce セッションとワークフロー

この章では、以下の項目について説明します。• Salesforce セッションとワークフローの概要, 39 ページ• Salesforce 接続, 39 ページ• Salesforce のソースとのセッションの設定, 42 ページ• Salesforce のターゲットとのセッションの設定, 47 ページ• セッションパフォーマンスを最㽩にする設定, 56 ページ

Salesforce セッションとワークフローの概要マッピングを作成後、セッションを作成することができます。また、このセッションをワークフローで使用して、データの抽出、トランスフォーメーション、およびロードを実行できます。 Workflow Manager で、セッションとワークフローを作成します。Salesforce セッションを設定するときには、Salesforce に対してデータの読み取りおよび書き込みを行うための接続を作成します。 PowerCenter Integration Service が Salesforce ソースからデータを読み取る方法やSalesforce ターゲットにデータを書き込む方法を決定するため、セッションでプロパティを定義することもできます。セッションを設定するには、以下のタスクを実行します。• Workflow Manager で Salesforce ソースおよびターゲットへのアプリケーション接続を設定します。

Salesforce に対する読み取りまたは書き込みのために、アプリケーション接続を設定します。• Salesforce ソースについて、セッションプロパティを設定します。• Salesforce ターゲットについて、セッションプロパティを設定します。• 必要に応じて、パフォーマンスを最適化するようにセッションを設定します。

Salesforce 接続PowerCenter Integration Service が Salesforce に接続するには、Workflow Manager で Salesforce アプリケーション接続を設定しておく必要があります。Salesforce アプリケーション接続を設定するときには、

39

PowerCenter Integration Service が Salesforce に接続する際に使用する接続属性を指定します。接続オブジェクトには、Salesforce のユーザー ID、パスワード、実行時接続のエンドポイント URL 情報が格納されます。PowerCenter Integration Service は、Salesforce セキュリティメカニズムを使用してログインの認証を行います。指定したログインが無効な場合は、以下のエラーが表示されます。Invalid login. When accessing Salesforce from outside of your company's trusted networks, you must append a security token to your password to log in to the API or a desktop client. To receive or reset your security token, log in to Salesforce with your browser and click Setup | My Personal Information | Reset Security Token.有効な Salesforce ログインの取得の詳細については、社内の Salesforce 管理者に問い合わせてください。注: アプリケーション接続に接続変数は使用できません。OAuth タイプの接続を作成することでも、Salesforce API.を使用して Salesforce にアクセスできます。OAuth は、セキュアな API 承認に使用できる標準プロトコルです。OAuth には、ユーザが Salesforce の資格情報を公開する必要がないというメリットがあり、Salesforce 管理者はいつでもコンシューマのアクセスを取り消すことができます。

Salesforce 接続の設定Salesforce アプリケーション接続を設定するには：1. ［Workflow Manager］で、PowerCenter リポジトリに接続します。 2. ［接続］ - ［アプリケーション］をクリックします。

［アプリケーション接続ブラウザ］ダイアログボックスが表示されます。3. ［タイプの選択］から、［Salesforce 接続］を選択します。 4. [新規作成]をクリックします。［接続オブジェクト定義］ダイアログボックスが表示されます。 5. Salesforce 接続をセットアップする際、接続タイプには［標準］または［OAuth］が選択できます。

以下の表に、標準接続のプロパティ一覧を示します。

接続プロパティ説明名前 Salesforce 接続の名前。タイプ標準の Salesforce 接続。ユーザー名 Salesforce アカウントのユーザー名。パスワード Salesforce アカウントのパスワード。サービスの URL Salesforce サービスの URL。

https://login.salesforce.com/services/Soap/u/45.0Salesforce のピックリスト、マージ、およびルックアップのトランスフォーメーションを使用している間の、Salesforce サービスの URL。https://login.salesforce.com/services/Soap/u/33.0

40 第 7 章: Salesforce セッションとワークフロー

以下の表に、OAuth 接続のプロパティ一覧を示します。

接続プロパティ

説明

名前 OAuth 接続の名前。タイプ［OAuth を使用］チェックボックスを選択して、OAuth 接続を使用します。更新トークン Salesforce の更新トークン。

リフレッシュトークンの生成方法の詳細については、「リフレッシュトークンの生成」 (ページ 41)を参照してください。

コンシューマキー

更新トークンの生成に必要になる、Salesforce から取得するコンシューマキー。コンシューマキーの生成方法の詳細については、Salesforce のマニュアルを参照してください。

コンシューマシークレット

更新トークンの生成に必要になる、Salesforce から取得するコンシューマシークレット。コンシューマシークレットの生成方法の詳細については、Salesforce のマニュアルを参照してください。

6. ［OK］をクリックします。新しいアプリケーション接続が［アプリケーションオブジェクトブラウザ］に表示されます。

リフレッシュトークンの生成OAuth タイプの接続を作成すると、Salesforce API を使用して Salesforce にアクセスできます。OAuth は、セキュアな API 承認に使用できる標準プロトコルです。ユーザーは Salesforce の資格情報を公開する必要がなく、Salesforce 管理者はいつでもコンシューマのアクセスを取り消すことができます。リフレッシュトークンを生成するには、以下の手順を実行します。1. 次のリンクから、Oauth リフレッシュトークンを生成するユーティリティをダウンロードします。

https://marketplace.informatica.com/listings/cloud/solutions/sfdc_oauth_tool_for_powercenter_10_2_0_hotfix_1.html

2. ユーティリティをダウンロードしたら、OAuth.zip ファイルを解凍します。 3. Oauth\conf フォルダに移動し、server.xml ファイルを開き、mystore.jks ファイルパスを更新フォルダに移動し、

server.xml ファイルを開き、mystore.jks ファイルパスをシステム上のそれに更新します。ファイルを保存し、閉じます。

4. ~\oauth\bin に移動して、コマンド catalina.bat start を実行します。 5. ブラウザから http://localhost:8090/salesforce に移動します。 6. Salesforce ユーザー名およびパスワードを入力してログインします。 7. ［クライアント ID］（コンシューマキー）および［コンシューマシークレットキー］（コンシューマシーク

レット）を入力してから［送信］をクリックします。リフレッシュトークンが生成されます。

Salesforce 接続 41



http://localhost:8090/salesforce

Salesforce のソースとのセッションの設定［マッピング］タブで、Salesforce ソースのセッションプロパティを設定できます。セッション内の各ソース

インスタンスについて、プロパティを定義します。以下の表に、Salesforce ソースに対して設定できるセッションプロパティを示します。

プロパティ名説明SOQL フィルタ条件 Salesforce ソースレコードをフィルタリングするためのフィルタ条件を入力し

ます。CDC 時間制限変更された Salesforce データを PowerCenter 統合サービスが読み取る時間枠

（秒）。［CDC 時間制限］をゼロ以外の値に設定すると、PowerCenter 統合サービスがソースデータの完全初期読み取りを実行し、指定された時間枠内でSalesforce データに対する変更をキャプチャします。変更データを無限時間キャプチャするよう設定するには、値を-1 に設定します。デフォルトは 0 です。

フラッシュ間隔変更された Salesforce データを PowerCenter 統合サービスがキャプチャする間隔（秒）。デフォルトは 300 です。［CDC 時間制限］をゼロ以外の値に設定した場合、PowerCenter 統合サービスが 300 秒ごとにソースから変更データをキャプチャします。それ以外の場合、PowerCenter 統合サービスはこの値を無視します。

［フラッシュ間隔］の最小推奨値は 60 秒です。CDC 開始タイムスタンプ時間枠の開始日時。PowerCenter 統合サービスは、この時刻より後に追加また

は変更されたデータを抽出します。形式は YYYY-MM-DDTHH:MI:SS.SSSZ でなければなりません。パラメータファイルで$Paramstart マッピング変数を使用して CDC 開始時刻を指定することもできます。

CDC 終了タイムスタンプ時間枠の終了日時。PowerCenter 統合サービスは、この時刻より前に追加または変更されたデータを抽出します。形式は YYYY-MM-DDTHH:MI:SS.SSSZ でなければなりません。パラメータファイルで$Paramend マッピング変数を使用してCDC 終了時刻を指定することもできます。

行制限 PowerCenter 統合サービスが処理する行の最大数。デフォルトは 0 です。0 は行制限がないことを示し、PowerCenter 統合サービスはすべてのレコードを処理します。

queryAll を使用すべての行（アクティブな行、アーカイブ済みの行、ごみ箱に存在する削除済みの行など）を返すクエリを実行します。選択しない場合、PowerCenter 統合サービスはアクティブな行のみを返します。

［一括クエリの有効化］オプションを使用するように、または変更データキャプチャを実行するようにセッションを設定すると、PowerCenter 統合サービスはこのプロパティを無視します。

CDC にSystemModstamp を使用

SystemModstamp を Salesforce の変更レコード用のタイムスタンプとして使用します。選択しない場合、PowerCenter 統合サービスは LastModifiedDate タイムスタンプを使用して Salesforce の変更レコードを識別します。デフォルトでは、LastModifiedDate タイムスタンプを使用するように設定されています。

CDC フラッシュの間隔オフセット

CDC フラッシュの間隔をオフセットする秒数。CDC 時間制限内にサブミットされ、時間制限内に Salesforce によってコミットされなかったリアルタイムデータをキャプチャします。

一括クエリの有効化 Salesforce Bulk API を使用して Salesforce ソースデータを読み取ります。デフォルトでは、PowerCenter 統合サービスは標準の Salesforce API を使用します。


プロパティ名説明PK Chunking の有効化選択すると、プライマリキーチャンクが有効になります。プライマリキーチャ

ンクを有効にすると、Bulk API ではレコード ID に基づいてデータセットが複数のチャンクに分割され、チャンクごとに抽出クエリが作成されます。

PK Chunking サイズチャンクのレコードの数。デフォルトは 100000 です。最大値は 250000 です。

［PK チャンクを有効にする］を選択した場合に限り適用可能です。PK チャンクの startRow ID

チャンクが開始される行 ID。デフォルトでは、Salesforce は最初のレコードからチャンクを適用します。

PK チャンクの親オブジェクト

親オブジェクトを指定し、共有オブジェクトでクエリの PK チャンクを有効にします。たとえば、CaseHistory の場合、親オブジェクトとして Case を指定します。PK チャンクは、親オブジェクトがサポートされている場合にのみ、共有オブジェクトでサポートされます。注: PK チャンク親オブジェクト名は、大文字と小文字が区別されます。名前は大文字で始まり、それ以降は小文字にする必要があります。

ソースデータのフィルタリングセッションの実行時に、PowerCenter Integration Service は、Salesforce のソース定義に含まれるオブジェクトとフィールドに基づいて SOQL クエリを生成します。Salesforce ソースからデータを読み取るセッションを設定するときには、ソースから読み取るレコードをフィルタリングするため、フィルタ条件を入力できます。Salesforce マニュアルに記載された SOQL 構文に従って、フィルタ条件を入力します。フィルタ条件を入力すると、PowerCenter Integration Service は SOQL クエリの WHERE 句を変更してオーバライドします。フィルタ条件を入力するときは、次のガイドラインを考慮してください。• Salesforce ソースからのレコードをフィルタリングするには、SOQL フィルタ条件のセッションプロパティ

にフィルタ条件を入力します。例えば、2007 年 10 月 30 日より前に作成された Salesforce Account オブジェクトからレコードを読み取る場合、以下のフィルタ条件を入力します。CreatedDate < '2007-10-30'

• 次の例に示すように、Order By および Group By 句よりも先に、フィルタ条件を指定する必要があります。id!= null Order By Name

Salesforce API が、実行時に SOQL 構文検査を実行します。無効なフィルタ条件を入力すると、セッションが失敗します。CDC を有効にし、以下の条件のいずれかを満たす場合も、セッションは失敗します。• フィルタ条件に Order By または Group By 句が入力されている。• フィルタ条件に LIMIT 句が入力されている。• フィルタ条件に AND または OR 演算子が入力されているが、クエリが括弧で囲まれていない。次の例に示

すように、クエリを括弧で囲んでください。(Name="Jason" OR Name="Thompson")

• フィルタ条件に特殊演算子が入力されているが、クエリが括弧で囲まれていない。次の NOT 演算子の例に示すように、クエリを括弧で囲んでください。(NOT(Name LIKE 'Jason'))

Salesforce のソースとのセッションの設定 43

削除済みおよびアーカイブ済みの Salesforce レコードのキャプチャPowerCenter 統合サービスは、Salesforce のソースオブジェクトから、アクティブなレコード、削除済みのレコード、アーカイブ済みのレコードをキャプチャできます。デフォルトでは、削除済みレコードとアーカイブ済みレコードはセッションでキャプチャされません。削除済みレコードとアーカイブ済みレコードのキャプチャ時には、削除済みレコードはごみ箱からキャプチャされ、アーカイブ済みデータは Salesforce アーカイブからキャプチャされます。削除済みおよびアーカイブ済みのレコードをキャプチャするには、［QueryAll を使用］セッションプロパティを設定します。注: 指定された時間枠が 30 日を超えている場合、セッションでは削除済みレコードのフェッチが失敗します。変更データキャプチャを実行するセッションを設定すると、［QueryAll を使用］プロパティが上書きされます。

変更データのキャプチャPowerCenter 統合サービスは、複製可能で、CreatedDate フィールドと LastModifiedDate フィールドを含むSalesforce オブジェクトから、変更データをキャプチャできます。複製可能でない、または CreatedDate フィールドと LastModifiedDate フィールドを含まない Salesforce オブジェクトから変更データをキャプチャするようにセッションを設定した場合、セッションは失敗します。複製可能なオブジェクトの詳細については、Salesforce のマニュアルを参照してください。PowerCenter 統合サービスは、削除されたデータをキャプチャする際に、削除されたレコードの ID のみを返し、行通知を「delete」に設定します。変更データをキャプチャするには、次の方法のいずれかを使用します。• 変更データを連続的にキャプチャする。変更データをキャプチャしてリアルタイムでデータを処理するよう

にセッションを設定します。• 特定の時間枠内の変更データをキャプチャする。データ変更の際に、特定の時間枠内の変更データをキャプ

チャするようにセッションを設定します。デフォルトでは、変更データキャプチャは無効になっています。特定の方法を有効にするには、セッションプロパティで必須属性を指定します。1 つの CDC 方法に属性を設定します。2 つの異なった CDC 方法を 1 つのセッションに定義しないでください。LastModifiedDate または SystemModstamp フィールドを、Salesforce レコードの最終更新日時を判断するタイムスタンプとして設定できます。変更データキャプチャを実行するセッションを設定すると、［QueryAll を使用］セッションプロパティがオーバーライドされます。関連項目：•「変更データのキャプチャでの SystemModstamp または LastModifiedDate タイムスタンプの使用」 (ペー

ジ 46)

継続 CDC セッションPowerCenter 統合サービスは連続 CDC セッションを実行する際に、ソースオブジェクトのすべてのレコードを読み取り、挿入フラグを設定した行として次のトランスフォーメーションにそれらを渡します。 PowerCenter 統合サービスがすべてのソースデータを読み取ると、CDC 時間制限とフラッシュ間隔が開始されます。


フラッシュ間隔が終了すると、PowerCenter 統合サービスは以下のタスクを実行し、連続 CDC セッションの変更データをキャプチャします。1. 初期読み取り以降に作成されたすべてのレコードを読み取り、それらを次のトランスフォーメーションに

挿入フラグを付けた行として渡します。2. 初期読み取り以降に更新されたすべてのレコードを読み取り、それらを次のトランスフォーメーションに

更新フラグを付けた行として渡します。3. 初期読み取り以降に削除されたすべてのレコードを読み取り、それらを次のトランスフォーメーションに

削除フラグを付けた行として渡します。PowerCenter 統合サービスがすべての変更データの読み取りを終了すると、フラッシュ間隔が再度開始されます。 CDC 時間制限が終了すると、PowerCenter 統合サービスが Salesforce からの読み取りを停止します。変更データをキャプチャしてソースベースコミットを使用するようにセッションを設定すると、PowerCenter統合サービスが、ターゲットベースコミット間隔とフラッシュ間隔に基づいてターゲットに対してデータをコミットします。例えば、CDC 時間制限を 4,000 秒、フラッシュ間隔を 300 秒、ソースベースコミット間隔を 1,000 行に設定します。PowerCenter 統合サービスがすべてのソースデータを読み取った後に、フラッシュ間隔が開始されます。 PowerCenter 統合サービスが変更データをキャプチャし、ソースから 1,000 行を読み取った後および300 秒のフラッシュ間隔ごとに、ターゲットに対して行をコミットします。 PowerCenter 統合サービスは、4,000 秒後に Salesforce からの読み取りを停止します。ターゲットベースのコミットを使用するようにセッションを設定している場合は、PowerCenter 統合サービスはソースベースのコミットに基づいてセッションを実行します。また、行は、フラッシュ間隔だけを基にターゲットにコミットされます。コミット間隔に基づいて行をターゲットにコミットすることはありません。

CDC フラッシュの間隔オフセットCDC フラッシュの間隔オフセットは CDC フラッシュの間隔をオフセットする秒数です。フラッシュの間隔オフセットを、CDC 時間制限内にサブミットされ、時間制限内に Salesforce によってコミットされなかったリアルタイムデータをキャプチャするように設定します。Salesforce がデータをコミットする前に自動トリガを実行する必要がある場合に遅延が起きることがあります。セッションをフラッシュの間隔オフセットを使用するように設定した場合は、PowerCenter 統合サービスはフラッシュの間隔からフラッシュの間隔オフセットを減算します。たとえば、フラッシュの間隔を 300 秒に設定し、フラッシュの間隔オフセットを 2 秒に設定したとします。初回のフラッシュの間隔は 9:00:00 に開始し、9:04:58 に終了します。フラッシュの間隔オフセットなしでは、9:05:00 に終了する予定でした。2 回目のフラッシュの間隔は 9:04:59 に開始し、9:09:57 に終了します。3 回目のフラッシュの間隔は 9:09:58 に開始し、9:14:56 に終了します。

連続 CDC セッションの設定複製可能な Salesforce オブジェクトから読み取るセッションの変更データを連続的にキャプチャするには、以下のタスクを実行します。• 各 CDC セッションに対して、リアルタイムセッション用の設定手順を実行します。• 変更データキャプチャの時間制限とフラッシュ間隔を設定します。オプションとしてフラッシュの間隔オフ

セットを設定します。

時間枠ベースの CDC セッションPowerCenter 統合サービスは、特定の時間枠内の CDC セッションを実行するとき、ソースオブジェクトのすべてのレコードを読み取り、CDC 時間枠基準に一致するレコードを抽出します。

Salesforce のソースとのセッションの設定 45

PowerCenter 統合サービスは、以下の手順を実行して、時間枠内の CDC セッションの変更データをキャプチャします。1. CDC 開始時刻と終了時刻のあいだに作成されたすべてのレコードを読み取り、それらを次のトランスフォ

ーメーションに挿入フラグを付けた行として渡します。2. CDC 開始時刻と終了時刻のあいだに更新されたすべてのレコードを読み取り、それらを次のトランスフォ

ーメーションに更新フラグを付けた行として渡します。3. CDC 開始時刻と終了時刻のあいだに削除されたすべてのレコードを読み取り、それらを次のトランスフォ

ーメーションに削除フラグを付けた行として渡します。

時間枠内の CDC セッションの設定特定の時間枠内の変更データのキャプチャを有効にするには、時間枠の開始時刻と終了時刻をセッションプロパティで定義します。

時間枠内の CDC セッションの処理に関するルールおよびガイドラインCDC セッションを特定の時間枠で実行する場合は、以下のルールとガイドラインを使用します。• セッションを実行すると、PowerCenter Integration Service が、開始時刻と終了時刻の形式を検査しま

す。タイムスタンプ形式が適切でない場合、セッションは失敗します。• 開始時刻と終了時刻の値は過去でなければなりません。• 開始時刻は終了時刻より早い時刻でなければなりません。• セッションを連続的に実行することはできません。• 変更データをキャプチャしてソースベースコミットを使用するようにセッションを設定すると、

PowerCenter Integration Service が、ソースベースコミット間隔に基づきターゲットに対してデータをコミットします。ターゲットベースのコミットを使用するようにセッションを設定している場合は、PowerCenter Integration Service はソースベースのコミットに基づいてセッションを実行します。

変更データのキャプチャでの SystemModstamp またはLastModifiedDate タイムスタンプの使用Salesforce ソースからデータを抽出するセッションを実行すると、PowerCenter Integration Service は、

［CDC に SystemModstamp を使用］セッションプロパティに基づいて新規および更新済みのレコードを判断します。 Salesforce レコードの最終更新日時を判断するために SystemModstamp または LastModifiedDate属性を使用するかどうかを示すように、このセッションプロパティを設定します。Salesforce は、レコード更新時に Salesforce レコードの LastModifiedDate 属性を更新します。 Salesforceは、レコードまたは関連オブジェクトのレコード更新時に Salesforce レコードの SystemModstamp 属性を更新します。Salesforce は、LastModifiedDate 属性ではなく、SystemModstamp 属性にインデックスを付けます。セッションパフォーマンスを向上させるには、SystemModstamp 属性を使用します。

一括 API ソースセッションPowerCenter 統合サービスでは、Saleforce 一括 API を使用して Salesforce ソースからデータを読み取ることができます。一括 API を使用して、最小限の数の API 呼び出しで Salesforce から大量のデータを読み取ります。一括 API を使用すれば、バージョン 25.0 以降の Salesforce API で Salesforce ソースからデータを読み取ることができます。


一括 API を使用して個々の Salesforce ソースからデータを読み取ります。一括 API では、関連するソースオブジェクトからデータを読み取ることはできません。関連するソースオブジェクトからデータを読み取るには、標準 API を使用します。一括 API による読み取りでは、データの各バッチに CSV 形式で最大 1 GB のデータを含めることができます。Salesforce ソースの一括 API を使用するようにセッションを設定するには、［一括クエリの有効化］セッションプロパティを使用します。このプロパティを選択した場合、PowerCenter 統合サービスは［QueryAll を使用］セッションプロパティを無視します。PowerCenter 統合サービスは、一括 API ソースセッションの［エラー時に停止］セッションプロパティを無視します。

Salesforce のターゲットとのセッションの設定［マッピング］タブで、Salesforce ターゲットのセッションプロパティを設定できます。セッション内の各タ

ーゲットインスタンスについて、プロパティを定義します。以下の表に、Salesforce ターゲットに対して設定できるセッションプロパティを示します。

プロパティ名説明挿入を更新/挿入として扱う

挿入フラグが設定されたレコードを更新/挿入します。デフォルトでは、PowerCenter 統合サービスはすべてのレコードを挿入として扱います。

更新を更新/挿入として扱う

更新フラグが設定されたレコードを更新/挿入します。このプロパティは、マッピングのアップデートストラテジトランスフォーメーションか、もしくは［ソース行の扱い］セッションプロパティを使用して、レコードに更新フラグを設定するときに使用します。

最大バッチサイズ PowerCenter 統合サービスが 1 つのバッチで Salesforce ターゲットに書き込むレコードの最大数。デフォルトは 200 件のレコードです。Bulk API ターゲットセッションでは使用されません。

フィールドを NULLに設定

ターゲット内の値をソースからの NULL 値に置換します。PowerCenter 統合サービスでは、更新操作または更新/挿入操作中に、デフォルトでレコードの値が NULL 値に置換されることはありません。既存の値が保持されます。

SFDC エラーファイルの使用

エラーログファイルを生成します。PowerCenter 統合サービスでは、デフォルトでエラーログファイルが生成されません。Bulk API ターゲットセッションのエラーログファイルを生成するには、［すべてのバッチが処理されるまで一括ジョブを監視］セッションプロパティも選択します。

SFDC 成功ファイルの使用

成功ログファイルを生成します。PowerCenter 統合サービスでは、デフォルトで成功ログファイルが生成されません。Bulk API ターゲットセッションの成功ログファイルを生成するには、［すべてのバッチが処理されるまで一括ジョブを監視］セッションプロパティも選択します。

SFDC 成功ファイルディレクトリ

PowerCenter 統合サービスが成功ログファイルを格納するディレクトリです。PowerCenter 統合サービスでは、デフォルトで成功ログファイルが$PMTargetFileDir ディレクトリに格納されません。PowerCenter 統合サービスでは、エラーログファイルは$PMBadFileDir ディレクトリに格納されます。

Salesforce のターゲットとのセッションの設定 47

プロパティ名説明Idlookup フィールドを使用して更新/挿入する

Salesforce idLookup フィールドを使用して、更新/挿入される必要があるターゲットレコードを識別します。このプロパティを選択しない場合は、更新/挿入操作に外部 ID を使用します。このプロパティを選択せず、外部 ID も指定しない場合、セッションは失敗します。

更新/挿入にこのExternalId/IdLookupフィールドを使用する

更新/挿入に使用する外部 ID または idLookup フィールドの正確な名前。デフォルトでは、PowerCenter 統合サービスはターゲットの最初の外部 ID またはidLookup フィールドを使用します。このプロパティは、更新/挿入に別のフィールドを使用する場合に使用します。

SFDC Bulk API の使用 Salesforce Bulk API を使用して大量のデータを含むバッチファイルを Salesforceターゲットにロードします。デフォルトでは、PowerCenter 統合サービスは標準の Salesforce API を使用します。

すべてのバッチが処理されるまで一括ジョブを監視

Bulk API ターゲットセッションを監視します。このプロパティを選択すると、PowerCenter 統合サービスは各バッチのステータスをセッションログに記録します。このプロパティを選択しない場合、PowerCenter 統合サービスは、セッションログ用の完全なセッション統計情報を生成しません。セッションの成功ログまたはエラーログを生成するには、［SFDC 成功ファイルの使用］または［SFDC エラーファイルの使用］セッションプロパティとともにこのプロパティを選択します。

並列実行を逐次実行でオーバーライド

Salesforce Bulk API にターゲットに逐次バッチを書き込むように指示します。デフォルトでは、Bulk API はバッチを並列に書き込みます。

一括成功およびエラーファイルの作成の無効化

Bulk API ターゲットセッションの成功ログファイルおよびエラーログファイルの作成を無効化します。

［SFDC エラーファイルの使用］および［SFDC 成功ファイルの使用］セッションプロパティよりも優先されます。

フィールド切り詰め属性の有効化

Salesforce で、ターゲットファイルよりも長いターゲットデータを切り詰めることができるようにします。このプロパティを選択すると、オーバーフローデータがSalesforce で切り詰められてから、Salesforce のターゲットに行が書き込まれます。デフォルトでは、PowerCenter 統合サービスはオーバーフローデータをセッションエラーファイルに書き込みます。

成功およびエラーファイルにプレフィックスを設定

成功ログファイル名およびエラーログファイル名にプレフィックスを追加します。プレフィックスを追加した場合、成功ログファイルは次の命名規則を使用します: <プレフィックス>_<セッション名><タイムスタンプ>_success.csv.プレフィックスを追加した場合、エラーログファイルは次の命名規則を使用します: <プレフィックス>_<セッション名><タイムスタンプ>_error.csv.

Bulk API の物理削除の有効化

Bulk API ターゲットセッションの Salesforce ターゲットから行を完全に削除します。

一括エラーファイルの場所の設定

Bulk API ターゲットのエラーログファイルのディレクトリ。


プロパティ名説明一括ジョブステータスのポーリング間隔の設定

Bulk API ターゲットセッションに関する情報について Salesforce をポーリングする前に PowerCenter 統合サービスが待機する時間（秒）。正の整数値を入力します。デフォルトでは、PowerCenter 統合サービスは 10 秒ごとにポーリングを実行します。

割り当てルールの選択

標準 API を使用して、Salesforce の Case か Lead のターゲットオブジェクトにのみ適用可能です。レコードの挿入、更新、upsert のいずれかを実行しているとき、レコードで属性を再割り当てするための割り当てルール。- なし。割り当てルールを使用しないことを選択します。デフォルトは［なし］

です。- デフォルト。組織のデフォルトの割り当てルールセットを使用することを選択

します。- カスタム。カスタム割り当てルールを指定して使用することを選択します。注: Bulk API の割り当てルール選択は使用できません。

割り当てルールを指定する

カスタム割り当てルールの場合有効な割り当てルールを入力します。

ターゲットに対する更新/挿入操作の設定Salesforce の更新/挿入操作は、Salesforce オブジェクトで新しいレコードを作成するか、既存のレコードを更新します。 Salesforce オブジェクトにレコードを更新/挿入するには、以下のフィールドタイプのいずれかを指定する必要があります。• 外部 ID フィールド。Salesforce のカスタムフィールドを使用して、Salesforce オブジェクト内の各レコー

ドを一意に識別できます。 Salesforce の各オブジェクトについて、カスタムの外部 ID フィールドを作成できます。 PowerCenter Designer で Salesforce ターゲット定義のプロパティを表示して、オブジェクトに外部 ID フィールドが含まれるかどうかを確認できます。

• idLookup フィールド。Salesforce idLookup フィールドを使用して、Salesforce オブジェクト内の各レコードを識別できます。 Salesforce は、標準の各 Salesforce オブジェクトについて、idLookup フィールドを作成します。例えば、Email フィールドは Contact オブジェクトの idLookup フィールドです。カスタムの Salesforce オブジェクトに idLookup フィールドは含まれません。 idLookup フィールドの詳細については、Salesforce のマニュアルを参照してください。

Salesforce ターゲットオブジェクトには、複数の外部 ID または Idlookup フィールドが存在する可能性があります。デフォルトでは、PowerCenter Integration Service は最初に検出した外部 ID または Idlookup フィールドを使用します。ただし、セッションプロパティで外部 ID または Idlookup フィールドを指定して、更新/挿入操作を行うことができます。Salesforce ターゲットに書き込むセッションの更新/挿入操作を設定する手順1. マッピングでソースからターゲットへ外部 ID または idLookup フィールドをマッピングします。外部 ID

を使用している場合は、外部 ID を Salesforce ターゲットオブジェクトの外部 ID フィールドにマッピングします。 idLookup フィールドを使用している場合は、フィールドを該当するターゲットフィールドにマッピングします。例えば、email ソースフィールドは Salesforce Contact オブジェクトターゲットのEmail フィールドにマッピングします。

2. ［挿入を更新/挿入として扱う］または［更新を更新/挿入として扱う］セッションプロパティを設定して、レコードを更新/挿入するように Salesforce セッションを設定します。

3. 外部 ID フィールドではなく idLookup フィールドを使用するには、［IdLookup フィールドを使用して更新/挿入する］セッションプロパティを有効にします。デフォルトでは、PowerCenter Integration Service は外部 ID を使用して更新/挿入を行います。外部 ID をオーバーライドし、代わりに idLookup を使用するように、セッションを設定できます。


4. 使用する外部 ID または Idlookup フィールドを指定するには、［この外部 ID/Idlookup フィールドを使用して更新/挿入する］セッションプロパティに外部 ID または Idlookup フィールドの名前を入力します。注: 外部 ID または Idlookup フィールドの名前を入力しない場合、PowerCenter Integration Service は最初に検出した外部 ID または Idlookup フィールドを選択します。指定したフィールドが外部 ID またはIdlookup フィールドでない場合やフィールド名のスペルが間違っている場合、セッションは失敗します。

最大バッチサイズの設定PowerCenter Integration Service は、Salesforce ターゲットへのデータをバッチとして書き込みます。セッションプロパティの最大バッチサイズ属性は、PowerCenter Integration Service が Salesforce ターゲットに1 つのバッチで書き込むことができるレコードの最大数を決定します。 Salesforce サービスは、1 回の挿入、更新、または削除コールで最大 200 レコードを受信できます。Salesforce サービスに対して実行するコールの数を減らすには、各バッチが、［最大バッチサイズ］プロパティで設定された、最大数のレコードを含む必要があります。セッションのパフォーマンスを最適化するには、デフォルトの最大バッチサイズ 200 を使用し、バッファブロックに 200 の倍数のレコードが含まれるように

［DTM バッファサイズ］セッションを調整します。関連項目：•「DTM バッファサイズの調整」 (ページ 56)

更新操作および更新/挿入操作での NULL 値の処理PowerCenter Integration Service では、更新操作または更新/挿入操作中に、デフォルトで Salesforce レコードの既存の値がソースの NULL 値に置換されることはありません。既存の値を置換して NULL 値にするには、Salesforce のターゲットに対して［フィールドを NULL に設定］セッションプロパティを設定します。Salesforce ターゲットの外部 ID フィールドの値を NULL に設定することはできません。［フィールドを NULLに設定］セッションプロパティを有効にし、セッションが外部 ID フィールドの既存の値を NULL 値に置換しようとした場合、セッションは失敗します。

子オブジェクトの関連付けを解除標準 API で更新/挿入操作を実行することで、カスタム子オブジェクトと標準の親オブジェクトの関連付けを解除できます。子オブジェクトの関連付けを解除するときは、子オブジェクトを親オブジェクトから切断します。カスタム子オブジェクトと標準の親オブジェクトの関連付けを解除するには、以下のタスクを実行します。• Salesforce 標準 API を使用する。• ［挿入を更新/挿入として扱う］または［更新を更新/挿入として扱う］セッションプロパティを使用して更

新/挿入を実行するように、セッションを設定する。• ［フィールドを NULL に設定］セッションプロパティを使用して null による更新を実行するように、セッシ

ョンを設定する。• 同じ更新/挿入行において、NULL 値を以下のフィールドに渡します。

- 親オブジェクトの外部 ID フィールド。- 子オブジェクトの任意のフィールド。

例えば、標準の Account オブジェクトに子リレーションのある、カスタム Contact オブジェクトがあります。カスタム Contact オブジェクトと標準 Account オブジェクトの関連付けを解除するには、標準 API を使用して行を更新/挿入できます。行には、Account オブジェクトの外部 ID の NULL 値と、Contact オブジェクト内の任意のフィールドの NULL 値が含まれます。


PowerExchange for Salesforce セッションのログの詳細PowerCenter Integration Service では、Salesforce ターゲットに書き込むセッションごとに、レコードレベルでログを生成できます。PowerCenter Integration Service では、以下のタイプのログを生成できます。• 成功ログ。成功ログには、Salesforce のターゲットへのロードが成功した各レコードのエントリが含まれ

ます。各エントリには、Salesforce ID など、レコードのすべてのフィールドにロードされた値が含まれます。Salesforce のターゲットにどのデータがロードされるかを理解するには、このファイルを使用します。成功ログは、実行されたすべての操作の監査証跡として使用できます。

• エラーログ。エラーログには、各データエラーのエントリが含まれます。ログの各エントリには、レコードのすべてのフィールドの値とエラーメッセージが含まれます。エラーログには、Salesforce およびPowerCenter からのエラーメッセージが表示されます。Salesforce のターゲットにレコードがロードされなかった理由を理解するには、このファイルを使用します。

PowerCenter Integration Service では、データに含まれるカンマおよび引用符の周りに引用符が挿入されます。注: PowerExchange for Salesforce の成功およびエラーログは、PowerCenter のセッションログとは異なります。PowerExchange for Salesforce の成功およびエラーログには、Salesforce ターゲットのセッションに固有のレコードレベルでの詳細が含まれます。PowerCenter のセッションログには、PowerCenter Integration Service で実行するタスク、一般的なセッションエラー、およびセッションのためのロード要約とトランスフォーメーション統計に関する情報が含まれます。PowerCenter Integration Service では、成功およびエラーログファイルに以下の命名規則が使用されます。

ログファイルのタイプ命名規則成功ログファイル <セッション名><タイムスタンプ>_success.csvエラーログファイル <セッション名><タイムスタンプ>_error.csv

Salesforce のターゲットに書き込むセッションごとに、成功ログおよびエラーログを生成するようにPowerCenter Integration Service を設定するには、［SFDC エラーファイルの使用］、［SFDC 成功ファイルの使用］、および［SFDC 成功ファイルディレクトリ］セッションプロパティを設定します。セッションごとの成功およびエラーログファイルにプレフィックスを追加できます。プレフィックスを設定した場合、PowerCenter Integration Service は次のようにログファイル名にプレフィックスを追加します。

ログファイルのタイププレフィックスが付いた命名規則成功ログファイル <プレフィックス>_<セッション名><タイムスタンプ>_success.csvエラーログファイル <プレフィックス>_<セッション名><タイムスタンプ>_error.csv

成功およびエラーログファイルにプレフィックスを追加するには、［成功およびエラーファイルにプレフィックスを設定］セッションプロパティを使用します。

サンプルの成功ログ以下の表に、成功ログの抜粋を示します。ID NAME ACCOUNT_NO EXT_ACCOUNT_NO__C STATUS0017000000NYre4AAD JumpCo 76543 666 Item Created

［ステータス］フィールドは、PowerCenter 統合サービスによって、レコードの作成、更新、削除のいずれかが行われたかどうかを示しています。


エラーログの例以下の表に、エラーログの抜粋を示します。NAME ACCOUNT_NO ANNUAL_REV EXT_ACCOUNT_NO_C ERRORCompany1 76544 800 万 555 値を正しいデータ型に変換する際に、

エラーが発生しました:入力文字列: 「800 万」

Company2 76545 - 444 指定されている重複外部 ID：444

Company3 76546 3.70E+10 444 指定されている重複外部 ID：444

更新/挿入用の idLookup による外部 ID のオーバーライドPowerCenter Integration Service は、Salesforce ターゲットで更新/挿入操作を実行するときに外部 ID または idLookup フィールドを使用できます。 PowerCenter Integration Service は、これらの ID のいずれかを使用して、Salesforce ターゲット内の更新/挿入対象レコードを識別します。デフォルトでは、PowerCenter Integration Service は外部 ID を使用して更新/挿入を行います。外部 ID をオーバーライドし、代わりにidLookup を使用するように、セッションを設定できます。

一括 API ターゲットセッションPowerCenter 統合サービスでは、Saleforce 一括 API を使用して Salesforce ターゲットにデータを書き込むことができます。一括 API を使用して、最小限の数の API 呼び出しで Salesforce に大量のデータを書き込みます。一括 API を使用すれば、バージョン 20.0 以降の Salesforce API で Salesforce ターゲットにデータを書き込むことができます。一括 API による書き込みでは、データの各バッチに、CSV 形式で最大 10,000 レコードまたは 100 万文字のデータを含めることができます。バッチを同時に、または逐次ロードするように一括 API ターゲットセッションを設定できます。セッションログでバッチの進行状況を監視し、行レベルの情報で成功およびエラーログを作成することもできます。Salesforce ターゲットの一括 API を使用するようにセッションを設定するには、［SFDC 一括 API の使用］セッションプロパティを使用します。このプロパティを選択した場合、PowerCenter 統合サービスは［最大バッチサイズ］セッションプロパティを無視します。PowerCenter 統合サービスは、一括 API ターゲットセッションの［エラー時の停止］セッションプロパティを無視します。リレーショナルデータベースにエラーロギングを設定すると、PowerCenter Integration Service でエラーメッセージが Salesforce ターゲットの PMERR テーブルにロードされない。一括 API ターゲットセッションを実行する前に、PowerCenter 統合サービスマシン上で Java 一時ディレクトリを設定します。

一括 API ターゲットセッションを監視PowerCenter 統合サービスで Salesforce 一括 API ターゲットセッションを監視できます。詳細なセッション統計を確認する場合や、セッションの成功ログまたはエラーログを生成する場合に、一括 API ターゲットセッションを監視対象として設定します。PowerCenter 統合サービスが一括 API ターゲットセッションを監視するとき、Salesforce サービスから各バッチのステータスを要求します。PowerCenter 統合サービスは、すべてのバッチが完了するまで、10 秒ごとに要求を繰り返し、Salesforce サービスからの応答をセッションログに書き込みます。要求に応じて、PowerCenter 統合サービスでは成功ログまたはエラーログも生成します。


デフォルトでは、PowerCenter 統合サービスは一括 API ターゲットセッションを監視しません。監視しない場合、セッションログには、バッチ作成に関する情報は含まれますが、バッチ処理に関する詳細または完全なセッション統計情報は含まれません。また、PowerCenter 統合サービスはセッションの成功ログまたはエラーログも生成しません。注: PowerCenter 統合サービスは、一括 API ターゲットセッションを監視するときに追加の API 呼び出しを実行します。PowerCenter 統合サービスが行う API 呼び出しの数を減らすには、セッションを監視しないでください。バッチ処理の詳細については、セッションログのバッチ ID を使用して Salesforce 統計情報にアクセスします。セッションを監視するように設定するには、［すべてのバッチが処理されるまで一括ジョブを監視］セッションプロパティを選択します。各バッチに対して正しくロードされているレコードの数を確認するには、［トレースのオーバーライド］セッションプロパティを［なし］以外の値に設定します。

一括 API ターゲットロードタイプSalesforce サービスは、一括 API ターゲットのパラレルロードまたはシリアルロードを実行できます。デフォルトでは、パラレルロードを実行します。パラレルロードでは、Salesforce サービスはセッションターゲットにバッチを同時に書き込みます。各バッチをできる限り迅速に処理します。シリアルロードでは、Salesforce サービスは受信した順にバッチをターゲットに書き込みます。各バッチのコンテンツ全体を次のバッチに進む前に処理します。ターゲットでのロード順序を気にしない場合は、パラレルロードを使用してパフォーマンスを向上させます。更新/挿入ロード時など、ターゲットでのロード順序を保持する場合は、シリアルロードを使用します。一括 API ターゲットセッションをシリアルロードするように設定するには、［並列実行を逐次実行でオーバーライド］セッションプロパティを選択します。

Bulk API ターゲット成功ファイルおよびエラーファイルPowerCenter 統合サービスが Salesforce Bulk API ターゲットセッションを監視するとき、Bulk API 成功ログおよびエラーログを生成できます。成功ログおよびエラーログは、Salesforce サービスが提供する行レベルの詳細を含む CSV ファイルです。Salesforce サービスが Bulk API ターゲットセッションのすべてのバッチ処理を完了すると、PowerCenter 統合サービスは成功情報およびエラー情報を要求します。PowerCenter 統合サービスは、この情報を使用して成功ログおよびエラーログを生成します。以下の表に、Bulk API ターゲットの成功ログファイルおよびエラーログファイルの場所と命名規則を示します。

ログタイプ場所命名規則Bulk API 成功ログ $PMTargetFileDir <セッション名>_<タイムスタンプ>_bulk_success.csvBulk API エラーログ $PMBadFileDir <セッション名>_<タイムスタンプ>_bulk_error.csv

成功ログを生成するには、［SFDC 成功ファイルの使用］セッションプロパティを選択します。エラーログを生成するには、［SFDC エラーファイルの使用］セッションプロパティを選択します。PowerCenter 統合サービスでログが生成されるようにするには、［すべてのバッチが処理されるまで一括ジョブを監視］セッションプロパティを選択して監視を有効にします。


セッションごとに、Bulk API の成功ログファイルおよびエラーログファイルにプレフィックスを追加できます。プレフィックスを設定した場合、PowerCenter 統合サービスは次のようにログファイル名にプレフィックスを追加します。

ログタイプ場所プレフィックスが付いた命名規則Bulk API 成功ログ $PMTargetFileDir <プレフィックス>_<セッション名>_<タイムスタンプ

>_bulk_success.csvBulk API エラーログ

$PMBadFileDir <プレフィックス>_<セッション名>_<タイムスタンプ>_bulk_error.csv

成功ログファイルまたはエラーログファイルにプレフィックスを追加するには、［成功およびエラーファイルにプレフィックスを設定］セッションプロパティを使用します。

一括 API 成功ログ一括 API 成功ログには、以下のカラムが含まれます。

カラム名説明JobId ジョブ ID。BatchId ターゲットバッチ ID。ID Salesforce ID。Success ターゲットに行が正常に書き込まれたことを示します。デフォルトは、一括 API 成功ログのす

べての行で True です。Created ターゲットで行が挿入されたか更新されたかを示します。

- True。行が挿入されました。- False。行が更新されました。

Error 行に関連付けられているエラーメッセージ。一括 API 成功ログにはエラーは表示されません。

これらのカラムに加え、一括 API 成功ログにはソース行全体が書き込まれます。エラーメッセージを参照して、ソース行のエラーを修正することができます。以下の表に、一括 API 成功ログの抜粋を示します。JobId BatchId ID Success Created Error ID Name750i00000013Q7SAAU

751i0000001Jzz7AAC

001T000000HsvMdIAJ

TRUE FALSE - 2340A1 CAM Water750i00000013Q7SAAU

751i0000001Jzz7AAC

001T000000HsvMeIAJ

TRUE TRUE - 2340A2 RDD Electric750i00000013Q7SAAU

751i0000001Jzz7AAC

001T000000HsvMfIAJ

TRUE FALSE - 2340A3 NXY Gas

一括 API 成功ログの詳細については、Salesforce のマニュアルを参照してください。


一括 API エラーログ一括 API エラーログには、以下のカラムが含まれます。

カラム名説明JobId ジョブ ID。BatchId ターゲットバッチ ID。ID Salesforce ID。このフィールドは読み込まれないこともあります。Success ターゲットに行が正常に書き込まれたことを示します。デフォルトは、一括 API エラーログの

すべての行で False です。Created エラー行には関係ありません。Error 行に関連付けられているエラーメッセージ。

これらのカラムに加え、一括 API エラーログにはソース行全体が書き込まれます。エラーメッセージを参照して、ソース行のエラーを修正することができます。以下の表に、一括 API エラーログの抜粋を示します。JobId BatchId ID Success Created Error ID Name750i00000013Q7SAAU

751i0000001Jzz7AAC

- FALSE FALSE MALFORMED_ID:アカウント ID:正しくないタイプの ID 値:ÃƒÂ¯Ã'Â»Ã'Â¿

Ã¯Â»Â¿ MDM Water

750i00000013Q7SAAU

751i0000001Jzz7AAC

- FALSE FALSE MALFORMED_ID:アカウント ID:正しくないタイプの ID 値:QHP1NÃ£

QHP1NÃ£ RAA Electric

一括 API エラーログの詳細については、Salesforce のマニュアルを参照してください。

一括 API ターゲットによる物理削除Salesforce 一括 API を使用する場合、Salesforce ターゲットから行を完全に削除するようにセッションを設定できます。一括 API を使用して Salesforce ターゲットからデータを削除する場合、デフォルトでは PowerCenter 統合サービスは、削除した行をリサイクルビンにコピーします。リサイクルビンを空にするまでは、削除した行を取得することができます。つまり、リサイクルビンを空にするまでは、削除された行によってハードディスクの容量が占有されています。行を完全に削除する場合は、物理削除を実行するように一括 API ターゲットセッションを設定できます。物理削除を行うと、PowerCenter 統合サービスはリサイクルビンを経由せずに行を完全に削除します。PowerCenter 統合サービスが物理削除オプションで削除したデータは復元できません。


セッションパフォーマンスを最㽩にする設定マッピングまたはセッションを編集することで、PowerExchange for Salesforce のパフォーマンスを向上させることができます。セッションのパフォーマンスを向上させるには、以下のオプションを設定します。• DTM バッファサイズ。 DTM バッファサイズの値を増減して、PowerCenter Integration Service が DTM

バッファメモリとして使用するメモリの量を指定できます。• 文字列フィールドの精度。文字列トランスフォーメーションのデータタイプにマッピングされているフィー

ルドの精度を変更します。これらのパラメータの詳細については、『PowerCenter パフォーマンスのチューニングの概褿』を参照してください。

DTM バッファサイズの調整DTM バッファサイズは、データをソースからターゲットに移動するときに PowerCenter Integration Serviceが使用するバッファブロックのサイズを決定します。ターゲット定義がバッファブロックを受信するときには、PowerCenter Integration Service がレコードを Salesforce サービスに送信するため 1 つ以上のバッチを作成します。例えば、［最大バッチサイズ］が 200 に設定され、バッファブロックに 200 件のレコードが含まれている場合、PowerCenter Integration Service は Salesforce ターゲットに、200 件のレコードを含む 1 つのバッチを送信します。バッファブロックに 500 件のレコードが含まれる場合、PowerCenter Integration Service は、それぞれ 200 件、200 件、100 件のレコードを含む、3 つのバッチを送信します。Salesforce ターゲットに書き込むセッションのパフォーマンスは、リレーショナルデータベースに書き込む同様のセッションよりも遅くなります。Salesforce サービスはリレーショナルデータベースの上で動作するからです。Salesforce ターゲットのセッションのパフォーマンスを最適化するには、バッファブロックに 200 の倍数のレコードが含まれるように［DTM バッファサイズ］セッションプロパティを調整します。

文字フィールドの精度の変更パフォーマンスを改善するために、ソースまたはターゲットのデータの予想サイズまで精度を下げることができます。例えば、Salesforce のソース定義では、String データタイプのフィールドの精度は 64 KB です。ただし、このフィールドには、最大サイズ 1 KB のデータが含まれます。ソース定義のフィールドの精度を 1 KB に下げて、PowerCenter Integration Service がそのフィールドで 1 KB 未満のデータを処理するようにできます。Salesforce のソース定義またはターゲット定義を編集して、PowerCenter 内の文字列トランスフォーメーションのデータタイプにマッピングされているフィールドの精度を変更します。 PowerCenter 内の文字列トランスフォーメーションのデータタイプにマッピングされていないフィールドの精度は変更しないでください。


付録 A

データタイプリファレンスこの付録では、以下の項目について説明します。• データタイプリファレンスの概要, 57 ページ• Salesforce データタイプとトランスフォーメーションデータタイプ, 57 ページ

データタイプリファレンスの概要PowerCenter Integration Service が Salesforce オブジェクトからデータを読み取る際は、各 Salesforce データタイプは互換性のある PowerCenter トランスフォーメーションデータタイプに変換されます。 PowerCenter Integration Service が Salesforce オブジェクトにデータをロードする際は、各 PowerCenterトランスフォーメーションデータタイプは互換性のある Salesforce データタイプに変換されます。PowerExchange for Salesforce は以下のデータタイプを使用します。• Salesforce データタイプ。Salesforce データタイプは、マッピング内の Salesforce 定義に表示されます。• トランスフォーメーションデータタイプ。トランスフォーメーションデータタイプは、トランスフォーメー

ションプロセス中に PowerCenter が使用する汎用データタイプです。 PowerCenter 内のトランスフォーメーションでこのデータタイプが表示されます。

Salesforce データタイプとトランスフォーメーションデータタイプPowerCenter Integration Service で、Salesforce ソースからデータが読み込まれる場合、データフィールド内のデータがアプリケーションソース修飾子で使用されるトランスフォーメーションデータタイプに変換されます。 Salesforce ターゲットにデータを書き込むとき、PowerCenter Integration Service は、ターゲットオブジェクト内のネイティブデータタイプに基づいてデータを変換します。

57

次の表に、Salesforce データタイプとトランスフォーメーションデータタイプの間の変換を示します。

Salesforce のデータ型

範囲と内容トランスフォーメーションのデータ型

範囲と内容

AnyType String、Picklist、Reference、Boolean、Currency、Integer、Double、Percent、ID、Date、Datetime、URL、Email データを返す、多形性データタイプ。

String 1～104,857,600 文字

Base64 Base64 エンコードの任意のバイナリデータ

String 1～104,857,600 文字

Boolean ブール（true/false）値。 Integer 精度 10、位取り 0Currency 通貨の値。 Decimal 精度 1～28 桁、位取り 0～28DataCategoryGroupReference

カテゴリグループの種類およびカテゴリの一意の名前。

String 1～104,857,600 文字

Date 日付の値。 Date/Time 西暦 0001 年 1 月 1 日～西暦 9999年 12 月 31 日

（精度はナノ秒まで）DateTime 日付と時刻の値。 Date/Time 西暦 0001 年 1 月 1 日～西暦 9999

年 12 月 31 日（精度はナノ秒まで）

Double 倍精度浮動小数点の値。 Decimal 精度 1～28 桁、位取り 0～28Email 電子メールアドレス String 1～104,857,600 文字Encrypted String 暗号化されたテキストフィー

ルドには、暗号化された形式で保存されている文字、数字、または記号の組み合わせが含まれます。

String 1～104,857,600 文字

Geolocation 緯度と経度によって場所を指定する複合フィールド。

Double 精度 1-28 桁、位取り 0-28。PowerCenter 統合サービスはGeolocation を、緯度、経度の 2つの Double 値に変換します。

ID Salesforce オブジェクトのプライマリキー。

String 1～104,857,600 文字

Int 整数値。 Integer 精度 10、位取り 0Multipicklist 複数選択の候補リスト。列挙

された値から複数の値を選択することが可能。

String 1～104,857,600 文字

Percent パーセント値。 Decimal 精度 1～28 桁、位取り 0～28

58 付録 A: データタイプリファレンス

Salesforce のデータ型

範囲と内容トランスフォーメーションのデータ型

範囲と内容

Picklist 単一選択の候補リスト。列挙された値から 1 つの値を選択することが可能。

String 1～104,857,600 文字

参照別の Salesforce に対する相互参照。

String 1～104,857,600 文字

String 文字列値。 String 1～104,857,600 文字Textarea 複数行テキストフィールドと

して表示される文字列。String 1～104,857,600 文字

Time 時間の値。 Date/Time 精度 1-28 桁、位取り 0-28。PowerCenter 統合サービスは、Salesforce の time データ型をDate/Time トランスフォーメーションデータ型に変換する際に現在の日付を追加します。PowerCenter 統合サービスは、Date/Time トランスフォーメーションデータ型を Salesforce の timeデータ型に変換する際に日付を切り詰めます。

Url url 値。 String 1～104,857,600 文字

注: Salesforce 定義をインポートした後、PowerCenter 内の文字列トランスフォーメーションデータタイプにマッピングされたフィールドの精度を変更することができます。必要なら、精度値を下げてパフォーマンスを向上させることもできます。PowerCenter 内の文字列トランスフォーメーションのデータタイプにマッピングされていないフィールドの精度は変更しないでください。

Salesforce データタイプとトランスフォーメーションデータタイプ 59

付録 B

用語集Salesforce Sandbox特別のテストまたは開発 Salesforce 環境です。Salesforce オブジェクトAccount、Asset、Case Solution、Lead などの、Salesforce のサブジェクトエリアです。 Salesforce オブジェクトは通常、Salesforce ユーザーインタフェースのタブに対応します。例えば、Salesforce の［アカウント］タブにアカウントを追加できます。標準およびカスタムの Salesforce オブジェクトを PowerCenter にトランスフォーメーション、ソース定義、およびターゲット定義としてインポートします。Sforce Object Query Language（SOQL）Salesforce クエリコールでクエリの構築に使用される専用 Salesforce 言語です。実行時に、PowerCenter Integration Service がマッピングに含まれるオブジェクトとフィールドに基づいて SOQL クエリを生成します。プライマリ Salesforce オブジェクトPowerCenter でソース定義、ターゲット定義、またはをトランスフォーメーションを作成するためにインポートする Salesforce のプライマリオブジェクト。変更データキャプチャ（CDC）PowerExchange for Salesforce が変更データを処理できるようにするオプションです。 CreatedDate フィールドと LastModifiedDate フィールドを持つ複製可能オブジェクトの変更データをキャプチャできます。外部 IDSalesforce の外部のシステムによって生成されるレコード ID です。Salesforce オブジェクトが外部 ID フィールドを持つよう設定されている場合、PowerCenter Integration Service は、外部 ID フィールドを使用してオブジェクトのレコードを識別します。 Salesforce では、カスタムフィールドが外部 ID フィールドかどうかをユーザーが指定します。更新/挿入データを Salesforce ターゲットにロードするときに、外部 ID フィールドとして指定されたカスタムフィールドを使用して、新しいレコードを作成するか、既存のレコードを更新するかを判断する Salesforce オペレーションです。Salesforce ターゲットオブジェクトに外部 ID フィールドとして指定されたカスタムフィールドが含まれる場合にのみ、レコードを更新/挿入するようにセッションを設定できます。

複製可能オブジェクト別の環境に複製できる Salesforce オブジェクトです。すべての Salesforce オブジェクトに、オブジェクトが別の環境で複製できるかどうかを決定する複製可能フラグがあります。PowerExchange for Salesforce は、このフラグを使用して Salesforce オブジェクトを複製できるかどうかを判断します。関連する Salesforce オブジェクトプライマリ Salesforce オブジェクトに関連する Salesforce オブジェクトです。プライマリ Salesforce オブジェクトに基づいて Salesforce 定義をインポートする場合、関連オブジェクトのフィールドもインポートできます。Designer では、Salesforce で定義されたリレーションに基づいて関連オブジェクトを特定します。

用語集 61

索引

BBulk API

ターゲットの成功ログおよびエラーログ 53Bulk API ターゲットセッション

Salesforce のための設定 47Bulk API の物理削除の有効化

Salesforce のための設定 47

CCDC に SystemModstamp を使用

Salesforce のための設定 42CDC フラッシュの間隔オフセット

Salesforce の説明 45CDC 開始タイムスタンプ

Salesforce のための設定 42CDC 時間制限

Salesforce のための設定 42Salesforce の説明 44

CDC 終了タイムスタンプ Salesforce のための設定 42

DDesigner

Salesforce との統合 10DTM バッファサイズ

Salesforce セッションのチューニング 56Salesforce のための設定 50

HHTTP プロキシオプション

PowerCenter Integration Service（Salesforce）用の設定 16PowerCenter クライアント（Salesforce）のための設定 15構成 15

IID

外部および Salesforce 20idLookup

Salesforce の説明 49外部 ID のオーバーライド 52

Idlookup フィールドを使用して更新/挿入する Salesforce のための設定 47

JJava

一括 API ターゲットセッションの要件 14Java ヒープサイズ 14

LLastModifiedDate

Salesforce の説明 46LKP_FILTER ポート

Salesforce の説明 27LKP_MATCHIDX ポート

Salesforce の説明 28

NNULL

更新/挿入および更新での処理 50

P$Paramstart

マッピング変数 42$Paramend

マッピング変数 42パフｫーマンス

Salesforce でのバッファブロックサイズの設定 50Salesforce の DTM バッファサイズの設定 56

PickList_Input ポート Salesforce PickList トランスフォーメーション内 36

Picklist トランスフォーメーション関連する Salesforce オブジェクトからのフィールドのインポート 18, 19

pmsfdc.ini PowerExchange for Salesforce 構成ファイル 15

pmsfdc.xml Salesforce プラグイン 12

PowerCenter Salesforce との統合 9

PowerCenter 統合サービス Salesforce との統合 10

PowerExchange for Salesforce 概要 9サポートされている Salesforce のバージョン 13デフォルトの Salesforce API のバージョン 13

QQueryAll を使用


62

SSalesforce

データ型 57Salesforce API のバージョン

アプリケーション接続内の Salesforce サービスの URL 13Salesforce PickList トランスフォーメーション

PickList_Input ポート 36ガイドライン 37概要 35コンポーネント 36出力ポート 36パススルーポート 36ポートタイプ 36作成 37

Salesforce Sandbox アクセス 22

Salesforce オブジェクト権限 9説明 9属性 21

Salesforce セッション時間枠変更データキャプチャ 45セッション詳細のロギング 51連続変更データキャプチャ 44

Salesforce ターゲット一括 API による物理削除 55

Salesforce のターゲットタイムゾーン要件 21

Salesforce 統合トランスフォーメーションガイドライン 33概要 30コンポーネント 31デフォルトポート 32ポートタイプ 32作成 33

Salesforce のソースタイムゾーン処理 20

Salesforce のソース定義作成 20

Salesforce のための設定一括 API ソースセッション 46一括 API ターゲットセッション 52

Salesforce の定義概要 18

Salesforce ルックアップトランスフォーメーション一致、識別 28コンポーネント 25デフォルトポート 26パススルーポート 27ポートタイプ 26ルックアップトランスフォーメーションとの比較 24ルックアップフィルタ 27ルックアップポート 26概要 24作成 29

SFDC Bulk API の使用 Salesforce ターゲットの設定 47

SFDC エラーファイルの使用 Salesforce のための設定 47

SFDC 成功ファイルディレクトリ Salesforce のための設定 47

SFDC 成功ファイルの使用 Salesforce のための設定 47

Sforce Object Query Language（SOQL）説明 10

SOQL オーバーライド設定 43

SOQL オーバーライド (続く)説明 43

SOQL フィルタ条件 Salesforce のための設定 43

SystemModstamp 説明 46

あアプリケーション接続

Salesforce 39Salesforce API のバージョン 13Salesforce でのエンドポイント URL 39Salesforce の説明 10Salesforce のための設定 40

暗号化 HTTP プロキシパスワード 16

い一括 API

Java 一時ディレクトリの要件 14Salesforce ターゲットからの物理削除 55エラーログ 55成功ログ 54

一括 API ソースセッション Salesforce のための設定 46

えエラーファイルにプレフィックスを設定

Salesforce のための設定 47エラーログ

Salesforce Bulk API ターゲットセッション 53Salesforce 一括 API 55

おオブジェクトタイプ

Salesforce の標準とカスタム 10

か外部 ID

idLookup でのオーバーライド 52Salesforce の説明 20説明 49

外部 ID 属性 Salesforce の説明 21

カスタムオブジェクト Salesforce の説明 10

カスタムフィールド Salesforce の外部 ID 属性 18

モニタリング Salesforce 一括 API ターゲットセッション 52

関連オブジェクト: Salesforce からのフィールドのインポート 19

関連オブジェクト Salesforce からのインポート 18

関連付けを解除更新/挿入でカスタム子オブジェクト 50

索引 63

け権限

Salesforce データ上 9検証

SOQL 構文 10

こ更新可能な属性

Salesforce の説明 21更新/挿入

idLookup での外部 ID のオーバーライド 52Salesforce idLookup フィールド 49Salesforce セッション設定 49Salesforce の説明 49Salesforce のための設定 49外部 ID 49カスタム子オブジェクトの関連付けを解除 50

コードページ Salesforce での検査 11Salesforce のサポートされるコードページ 11

この外部 ID/IdLookup フィールドを使用して更新する Salesforce のための設定 47

さ作成可能な属性

Salesforce の説明 21

し出力ポート

Salesforce PickList トランスフォーメーション内 36

すすべてのバッチが処理されるまで一括ジョブを監視


せ成功ログ

Salesforce Bulk API ターゲットセッション 53Salesforce 一括 API 54

精度 Salesforce フィールドに対する変更 56

セッション Salesforce での DTM バッファサイズのチューニング 56Salesforce での結合のチューニング 19概要 39

セッション詳細 Salesforce セッション用 51

セッションのプロパティ Salesforce 47Salesforce での［CDC に SystemModstamp を使用］ 42Salesforce での［QueryAll を使用］ 42Salesforce での CDC 開始タイムスタンプ 42Salesforce での CDC 時間制限 42Salesforce での CDC 終了タイムスタンプ 42Salesforce での SOQL フィルタ条件 42Salesforce でのフラッシュ間隔 42

セッション条件 Salesforce での DTM バッファサイズ 50Salesforce での行制限 42

接続オブジェクト Salesforce の説明 10

そソース定義

Salesforce からのインポート 22Salesforce の概要 18

ソース Salesforce データ、フィルタリング 43関連する Salesforce オブジェクトからのフィールドのインポート 18, 19

たターゲット操作

PowerExchange for Salesforce 20ターゲット定義

Salesforce からのインポート 22Salesforce の概要 18

タイムスタンプ Salesforce での変更データキャプチャの設定 46

タイムゾーン処理 Salesforce ソース用 20

タイムゾーン要件 Salesforce ターゲット用 21

ターゲット関連する Salesforce オブジェクトからのフィールドのインポート 18, 19

ターゲットロード Salesforce 一括 API ターゲットセッション 53

てデータ型

Salesforce 57データタイプ

Salesforce のための変換 20, 57データアクセス制御

Salesforce の説明 9データ移動モード

Salesforce での ASCII 11Salesforce での Unicode 11

と統合トランスフォーメーション

関連する Salesforce オブジェクトからのフィールドのインポート 18, 19

トランスフォーメーション Salesforce PickList 35Salesforce 統合 30Salesforce ルックアップ 24

に認証

Salesforce でのユーザー認証 10, 39

64 索引

はパススルーポート

Salesforce PickList トランスフォーメーション内 36Salesforce ルックアップトランスフォーメーション内 27

派生オブジェクト Salesforce の説明 18

バッチサイズ Salesforce の説明 50

ふフィールドを NULL に設定

Salesforce のための設定 47セッションプロパティ 50

フィールド切り詰め属性の有効化 Salesforce のための設定 47

フィルタ、Salesforce ソース用 43フィルタ条件

Salesforce データ 43Salesforce ルックアップ上 27

フィールドの属性 Salesforce の説明 21

プライマリ Salesforce オブジェクト説明 18

プラグイン PowerExchange for Salesforce 用の登録 12

フラッシュ間隔 Salesforce のための設定 42Salesforce の説明 44

プロキシパスワード暗号化 16

ほポート

Salesforce PickList トランスフォーメーションのタイプ 36Salesforce 統合トランスフォーメーション内のタイプ 32Salesforce ルックアップトランスフォーメーション内のタイプ 26

まマッピング変数

Salesforce セッションでの CDC 用 42

め命名規則

関連する Salesforce オブジェクト用 18

りリレーション

Salesforce からの関連オブジェクトフィールドのインポート 18

るルール

Salesforce ターゲットのアップデートストラテジの設定 22Salesforce の時間枠内変更データキャプチャ用 46Salesforce の連続変更データキャプチャ用 44関連 Salesforce オブジェクトからのフィールドのインポート用 19

ルックアップクエリ Salesforce 一致 28Salesforce の説明 28

ルックアップトランスフォーメーション関連する Salesforce オブジェクトからのフィールドのインポート 18, 19

ルックアップポート Salesforce ルックアップトランスフォーメーション内 26

れ連続ワークフロー

および Salesforce での変更データキャプチャ 44

索引 65

Documents

イド PowerCenter ユーザーガ...イド PowerCenter ユーザーガ ... 12