Salesforce (SFDC)データベース - インポート

ブリッジの仕様

ベンダー	Salesforce
ツール名	データベース
ツールバージョン	Winter'18 (API v41.0)〜最新バージョン
ツールのWebサイト	http://www.salesforce.com/
サポートされている方法論	[リレーショナルデータベース] データストア(物理データモデル) REST API経由の
データプロファイリング
増分収集
マルチモデル収集
モデル選択のためのリモートリポジトリーの参照

仕様
ツール: REST API経由の Salesforce / DatabaseのWinter'18 (API v41.0)～最新バージョン
http://www.salesforce.com/をご覧ください。
メタデータ: [リレーショナルデータベース] データストア(物理データモデル)
コンポーネント: SalesForceObjectsバージョン11.2.0

免責事項
このインポートブリッジでは、インターネットに接続して次のサードパーティライブラリーをダウンロードする必要があります:
- オープンソースのサードパーティライブラリーをダウンロードする場合はhttps://repo.maven.apache.org/maven2/など
- その他のサードパーティソフトウェア(データベース特定のJDBCドライバーなど)は該当するサイトへ

ダウンロードされたサードパーティライブラリーは、$HOME/data/download/MIMB/に格納されています。
HTTPSが失敗した場合、インポートブリッジはHTTPを試します。
- インターネットへのアクセスにプロキシを使用している場合は、JREでそのプロキシを設定する必要があります(Miscellaneousパラメーターで -j オプションをご覧ください。)。
- インポートブリッジではインターネットにフルにアクセスできない場合は、インターネットアクセスがある別のサーバーから$HOME/data/download/MIMB/ディレクトリーをコピーします。$HOME/bin/MIMB.sh (または.bat) -dというコマンドを使えば、すべてのブリッジで使用される全サードパーティライブラリーを一度にダウンロードできます。

このインポートブリッジを実行すると、ライセンス規約の責任、およびダウンロードしたサードパーティソフトウェアライブラリーによって生じる潜在的なセキュリティの脆弱性を受け入れることになります。

概要
このインポートブリッジは、コンシューマーを認証し、利用可能な物理メタデータ(テーブルなど)を取得します。コンシューマーが既にユーザーの認証情報を持っていると仮定するユーザー名 - パスワード認証フローを利用します。

要件
ユーザーがSalesforceドキュメントを送信する場合は、特定のセキュリティ設定を指定し、標準オブジェクトとカスタムオブジェクトでこのアクセスを許可する必要があります。
権限の設定方法:
- Salesforce内で[セットアップ]をクリックし、[ユーザーの管理]をクリックします
- [ユーザーの管理]ツリーの下で[プロファイル]をクリックします。
- [プロファイル]が右側に表示されたら、編集するプロファイルを選択し、対応するプロファイルの横にある[編集]リンクをクリックします。

標準オブジェクト: [ドキュメント]セクションで[読み取り]権限が選択されていることを確認します。
カスタムオブジェクト: 各カスタムオブジェクトに読み取り権限が選択されていることを確認します。

APIバージョン: This bridge supports any バージョンs of Salesforce from Winter'18 バージョン (API v41.0) to the latest バージョン such as Spring'23 (API v57.0).
This bridge will automatically detect the API バージョン <MajorInt>.<MinorInt> of the Saleforce Server to make the following requests:
- 'Describe Global' URI: /v<MajorInt>.<MinorInt>/sobjects/
- 'sObject Basic Information' URI: /v<MajorInt>.<MinorInt>/sobjects/sObject/
- 'SOQL Query' URI: /v<MajorInt>.<MinorInt>/query?
Note the above automatic バージョン detection can be overwritten for forcing a specific バージョン using the option -api.バージョン in the Miscellaneous parameter.

