Informatica Cloud - Summer 2016

Informatica Cloud
(バージョン Summer 2016)
Salesforce コネクタガイ
ド
Informatica Cloud Salesforce コネクタガイド
バージョン Summer 2016
2016 年 6 月
著作権 1993-2016 Informatica LLC. すべての権利を保留する.
本ソフトウェアおよびマニュアルには、Informatica LLC の所有権下にある情報が収められています。これらは使用および開示の制限等を定めた使用許諾契約のもとに
提供され、著作権法により保護されています。当該ソフトウェアのリバースエンジニアリングは禁じられています。本マニュアルのいかなる部分も、いかなる手段（電
子的複写、写真複写、録音など）によっても、Informatica LLC の事前の承諾なしに複製または転載することは禁じられています。このソフトウェアは、米国および/
または国際的な特許、およびその他の出願中の特許によって保護されています。
合衆国政府によるソフトウェアの使用、複製または開示は、DFARS 227.7202-1（a）および 227.7702-3（a）（1995 年）、DFARS 252.227-7013(C)（1）（ii）（1988 年 10
月）、FAR 12.212（a）（1995 年）、FAR 52.227-19、または FAR 52.227-14（ALT III）に記載されているとおりに、当該ソフトウェア使用許諾契約に定められた制限に
よって規制されます。
本製品または本書の情報は、予告なしに変更されることがあります。お客様が本製品または本書内に問題を発見された場合は、書面にて当社までお知らせください。
Informatica、Informatica Platform、Informatica Data Services、PowerCenter、PowerCenterRT、PowerCenter Connect、PowerCenter Data Analyzer、
PowerExchange、PowerMart、Metadata Manager、Informatica Data Quality、Informatica Data Explorer、Informatica B2B Data Transformation、Informatica B2B
Data Exchange、Informatica On Demand、Informatica Identity Resolution、Informatica Application Information Lifecycle Management、Informatica Complex
Event Processing、Ultra Messaging、Informatica Master Data Management、および Live Data Map は、Informatica LLC の米国および世界中の管轄地での商標また
は登録商標です。その他のすべての企業名および製品名は、それぞれの企業の商標または登録商標です。
本ソフトウェアまたはドキュメントの一部は、次のサードパーティが有する著作権に従います（ただし、これらに限定されません）。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 The JBoss Group, LLC, コンテンツの無断複写・転載
を禁じます、ソフトウェア copyright, Red Hat Middleware, LLC, コンテンツの無断複写・転載を禁じます、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.コンテンツの無断複写・転載を禁じま
す）が含まれています。また、このソフトウェアの再配布は、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-3Clause）、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 ドライバの使用に関するいかなる直接的、間接的、偶発的、特別、あるいは結果的損害に対し
て責任を負わないものとします。本制限事項は、すべての訴訟原因に適用されます。訴訟原因には、契約違反、保証違反、過失、厳格責任、詐称、その他の不
法行為を含みますが、これらに限るものではありません。
Part Number: IC-SFCG-25000-0001
目次
序文............................................................ 7
Informatica のリソース. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Informatica Network. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
Informatica ナレッジベース. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Informatica マニュアル. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Informatica 製品可用性マトリックス. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Informatica Velocity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Informatica Marketplace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8
Informatica グローバルカスタマサポート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
第 1 章 : Salesforce コネクタの概要............................. 9
Salesforce コネクタの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9
Salesforce コネクタのタスクタイプおよびオブジェクトタイプ. . . . . . . . . . . . . . . . . . . . . . . . 10
Salesforce コネクタの例. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
第 2 章 : Salesforce コネクタの管理............................ 11
Salesforce のファイアウォール設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Salesforce のライセンスタイプ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Hosted Agent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Secure Agent のプロパティ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
ユーザープロパティ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
第 3 章 : Salesforce 接続...................................... 13
Salesforce 接続の概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
セキュリティトークンと信頼済み IP 範囲. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Salesforce 接続のプロパティ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
14
第 4 章 : Salesforce でのデータ同期タスク...................... 15
データ同期タスクの前提条件. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
データ同期タスクの Salesforce ソース. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
アーカイブ済みおよび削除済み Salesforce データをタスクに含める. . . . . . . . . . . . . . . . .
16
Salesforce ソースのルールとガイドライン. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
データ同期タスクの Salesforce ターゲット. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
16
Salesforce ターゲットのルールとガイドライン. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
更新/挿入タスク操作. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Salesforce データ同期タスクのフィールドマッピング. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
18
データ同期タスクの詳細オプション. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
18
Salesforce 標準 API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
19
Salesforce Bulk API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
関連オブジェクトに対する NULL 更新. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
4
目次
第 5 章 : Salesforce でのマッピングとマッピング設定タスク..... 23
Salesforce でのマッピングとマッピング設定タスクの概要. . . . . . . . . . . . . . . . . . . . . . . . . .
23
マッピングの Salesforce オブジェクト. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
マッピングの Salesforce ソース. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23
マッピングの Salesforce ターゲット. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
マッピングの Salesforce ルックアップオブジェクト. . . . . . . . . . . . . . . . . . . . . . . . . . .
26
マッピング設定タスクの Salesforce オブジェクト. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
マッピング設定タスクの Salesforce ソース. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
26
マッピング設定タスクの Salesforce ターゲット. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28
マッピング設定タスクの Salesforce ルックアップオブジェクト. . . . . . . . . . . . . . . . . . . .
30
第 6 章 : Salesforce でのデータレプリケーションタスク.........
31
データレプリケーションの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31
データレプリケーションソースのプロパティ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
データレプリケーションターゲットのプロパティ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
ロードタイプ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
完全なロード. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
増分ロード. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33
Salesforce ソースのレプリケート. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34
データベースターゲットのリセット. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
35
ソースとターゲットの不一致の処理. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
35
AutoAlterColumnType プロパティの設定. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
データレプリケーションのソースとターゲットのルールおよびガイドライン. . . . . . . . . . . .
36
データレプリケーションタスク. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
37
データレプリケーションタスクの設定のルールおよびガイドライン. . . . . . . . . . . . . . . . . .
37
高精度計算. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
37
Salesforce Base64 エンコードボディサイズ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Salesforce API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
38
第 7 章 : Salesforce でのデータマスキングタスク................ 39
Salesforce でのデータマスキングタスクの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
リレーション調整ストラテジ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
外部 ID フィールド. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
40
カスタムフィールドルックアップ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
一意のフィールドルックアップ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
40
連結オブジェクト. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
ターゲットの所有者名. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Salesforce Bulk API の制限事項. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
データマスキングでの Salesforce の制限. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
標準オブジェクトの特殊処理. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
詳細 Salesforce オプション. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
目次
44
5
第 8 章 : 共通設定............................................. 46
共通設定の概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
46
関連する Salesforce オブジェクトの ID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
オブジェクト検索および選択. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
ビジネス名の表示. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
データフィルタ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
48
データフィルタのルールおよびガイドライン. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Salesforce 送信メッセージによるタスクの開始. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
第 9 章 : トラブルシューティング............................... 50
トラブルシューティングの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
50
Salesforce 接続のトラブルシューティング. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Salesforce データ同期タスクのトラブルシューティング. . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
データ評価タスクのトラブルシューティング. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
データレプリケーションタスクのトラブルシューティング. . . . . . . . . . . . . . . . . . . . . . . . . . . 52
付録 A : データ型リファレンス.................................. 53
データ型リファレンスの概要. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Salesforce のデータ型とトランスフォーメーションのデータ型. . . . . . . . . . . . . . . . . . . . . . . . 54
索引........................................................... 56
6
目次
序文
『Informatica Cloud Salesforce コネクタガイド』では、Salesforce コネクタの設定方法と使用方法について
説明します。このガイドでは、ビジネスユーザーが Salesforce コネクタを使用して、データを Salesforce か
ら読み取ったり、データを Salesforce に書き込んだりする方法について説明します。
Informatica のリソース
Informatica Network
Informatica Network は、 Informatica グローバルカスタマサポート、Informatica ナレッジベースなどの製
品リソースをホストします。Informatica Network には、https://network.informatica.com からアクセスし
てください。
メンバーは以下の操作を行うことができます。
•
1 つの場所からすべての Informatica のリソースにアクセスできます。
•
ドキュメント、FAQ、ベストプラクティスなどの製品リソースをナレッジベースで検索できます。
•
製品の提供情報を表示できます。
•
自分のサポート事例を確認できます。
•
最寄りの Informatica ユーザーグループネットワークを検索して、他のユーザーと共同作業を行えます。
Informatica ナレッジベース
ドキュメント、ハウツー記事、ベストプラクティス、PAM などの製品リソースを Informatica Network で検索
するには、Informatica ナレッジベースを使用します。
ナレッジベースには、https://kb.informatica.com からアクセスしてください。ナレッジベースに関する質
問、コメント、ご意見の連絡先は、Informatica ナレッジベースチーム（[email protected]）で
す。
Informatica マニュアル
使用している製品の最新のドキュメントを取得するには、
https://kb.informatica.com/_layouts/ProductDocumentation/Page/ProductDocumentSearch.aspx にある
Informatica ナレッジベースを参照してください。
このマニュアルに関する質問、コメント、ご意見の電子メールの送付先は、Informatica マニュアルチーム
（[email protected]）です。
7
Informatica 製品可用性マトリックス
製品可用性マトリックス（PAM）には、製品リリースでサポートされるオペレーティングシステム、データベー
スなどのデータソースおよびターゲットが示されています。Informatica Network メンバである場合は、PAM
（https://network.informatica.com/community/informatica-network/product-availability-matrices）に
アクセスできます。
Informatica Velocity
Informatica Velocity は、Informatica プロフェッショナルサービスによって開発されたヒントおよびベスト
プラクティスのコレクションです。数多くのデータ管理プロジェクトの経験から開発された Informatica
Velocity には、世界中の組織と協力して優れたデータ管理ソリューションの計画、開発、展開、および維持を
行ってきた弊社コンサルタントの知識が集約されています。
Informatica Network メンバである場合は、Informatica Velocity リソース
（http://velocity.informatica.com）にアクセスできます。
Informatica Velocity についての質問、コメント、またはアイデアがある場合は、[email protected] から
Informatica プロフェッショナルサービスにお問い合わせください。
Informatica Marketplace
Informatica Marketplace は、お使いの Informatica 製品を強化したり拡張したりするソリューションを検索
できるフォーラムです。Informatica の開発者およびパートナーの何百ものソリューションを利用して、プロ
ジェクトで実装にかかる時間を短縮したり、生産性を向上させたりできます。Informatica Marketplace には、
https://marketplace.informatica.com からアクセスできます。
Informatica グローバルカスタマサポート
Informatica Network の電話またはオンラインサポートからグローバルカスタマサポートに連絡できます。
各地域の Informatica グローバルカスタマサポートの電話番号は、Informatica Web サイト
（http://www.informatica.com/us/services-and-training/support-services/global-support-centers）を
参照してください。
Informatica Network メンバである場合は、オンラインサポート（http://network.informatica.com）を使用
できます。
8
序文
第 1 章
Salesforce コネクタの概要
この章では、以下の項目について説明します。
•
Salesforce コネクタの概要, 9 ページ
•
Salesforce コネクタのタスクタイプおよびオブジェクトタイプ, 10 ページ
•
Salesforce コネクタの例, 10 ページ
Salesforce コネクタの概要
Salesforce コネクタを使用すると、データを Salesforce から安全に読み取ったり、Salesforce に安全に書き
込んだりすることができます。
Salesforce は、販売チームが連絡先および販売活動を管理するためのクラウドベースの顧客関係管理（CRM）
ソリューションです。Salesforce を使用すると、組織の販売活動の連絡先およびデータを保存および管理でき
ます。
Salesforce 接続は任意の Informatica Cloud タスクで使用できます。任意のタイプの Salesforce アカウン
トに対する接続を作成できます。次の Salesforce エディションに対する接続を作成できます。
•
Professional Edition
•
Enterprise Edition
•
Unlimited Edition
Salesforce のソースとターゲットは、Salesforce オブジェクトモデルのオブジェクトを表します。
Salesforce オブジェクトとは、Salesforce Web サイトのタブやその他のユーザーインタフェース要素に対応
するテーブルです。例えば、取引先オブジェクトには、Salesforce の［取引先］タブのフィールドに表示され
る情報が含まれます。
9
Salesforce コネクタのタスクタイプおよびオブジェ
クトタイプ
あるタスクを実行するために Salesforce 接続を作成する場合、そのタスクに対して Salesforce コネクタでサ
ポートされているオブジェクトを選択できます。
次の表に、Salesforce コネクタによってサポートされているタスクタイプおよびオブジェクトタイプの一覧を
示します。
タスクタイプ
ソース
ターゲット
ルックアップ
データ同期
○
○
○
マッピング設定
○
○
○
PowerCenter
○
○
○
データレプリケーション
○
○
×
連絡先検証
○
×
×
データアセスメント
○
×
×
データマスキング
○
○
○
DNB 360
×
×
×
Salesforce コネクタの例
組織では、リアルタイムの営業案件情報を Salesforce システムから外部システムへと移行する必要が生じる場
合があります。Salesforce コネクタを使用すると、Salesforce システムからデータを抽出し、ターゲットシ
ステムに書き込むことができます。経営管理チームは、外部システムを使用してデータを調整および分析した
り、レポートを生成したり、意思決定を行ったりできます。
Salesforce コネクタは、組織内のアプリケーションの取引先、連絡先、価格、製品など、ビジネスの重要なデ
ータをその他の重要なアプリケーションやデータベースと迅速に同期するのに役立ちます。販売、マーケティ
ング、その他のチームは Salesforce からデータを他の任意のデータベースまたは外部システムに移動して、意
思決定を支援するためのレポートを生成できます。
10
第 1 章: Salesforce コネクタの概要
第 2 章
Salesforce コネクタの管理
この章では、以下の項目について説明します。
•
Salesforce のファイアウォール設定, 11 ページ
•
Salesforce のライセンスタイプ, 11 ページ
•
Hosted Agent, 12 ページ
•
Secure Agent のプロパティ, 12 ページ
•
ユーザープロパティ, 12 ページ
Salesforce のファイアウォール設定
組織でデータがファイアウォールを通過する場合は、Salesforce へのアクセスを許可するようにファイアウォ
ールを設定する必要があります。
Salesforce サーバーに接続できない場合、Salesforce タスクの実行時に接続エラーが発生することがありま
す。接続エラーが発生したら、Salesforce サーバーへのアクセスを許可するようにネットワーク管理者に依頼
します。
詳細については、Informatica Cloud コミュニティの記事"Firewall Rule for Informatica Cloud"を参照し
てください。
注: Salesforce サーバーの IP アドレスは変更されることがあります。 Salesforce のサーバーの IP アドレス
に関する最新情報については、Salesforce のマニュアルを参照してください。
Salesforce のライセンスタイプ
ライセンスにより、組織に対する Informatica Cloud サブスクリプションレベルが決定され、Informatica
Cloud の統合タスク、機能、コネクタ、およびバンドルにアクセスできるようになります。Salesforce の接続
には、機能ライセンスが必要です。
管理者は、企業に設定された機能ライセンスタイプの見直し、ジョブアクティビティを監視して、使用状況が
機能ライセンスサブスクリプションに沿ったものかどうかの確認、機能ライセンスの有効期限の管理などを行
います。
11
Hosted Agent
Informatica Cloud Hosted Agent は、Informatica Cloud ホスティング機能でホストされるランタイム環境で
す。Cloud Runtime ライセンスを保有している場合は、Hosted Agent を使用してタスクを実行できます。
Informatica Cloud ホスティング機能により、Hosted Agent ランタイム環境とその環境で実行されるエージェ
ントを管理します。 Hosted Agent ランタイム環境を追加、削除、または設定することはできません。
Hosted Agent は、Salesforce コネクタを使用するデータ同期タスクとマッピング設定タスクを実行できます。
Secure Agent のプロパティ
Salesforce 固有の次のタイプの Secure Agent 設定のプロパティを設定できます。
プロパティ
タイ
プ
説明
SalesForceConnectionTimeo
ut
DTM
Salesforce Web サービスで、タイムアウトするまで
に待機を要求する秒数。
AutoAlterColumnType
カスタ
ム
データレプリケーションタスクの場合は、
AutoAlterColumnType カスタム構成プロパティを設定
して、Salesforce ソースフィールドのデータ型、精
度、またはスケールが変更されたときに、データベー
スターゲットのカラムが調整されるようにします。
このプロパティは、データレプリケーションタスクを
実行する Secure Agent の場合に設定します。次の値
を入力します。
-［タイプ］では、［Tomcat］を選択します。
-［サブタイプ］では、［INFO］を選択します。
-［名前］には、「AutoAlterColumnType」と入力します。
-［値］には、「yes」と入力してこのプロパティをオンに
します。
ユーザープロパティ
Salesforce 固有の次のタイプのユーザープロパティを設定できます。
12
プロパティ
説明
Salesforce ユーザー名
Salesforce のユーザー名。
Salesforce ユーザー名の確認
Salesforce ユーザー名の確認。
第 2 章: Salesforce コネクタの管理
第 3 章
Salesforce 接続
この章では、以下の項目について説明します。
•
Salesforce 接続の概要, 13 ページ
•
セキュリティトークンと信頼済み IP 範囲, 13 ページ
•
Salesforce 接続のプロパティ, 14 ページ
Salesforce 接続の概要
Salesforce 接続を使用して、Salesforce アプリケーションのオブジェクトにアクセスします。
Salesforce 接続は、連絡先検証タスク、データアセスメントタスク、データマスキングタスク、データレプリ
ケーションタスク、データ同期タスク、PowerCenter タスク、およびマッピング設定タスクで使用できます。
接続を作成して Salesforce メタデータをインポートし、データオブジェクトを作成、データをプレビュー、お
よびマッピングタスクを実行します。Salesforce 接続を作成する際には、Salesforce アカウントのユーザー
名、パスワード、およびセキュリティトークンを指定します。Salesforce セキュリティトークンをパスワード
の末尾に追加して、Salesforce アカウントに接続することもできます。
デフォルトでは、既存の組織の Salesforce 接続で Salesforce API のバージョン 31 が使用され、新しい組織
の Salesforce 接続で Salesforce API のバージョン 34 が使用されます。既存の Salesforce 接続を編集するか
新しい接続を作成して、Salesforce API のバージョン 36、バージョン 35、バージョン 34、バージョン 33、ま
たはバージョン 31 を使用することができます。Salesforce コネクタでは、Salesforce API のバージョン 36
およびバージョン 35 用に SFDC Wealth Management オブジェクトがサポートされています。
セキュリティトークンと信頼済み IP 範囲
大半の Salesforce アカウントでは、アカウントにアクセスするためにセキュリティトークンが必要です。
Salesforce 接続を作成する際にセキュリティトークンを入力できます。自分のアカウントにセキュリティト
ークンが必要だが所有していない場合は、セキュリティトークンを生成またはリセットできます。Salesforce
Web サイトにログインして、［設定］ > ［私の個人情報］ > ［私のセキュリティトークンのリセット］をクリ
ックします。
13
Salesforce 接続にセキュリティトークンを追加せずに済むようにするには、自分の Salesforce アカウントの
［信頼済み IP 範囲］に Informatica Cloud の IP アドレスを追加します。 Salesforce Web サイトで、
［Setup］ > ［Security Controls］ > ［Network Access］をクリックして、次の IP アドレスを追加します。
•
Informatica Cloud. Informatica Cloud Secure Agent IP アドレス範囲。
Secure Agent で使用する IP アドレス範囲については、Informatica Cloud コミュニティの記
事"Secure Agent IP Address Ranges"を参照してください。
•
Secure Agent マシン: Secure Agent を実行しているすべてのマシンの個々の IP アドレスまたは範囲を追
加します。
詳細については、Salesforce のマニュアルを参照してください。
Salesforce 接続のプロパティ
以下の表に、接続のプロパティを示します。
接続プロパティ
説明
ユーザー名
Salesforce アカウントのユーザー名。
パスワード
Salesforce アカウントのパスワード。
セキュリティトー
クン
Salesforce アプリケーションから生成されたセキュリティトークンです。
サービス URL
Salesforce サービスの URL。最大長は 100 文字です。
次のバージョンの Salesforce API を使用できます。
- バージョン 31。Salesforce 接続は、デフォルトで次のサービス URL を使用
します: https://login.salesforce.com/services/Soap/u/31.0
- バージョン 33。接続にバージョン 33 の Salesforce API を使用するには、
次のサービス URL を入力します: https://login.salesforce.com/
services/Soap/u/33.0
- バージョン 34。接続にバージョン 34 の Salesforce API を使用するには、
次のサービス URL を入力します: https://login.salesforce.com/
services/Soap/u/34.0
- バージョン 35。接続にバージョン 35 の Salesforce API を使用するには、
次のサービス URL を入力します: https://login.salesforce.com/
services/Soap/u/35.0
- バージョン 36。接続にバージョン 36 の Salesforce API を使用するには、
次のサービス URL を入力します: https://login.salesforce.com/
services/Soap/u/36.0
Secure Agent に対
して定義されたプ
ロキシサーバー設
定をバイパス
14
第 3 章: Salesforce 接続
Secure Agent の Secure Agent Manager で定義されているプロキシサーバ
ー設定をバイパスします。プロキシサーバー設定をバイパスするときは、
Salesforce への直接接続を使用します。
第 4 章
Salesforce でのデータ同期タスク
この章では、以下の項目について説明します。
•
データ同期タスクの前提条件, 15 ページ
•
データ同期タスクの Salesforce ソース, 15 ページ
•
データ同期タスクの Salesforce ターゲット, 16 ページ
•
更新/挿入タスク操作, 17 ページ
•
Salesforce データ同期タスクのフィールドマッピング, 18 ページ
•
データ同期タスクの詳細オプション, 18 ページ
•
関連オブジェクトに対する NULL 更新, 22 ページ
データ同期タスクの前提条件
データ同期タスクを作成する際には、事前に次の前提条件タスクを実行します。
1.
ターゲットデータベースを作成します。
Salesforce データをデータベースターゲットに書き込むには、データベース管理者は、Salesforce オブ
ジェクトのデータを格納するためのデータベーステーブルを各オブジェクトについて作成する必要があり
ます。
2.
データベースユーザーを作成します。
Salesforce データをデータベースターゲットに書き込むには、データベース管理者がターゲットデータベ
ースにデータベースユーザーアカウントを作成する必要があります。各データベースユーザーアカウント
には、DELETE、INSERT、UPSERT、UPDATE の各権限が必要です。
データ同期タスクの Salesforce ソース
データ同期タスクでは、単一のオブジェクト、複数の関連オブジェクト、または保存済みクエリを使用できま
す。
Salesforce ソースのプロパティは、データ同期タスクウィザードの［ソース］ページで設定します。
15
次の表に、Salesforce ソースのプロパティを示します。
プロパティ
説明
接続
ソース接続の名前。
ソースタイプ
ソースオブジェクトのタイプ［シングル］、［複数］、または
［保存済みクエリ］を選択します。
ソースオブジェクト
ソースオブジェクトの名前。
ラベルの代わりに技術名を表
示
ビジネス名の代わりに技術名を表示します。
ソースフィールドをアルファ
ベット順に表示
ソースフィールドを、ソースシステムによって返される順序で
はなく、アルファベット順に表示します。
ソースのアーカイブ済みの行
と削除済みの行を含める
ソースのアーカイブ済みの行と削除済みの行を含めます。デフ
ォルトでは、エージェントはアクティブな行を返します。
Salesforce で明示的なリレーションが定義されている複数のオブジェクトを追加できます。例えば、商談オブ
ジェクトをソースとして使用する場合は、関連する取引先オブジェクトも追加できます。マスタレコードオブ
ジェクトも追加できます。マスタレコードオブジェクトは取引先オブジェクトに関連しているためです。
アーカイブ済みおよび削除済み Salesforce データをタスクに含め
る
Salesforce 標準 API を使用してタスク内の Salesforce ソースを操作する場合は、［ソースのアーカイブ済みの
行と削除済みの行を含める］フィールドを選択することで、削除済みおよびアーカイブ済みのソースデータを
取得することができます。
このオプションを選択すると、データ同期タスクは、削除済みおよびアーカイブ済みの Salesforce データをソ
ースから取得します。
削除タスク操作または Salesforce Bulk API を使用する場合、データ同期タスクは、削除済みおよびアーカイ
ブ済みのデータを無視します。
Salesforce ソースのルールとガイドライン
Salesforce ソースを設定するときは、次のルールおよびガイドラインを考慮します。
•
タスクを実行したときに、エージェントがすべてのソースオブジェクトをレプリケートできない場合、複数
の Salesforce ソースオブジェクトと 1 つのフラットファイルターゲットが含まれるタスクは失敗します。
•
すべてのオブジェクトが同じソース接続で利用できる必要があります。オブジェクトが複数あるソース内の
すべての Salesforce オブジェクトには、Salesforce で事前に定義されたリレーションが必要です。
データ同期タスクの Salesforce ターゲット
データ同期タスクでは、ターゲットとして単一のオブジェクトを使用できます。
使用できるターゲット接続は、タスクで選択したタスク操作によって異なります。
16
第 4 章: Salesforce でのデータ同期タスク
次の表に、Salesforce ターゲットのプロパティを示します。
プロパティ
説明
接続
ターゲット接続の名前。
ターゲットオブジェクト
ターゲットオブジェクトの名前。
ラベルの代わりに技術名を表
示
ビジネス名の代わりに技術名を表示します。
ターゲットフィールドをアル
ファベット順に表示
ソースフィールドを、ソースシステムによって返される順序で
はなく、アルファベット順に表示します。
Salesforce ターゲットのルールとガイドライン
Salesforce ターゲットについては、次のルールおよびガイドラインを考慮します。
•
ソースでは、Salesforce ターゲットオブジェクトの必須フィールドに、NULL 以外の値を提供する必要があ
ります。
•
フィールドのデータ型に指定した最大精度とスケールをデータで最大限に使用すると、タスクでは、
Salesforce ターゲットフィールドで数値データの最下位桁が落ちることがあります。
例えば、データ型が Decimal (14, 4)の Salesforce フィールドに 65656565656565.6969 を挿入しようとす
ると、タスクではその代わりに 65,656,565,656,565.6950 が挿入されます。データ型が Decimal (18, 0)の
Salesforce フィールドに 123456789123456789 を挿入しようとすると、タスクでは
123,456,789,123,456,784 が挿入されます。
•
フィールドのデータ型に指定した最大精度とスケールをデータで最大限に使用すると、タスクではデータが
予期せずに丸められて Salesforce ターゲットフィールドに挿入されることがあります。
例えば、データ型が Decimal (18, 0)の Salesforce フィールドに 555555555565.8855 を挿入しようとする
と、タスクではその代わりに 555555555566 が挿入されます。ただし、Salesforce にそのデータを手動で入
力すると、Salesforce ではデータが 555555555565 に丸められます。データ型が Decimal (14, 4)の
Salesforce フィールドに 12345678923456.3399 を挿入しようとすると、タスクではその代わりに
12,345,678,923,456.3400 が挿入されます。
更新/挿入タスク操作
Salesforce ターゲットに更新/挿入を実行するようにデータ同期タスクを設定する場合は、データ同期タスク
ウィザードの［スケジュール］ページで更新/挿入フィールドを設定します。標準オブジェクトに対しては ID
フィールドを使用できます。標準オブジェクトとカスタムオブジェクトに対しては、外部 ID フィールド、また
は idLookup フィールドプロパティが有効になっているあらゆるフィールドを使用できます。タスクのフィール
ドマッピングに更新/挿入フィールドを必ず含めます。
注: 定義された Salesforce ユーザーアカウントに、外部 ID フィールドまたは idLookup フィールドプロパテ
ィが有効になっているフィールドに対する作成または更新権限がない場合、タスクは失敗します。書き込み保
護されている外部 ID フィールドまたは idLookup フィールドによる更新/挿入タスク操作を設定する場合は、デ
ータが存在することを確認します。
更新/挿入タスク操作
17
Salesforce データ同期タスクのフィールドマッピン
グ
ソースカラムからターゲットカラムへのマッピングは、データ同期タスクウィザードの［フィールドマッピン
グ］ページで行うことができます。少なくとも 1 つのソースカラムを 1 つのターゲットカラムにマッピングす
る必要があります。互換性のあるデータ型のカラムをマッピングするか、データ型を適切に変換するフィール
ド式を作成します。
データ同期タスクでは、実施する操作に応じて、フィールドマッピングで特定のフィールドが必要になります。
デフォルトでは、データ同期タスクは類似する名前のフィールドをマッピングします。フィールドマッピング
を設定するときは、必須フィールドがマッピングされたままにします。必須フィールドをマッピングしないと、
データ同期タスクは失敗します。
以下の表に、各タスク操作とターゲットタイプについて、必須フィールドを示します。
必須フィー
ルド
タスク操
作
説明
ID
削除
ID カラムをマッピングして、データ同期タスクが、Salesforce タ
ーゲットで削除または更新するレコードを特定できるようにしま
す。
更新
更新/挿入
フィールド
更新/挿入
更新/挿入フィールドを設定およびマッピングして、データ同期タ
スクが、Salesforce ターゲットで更新/挿入するレコードを特定で
きるようにします。
更新/挿入フィールドとして設定できるのは、外部 ID フィールドま
たは idLookup フィールドプロパティが有効になっているフィール
ドです。
非 NULL フ
ィールド
挿入
更新
Salesforce で NULL にできないすべてのフィールドをマッピングし
ます。
更新/挿入
注: フィールドマッピングを設定する際には、次のタスクも実行できます。
•
類似する名前のカラムをマッピングする。
•
フィールドのデータ型を編集する。
•
フィールドマッピングにマップレットを追加する。
•
フィールド式を作成してデータを変換する。
•
ルックアップを作成する。
•
フィールドマッピングセクションで定義した式を検証する。
データ同期タスクの詳細オプション
Salesforce でデータ同期タスクを設定する際に、ソースとターゲットの詳細オプションを使用できます。
18
第 4 章: Salesforce でのデータ同期タスク
Salesforce 標準 API
Salesforce 標準 API を使用すると、データを Salesforce ソースから読み取ってデータを Salesforce ターゲッ
トに書き込むことができます。通常の量の Salesforce データを処理して、標準 API ロードの結果で標準的な
レポートを作成するには、標準 API を使用します。
標準 API のターゲットバッチサイズ
Salesforce 標準 API を使用して Salesforce ターゲットに書き込みを行うときには、Salesforce へのデータの
書き込みに使用するターゲットバッチサイズを設定できます。
ターゲットバッチサイズにより、各クエリに含めて Salesforce ターゲットに書き込むレコードの最大数が決ま
ります。Salesforce では、クエリごとに最大 200 個のレコードが許可されます。200 より大きい値を入力した
場合は、各クエリに 200 行が含まれます。デフォルトは 200 です。
1 回のクエリで同じ行を複数回更新することはできないため、更新/挿入ではバッチサイズを小さくすることが
あります。特定の行に対する複数の更新/挿入を同じクエリで処理するには、バッチサイズを 1 に設定します。
Salesforce では、24 時間に実行できるクエリの数が制限されます。
標準 API の成功ファイルとエラーファイル
Salesforce 標準 API を使用して Salesforce ターゲットに書き込みを行うと、データ同期タスクではデフォル
トで Salesforce エラーファイルが作成されます。Salesforce 成功ファイルを作成するように、タスクを設定
できます。2 つの Salesforce 成功ファイル（UTC タイムスタンプを使用したファイルと Secure Agent のロー
カルタイムスタンプを使用したファイル）を生成できます。
Salesforce 成功ファイルには、正常に処理された行ごとに 1 行が含まれます。各行には、行 ID、データ、お
よび作成、更新、更新/挿入、削除のうちいずれかのタスク操作が含まれます。操作をロールバックする必要が
生じた場合は、成功ファイルを使用して、作成された行を追跡します。
Salesforce エラーファイルには、ターゲットに書き込まれない行ごとに 1 行が含まれます。エラーファイルに
は、各データエラーのエントリが含まれます。ログの各エントリには、レコードのすべてのフィールドの値と
エラーメッセージが含まれます。Salesforce のターゲットにレコードがロードされなかった理由を理解するに
は、このファイルを使用します。
以下の表に、標準 API の成功ファイルおよびエラーファイルの場所と命名規則を示します。
ファイルタイプ
場所
命名規則
標準 API 成功ファイル
<SecureAgent_InstallDirectory>
\main\rdtmDir\success
s_dss_<TaskID>_TimeStamp_stan
dard_success.csv
標準 API エラーファイル
<SecureAgent_InstallDirectory>
\main\rdtmDir\error
s_dss_<TaskID>_TimeStamp_stan
dard_error.csv
Secure Agent のローカルタイムスタンプを使用して成功ファイルを生成するには、次の手順を実行します。
1.
データ同期タスクウィザードの［スケジュール］ページに移動します。
2. ［詳細 Salesforce オプション］領域の［Salesforce API］で［標準 API］を選択します。
3. ［成功ファイルの作成］を選択します。
4.
変更を保存します。
UTC タイムスタンプを使用して追加の成功ファイルを生成するには、次の手順を実行します。
1.
データ同期タスクウィザードの［スケジュール］ページに移動します。
データ同期タスクの詳細オプション
19
2. ［詳細 Salesforce オプション］領域の［Salesforce API］で［標準 API］を選択します。
3. ［成功ファイルの作成］を選択します。
4.
変更を保存します。
5.
<SecureAgent_InstallDirectory>\main\bin\rtdm にある pmrdtm.cfg ファイルを開きます。
6.
次のように、DSFDCCreateSuccessErrorFileFromParams プロパティを JVMOption として追加します。
JVMOption1=-DSFDCCreateSuccessErrorFileFromParams=true
7.
pmrdtm.cfg ファイルを保存します。
Salesforce Bulk API
Salesforce Bulk API を使用すると、Salesforce ソースからデータを読み取り、Salesforce ターゲットにデ
ータを書き込むことができます。Bulk API を使用して、最小限の数の API 呼び出しを生成しながら、大量の
Salesforce データを処理します。
Salesforce Bulk API を使用すると、各バッチに 10MB のデータまたは CSV 形式の 10,000 のレコードを含める
ことができます。データ同期タスクでは、バッチが作成されるときに、テキストを囲む引用符など、必要な文
字が追加されてデータが書式設定されます。
Bulk API を使用して Salesforce ターゲットに書き込みが行われるジョブは監視できます。Bulk API のターゲ
ットジョブを監視するときは、データ同期タスクにより、低レベル情報の成功ファイルとエラーファイルを作
成できます。データ同期タスクでは、バッチのロードを同時に行うか、または順次に行うこともできます。
バルクジョブを監視する
Bulk API を使用して Salesforce ターゲットに書き込みを行うときは、タスクの監視を有効にします。監視を
有効にすると、データ同期タスクにより、Salesforce サービスから各バッチのステータスが要求されます。デ
ータ同期タスクは、すべてのバッチが終了するまで 10 秒間隔で要求を繰り返します。Salesforce サービスか
らの応答は、データ同期タスクによってアクティビティモニタ、アクティビティログ、およびセッションログ
に書き込まれます。監視を有効にすると、データ同期タスクにより、Bulk API エラーファイルも生成されま
す。
デフォルトでは、データ同期タスクで Bulk API ジョブの監視が許可されます。タスクは、監視せずに実行する
よう設定できます。監視しない場合、アクティビティログとセッションログにはバッチの作成に関する情報が
含まれますが、バッチ処理に関する詳細や正確なジョブ統計は含まれません。
注: Bulk API ジョブを監視すると、データ同期タスクでは追加の API 呼び出しが実行されます。データ同期タ
スクが行う API 呼び出しの数を減らすには、ジョブを監視しない設定にします。バッチ処理の詳細については、
セッションログのジョブ ID とバッチ ID を使用して Salesforce 統計情報にアクセスします。
Bulk API の成功ファイルとエラーファイル
Bulk API ターゲットジョブを監視する場合、データ同期タスクにより、Bulk API エラーファイルがデフォル
トで生成されます。Bulk API 成功ファイルを作成するように、タスクを設定できます。成功ファイルおよびエ
ラーファイルは、Salesforce サービスが提供する行レベルの詳細を含む CSV ファイルです。
Bulk API 成功ファイルとエラーファイルには、ジョブ ID、バッチ ID、データ、エラーメッセージ情報が含ま
れます。
注: バージョン 32 以上の Salesforce Bulk API を使用する場合、成功ファイルに、データ同期タスクの［フ
ィールドマッピング］ページの、ジョブ ID、バッチ ID、データ、エラーメッセージ情報とともに、接続されて
いるすべてのフィールドが含まれます。
20
第 4 章: Salesforce でのデータ同期タスク
以下の表に、Bulk API の成功ファイルおよびエラーファイルの場所と命名規則を示します。
ファイルタイプ
場所
命名規則
Bulk API 成功ファイ
ル
<SecureAgent_InstallDirectory>
\main\rdtmDir\success
s_dss_<TaskID>_TimeStamp_b
ulk_success.csv
Bulk API エラーファ
イル
<SecureAgent_InstallDirectory>
\main\rdtmDir\error
s_dss_<TaskID>_TimeStamp_b
ulk_error.csv
成功ファイルを生成するには、次の手順を実行します。
1.
データ同期タスクウィザードの［スケジュール］ページに移動します。
2. ［詳細 Salesforce オプション］領域の［Salesforce API］で［Bulk API］を選択します。
3. ［バルクジョブを監視する］を選択します。
4. ［成功ファイルの作成］を選択します。
5.
変更を保存します。
シリアルモードを有効にする
Bulk API を使用してデータを Salesforce にロードするときに、パラレルロードまたはシリアルロードを実行
するようにタスクを設定できます。デフォルトでは、パラレルロードが実行されます。
パラレルロードでは、Salesforce により複数のバッチが同時にターゲットに書き込まれます。Salesforce は、
可能なときに各バッチを処理します。シリアルロードでは、Salesforce が受信した順でバッチがターゲットに
書き込まれます。各バッチのコンテンツ全体を処理した後で、次のバッチが処理されます。
特定の順序でターゲットにロードする必要がない場合は、パラレルロードを使用してパフォーマンスを向上さ
せます。更新/挿入ロード時など、ターゲットでのロード順序を保持する場合は、シリアルロードを使用しま
す。
物理削除
Bulk API を使用する場合は、Salesforce ターゲットからデータを完全に削除するようにタスクを設定できま
す。
Bulk API タスクを使用して Salesforce ターゲットからデータを削除する場合、データ同期タスクは、削除し
た行をリサイクルビンにコピーします。削除されたデータは一定時間内は回復できますが、これにはハードデ
ィスクからのスペースがさらに必要となります。
物理削除を使用すると、データ同期タスクではリサイクルビンがバイパスされます。物理削除オプションを使
用してデータを削除した場合、そのデータをリカバリすることはできません。
プライマリキーチャンクの有効化
大きなテーブルからデータを抽出するときは、プライマリキーチャンクを有効にしてパフォーマンスを向上さ
せます。
Bulk API を使用してデータを Salesforce から抽出するときに、プライマリキーチャンクを有効にすることが
できます。デフォルトでは、Bulk API ではプライマリキーチャンクは使用されません。
プライマリキーチャンクを有効にすると、Bulk API ではレコード ID に基づいてデータセットが複数のチャン
クに分割され、チャンクごとに抽出クエリが作成されます。すべての抽出クエリが完了すると、Bulk API はデ
ータを結合します。
データ同期タスクの詳細オプション
21
Salesforce では、カスタムオブジェクトと特定の標準オブジェクトでプライマリキーチャンクがサポートされ
ます。プライマリキーチャンクをサポートするオブジェクトの詳細については、Salesforce のマニュアルを参
照してください。
注: プライマリキーチャンクは、Salesforce 接続で Salesforce API のバージョン 32 以降が使用されている場
合に有効化できます。デフォルトのチャンクサイズは 100000 です。
関連オブジェクトに対する NULL 更新
関連 Salesforce オブジェクトに対して NULL 更新を実行できます。 NULL 更新の結果は、使用する Salesforce
API によって異なります。
標準 API を使用して関連オブジェクト内のフィールドを NULL 値で更新すると、関連オブジェクトが切り離され
ます。
Bulk API を使用して関連オブジェクト内のフィールドを NULL 値で更新すると、そのフィールドが NULL 値で更
新されます。
22
第 4 章: Salesforce でのデータ同期タスク
第 5 章
Salesforce でのマッピングとマッ
ピング設定タスク
この章では、以下の項目について説明します。
•
Salesforce でのマッピングとマッピング設定タスクの概要, 23 ページ
•
マッピングの Salesforce オブジェクト, 23 ページ
•
マッピング設定タスクの Salesforce オブジェクト, 26 ページ
Salesforce でのマッピングとマッピング設定タスク
の概要
Salesforce データオブジェクトの読み取り操作または書き込み操作の作成後に、マッピングを設定できます。
マッピング内には、次のオブジェクトを定義できます。
•
Salesforce メタデータからのデータ読み取りへの入力としての、Salesforce データオブジェクトの読み取
り操作。
•
出力としてのフラットファイル、リレーショナル、またはサポートされる任意のデータオブジェクト。
マッピングを検証および実行し、Salesforce データを抽出して、リレーショナルまたはフラットファイルター
ゲットにロードします。
マッピングの Salesforce オブジェクト
マッピングを作成するときに、ソースまたはターゲットのトランスフォーメーションを、Salesforce オブジェ
クトを表すように設定できます。
マッピングの Salesforce ソース
マッピングでは、ソーストランスフォーメーションを設定して単一の Salesforce ソースまたは複数の
Salesforce ソースを表すことができます。
Salesforce ソースの名前と説明を指定します。ソースオブジェクトのソースプロパティと詳細プロパティを設
定します。
23
次の表に、ソーストランスフォーメーションで設定できる Salesforce ソースプロパティを示します。
プロパティ
説明
接続
ソース接続の名前。
ソースタイプ
ソースオブジェクトのタイプ［単一オブジェクト］、［複数のオブジェク
ト］、または［パラメータ］を選択します。
オブジェクト
マッピングのソースオブジェクトの名前。
フィルタ
レコードをフィルタリングするための条件を追加します。簡易フィルタ
または詳細フィルタを設定します。
ソート
Salesforce 接続では、ソートはサポートされていません。
ソースのアーカイ
ブ済みの行と削除
済みの行を含める
アーカイブ済みおよび削除済みのソース行を含めます。デフォルトでは、
エージェントはアクティブな行を返します。
次の表に、ソーストランスフォーメーションで設定できる Salesforce ソース詳細プロパティを示します。
詳細プロパティ
説明
行制限
エージェントによって処理される最大行数。すべてのレコードを処理する
には［すべての行］を選択します。また、特定の行数を処理するには、行
数を指定します。
Salesforce API
ソースデータの読み取り用 Salesforce API。標準 API または Bulk API
を選択します。
SOQL フィルタ条件
ソースデータをフィルタリングするための SOQL 条件。
トレースレベル
このトランスフォーメーションのログに表示される情報の詳細度。［簡
易］、［通常］、［詳細 - 初期化］、［詳細 - データ］から選択できます。デ
フォルトは［通常］です。
マッピングの Salesforce ターゲット
マッピングでは、ターゲットトランスフォーメーションとして Salesforce オブジェクトを設定して
Salesforce にデータを挿入できます。
Salesforce ターゲットの名前と説明を指定します。ターゲットオブジェクトのターゲットプロパティと詳細プ
ロパティを設定します。
次の表に、ターゲットトランスフォーメーションで設定できる Salesforce ターゲットプロパティを示します。
24
プロパティ
説明
接続
ターゲット接続の名前。
ターゲットタ
イプ
ターゲットオブジェクトのタイプ［単一オブジェクト］または［パラメータ］
を選択します。
第 5 章: Salesforce でのマッピングとマッピング設定タスク
プロパティ
説明
オブジェクト
ターゲットオブジェクトの名前。1 つのターゲットのターゲットオブジェク
ト、または複数のターゲットのプライマリターゲット。
操作
ターゲット操作。 Insert、Update、Upsert、Delete、Data Driven のいずれ
かのコマンドを選択します。
次の表に、ターゲットトランスフォーメーションで設定できる Salesforce ターゲット詳細プロパティを示しま
す。
詳細プロパティ
バッチごとの最大行数
説明
（標準 API を使用して Salesforce ターゲットをロードする場
合）
Salesforce ターゲットに書き込む各クエリに含めるレコー
ドの最大数。 1 から 200 までの範囲で数値を入力します。
特定の行に対する複数の更新/挿入を同じクエリで処理する
には、バッチサイズを 1 に設定します。デフォルトは 200 で
す。
NULL への設定
NULL 値でターゲットの既存の値を置き換えることができる
かどうかを指定します。 NULL 値でターゲットの既存の値を
置き換えることができるようにする場合は True を選択しま
す。
デフォルトは False です。
SFDC エラーファイルの使用
Salesforce エラーファイルを作成します。マッピング設定
タスクは、エラーファイルをディレクトリ
<SecureAgent_InstallDirectory>/main/rdtmDir/error に書き込
みます。デフォルトでは、エージェントは、エラーログファ
イルを生成しません。
エラーログファイルを生成するには、［はい］を選択します。
エラーファイルの場所とファイルプレフィックスを入力しま
す。ファイルプレフィックスは、成功ログファイル名および
エラーログファイル名にプレフィックスを追加します。
SFDC 成功ファイルの使用
Salesforce 成功ファイルを作成します。デフォルトでは、
エージェントは、成功ログファイルを生成しません。
成功ログファイルを生成するには、［はい］を選択します。
成功ファイルの場所とファイルプレフィックスを入力しま
す。
Salesforce API
ターゲットデータを書き込む Salesforce API。標準 API ま
たは Bulk API を選択します。
Bulk を監視
Salesforce Bulk API ターゲットを監視します。
シリアルモードを有効にする
Salesforce Bulk API バッチをターゲットに順番にロードし
ます。
デフォルトでは、Salesforce は Bulk API バッチを並列にロ
ードします。
拒否された行を転送
拒否された行を次のセッションに転送します。
マッピングの Salesforce オブジェクト
25
マッピングの Salesforce ルックアップオブジェクト
指定したルックアップ条件に基づいて、Salesforce ルックアップオブジェクトからデータを取得できます。
Salesforce でルックアップを設定するときには、ルックアップ接続とルックアップオブジェクトを選択しま
す。ルックアップ条件で複数の一致が返されるときの動作も定義します。
次の表に、ルックアップトランスフォーメーションで設定できる Salesforce ルックアップオブジェクトのプロ
パティを示します。
ルックアップオブジェクトのプロ
パティ
説明
接続
ルックアップ接続の名前。
ソースタイプ
ソースオブジェクトのタイプ［単一オブジェクト］また
は［パラメータ］を選択します。
ルックアップオブジェクト
マッピングのルックアップオブジェクトに名前を付けま
す。
複数一致
ルックアップ条件で複数の一致が返されるときの動作。
最初の行、最後の行、任意の行、すべての行を返すか、
またはエラーをレポートすることができます。
すべての行を選択して複数の一致がある場合、ルックア
ップトランスフォーメーションはアクティブなトランス
フォーメーションになります。任意の行、最初の行、ま
たは最後の行を選択して、複数の一致がある場合、ルッ
クアップトランスフォーメーションはパッシブなトラン
スフォーメーションになります。
マッピング設定タスクの Salesforce オブジェクト
マッピング設定タスクを設定する場合は、Salesforce のソースとターゲットに詳細プロパティを設定できま
す。
マッピング設定タスクの Salesforce ソース
テンプレートベースのマッピング設定タスクで使用される Salesforce ソース接続の場合、マッピング設定タス
クウィザードの［ソース］ページで詳細なプロパティを設定できます。
以下のプロパティを設定することができます。
26
プロパティ
説明
接続
ソース接続の名前。
ソースタイプ
ソース接続のタイプ。［シングル］、［複数］、または［クエリ］を選択します。
ソースオブジェ
クト
ソースオブジェクトの名前。
第 5 章: Salesforce でのマッピングとマッピング設定タスク
プロパティ
クエリのオプシ
ョン
関連オブジェク
ト
説明
次のオプションから選択できます。
- フィルタ。フィルタ条件により、Salesforce のデータをフィルタします。
- ラベルの代わりに技術名を表示。ビジネス名の代わりに技術名を表示します。
- ソースフィールドをアルファベット順に表示。ソースフィールドを、ソースシ
ステムによって返される順序ではなく、アルファベット順に表示します。
タスクの関連オブジェクトが含まれます。
以下の詳細プロパティを設定できます。
詳細プロパティ
説明
SOQL フィルタ条件
Salesforce ソースレコードをフィルタリングするためのフィルタ条件
を入力します。
CDC 時間制限
変更された Salesforce データをエージェントが読み取る期間（単位は
秒）。CDC 時間制限をゼロ以外の値に設定すると、エージェントでソース
データの完全初期読み取りが実行され、その後指定した時間内に
Salesforce データに対して加えられた変更がキャプチャされます。変
更データを無限時間キャプチャするよう設定するには、値を-1 に設定し
ます。デフォルトは 0 です。
フラッシュ間隔
変更された Salesforce データをエージェントがキャプチャする間隔
（単位は秒）。デフォルトは 300 です。CDC 時間制限を 0 以外の値に設定
すると、エージェントにより、変更されたデータがソースから 300 秒ご
とにキャプチャされます。それ以外の場合、エージェントはこの値を無
視します。
CDC 開始タイムスタ
ンプ
時間枠の開始日時。エージェントは、この時間以降に追加または変更さ
れたデータを抽出します。形式は YYYY-MM-DDTHH:MI:SS.SSSZ でなけれ
ばなりません。パラメータファイルで$Paramstart マッピング変数を使
用して CDC 開始時刻を指定することもできます。
CDC 終了タイムスタ
ンプ
時間枠の終了日時。エージェントは、この時間以前に追加または変更さ
れたデータを抽出します。形式は YYYY-MM-DDTHH:MI:SS.SSSZ でなけれ
ばなりません。パラメータファイルで$Paramend マッピング変数を使用
して CDC 終了時刻を指定することもできます。
行制限
エージェントによって処理される最大行数。デフォルトは 0 です。デフ
ォルト値は行数の制限がないことを示し、エージェントによってすべて
のレコードが処理されます。
queryAll を使用
すべての行（アクティブな行、アーカイブ済みの行、ごみ箱に存在する
削除済みの行など）を返すクエリを実行します。それ以外の場合、エー
ジェントはアクティブな行を返します。
［一括クエリの有効化］オプションを使用するように、または変更デー
タキャプチャを実行するようにセッションを設定すると、エージェント
はこのプロパティを無視します。
マッピング設定タスクの Salesforce オブジェクト
27
詳細プロパティ
説明
CDC に
SystemModstamp を
使用
SystemModstamp を Salesforce の変更レコード用のタイムスタンプとし
て使用します。それ以外の場合、エージェントは LastModifiedDate タ
イムスタンプを使用して Salesforce の変更レコードを識別します。デ
フォルトでは、LastModifiedDate タイムスタンプを使用するように設
定されています。
一括クエリの有効化
Salesforce 一括 API を使用して Salesforce ソースデータを読み取りま
す。
デフォルトでは、エージェントによって標準の Salesforce API が使用
されます。
マッピング設定タスクの Salesforce ターゲット
テンプレートベースのマッピング設定タスクで使用される Salesforce ターゲット接続の場合、マッピング設定
タスクウィザードの［ターゲット］ページで詳細なプロパティを設定できます。
以下のプロパティを設定することができます。
プロパティ
説明
接続
ターゲット接続の名前。
ターゲットオブ
ジェクト
ターゲットオブジェクトのタイプ
フィルタ
フィルタ条件により、Salesforce のデータをフィルタします。
ラベルの代わり
に技術名を表示
ビジネス名の代わりに技術名を表示します。
ターゲットフィ
ールドをアルフ
ァベット順に表
示
ターゲットフィールドを、ソースシステムによって返される順序ではなく、
アルファベット順に表示します。
以下の詳細プロパティを設定できます。
28
詳細プロパティ
説明
挿入を更新/挿入として扱う
挿入フラグが設定されたレコードを更新/挿入します。デフォ
ルトでは、エージェントはすべてのレコードを挿入として扱
います。
更新を更新/挿入として扱う
更新フラグが設定されたレコードを更新/挿入します。マッピ
ングでアップデートストラテジトランスフォーメーションを
使う場合は、このプロパティを選択します。［ソース行の扱
い］セッションプロパティを選択して、レコードに更新フラ
グを設定します。
第 5 章: Salesforce でのマッピングとマッピング設定タスク
詳細プロパティ
説明
最大バッチサイズ
エージェントが 1 つのバッチで Salesforce ターゲットに書き
込むレコードの最大数。デフォルトは 200 件のレコードです。
このプロパティは、Bulk API ターゲットセッションでは使用
しません。
フィールドを NULL に設定
ターゲット内の値をソースからの NULL 値に置換します。
デフォルトでは、エージェントは、更新または更新/挿入の操
作中にレコードに含まれる既存の値を NULL 値で置換しませ
ん。
SFDC エラーファイルの使用
エラーログファイルを生成します。デフォルトでは、エージ
ェントは、エラーログファイルを生成しません。
Bulk API ターゲットセッションのエラーログファイルを生成
するには、［すべてのバッチが処理されるまで一括ジョブを監
視］セッションプロパティも選択します。
SFDC 成功ファイルの使用
成功ログファイルを生成します。デフォルトでは、エージェ
ントは、成功ログファイルを生成しません。
Bulk API ターゲットセッションの成功ログファイルを生成す
るには、［すべてのバッチが処理されるまで一括ジョブを監
視］セッションプロパティも選択します。
SFDC 成功ファイルディレクト
リ
エージェントが成功ログファイルを格納するディレクトリで
す。
デフォルトでは、成功ログファイルはエージェントにより
$PMTargetFileDir ディレクトリに格納されます。エラーログ
ファイルはエージェントにより$PMBadFileDir ディレクトリ
に格納されます。
Idlookup フィールドを使用し
て更新/挿入する
Salesforce idLookup フィールドを使用して、更新/挿入され
る必要があるターゲットレコードを識別します。
このプロパティを選択しない場合は、更新/挿入操作に外部
ID を使用します。このプロパティを選択せず、外部 ID も指
定しない場合、セッションは失敗します。
更新/挿入にこの
ExternalId/IdLookup フィール
ドを使用する
SFDC Bulk API の使用
更新/挿入に使用する外部 ID または idLookup フィールドの正
確な名前。
デフォルトでは、エージェントはターゲットの最初の外部 ID
または idLookup フィールドを使用します。このプロパティ
は、更新/挿入に別のフィールドを使用する場合に使用しま
す。
Salesforce Bulk API を使用して大量のデータを含むバッチ
ファイルを Salesforce ターゲットにロードします。
デフォルトでは、エージェントによって標準の Salesforce
API が使用されます。
マッピング設定タスクの Salesforce オブジェクト
29
詳細プロパティ
説明
すべてのバッチが処理される
まで一括ジョブを監視
Bulk API ターゲットセッションを監視します。
このプロパティを選択すると、エージェントは各バッチのス
テータスをセッションログに記録します。このプロパティを
選択しない場合、エージェントは、セッションログ用の完全
なセッション統計情報を生成しません。
セッションの成功ログまたはエラーログを生成するには、
［SFDC 成功ファイルの使用］または［SFDC エラーファイルの
使用］セッションプロパティとともにこのプロパティを選択
します。
並行処理（パラレル）をオー
バーライド
Salesforce Bulk API にターゲットに逐次バッチを書き込む
ように指示します。デフォルトでは、Bulk API はバッチを並
列に書き込みます。
一括成功およびエラーファイ
ルの作成の無効化
Bulk API ターゲットセッションの成功ログファイルおよびエ
ラーログファイルの作成を無効化します。
［SFDC エラーファイルの使用］および［SFDC 成功ファイルの
使用］セッションプロパティよりも優先されます。
フィールド切り詰め属性の有
効化
Salesforce で、ターゲットファイルよりも長いターゲットデ
ータを切り詰めることができるようにします。このプロパテ
ィを選択すると、オーバーフローデータが Salesforce で切り
詰められてから、Salesforce のターゲットに行が書き込まれ
ます。
デフォルトでは、エージェントはオーバーフローしたデータ
をセッションエラーファイルに書き込みます。
マッピング設定タスクの Salesforce ルックアップオブジェクト
マッピング設定タスクで使用される Salesforce ルックアップ接続では、マッピング設定タスクウィザードの
［その他のパラメータ］ページで詳細プロパティを設定できます。
次の表に、ルックアップトランスフォーメーションで設定できる Salesforce ルックアップオブジェクトのプロ
パティを示します。
30
ルックアップオブジェクトのプロ
パティ
説明
接続
ルックアップ接続の名前。
ルックアップオブジェクト
マッピングのルックアップオブジェクトに名前を付けま
す。
ラベルの代わりに技術名を表示
ビジネス名の代わりに技術名を表示します。
ルックアップフィールドをアルフ
ァベット順に表示
ルックアップフィールドを、ソースシステムによって返
される順序ではなく、アルファベット順に表示します。
第 5 章: Salesforce でのマッピングとマッピング設定タスク
第 6 章
Salesforce でのデータレプリケー
ションタスク
この章では、以下の項目について説明します。
•
データレプリケーションの概要, 31 ページ
•
データレプリケーションソースのプロパティ, 31 ページ
•
データレプリケーションターゲットのプロパティ, 32 ページ
•
ロードタイプ, 32 ページ
•
Salesforce ソースのレプリケート, 34 ページ
•
データベースターゲットのリセット, 35 ページ
•
ソースとターゲットの不一致の処理, 35 ページ
•
データレプリケーションタスク, 37 ページ
データレプリケーションの概要
データレプリケーションタスクを使用して、Salesforce データをターゲットにレプリケートできます。データ
をレプリケートすると、データをバックアップしたり、オフラインでレポートを作成したりすることができま
す。Salesforce オブジェクトのデータを、データベースまたはフラットファイルにレプリケートできます。
データレプリケーションソースのプロパティ
データレプリケーションタスクで、レプリケートするオブジェクトのプロパティを設定できます。
次の表に、データレプリケーションタスクの Salesforce ソースのプロパティを示します。
プロパティ
説明
ソース接続
ソース接続の名前。
レプリケートするオブジェクト
レプリケートするソースオブジェクト。［すべてのオブジ
ェクト］、［オブジェクトを含む］、または［オブジェクト
を除外する］を選択します。
31
プロパティ
説明
オブジェクトの処理中にエラーが
発生した場合:
エラーが発生した場合に、オブジェクトの処理を終了また
は続行します。
ラベルの代わりに技術名を表示
ビジネス名の代わりに技術名を表示します。
ソースのアーカイブ済みの行と削
除済みの行を含める
ソースのアーカイブ済みの行と削除済みの行を含めます。
デフォルトでは、エージェントはアクティブな行を返しま
す。
データレプリケーションターゲットのプロパティ
データレプリケーションタスクで、ターゲットプロパティを設定できます。
次の表に、データレプリケーションタスクのターゲットのプロパティを示します。
プロパティ
説明
接続
ターゲット接続の名前。ターゲット接続を選択するか、新
しい接続を作成します。
ターゲットのプレフィックス
ターゲット内のターゲットオブジェクトの名前を作成する
ためにソースオブジェクト名に追加するプレフィックスの
文字列。
ロードタイプ
前回の実行以降にソースオブジェクト内で作成、変更、お
よび削除されたデータすべてを特定して、変更内容をター
ゲットオブジェクトにプロパゲートします。
削除オプション
削除されたカラムおよび行を削除または保持します。
コミットサイズ
すべての実行に対するデータレプリケーションタスクに使
用されます。値が指定されていない場合、エージェントは
デフォルト値を使用します。
ロードタイプ
データレプリケーションタスクを設定する際には、使用するロードタイプを指定します。ロードタイプによっ
て、データレプリケーションタスクがソースからターゲットにデータをレプリケートするときに使用する操作
のタイプが決まります。
タスクが Salesforce ソースを使用している場合に、増分ロードタイプを指定できます。
32
第 6 章: Salesforce でのデータレプリケーションタスク
完全なロード
完全なロードの場合、データレプリケーションタスクは、タスクのソースオブジェクトのすべての行のデータ
をレプリケートします。データレプリケーションタスクは、タスクが実行されるたびに、ターゲットのデータ
ベーステーブルまたはフラットファイルをトランケートし、ソースから全データの更新を実行します。
完全なロードは次の場合に実行します。
•
データレプリケーションタスク内の Salesforce オブジェクトが、Salesforce 内でレプリケート不可に設定
されている場合。
レプリケート不可のオブジェクトを含むデータレプリケーションタスクに対して増分ロードを実行すると、
そのデータレプリケーションタスクは当該オブジェクトに対して完全なロードを実行します。レプリケート
可能な Salesforce オブジェクトの一覧を取得する方法については、Salesforce 管理者にお問い合わせくだ
さい。
•
Salesforce フィールドのデータ型が変更された場合。
データ型が変更されていることがデータレプリケーションタスクによって検出された場合は、まず、ターゲ
ットテーブルをリセットして、更新された Salesforce オブジェクトに合わせてテーブルを作成し直します。
その後、データレプリケーションタスクを完全ロードで実行し、データレプリケーションタスクに含まれる
すべての Salesforce オブジェクトからデータを再ロードする必要があります。または、
AutoAlterColumnType カスタム構成プロパティを設定して、Salesforce オブジェクトに合わせてターゲッ
トテーブルのカラムが更新されるようにします。AutoAlterColumnType プロパティは、状況によっては適用
されない場合があります（例えば、ソースとターゲットのデータ型に互換性がない場合など）。
増分ロード
Salesforce データをデータベースターゲットにレプリケートする際には、増分ロードを使用できます。
増分ロードには次のタイプがあります。
•
最初の完全なロードの後での増分ロードデータレプリケーションタスクは、初回実行時に完全なロードを実
行し、すべての行のデータをレプリケートします。
•
特定期間の増分ロードデータレプリケーションタスクは、初回実行時に更新/挿入操作を実行して、指定さ
れた期間中のソースに対する変更に基づいてデータをレプリケートします。
初回実行後は、どちらのタイプの増分ロードも同じ方法でデータをレプリケートします。
データレプリケーションタスクは、更新/挿入操作を実行して、新しい行および前回のタスク実行以降に変更さ
れた行のデータをレプリケートします。前回の実行時刻は、Salesforce から最後のレコードがレプリケートさ
れた時刻により決定されます。
各レプリケーションセッションは、単一のトランザクションで実行されます。デフォルトのコミット間隔を使
用している場合にエラーが発生すると、トランザクション全体がロールバックされます。コミット間隔の値を
小さくすれば、ロールバックが発生したとき、最後のバッチのみがロールバックされるようになります。パフ
ォーマンスを最適化するため、データレプリケーションタスクを数週間または数か月などの長間隔で実行する
ようスケジュールする場合には、増分ロードの使用を避けます。その場合は、代わりに完全なロードを実行し
て、スケジュール間隔中にレプリケートされたすべてのデータがロールバックされないようにします。
増分実行時に、データレプリケーションタスクがターゲットテーブルをトランケートすることはありません。
ターゲットテーブルをトランケートするには、完全なロードのデータレプリケーションタスクを実行する必要
があります。
データレプリケーションタスクは、Salesforce のソースオブジェクトとターゲットテーブルを比較して不一致
個所を見つけるため、次のタスクを実行します。
1.
ソースとターゲットのフィールド名を比較します。
2.
ターゲットテーブルのフィールドを挿入および削除してソースと一致させます。
3.
クエリを実行して、値が挿入または更新されているかどうかを確認します。
ロードタイプ
33
4.
新しい行および変更された行をレプリケートします。
Salesforce Bulk API を使用して増分ロードを実行することはできません。タスクで増分ロードオプションを
選択した場合は、Salesforce Bulk API 詳細オプションを無効にします。
増分ロードの実行のルールおよびガイドライン
データレプリケーションタスクを増分ロードとして実行するときは、次のルールおよびガイドラインを考慮し
ます。
•
ターゲットにカラムを追加できます。データレプリケーションタスクでは、フィールド名の不整合が調整さ
れてからクエリが実行され、変更されたデータが検索されるため、フィールド名の変更では行がレプリケー
トされません。レプリケーションが行われるのは、行のデータが変更された場合のみです。
たとえば、Salesforce ソースに「New」という名前のフィールドが含まれており、ターゲットにはこのフィ
ールドが存在しないとします。増分ロードを実行し、行 1 の New フィールドに値が存在しない場合、データ
レプリケーションタスクでは、New フィールドがターゲットテーブルに追加されますが、行 1 ではデータが
レプリケートされません。行 1 の New フィールドに値が含まれる場合、データレプリケーションタスクで
は、行 1 でデータがレプリケートされます。
•
ソースカラムとターゲットカラムで、データ型、精度、スケールが一致しない場合、増分ロードは失敗する
可能性があります。ソースカラムとターゲットカラムでデータ型が一致しない場合、またはソースカラムの
精度やスケールがターゲットカラムのものよりも高い場合、増分ロードは失敗します。
この問題を解決するには、AutoAlterColumnType カスタム設定プロパティを設定し、ターゲットテーブルカ
ラムを更新して Salesforce オブジェクトと一致させることができます。
ターゲットをリセットしてターゲットテーブルを再作成し、対応するソースオブジェクトと一致させること
もできます。次にデータレプリケーションタスクを完全なロードで実行し、データレプリケーションタスク
に含まれる、すべてのソースオブジェクトのデータをリロードします。
•
データレプリケーションタスクでは、レプリケートできない Salesforce オブジェクト、または作成者と最
終変更者の日付がない Salesforce オブジェクトで増分ロードを実行できません。各 Salesforce オブジェ
クトは、Salesforce でレプリケートできないように設定できます。レプリケート可能な Salesforce オブジ
ェクトの一覧を取得する方法については、Salesforce 管理者にお問い合わせください。
Salesforce では、すべてのオブジェクトの作成者または最終変更者の日付が追跡されているわけではあり
ません。
•
タスクを増分ロードで複数回実行する場合、前回の実行の終了時刻と次の実行の開始時刻の間隔は、最低で
も 60 秒にする必要があります。60 秒の待機時間より前にタスクを実行しようとすると、タスクは失敗しま
す。
•
ターゲットがフラットファイルであるとき、タスクを増分ロードで実行することはできません。
Salesforce ソースのレプリケート
Salesforce ソースをレプリケートするときに、Salesforce ソース内の現在の行をすべてレプリケートできま
す。さらに Salesforce ソース内の削除された行やアーカイブされた行もレプリケートできます。削除された行
やアーカイブされた行をレプリケートすると、古いデータの保持や分析が可能になります。
Salesforce ソースに高精度データを含む計算フィールドがある場合は、高精度計算を有効にできます。高精度
計算を使用すると、最高 28 の精度を備えた計算フィールドのデータをレプリケートできます。
まだ存在しないターゲットデータベーステーブルに Salesforce ソースをレプリケートするとき、データレプリ
ケーションタスクはターゲットテーブルごとに一意ではないインデックスを生成します。［データレプリケーシ
ョンタスク］ページで［ターゲットの作成］オプションを使用して、ターゲットデータベーステーブルに
Salesforce ソースをレプリケートするときに、データレプリケーションタスクはインデックスを作成します。
34
第 6 章: Salesforce でのデータレプリケーションタスク
データレプリケーションタスクは、Salesforce ID のフィールドに基づいてインデックスを生成します。
Salesforce ID のフィールドがないデータベースターゲットについては、データレプリケーションタスクでは
インデックスは生成されません。
データベースターゲットのリセット
データレプリケーションタスクでリレーショナルターゲットテーブルをリセットすると、そのタスクのすべて
のターゲットテーブルが削除されます。
リレーショナルターゲットをリセットする必要がある理由として、以下が考えられます。
•
Salesforce ソースフィールドのデータ型、精度、またはスケールが変更されている場合に、データレプリ
ケーションタスクを増分ロードとして実行すると、タスクが失敗することがあります。これは、ソースフィ
ールドとリレーショナルターゲットテーブルカラムのデータ型が一致しない、または、ターゲットテーブル
カラムに、Salesforce フィールドのすべての値を格納できないためであることが考えられます。ターゲッ
トテーブルをリセットすると、ターゲットテーブルカラムのデータ型、精度、またはスケールを、
Salesforce フィールドと同期できます。精度またはスケールを低下させた場合、データレプリケーション
タスクは成功し、ターゲットテーブルカラムは変更されません。
•
Salesforce ソースのフィールドを削除すると、データレプリケーションタスクは、Microsoft SQL Server
リレーショナルターゲットに書き込みを行います。
Microsoft SQL Server ターゲットに書き込むデータレプリケーションタスクを実行する場合に、ソースに
存在しないフィールドまたはカラムがあると、そのデータレプリケーションタスクは失敗します。データレ
プリケーションタスクの実行を成功させるには、ターゲットテーブルをリセットして、最新のソース定義に
基づいてターゲットを再作成してから、データレプリケーションタスクを実行します。
ソースとターゲットの不一致の処理
Salesforce ソースとデータベースターゲットに対する増分ロードを実行した場合に、ソースとターゲットのメ
タデータが一致しないと、タスクが失敗することがあります。
Salesforce フィールドのデータ型とデータベースターゲットカラムのデータ型が一致しないため、タスクが失
敗することがあります。Salesforce フィールドの精度またはスケールが増分されたため、データベースカラム
に値を格納できない場合にもタスクが失敗することがあります。
ソースメタデータの変更に合わせてターゲットカラムを調整するには、AutoAlterColumnType カスタム構成プ
ロパティを使用します。このプロパティを使用すると、データレプリケーションタスクによって、ターゲット
カラムのメタデータがソースに合わせて変更されます。AutoAlterColumnType カスタム構成プロパティはデー
タレプリケーションタスクを実行する Secure Agent について設定します。
AutoAlterColumnType プロパティは、状況によっては使用できないことがあります。AutoAlterColumnType プ
ロパティを実行しても不一致が解決しない場合は、ターゲットのリセットおよび再ロードが必要になることも
あります。
データベースターゲットのリセット
35
次の表に、メタデータの不一致の例とその対処方法をいくつか示します。
ソースとターゲットのメ
タデータの不一致
アクション
精度が増分された
AutoAlterColumnType を使用します。
精度が減分された
ターゲットをリセットして再ロードします。
データ型が変更された
ターゲットをリセットして再ロードします。
カラムが追加された
アクションは必要ありません。この問題はすべてのロードタイプ
で解決できます。
カラムが削除された
アクションは必要ありません。この問題はすべてのロードタイプ
で解決できます。
AutoAlterColumnType プロパティの設定
AutoAlterColumnType カスタム構成プロパティを設定して、Salesforce ソースフィールドのデータ型、精度、
またはスケールが変更されたときに、データベースターゲットのカラムが調整されるようにします。このプロ
パティは、データレプリケーションタスクを実行する Secure Agent の場合に設定します。
1. ［設定］ > ［ランタイム環境］をクリックします。
2.
データレプリケーションタスクを実行する Secure Agent をクリックし、［Secure Agent の編集］を選択し
ます。
3. ［カスタム構成の詳細］の［追加］アイコンをクリックし、次の値を入力します。
フィールド
値
タイプ
［Tomcat］を選択します。
サブタイプ
［情報］を選択します。
名前
カスタムプロパティの名前。
「AutoAlterColumnType」と入力します。
値
「yes」と入力してこのプロパティをオンにします。
4. ［OK］をクリックして変更を保存します。
データレプリケーションのソースとターゲットのルールおよびガイ
ドライン
データレプリケーションタスクのソースとターゲットについては、次のルールおよびガイドラインを考慮しま
す。
36
•
同じソースオブジェクトを同じターゲットオブジェクトにレプリケートするように、複数のデータレプリケ
ーションタスクを設定することはできません。例えば、Salesforce アカウントデータを SF_ACCOUNT
Oracle データベーステーブルに書き込むように、2 つのデータレプリケーションタスクを設定できません。
•
同じターゲットテーブルに書き込みを行う複数のデータレプリケーションタスクを、同時に実行することは
できません。
第 6 章: Salesforce でのデータレプリケーションタスク
データレプリケーションタスク
データをソースからターゲットにレプリケートするには、データレプリケーションタスクを設定します。デー
タレプリケーションタスクを設定するときは、ソース接続、ターゲット接続、レプリケートするオブジェクト
を指定します。
データレプリケーションタスクでは、1 つ以上の Salesforce オブジェクトからデータをレプリケートできま
す。このタスクを設定すると、選択した接続によって使用可能となる、すべてのオブジェクトをレプリケート
できるようになり、一連のオブジェクトを組み込んだり除外したりして、レプリケーション用のオブジェクト
を選択することもできるようになります。行とカラムをデータレプリケーションタスクから除外することもで
きます。タスクを実行するタイミングと頻度を指定するには、スケジュールをデータレプリケーションタスク
に関連付けます。
データレプリケーションタスクを設定するのは、完全なロードまたは増分ロードを実行するためです。オブジ
ェクトごとにすべての行をレプリケートするには、完全なロードを実行します。前回のタスク実行以降に新し
く追加された行や変更された行をレプリケートするには、増分ロードを実行します。
データレプリケーションタスクをタスク実行中にスケジュールから削除しても、タスクは完了します。スケジ
ュールに関連するその他のタスク実行は、データレプリケーションタスクによってキャンセルされます。
データレプリケーションタスクの設定中、設定内容をいつでも保存できます。次のいずれかのオプションを選
択できます。
•
保存して続行
•
保存して実行
•
保存して閉じる
データレプリケーションタスクを設定するには、データレプリケーションタスクウィザードを使用して、次の
手順を実行します。
1.
ソースを設定します。
2.
ターゲットを設定します。
3.
必要に応じてフィールドを除外します。
4.
必要に応じてデータフィルタを設定します。
5.
必要に応じてスケジュールを設定します。
データレプリケーションタスクの設定のルールおよびガイドライン
データレプリケーションタスクを設定するときは、次のルールおよびガイドラインを考慮します。
•
ソースのテーブルおよびフィールドの名前に使用できる文字数は、最大 79 文字です。
•
ソースオブジェクトとターゲットオブジェクトが同一のデータレプリケーションタスクを設定することはで
きません。ソース接続とターゲット接続が同一の場合は、ターゲットのプリフィックスを入力して、ソース
オブジェクトとターゲットオブジェクトを区別する必要があります。
•
Salesforce ターゲットにデータをレプリケートすることはできません。
高精度計算
タスクで高精度計算を有効にすると、Salesforce 計算フィールド内の高精度データの処理が可能になります。
高精度計算を有効にすると、データレプリケーションタスクは、Salesforce 計算フィールド内のデータ（最大
28 桁の精度）を読み込み、ターゲットに書き出すことができます。
データレプリケーションタスク
37
Salesforce Base64 エンコードボディサイズ
Salesforce ソースでは、Base64 エンコードデータのボディサイズを設定できます。
Salesforce ソースに Base64 エンコードデータが含まれており、それをデータレプリケーションタスクで処理
する場合は、Base64 ボディサイズを設定します。デフォルトでは、Base64 エンコードデータのボディサイズ
は 7 MB です。このサイズは必要に応じて拡大できます。
注: データ同期タスクを設定して、レプリケーション後にこのデータを処理する場合は、［タイプの編集］オプ
ションを使用して、Base64 エンコードデータのデータ型の精度を高めます。
Salesforce API
Salesforce の標準 API または Bulk API を使用して、データレプリケーションタスクで Salesforce データを処
理できます。
標準 API を使用して、通常の量の Salesforce データを処理し、標準 API ロードの結果で標準レポートを作成
します。
Bulk API を使用して、最小限の数の API 呼び出しを生成しながら、大量の Salesforce データを処理します。
Salesforce の Bulk API では、データの各バッチに、CSV 形式で最大 10,000 行または 100 万文字のデータを含
めることができます。データレプリケーションタスクがバッチを作成するとき、テキストを囲む引用符の追加
など、データの書式設定を適切に行うために必要な文字が追加されます。
Bulk API を使用するときは、プライマリキーチャンクを有効にして、大きいテーブルからデータを抽出すると
きのパフォーマンスを向上させます。プライマリキーチャンクを有効にすると、Bulk API ではレコード ID に
基づいてデータセットがチャンクに分割され、チャンクごとに抽出クエリが作成されます。すべての抽出クエ
リが完了すると、Bulk API はデータを結合します。Salesforce では、カスタムオブジェクトと特定の標準オ
ブジェクトでプライマリキーチャンクがサポートされます。
38
第 6 章: Salesforce でのデータレプリケーションタスク
第 7 章
Salesforce でのデータマスキング
タスク
この章では、以下の項目について説明します。
•
Salesforce でのデータマスキングタスクの概要, 39 ページ
•
リレーション調整ストラテジ, 39 ページ
•
データマスキングでの Salesforce の制限, 43 ページ
•
標準オブジェクトの特殊処理, 44 ページ
•
詳細 Salesforce オプション, 44 ページ
Salesforce でのデータマスキングタスクの概要
データマスキングタスクは、非プロダクション環境用の実際的なテストデータを使用して、ソースデータ内の
機密情報が含まれるフィールドをマスキングします。調整されたオブジェクトリレーションを使用して、機密
情報を含むソースデータのサブセットを作成することを選択できます。
データマスキングタスクを作成するときに、標準オブジェクトを使用して複数のソースオブジェクトを追加で
きます。データマスキングタスクでは、外部 ID、カスタムフィールド、一意のフィールドルックアップが使用
されて、ターゲットの親子オブジェクト間でリレーションが調整されます。ターゲットを設定するときに、外
部 ID を指定してデータをターゲットに書き込むことができます。
データマスキングタスクで複数のソースオブジェクトを選択する場合は、プライマリオブジェクトを選択して、
必要な関連オブジェクトを個別に追加します。連結オブジェクトを使用すると、2 つの Salesforce オブジェク
ト間のリレーションの詳細を保存できます。
データマスキングタスクを実行すると、ターゲット接続名の代わりに、ターゲットのユーザーオブジェクトの
ソース所有者名を入力できます。
リレーション調整ストラテジ
Salesforce では、レコード ID によってレコードを一意に識別し、レコードをその他のレコードと関連付けま
す。Salesforce ではレコード ID を使用して、親子リレーションを調整します。
データマスキングタスクを実行すると、外部 ID、カスタムフィールド、一意のフィールドのいずれかでリレー
ションが調整され、データがターゲットに書き込まれます。Salesforce では、ターゲットデータの挿入や更
新/挿入に、カスタムフィールドルックアップではなく外部 ID を作成して使用することを推奨しています。
39
Salesforce で外部 ID を作成できない場合、データマスキングタスクにより Salesforce にカスタムフィールド
が作成され、ターゲットでルックアップが実行されます。Salesforce で外部 ID またはカスタムフィールドを
作成できない場合、データマスキングタスクで一意のフィールドが作成され、ソースとターゲットでルックア
ップが実行されます。データマスキングタスクで挿入または更新/挿入を行うと、外部 ID フィールドまたはカ
スタムフィールドルックアップによってレコードで親子リレーションが一意に識別されます。
外部 ID フィールド
Salesforce の外部 ID フィールドには、Salesforce 以外のシステムの一意のレコード識別子が付いた外部 ID
属性が含まれます。
データマスキングタスクは、外部 ID を使用してターゲットデータベース内の親子リレーションのオブジェクト
を特定します。Salesforce では、ターゲットデータの挿入や更新/挿入に、カスタムフィールドルックアップ
や一意のフィールドルックアップではなく、外部 ID を作成して使用することを推奨しています。［ターゲット］
タブから外部 ID を作成すると、データマスキングタスクは外部 ID の名前に DMASK_を追加します。データマス
キングタスクで作成した外部 ID は［ターゲット］タブに表示されます。
データマスキングタスクは、設計時にターゲット内に外部 ID 用の追加フィールドを作成します。オブジェクト
に外部 ID が存在する場合、データマスキングタスクは同じ外部 ID を使用します。タスクの実行後に外部 ID を
保持または削除できます。更新/挿入処理を他にも実行する場合は、外部 ID フィールドを保持できます。
カスタムフィールドルックアップ
データマスキングタスクでは、ルックアップベースの調整が親ターゲットオブジェクトで実行され、親レコー
ド ID が取得されます。
外部 ID が存在しない場合、データマスキングタスクにより、同じ名前の Salesforce ターゲットでルックアッ
プを実行するためのカスタムフィールドが作成されます。1 回のカスタムフィールドルックアップにつき、タ
ーゲットで 1 回のルックアップ操作が必要です。
データマスキングタスクでは、次の場合にカスタムフィールドルックアップが実行されます。
•
ターゲットオブジェクトで外部 ID の制限を超えている。
•
ターゲットで一意のフィールドの数が制限を超えている。
一意のフィールドルックアップ
データマスキングタスクは、外部 ID またはカスタムフィールドを作成できないオブジェクトに対して一意のフ
ィールドを使用します。この調整ストラテジは、一意のフィールドを含む標準オブジェクトのためのものです。
オブジェクトに一意のフィールドが存在する場合、タスクは一意のフィールドに基づいてルックアップ操作を
実行します。一意のフィールドルックアップでは、ソースとターゲットで 1 つのルックアップ操作が必要です。
一意のフィールドルックアップストラテジは、次の標準オブジェクトに適用可能です。
40
•
AdditionalNumber
•
Announcement
•
ApexClass
•
ApexComponent
•
ApexPage
•
ApexTrigger
•
Attachment
•
AuthProvider
第 7 章: Salesforce でのデータマスキングタスク
•
BrandTemplate
•
BusinessHours
•
BusinessProcess
•
CallCenter
•
CollaborationGroup
•
ContentDistribution
•
CorsWhitelistEntry
•
Document
•
EmailServicesAddress
•
EmailServicesFunction
•
EmailTemplate
•
EntitlementContact
•
EntitlementTemplate
•
Folder
•
Group
•
Holiday
•
LiveChatTranscriptEvent
•
LiveChatTranscriptSkill
•
LiveChatUserConfigProfile
•
LiveChatUserConfigUser
•
LiveChatVisitor
•
MailmergeTemplate
•
MilestoneType
•
NetworkActivityAudit
•
Note
•
PresenceUserConfigProfile
•
PresenceUserConfigUser
•
QuestionReportAbuse
•
QuestionSubscription
•
QuoteDocument
•
RecordType
•
ReplyReportAbuse
•
SelfServiceUser
•
RecordType
•
StreamingChannel
•
Topic
•
TopicAssignment
•
User
リレーション調整ストラテジ
41
•
UserProvAccount
•
UserProvAccountStaging
•
UserProvMockTarget
•
UserProvisioningLog
•
UserRole
•
WebLink
連結オブジェクト
連結オブジェクトは、2 つの関連オブジェクト間の多対多のリレーションを含んだ Salesforce オブジェクトで
す。
連結オブジェクト内に保存されたリレーションの詳細は、連結リレーションを形成します。多対多のリレーシ
ョンでは、オブジェクト内の各レコードが、もう 1 つのオブジェクト内の複数のレコードにリンクされます。
連結オブジェクトには、2 つのオブジェクト間のすべてのリレーションが保存されます。例えば、
CaseSolution は、Case オブジェクトと Solution オブジェクト間の多対多のリレーションを保存する連結オブ
ジェクトです。Case オブジェクトと Solution オブジェクト間のリレーションは、連結リレーションです。
連結オブジェクトからデータサブセットを作成できます。連結オブジェクトにデータを挿入することができま
す。連結オブジェクトへのデータの更新/挿入はできません。
ターゲットの所有者名
Salesforce では、データマスキングタスクは、ターゲット接続のユーザー名ではなく、ターゲット内のオブジ
ェクトのソース所有者名を追加できます。ターゲットには、同じエイリアスのユーザーが含まれる必要があり
ます。
複数のソースを選択した場合、ユーザーオブジェクトとその他の関連オブジェクトがソースのリストに追加さ
れます。ユーザーオブジェクトは、Salesforce のエイリアスフィールドに基づいてソース所有者名を調整しま
す。ターゲットにソースと同じ所有者名が含まれている場合、データマスキングタスクはターゲットのソース
所有者名を追加します。ターゲットにソースと同じ所有名が含まれていない場合、データマスキングタスクは
デフォルトのターゲット接続名を取り込みます。
複数のユーザーでエイリアス名が同じ場合、データマスキングタスクは任意のユーザーを選択して他のオブジ
ェクトとのリレーションを調整します。
Salesforce Bulk API の制限事項
Salesforce は、Salesforce Bulk API を介して送信または受信できるデータ量を制限しています。
パフォーマンスを向上し、大規模なデータセットの API 要求回数を減らすには、Salesforce Bulk API を使用
します。
バッチ制限
24 時間で最大 5,000 バッチを送信できます。クエリ、書き込み、および削除操作を実行できます。
Bulk API Writer
Bulk API Writer のデフォルトサイズは、1 つのバッチにつき 10,000 行です。タスクは 1 日に最大で
5000*10000（5000 万レコード）を処理できます。Bulk API Writer のバッチサイズを構成するには、Secure
Agent のプロパティを編集します。
42
第 7 章: Salesforce でのデータマスキングタスク
Bulk API Reader
Salesforce Bulk API Reader を使用すると、クエリから最大 15GB のデータを受信できます。クエリが 15GB を
超える場合、データマスキングタスクは失敗します。処理するデータ量が Salesforce の制限を超えていないか
どうかは、手動で計算することができます。
Salesforce Bulk API Reader を介してクエリできるデータ量は、次の式で算出できます。
Sum (the number of bytes in the fields that you want to mask) * (the number of rows in the query results) <
15 GB
Salesforce アプリケーションでオブジェクトのフィールドのサイズを確認し、マスクするフィールドのバイト
数を合計します。Salesforce オブジェクトのクエリ結果から、行の合計数を確認し、式を適用します。結果が
15GB の制限以内の場合、タスクは成功します。結果が 15GB の制限を超える場合、タスクは失敗します。
Salesforce Bulk API の制限事項の例
アカウントオブジェクトに 100 フィールドが含まれており、機密データの 10 フィールドをマスクするとしま
す。マスクする 10 フィールドすべてのサイズの合計は 100 バイトです。アカウントオブジェクトの行の合計
は、500,000 です。
次の式を使用します。
合計クエリサイズ = 100 * 500,000 = 0.05GB
0.05GB は 15GB のデータ制限範囲内であるため、アプリケーションはこのタスクを正常に処理できます。
以下の表に、Salesforce オブジェクトの合計クエリサイズの計算例をいくつか示します。
オブジェクト
クエリ結果内の行数
マスクされるフィー
ルドの合計サイズ
合計クエリサイズ
アカウント
500,000
1,000
0.5GB
担当者
6,000,000
2,000
12GB
リード
8,500,000
2,000
15.8GB
アカウントおよび連絡先オブジェクトの合計クエリサイズは 15GB のデータ制限範囲内であるため、アプリケー
ションはタスクを正常に処理できます。リードオブジェクトの合計クエリサイズは 15GB のデータ制限範囲を超
えるため、アプリケーションはデータを処理できません。リードオブジェクトのクエリを減らすには、水平お
よび垂直のパーティショニングを使用して、複数のデータマスキングタスクを作成します。
水平パーティショニングでは、Salesforce オブジェクト内の行数を分割できます。データフィルタ条件で条件
を指定し、クエリ結果の合計行数を減らします。クローズリードを使用するデータマスキングと、オープンリ
ードを使用するデータマスキングの、2 つのデータマスキングタスクを実行できます。
垂直パーティショニングでは、Salesforce オブジェクト内のフィールド数を分割できます。リードオブジェク
トに対し、1300 バイトのデータを含む 10 個のフィールドをマスクするタスクと、700 バイトのデータを含む 3
個のフィールドをマスクするタスク、2 つのデータマスキングタスクを作成できます。
データマスキングでの Salesforce の制限
Salesforce には、データマスキングタスクに対する次の制限があります。
•
TextArea および TextEncrypted フィールドタイプにフィルタを適用することはできません。
データマスキングでの Salesforce の制限
43
•
Salesforce のクエリのサイズには、20,000 文字という制限があります。ソースまたはターゲットプロファ
イルを構成してフィールドを非表示にし、オブジェクト内のフィールド数を減らすことができます。
•
Salesforce ユーザーアカウントに、外部 ID フィールドに対する作成または更新権限がない場合、更新/挿
入操作を行うことはできません。
•
データマスキングタスクは、ユーザー、UserLicense、プロファイル、コミュニティ、およびグループオブ
ジェクトをサポートしません。
標準オブジェクトの特殊処理
次の標準オブジェクトでは、特殊処理が必要です。
Pricebook2
組織ごとに、変更できない標準 Pricebook オブジェクトが含まれます。ソースに Pricebook2 オブジェクトが
含まれる場合、タスクでターゲットに外部 ID が生成された後、タスクを実行する前に Pricebook2 オブジェク
ト ID をターゲットの対応する外部 ID フィールドにコピーする必要があります。
RecordTypes
個々のオブジェクトのプロファイルレベルで有効にした場合、RecordTypes オブジェクトを選択できます。タ
スクを実行する前に、ターゲットプロファイルで必要な RecordTypes を有効にします。
詳細 Salesforce オプション
Salesforce オブジェクトの詳細オプションを表示および設定できます。
Salesforce オブジェクトについて、次の詳細オプションを設定します。
ルールとトリガの無効化
タスクを実行する前に、ターゲットの Salesforce のルールとトリガをすべて無効にできます。ターゲッ
トデータのロード速度を向上させるには、ルールとトリガを無効にします。
Salesforce ターゲットには、Salesforce オブジェクト用に設定されたトリガ、検証ルール、ワークフロ
ールールが含まれる場合があります。マスキングルールを適用した後でタスクを実行すると、マスクされ
たデータがターゲットで定義されたルールまたはトリガを満たさない場合があります。このタスクでは、
レコードをターゲットに挿入できず、行がエラーになります。このようなエラーが発生しないようにする
には、ターゲットの Salesforce のルールとトリガをすべて無効にしてからタスクを実行します。タスク
が完了すると、タスクにより、すべての Salesforce のトリガおよびルールが前の状態にリストアされま
す。
Salesforce 管理対象パッケージにルールとトリガが含まれる場合、データマスキングタスクでルールとト
リガを無効にすることはできません。
Bulk API の使用
Salesforce Bulk API を使用して、大量のデータを含むバッチファイルを Salesforce ターゲットにロード
します。デフォルトでは、アプリケーションで Salesforce 標準 API が使用されます。Salesforce 標準
API の場合、データの各バッチには最大 200 行を含めることができます。Salesforce Bulk API では、デ
ータの各バッチに最大 10000 行を含めることができます。このオプションを選択すると、アプリケーショ
ンにより Salesforce Bulk API ジョブが監視されます。
44
第 7 章: Salesforce でのデータマスキングタスク
プライマリキーチャンクの有効化
大きなテーブルからデータを抽出するときは、プライマリキーチャンクを有効にしてパフォーマンスを向
上させます。接続の API バージョンが 32.0 以降である場合は、プライマリキーチャンクを使用します。
Bulk API を使用してデータを Salesforce から抽出するときに、プライマリキーチャンクを有効にするこ
とができます。デフォルトでは、Bulk API ではプライマリキーチャンクは使用されません。Salesforce
では、1 回の一括クエリでクエリできるデータのサイズが 15 GB に制限されています。Salesforce では 1
つのクエリを 15 回再試行でき、その後、そのクエリはキャンセルされます。
プライマリキーチャンクを有効にすると、Bulk API ではレコード ID に基づいてデータセットが複数のチ
ャンクに分割され、チャンクごとに抽出クエリが作成されます。すべての抽出クエリが完了すると、Bulk
API によってデータが組み合わせられます。
プライマリキーチャンクサイズの有効化
チャンクのレコードの数。［プライマリキーチャンクの有効化］を選択した場合のみ適用できます。
チャンクサイズを指定できます。デフォルトは 100,000 です。最大値は 250,000 です。
詳細 Salesforce オプション
45
第 8 章
共通設定
この章では、以下の項目について説明します。
•
共通設定の概要, 46 ページ
•
関連する Salesforce オブジェクトの ID, 46 ページ
•
オブジェクト検索および選択, 47 ページ
•
ビジネス名の表示, 47 ページ
•
データフィルタ, 48 ページ
•
Salesforce 送信メッセージによるタスクの開始, 49 ページ
共通設定の概要
複数のタスクタイプに共通する、次の設定手順を実施できます。
•
カスタム外部 ID の作成
•
オブジェクトの検索
•
ビジネス名の表示
•
データフィルタの作成
•
Salesforce アウトバウンドメッセージによるタスクの開始
関連する Salesforce オブジェクトの ID
Informatica Cloud では、次のタイプの ID のいずれかに基づいて、Salesforce オブジェクトのレコードを識
別します。
46
•
Salesforce ID
Salesforce は、Salesforce オブジェクトの新しいレコードごとに ID を生成します。
•
外部 ID
Salesforce オブジェクトでは、オブジェクト内のレコードを識別するために、カスタム外部 ID フィールド
を作成できます。外部 ID は、サードパーティアプリケーションで生成された ID を使用して、Salesforce
オブジェクトのレコードを識別するために使用することができます。1 つまたは複数の外部 ID を使用して、
各 Salesforce オブジェクトのレコードを一意に識別できます。
Salesforce のターゲットに書き込むデータ同期タスクを作成する場合は、ソースから、Salesforce ターゲッ
トオブジェクトおよび関連オブジェクト（存在する場合）のレコードに対する Salesforce ID または外部 ID
を提供する必要があります。関連オブジェクトは、Salesforce で定義されたリレーションに基づいて他のオブ
ジェクトに関連付られたオブジェクトです。データ同期タスクは、Salesforce ID または外部 ID を使用して関
連オブジェクトへの変更を更新します。
タスク内のソースに Salesforce オブジェクト用の外部 ID が含まれている場合、タスクの Salesforce ターゲ
ットを作成するときに外部 ID を指定する必要があります。外部 ID を指定しない場合、各関連オブジェクト内
のレコードの識別に Salesforce ID が要求されます。
Salesforce 外部 ID の作成と使用の詳細については、Informatica Cloud コミュニティの記事
『Using External IDs and Related Objects in Informatica Cloud』を参照してください。
オブジェクト検索および選択
Salesforce 接続で、使用する 1 つまたは複数のオブジェクトを検索できます。マッピングおよびタスクのウィ
ザードでオブジェクトを検索できます。
Salesforce 接続を使用するときに、次の検索パラメータを選択できます。
•
名前
•
ラベル
ビジネス名の表示
Salesforce 接続では、以下のタスクタイプのフィールド名にビジネス名が表示されます。［ラベルの代わりに
フィールドの技術名を表示］オプションを使用して、ビジネス名の代わりに技術名を表示するようにタスクを
設定できます。
Salesforce 接続では、次のタスクタイプでフィールド名にビジネス名が表示されます。
•
データ同期
•
データレプリケーション
•
データマスキング
•
データアセスメント
•
連絡先検証
•
マッピング設定
Salesforce 接続を使用する場合、データ同期、連絡先検証、およびマッピング設定タスクでも、オブジェクト
のビジネス名が表示されます（ある場合）。その他のタスクタイプでは、オブジェクトの技術名が表示されま
す。
オブジェクト検索および選択
47
データフィルタ
Salesforce 接続を使用するときに、任意のタスクタイプに対して次のタイプのデータフィルタを作成できま
す。
•
•
簡易
1 つまたは複数の簡易データフィルタを作成します。複数の簡易データフィルタを作成した場合、関連する
タスクでは各フィルタ間に AND 演算子が作成され、すべての簡易データフィルタに当てはまる行がロードさ
れます。例えば、取引先の Salesforce オブジェクトの行を、データベーステーブルにロードする場合を考
えます。年間売上が$100,000 以上で、従業員数が 500 を超える取引先のみをロードするとします。この場
合、簡易データフィルタを次のように設定します。
フィールド
演算子
フィールド値
AnnualRevenue
以上
100000
NumberOfEmployees
より大きい
500
詳細
AND、OR、またはネストされた条件を使用する複雑な式を作るには、詳細データフィルタを作成します。す
べてのフィルタを含めた 1 つの式を入力します。入力した式は、ソースからレコードを取得するために使用
されるクエリ内の WHERE 句になります。
例えば、取引先の Salesforce オブジェクトの行を、データベーステーブルにロードする場合を考えます。
請求先の州がカリフォルニアまたはニューヨークで、年間売上が$100,000 以上のレコードをロードすると
します。この場合、詳細フィルタの式を次のように設定します。
(BillingState = 'CA' OR BillingState = 'NY') AND (AnnualRevenue >= 100000)
Salesforce オブジェクトにデータフィルタを作成すると、対応するタスクによって、WHERE 句を含む SOQL
クエリが生成されます。この WHERE 句はデータフィルタを表します。SOQL クエリの文字数は、20,000 字よ
り少なくする必要があります。クエリの文字制限を超過すると、次のエラーが表示されます。
Salesforce SOQL limit of 5000 characters has been exceeded for the object: <Salesforce object>.
Please exclude more fields or decrease the filters.
データレプリケーションタスクまたはデータ同期タスクに含まれるオブジェクトごとに、データフィルタのセ
ットを作成できます。データフィルタの各セットは、互いに独立して動作します。簡易および詳細のデータフ
ィルタの条件で、次のデータフィルタ変数を使用できます。
•
$LastRunDate
•
$LastRunTime
注: 複数のタイムゾーンにまたがる日付を比較する場合は、タイムゾーンの違いを考慮します。$LastRunDate
変数と$LastRunTime 変数の日付と時間は、Informatica Cloud Salesforce アプリケーションに設定されてい
るタイムゾーンに基づいています。実際のジョブの日付と時間は、Salesforce ソースの GMT タイムゾーンに基
づいています。
データフィルタのルールおよびガイドライン
Salesforce コネクタタスクのデータフィルタについては、次のルールおよびガイドラインを考慮します。
48
•
簡易データフィルタのフィールドのリストには、LongTextArea データ型の Salesforce フィールドが表示さ
れません。
•
URL データ型の Salesforce フィールドを含める際に、値に「http:// 」を含めないようにします。例えば、
値が http://www.informatica.com の場合は、www.informatica.com と入力します。
第 8 章: 共通設定
•
Phone データ型の Salesforce フィールドを含める場合は、値を(XXX) XXX-XXXX の構文で入力します。例え
ば、(555) 555-1212 と入力します。指定した構文が正しくないと、アプリケーションはこのフィルタを無
視します。
•
フィルタに Salesforce ID のフィールドを含める際に、ID の値を正確に指定します。ダミーの ID 値を入力
すると、SOQL クエリは失敗します。
•
データ同期タスクで Salesforce データをデータベースターゲットに書き込むときは、Salesforce データの
日時データ型が、Date (yyyy-MM-dd)および DateTime (yyyy-MM-dd HH:mm:ss)という必須形式に従ってい
ることを確認してください。
レコードに含まれる日時の形式が正しくないと、その行はアプリケーションによって拒否されます。
Salesforce ソースの日時データ型に日付が含まれていて時刻が含まれていない場合、アプリケーションで
は日付値の末尾に「00:00:00」が付加され、値が必須形式になります。
データベースターゲットに書き込むとき、アプリケーションでは、Salesforce の日付データと日時データ
が、データベースによって期待される正しい形式に変換されます。
Salesforce 送信メッセージによるタスクの開始
Salesforce 送信メッセージを受信したときに動作を開始するように、データ同期タスクまたはマッピング設定
タスクを設定できます。
データ同期タスクには単一の Salesforce ソースを組み込む必要があり、行の制限またはデータフィルタを組み
込むことはできません。
Salesforce メッセージを受信したときに動作を開始するようにタスクを設定すると、タスクウィザードによっ
てエンドポイント URL が生成されます。Salesforce では、エンドポイント URL を使用して、Salesforce が
Informatica Cloud にメッセージを送信するようにワークフロールールを設定します。
タスクがタイムアウトするタイミングを決定できます。タイムアウトは、タスクは非アクティブになるが、ま
だメッセージを受信できる時間の長さです。この期間にメッセージが受信されると、時間はリセットされます。
タイムアウトの長さを延ばすと、タスクは継続して実行され、いつでもメッセージを処理することができます。
デフォルトのタイムアウトは 60 秒です。
Salesforce が送信メッセージを送信すると動作を開始するようにタスクを設定するには、次の手順を実行しま
す。
1.
Informatica Cloud のウィザードで、タスクの単一の Salesforce ソースを選択します。
Salesforce からの送信メッセージを受信すると直ちに動作を開始するようにタスクを設定し、エンドポイ
ント URL をコピーします。
必要に応じて、タスクのタイムアウトオプションを選択します。
2.
Salesforce でワークフロールールを作成して、ワークフローアクションの送信メッセージを追加します。
タスクウィザードで、エンドポイント URL を使用して Salesforce 送信メッセージを設定し、タスクに送
信するフィールドを選択します。
注: タスクウィザードで URL をコピーしなかった場合は、タスクの詳細ページでエンドポイント URL を確
認できます。
タスクをアクティブにします。
Salesforce での送信メッセージの設定の詳細については、Informatica Cloud コミュニティの記
事"Real Time Data Synchronization Through Salesforce Outbound Messages"を参照してください。
Salesforce 送信メッセージによるタスクの開始
49
第 9 章
トラブルシューティング
この章では、以下の項目について説明します。
•
トラブルシューティングの概要, 50 ページ
•
Salesforce 接続のトラブルシューティング, 50 ページ
•
Salesforce データ同期タスクのトラブルシューティング, 51 ページ
•
データ評価タスクのトラブルシューティング, 52 ページ
•
データレプリケーションタスクのトラブルシューティング, 52 ページ
トラブルシューティングの概要
次のセクションを使用して Salesforce コネクタのエラーをトラブルシューティングします。代表的なエラーメ
ッセージとソリューションの一覧については、Informatica Cloud コミュニティの記
事"Troubleshooting: Common Error Messages"を参照してください。
Salesforce 接続のトラブルシューティング
次に示す状況に対する解決方法は、Salesforce 接続のトラブルシューティングで役に立つことがあります。
Salesforce アカウントへの接続に失敗します。
Salesforce 接続の詳細で Salesforce セキュリティトークンを入力する必要がある場合があります。セキ
ュリティトークンが必要で、Salesforce 接続のセキュリティトークンフィールドが空か無効な場合は、接
続をテストまたは作成するときに次のエラーメッセージが表示されます。
The login to Salesforce.com failed with the following message - LOGIN_MUST_USE_SECURITY_TOKEN:
Salesforce Web サイトへ移動してセキュリティトークンを取得します。接続の詳細にセキュリティトーク
ンを追加せずに済むようにするには、自分の Salesforce アカウントの［信頼済み IP 範囲］に
Informatica Cloud の IP アドレスを追加します。詳細については、「セキュリティトークンと信頼済み IP
範囲」 (ページ 13)を参照してください。Informatica How-To ライブラリの記事、「Activating IP
Addresses for Salesforce Connections」に追加情報が掲載されています。
50
Salesforce データ同期タスクのトラブルシューティ
ング
次に示す状況に対する解決方法は、Salesforce データ同期タスクのトラブルシューティングで役に立つことが
あります。
データ同期タスクが失敗します。
フラットファイルから Salesforce オブジェクトにデータを書き込むタスクを実行しようとしましたが、
フラットファイルの外部 ID フィールドの 1 つが関連する Salesforce オブジェクト内で見つかりませんで
した。この場合、タスクは次のエラーで失敗します。
[Salesforce object name] : Error received from salesforce.com. Fields []. Status code [INVALID_FIELD].
Message [Foreign key external ID: not found for field <field name> in entity <source object>].
これを解決するには、Salesforce にその外部 ID 値が存在することを確認します。
アウトバウンドメッセージを受信するとリアルタイムで実行するように設定されているデータ同期タスクが失
敗し、次のメッセージが表示されます。
The buffer [] returned from outbound message queue [] is corrupt.
この問題が発生し得る状況と可能なアクションを次の表に示します。
ケース
推奨アクション
アウトバウンドメッセージによって送
信されたフィールドが、タスクで使用
されているソースフィールドと一致し
ません。
アウトバウンドメッセージによって送信された
フィールドが、タスクで使用されているソース
フィールドと一致するように、アウトバウンド
メッセージを更新するかまたはタスクを更新し
ます。
タスクを設定した後に、フィールドの
精度やデータ型などのソースメタデー
タが変更されています。
タスクを更新します。タスク内のソースメタデ
ータを更新するには、フィールドマッピングペ
ージで、［フィールドの更新］をクリックしま
す。
エラーが解決しない場合は、ランタイム環境に対して次のカスタム設定プロパティを指定することでこの
問題を解決できます。
•
Type: Tomcat, Name: InfaAgent.MaxTotalBytesQueued, Value: <大きな数値（MB 単位）>
•
Type: Tomcat JRE, Name: INFA_MEMORY, Value: -Xmx<大きな数値>
•
Type: Tomcat, Name: InfaAgent.OutboundMessageIdDuplicateTimePeriod, Value: <大きな数値（ミ
リ秒）>
例:
•
Type: Tomcat, Name: InfaAgent.MaxTotalBytesQueued, Value:256
•
Type: Tomcat JRE, Name: INFA_MEMORY, Value: -Xmx1g
•
Type: Tomcat, Name: InfaAgent.OutboundMessageIdDuplicateTimePeriod, Value: 60000
アウトバウンドメッセージを受信したときに開始するタスクの設定の詳細については、「Salesforce 送信
メッセージによるタスクの開始」 (ページ 49)を参照してください。Secure Agent カスタムプロパティ
の設定の詳細については、「 Secure Agent のプロパティ」 (ページ 12)を参照してください。
Salesforce データ同期タスクのトラブルシューティング
51
データ評価タスクのトラブルシューティング
次に示す状況に対する解決方法は、Salesforce データ評価タスクのトラブルシューティングで役に立つことが
あります。
特定の Salesforce オブジェクトの品質メトリックを追加できません。
一部の品質メトリックは、すべての Salesforce オブジェクトには適用できません。例えば、アドレス検
証品質メトリックを商談オブジェクトのデータ評価タスクに含めることはできません。商談オブジェクト
にはアドレスフィールドが含まれていません。
データレプリケーションタスクのトラブルシューテ
ィング
次に示す状況に対する解決方法は、Salesforce データレプリケーションタスクのトラブルシューティングで役
に立つことがあります。
レプリケートに使用可能なオブジェクトのリストで Salesforce の UserRecordAccess または UserProfileFeed
オブジェクトが見つかりません。また、これらのオブジェクトを含む既存のタスクを実行できません。
データレプリケーションタスクは次の Salesforce オブジェクトをレプリケートしません。
•
ContentDocumentLink
•
FeedComment
•
FeedItem
•
UserProfileFeed
•
UserRecordAccess
•
Vote
以前のバージョンの Informatica Cloud のデータレプリケーションタスクにこれらのオブジェクトが含ま
れている場合、データレプリケーションタスクはタスクを実行しません。タスクが実行されるようにする
には、タスクからオブジェクトを削除します。
データレプリケーションタスクを実行しましたが、想定される時間内に結果を得られませんでした。
Salesforce サーバーが停止しているか、またはアクセスが集中しています。
データレプリケーションタスクが失敗したのはなぜですか?
データレプリケーションタスクは次の理由で失敗することがあります。
•
Salesforce フィールドのデータ型、精度、またはスケールが変更された後で増分ロードを実行した。
これらの変更後に Salesforce データをレプリケートするには、完全なロードを実行するようにデータ
レプリケーションタスクを設定します。
高精度データがある Salesforce 計算フィールドを含むタスクでは、切り捨てエラーが発生して失敗します。
タスクの高精度計算を有効にすると、28 桁まで計算フィールドのデータを処理できます。
52
第 9 章: トラブルシューティング
付録 A
データ型リファレンス
この付録では、以下の項目について説明します。
•
データ型リファレンスの概要, 53 ページ
•
Salesforce のデータ型とトランスフォーメーションのデータ型, 54 ページ
データ型リファレンスの概要
Informatica Cloud では、Salesforce を使用したマッピング、データ同期タスク、データレプリケーションタ
スク、データマスキングタスク、およびマッピング設定タスクで、次のデータ型が使用されます。
•
Salesforce ネイティブデータ型
Salesforce のデータ型は、フィールドのメタデータを編集するときに、ソースおよびターゲットトランス
フォーメーションに表示されます。
•
トランスフォーメーションデータ型
トランスフォーメーションデータ型は、トランスフォーメーションに表示されるデータ型のセットです。ト
ランスフォーメーションデータ型は、ANSI SQL-92 標準データ型に基づく内部データ型であり、
Informatica Cloud はこれらを使用して、プラットフォーム間でデータを移動します。マッピング、データ
同期タスク、データレプリケーションタスク、データマスキングタスク、およびマッピング設定タスクのす
べてのトランスフォーメーションに、トランスフォーメーションデータ型が表示されます。
Informatica Cloud は、ソースデータを読み取るときに、ネイティブデータ型を対応するトランスフォーメ
ーションデータ型に変換してからデータのトランスフォーメーションを実行します。Informatica Cloud
は、ターゲットに書き込むときに、トランスフォーメーションデータ型を対応するネイティブデータ型に変
換します。
53
Salesforce のデータ型とトランスフォーメーション
のデータ型
次の表に、Informatica Cloud でサポートされる Salesforce のデータ型、およびそれに対応するトランスフォ
ーメーションのデータ型を示します。
54
Salesforce のデータ型
トランスフ
ォーメーシ
ョンデータ
型
説明
AnyType
String
String、Picklist、Reference、Boolean、
Currency、Integer、Double、Percent、ID、
Date、Datetime、URL、Email データを返す、
多形性データタイプ。
Base64
String
Base64 エンコードバイナリデータ。
Boolean
Integer
ブール（true/false）値。
Combobox
String
列挙値。
Currency
Decimal
通貨の値。
DataCategoryGroupReference
String
カテゴリグループの種類および一意のカテゴリ
名。
Date
Date/Time
日付の値。
DateTime
Date/Time
日付と時刻の値。
Double
Decimal
倍精度浮動小数点の値。
Email
String
電子メールアドレス
Encrypted String
String
暗号化されたテキストフィールドには、暗号化
された形式で保存されている文字、数字、また
は記号の組み合わせが含まれます。
ID
String
Salesforce オブジェクトのプライマリキーフ
ィールド。
Int
Integer
このタイプのフィールドには、小数部のない数
値が含まれます。
JunctionIdList
String
基になる連結エンティティの多対多リレーショ
ンを表す参照 ID 値の文字列配列。文字列配列
のクエリと操作を行い、1 回の API 呼び出しで
基になる連結エンティティのクエリと操作を行
います。
注: このフィールドタイプは、V34.0 API 以降
から使用できます。
Location
Decimal
複合データ型であり、位置情報フィールドの緯
度と経度の値（倍精度浮動小数点型）が含まれ
ます。
付録 A: データ型リファレンス
Salesforce のデータ型
トランスフ
ォーメーシ
ョンデータ
型
説明
Master record
String
マージされたレコードの ID。
Multipicklist
String
複数選択の候補リスト。列挙された値から複数
の値を選択することが可能。
Percent
Decimal
パーセント値。
Phone
String
電話番号。
Picklist
String
単一選択の候補リスト。列挙された値から 1 つ
の値を選択することが可能。
Reference
String
別の Salesforce オブジェクトに対する相互参
照。
String
String
文字列。
Textarea
String
複数行テキストフィールドとして表示される文
字列。
Time
Date/Time
時間の値。
URL
String
URL 値。
Salesforce のデータ型とトランスフォーメーションのデータ型
55
索引
接続
Salesforce 14
接続の概要 13
I
ID
オブジェクトのタイプ 46
S
Salesforce
アーカイブ済みおよび削除済みデータをデータ同期タスクに含める
16
セキュリティトークンまたは信頼済み IP 範囲の設定 13
接続プロパティ 14
送信メッセージによるタスクの開始 49
ファイアウォール設定 11
Salesforce API
バージョン 14
Salesforce コネクタ
コネクタの概要 9
コネクタの例 10
タスクタイプおよびオブジェクトタイプ 10
Salesforce の ID
オブジェクトの 46
か
外部 ID
関連する Salesforce オブジェクト用 46
管理
Hosted Agent 12
ライセンスタイプ 11
関連オブジェクト
外部 ID の設定 46
関連オブジェクトに対する NULL 更新 22
き
共通設定
概要 46
データフィルタ 48
ビジネス名の表示 47
し
信頼済み IP 範囲
設定 13
せ
セキュリティトークン
設定 13
56
そ
送信メッセージ
Salesforce から、タスクの開始 49
て
データ型リファレンス
Salesforce とトランスフォーメーションのデータ型 54
概要 53
データ同期タスク
Bulk API 20
Salesforce ソース 15
Salesforce ターゲット 16
アーカイブ済みおよび削除済み Salesforce データを含める 16
更新/挿入タスク操作 17
詳細オプション 18
シリアルモードの有効化 21
前提条件 15
標準 API 19
フィールドマッピング 18
物理削除 21
プライマリキーチャンクの有効化 21
データマスキング
詳細 Salesforce オプション 44
プライマリキーチャンク 44
データマスキングタスク
Pricebook2 44
RecordTypes 44
Salesforce の制限 43
概要 39
リレーション調整ストラテジ
カスタムフィールドルックアップ 40
ターゲットの所有者名 42
連結オブジェクト 42
データレプリケーションタスク
Salesforce ソース 34
概要 31
設定
Salesforce API 38
Salesforce Base64 エンコードボディサイズ 38
高精度計算 37
ソースとターゲットの不一致の処理
AutoAlterColumnType プロパティ 36
データベースターゲットのリセット 35
ロードタイプ
完全なロード 33
増分ロード 33
ふ
ファイアウォール
Salesforce のための設定 11
フラットタイルターゲット
送信メッセージタスクでのトランケート 49
ま
マッピング
Salesforce ソース 23
Salesforce ターゲット 24
Salesforce ルックアップ 26
オブジェクト 23
マッピング設定タスク
Salesforce ソース 26
マッピング設定タスク (続く)
Salesforce ターゲット 28
Salesforce ルックアップ 30
オブジェクト 26
る
ルールおよびガイドライン
Salesforce ソース 16
Salesforce ターゲット 17
増分ロードの実行 34
データレプリケーションタスクの設定 37
データレプリケーションのソースとターゲット 36
索引
57

Download Report