OAuth認証の設定方法:
- Salesforce Administrativeコンソール内に"Manage Connected Apps"を作成します
次のようにプロパティを設定します:
- OAuth設定を有効にします
- [Available OAuth Scopes]で、[Provide access to your data via Web (Web)]を選択します
MM/MIMBで:
-「コンシューマーキー」と「コンシューマーシークレット」を指定します
- Miscellaneousパラメーターで"-access_token"を指定します。これを指定すると、ブリッジはインポート前にアクセストークンを取得しようとはせず、提供されたものを使用します。

OAuth 2.0 JWT Bearerフローを設定する場合:
- Javaユーティリティのキーツールを使ってキーペアを生成します。エントリーの名前をSalesforceにします。例:
%JAVA_HOME%\bin\keytool -genkeypair -keystore %JAVA_HOME%\lib\security\cacerts -storepass *specify JKS password* -storetype PKCS12 -alias Salesforce -keyalg RSA -keysize 2048 -dname "CN=Salesforce.Import.Bridge@metaintegration.info, OU=Poltava, O=Metaintegration, L=SanJose, ST=CA, C=US" -validity 365

- 生成されたキーペアを証明書ファイルとしてエクスポートします。例:
%JAVA_HOME%\bin\keytool -exportcert -keystore %JAVA_HOME%\lib\security\cacerts -storepass *specify JKS password* -alias Salesforce -file Salesforce.crt -rfc

- 生成されたシークレットキーのPEMファイルであるSalesforce.pemをエクスポートします。例:
openssl pkcs12 -in KeyStore.jks.p12 -nocerts -nodes -out Salesforce.pem
- ファイルのコンテンツが適切であることを確認します。例:
キー属性: <属性なし>
-----BEGIN PRIVATE KEY-----
MIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAAoIBAQCqtbOsYWiJXTrU
bHUnLvNH5Kieuer3RGSrogiWv2fLjQGXbHWSDjMbCFVU72T3+hT7uyKgfwA8P9V1
...
EioPeaQkpfOkdqNLEf9aZQ==
-----END PRIVATE KEY-----
- このファイルのコンテンツは、「コンシューマーシークレット」ブリッジパラメーターで指定します。

-Salesforce管理コンソールで、「接続済みアプリ」を作成します
プロパティを次のように設定します:
- OAuth設定を有効にします
- [デジタル書名を使用]を有効にし、生成された証明書をアップロードします。

[Available OAuth Scopes]で:
- [Provide access to your data via Web (Web)]を選択します
- [Perform requests at any time (refresh_token, offline_access)]を選択します

[OAuth Policies]で:
- [Admin approved users are pre-authorized]を指定します

[Profiles]で:
- 必須のプロファイルを指定します

このフローを利用する場合は、必須である「ユーザー」を指定し、「パスワード」を空にします。

よくある質問
該当なし

制限事項
現在判明している一般的な制限事項は、https://metaintegration.com/Products/MIMB/Help/#!Documents/mimbknownlimitations.htmlをご覧ください。
3番目のカラムにある[Description]というフィールドはSalesforce APIによって省略され、その結果、どのプロファイルの下にも表示されません。

サポート
トラブルシューティングパッケージを次の項目と共に提供してください:
- デバッグログ(UIまたはconf/conf.propertiesでMIR_LOG_LEVEL=6を使って設定可能)
- 利用できる場合はメタデータバックアップ(技術的理由によりこの共通オプションが実装されていないブリッジがあるものの、Miscellaneousパラメーターで-backupオプションを使って設定可能)

- SalesForce access_tokenの取得方法:
curl https://*your SalesForce instance URL* -d "grant_type=password" -d "client_id=*your SalesForce Client ID*" -d "client_secret=*your secret*" -d "username=*your SalesForce username*" -d "password=*your SalesForce password*" -H "X-PrettyPrint: 1"

ユーザー名/パスワードの認証パラメーター値を持っていなくても、アクセストークンとSalesforceインスタンスのURLを持っている場合は、Miscellaneousパラメーターを使用して指定できます(詳細はその説明を参照してください)。この場合は依然として、無視されるテキストをすべての必須パラメーターに入力する必要があります。

ブリッジパラメーター

ブリッジのマッピング

マッピング情報は利用できません