SAP Business Suite 4 HANA (S/4HANA)、ECC、R/3 ERP - インポート
ブリッジの要件
このブリッジ:そのSDKにアクセスするためにはツールのインストールが必要です。
ブリッジの仕様
| ベンダー | SAP |
| ツール名 | Business Suite 4 HANA (S/4HANA)、ECC、R/3 ERP |
| ツールバージョン | ECC 6.0 / NetWeaver 7.x |
| ツールのWebサイト | https://www.sap.com/products/erp.html (英語のみ) |
| サポートされている方法論 | [ビジネスアプリケーション] データストア(物理データモデル、論理データモデル) via JCO API |
| データプロファイリング |  |
| 増分収集 | |
| マルチモデル収集 | |
| モデル選択のためのリモートリポジトリーの参照 |  |
仕様
ツール: JCO API経由のSAP / Business Suite 4 HANA (S/4HANA)、ECC、R/3 ERPバージョンECC 6.0 / NetWeaver 7.x
https://www.sap.com/products/erp.htmlをご覧ください
メタデータ: [ビジネスアプリケーション] データストア(物理データモデル、論理データモデル)
コンポーネント: SapR3バージョン11.2.0
概要
このインポートブリッジは、SAP ECC ABAPディクショナリーからメタデータをインポートします。
要件
このインポートブリッジは、SAP Java Connector (JCo) APIライブラリーに依存して接続とメタデータを取得します。したがって、このインポートブリッジを実行するマシンではJCoライブラリーが利用可能であることが必要です。
APIはネットワーク経由でSAPサーバーと通信します。また、以下のサーバーポートが使用できます:
* ディスパッチャーポート: SAP GUIがWindowsおよびJavaに使用する32NN
* ゲートウェイポート: CPICおよびRFCの通信に使用される33NN
* SNCセキュアゲートウェイポート: CPICおよびRFCの暗号化された通信に使用される48NN
(NNは00から99までのSAPインスタンス番号)。
ファイアウォールがこれらのポートでの通信を許可するように設定されていることを確認します。
このインポートブリッジを使用する前に、ABAP RFC関数モジュールをデプロイしてSAP ECCサーバーを設定する必要があります。
SAPサーバーにRFC FunctionModuleを作成するためには、ABAP開発者アカウントが必要です。
このモジュールはインポートブリッジからのクエリーに応答し、必要なメタデータを取得します。
Supplemental documentation is available explaining how to deploy the RFC function module on the server at:
<InstallDir>/conf/MIRModelBridgeTemplate/SapR3/
The user account requires sufficient permissions to connect to the SAP server and execute the following RFC function modules:
* STFC_CONNECTION (check connectivity)
* RFC_SYSTEM_INFO (check system information)
* OCS_GET_INSTALLED_COMPS (check software バージョンs)
* Z_MITI_DOWNLOAD (main metadata import)
The SAP Java Connector (JCo) libraries may call additional RFC function modules (RFC_PING, RFC_METADATA_GET, ...).
詳細は、サポートノート460089 https://launchpad.support.sap.com/#/notes/460089
よくある質問
Q: SAPサーバーは低速になる場合があります。オフラインでの作業は可能ですか?
メタデータをSAPサーバーから取得する処理は、メタデータのボリューム、SAPサーバーのワークロード、SAPサーバーとローカルマシンの間のネットワークの速度に応じて、数時間を要する場合があります。
- Miscellaneousパラメーターオプションである-backupを使い、ダウンロードしたメタデータをテキストファイルとしてローカルディレクトリーに保存します。
- Miscellaneousパラメーターオプションである-restoreを使い、前にダウンロードしたテキストファイルからメタデータを読み取ることでインポートブリッジの実行を高速化し、サーバーからの再ダウンロードによる遅延を回避します。
制限事項
現在判明している一般的な制限事項は、MIMB Known Limitationsか、バンドルされているDocumentation/ReadMe/MIMBKnownLimitations.htmlをご覧ください。
このブリッジは増分収集をサポートしていません。SAP ABAPディクショナリーには、明らかな内部枠線や大きな変更単位が存在しません。ABAPディクショナリーは、水平リレーションシップリンクを持つコンポーネントの垂直ツリーとして構成されます。ブリッジを使用すれば、一度に階層のブランチをすべて(または一部)インポートできます。
水平方向の関係を壊さずにディクショナリーを垂直方向に分割する方法を知っているのはユーザーだけであることが多いため、インポートを別々のモデルに分割することをお勧めします。
サポート
トラブルシューティングパッケージを次の項目と共に提供してください:
- デバッグログ(UIまたはconf/conf.propertiesでMIR_LOG_LEVEL=6を使って設定可能)
- 利用できる場合はメタデータバックアップ(技術的理由によりこの共通オプションが実装されていないブリッジがあるものの、Miscellaneousパラメーターで-backupオプションを使って設定可能)
ブリッジパラメーター
| パラメーター名 | 説明 | タイプ | 値 | デフォルト | 範囲 | |||||||||||||||||||||
| アプリケーションサーバー | 接続先とするSAPアプリケーションサーバーホストの名前またはIPアドレスをここに入力します。 | STRING | 必須 | |||||||||||||||||||||||
| ルーター文字列 | ファイアウォールによって保護されているシステムに使用するSAPルーター文字列をここに入力します。 | STRING | ||||||||||||||||||||||||
| [System number] (システム番号) | SAPシステム番号(ABAPインスタンスのインスタンスID)をここに入力します。これは00から99までの2桁の整数です。 | 数値 | 必須 | |||||||||||||||||||||||
| クライアント | SAPシステムのクライアントIDをここに入力します。クライアントは000から999までの3桁の数値で識別されます。 | 数値 | 必須 | |||||||||||||||||||||||
| [User name] (ユーザー名) | ログオンユーザー名をここに入力します。SAPシステム上の有効なユーザー名である必要があります。 | STRING | 必須 | |||||||||||||||||||||||
| パスワード | ログオンユーザーパスワードをここに入力します。 | パスワード | 必須 | |||||||||||||||||||||||
| デフォルト言語 | 使用する言語を指定します。 | ENUMERATED |
|
DE | ||||||||||||||||||||||
| JCoライブラリーパス | このインポートブリッジは、Java Connector (JCo) 3.0 APIを使ってSAPからメタデータを読み取ります。 このパラメーターで、JCoライブラリーがあるディレクトリーパスを指定します。 Microsoft Windowsであれば、このディレクトリーに以下が含まれている必要があります。 - sapjco3.jar - sapjco3.dll さまざまなオペレーティングシステムとプロセッサーのアーキテクチャーに対し、SAPが提供しているさまざまなバージョンのJCoライブラリーを利用できます。作業する環境に対して正しいJCoディストリビューションを使用していることをご確認ください。 たとえば32ビットのWindowsプラットフォームで32ビットのJava JVMを使用する場合、Intel x86プロセッサーには32ビットのJCoライブラリーを使用する必要があります。 ダウンロードファイル、ライセンス、その他の情報は、https://support.sap.com/en/product/connectors/jco.htmlをご覧ください。 |
DIRECTORY | 必須 | |||||||||||||||||||||||
| コンテンツ | インポートスコープをサーバーのコンテンツ全体よりも小さなオブジェクトのセットに縮小することを可能にします。 オブジェクト識別子のセミコロン区切りのリストをTYPE_IDの形式で指定できます。 サポートされているオブジェクトタイプコードは、BFMR (アプリケーションコンポーネント)とDEVC (パッケージ)です。 アプリケーションコンポーネントの識別子は、SAP UIでHIERというトランザクションコードを使って取得できます。 |
REPOSITORY_SUBSET | ||||||||||||||||||||||||
| Miscellaneous | はじめに ダッシュで始まるMiscellaneousオプションを指定し、必要であればその後にパラメーターを追加できます。例: - connection.cast MyDatabase1="MICROSOFT SQL SERVER" 該当する場合は複数回使用できるオプションもあります。例: - connection.rename NewConnection1=OldConnection1 -connection.rename NewConnection2=OldConnection2; オプションのリストは長い文字列になるため、${MODEL_BRIDGE_HOME}\data\MIMB\parametersにあり拡張子が.txtであるファイルからロードすることもできます。その場合、オプションはすべて、このパラメーターの唯一の値としてそのファイル内で定義されることが必要です。例: ETL/Miscellaneous.txt JAVA環境のオプション -java.memory <Javaメモリの最大サイズ> (以前の-m) 64ビットJREではデフォルトで1G、またはconf/conf.properties内の設定に従います。例: -java.memory 8G -java.memory 8000M -java.parameters <Javaランタイム環境コマンドラインオプション> (以前の-j) -java.parameters -Dname=value -Xms1G のように、-java.parametersの後ろのテキストはすべてそのままJREに渡されるため、このオプションはMiscellaneousパラメーター内の最後に来る必要があります。インターネットへのアクセスにプロキシを使用している場合は、必要なサードパーティのソフトウェアライブラリーをダウンロードできるよう、次のオプションを設定する必要があります(このオプションはhttps://repo.maven.apache.org/maven2/にアクセスするため、そして例外的にいくつかの他のツールサイトにアクセスするために不可欠です)。 注: プロキシは、(会社の)外部トラフィックをHTTPSで暗号化しながら、HTTPでプロキシにアクセスできる内部トラフィックを信頼しているものがほとんどです。この場合、HTTPSリクエストはHTTPでプロキシに到達し、プロキシはそれをHTTPSで暗号化します。 -java.parameters -java.parameters -Dhttp.proxyHost=127.0.0.1 -Dhttp.proxyPort=3128 -Dhttp.proxyUser=user -Dhttp.proxyPassword=pass モデルインポートのオプション -model.name <モデル名> モデル名をオーバーライドをオーバーライドします。例: -model.name "My Model Name" -prescript <スクリプト名> このオプションによって、ブリッジの実行前にスクリプトを実行できるようになります。 スクリプトはbinディレクトリー(またはconf/conf.propertiesのM_SCRIPT_PATHで指定)にあり、拡張子が.batか.shであることが必要です。 スクリプトのパスに親ディレクトリーの記号( .. )を含めることはできません。 スクリプトは、成功した場合は終了コードである0を、失敗した場合は別の値を返します。 例: -prescript "script.bat arg1 arg2" -postscript <スクリプト名> このオプションによって、ブリッジが正しく実行された後にスクリプトを実行できるようになります。 スクリプトはbinディレクトリー(またはconf/conf.propertiesのM_SCRIPT_PATHで指定)にあり、拡張子が.batか.shであることが必要です。 スクリプトのパスに親ディレクトリーの記号( .. )を含めることはできません。 スクリプトは、成功した場合は終了コードである0を、失敗した場合は別の値を返します。 例: -postscript "script.bat arg1 arg2" -cache.clear インポート前にキャッシュをクリアするため、増分収集せずにフルインポートを実行します。 モデルが変更されず、-cache.clearパラメーターが使われていない場合(増分収集)、新しいバージョンは作成されません。 モデルが変更されず、-cache.clearパラメーターが設定されている場合(増分ではなくフルソースインポート)、新しいバージョンが作成されます。 -backup <directory> このオプションによってブリッジ入力メタデータを保存すれば、将来のトラブルシューティングで活用できます。指定された<directory>は空であることが必要です。 このオプションの主な用途は、データストアインポートブリッジ(特にJDBCベースのデータベースインポートブリッジ)です。 なお、このオプションは次のようなブリッジでは動作しません。 - ファイルベースのインポートブリッジ(入力ファイルで代用可能なため) - DI/BIリポジトリーインポートブリッジ(ツールのリポジトリーネイティブバックアップで代用可能なため) - APIベース(COMベースなど)による一部のインポートブリッジ(技術的な理由のため) データ接続オプション 使用するソースとターゲットのデータストアを参照するよう、通常はETL/DIツールとBIツールのインポートブリッジによってデータ接続が生成されます。これらのデータ接続はメタデータ管理ツールによって実際のデータストア(データベースやファイルシステムなど)への接続(メタデータスティッチング)に使われ、完全なエンドツーエンドのデータフローの来歴とインパクト分析が行われます。各データ接続の名前はインポートモデルごとに一意です。DI/BIデザインツールで使われているデータ接続名を可能な限り使用します。そうでない場合は、データベース/スキーマ名、ファイルシステムのパス、Uniform Resource Identifier (URI)など、短くても意味のある接続名が生成されます。次のオプションを使えば、接続を操作できます。これらのオプションによって、レガシーオプションである-c、-cd、-csが置き換えられます。 -connection.cast ConnectionName=ConnectionType SQL解析のためにジェネリックデータベース接続(ODBCやJDBCなど)を正確なデータベースタイプ(ORACLEなど)にキャストします。例: -connection.cast "My Database"="MICROSOFT SQL SERVER" サポートされているデータストア接続タイプのリストは次のとおりです。 ACCESS APACHE CASSANDRA DB2/UDB DENODO GOOGLE BIGQUERY HIVE MYSQL NETEZZA ORACLE POSTGRESQL PRESTO REDSHIFT SALESFORCE SAP HANA SNOWFLAKE MICROSOFT SQL AZURE MICROSOFT SQL SERVER SYBASE SQL SERVER SYBASE AS ENTERPRISE TERADATA VECTORWISE HP VERTICA -connection.rename OldConnection=NewConnection 既存の接続を新しい名前に変更します。例: -connection.rename OldConnectionName=NewConnectionName 既存の複数のデータベース接続の名前を変更し、新しい1つのデータベース接続に統合できます。例: -connection.rename MySchema1=MyDatabase -connection.rename MySchema2=MyDatabase -connection.split oldConnection.Schema1=newConnection データベース接続を1つまたは複数のデータベース接続に分割します。 1つのデータベース接続をスキーマごとの1つの接続に分割できます。例: -connection.split MyDatabase すべてのデータベース接続をスキーマごとの1つの接続に分割できます。例: -connection.split * データベースにスキーマ名を追加することで、データベース接続を明示的に分割し、新しいデータベース接続を作成できます。例: -connection.split MyDatabase.schema1=MySchema1 -connection.map SourcePath=DestinationPath ソースパスをデスティネーションパスにマッピングします。これは、異なるパスが同じオブジェクト(ディレクトリーまたはファイル)をポイントしている場合にファイルシステム接続にとって便利です。 Hadoopでは、あるプロセスがHDFSの完全パスで指定されたCSVファイルに書き込む一方、別のプロセスが、デフォルトのファイル名と拡張子を持つ相対パスで指定されている同じファイルによって実装されたHiveテーブル(外部)から読み取ります。例: -connection.map /user1/folder=hdfs://host:8020/users/user1/folder/file.csv Linuxでは、/users/johnや/users/paulといった複数のシンボリックリンクによって、/dataのような特定のディレクトリー(またはファイル)が参照されます。例: -connection.map /data=/users/John -connection.map /data=/users/paul Windowsでは、M:やN:といった複数のネットワークドライブによって、C:\dataのような特定のディレクトリーが参照されます。例: -connection.map C:\data=M:\ -connection.map C:\data=N:\ -connection.casesensitive ConnectionName 検出されたデータストアのタイプがこの設定(Microsoft SQL ServerやMySqlなど)をサポートしている場合は、指定された接続内のオブジェクト識別子に対し、大文字と小文字を区別しないデフォルトのマッチングルールがオーバーライドされます。例: -connection.casesensitive "My Database" -connection.level AggregationLevel 外部接続の集計レベルを指定します。例: -connection.level catalog サポートされている値のリスト: server catalog schema (デフォルト) SAPのオプション -jco.file <ファイルパス> SNC接続の詳細など、追加の接続情報でファイルへのパスを指定します。 このインポートブリッジは、そのインポートブリッジ設定で指定されたパラメーターをJava Connector (JCo)に渡す前にファイルに追加します。 このようなJCoファイルはプレーンテキストファイルであり、以下のような内容が含まれます: jco.client.snc_mode=1 jco.client.snc_partnername=p:CN=POT, OU=SAP jco.client.snc_qop=3 jco.client.snc_myname=p:CN=JCO3, O=SAP, C=DE jco.client.snc_lib=C:\\JCO_SNC\\64bit\\SAPCRYPTOLIBP\\sapcrypto.dll SNCの設定の詳細は、SAPサポート( https://me.sap.com/notes/2642538 など)をご覧ください。 -function <関数モジュール名> このインポートブリッジで使用されるSAP ABAP関数モジュール名を、デフォルト値であるZ_MITI_DOWNLOADから変更します。 -function "Z_MYMITI_DOWNLOAD" -idocs.skip iDocsをインポート(スキップ)しない -functiongroups.skip ファンクショングループとファンクションモジュールをインポート(スキップ)しない -programs.skip プログラムをインポート(スキップ)しない -import.table.functions テーブルファンクションをインポート |
STRING |
ブリッジのマッピング
| Meta Integration Repository (MIR) メタモデル (OMG CWM標準に基づく) |
"SAP Business Suite 4 HANA (S/4HANA), ECC, R/3 ERP" メタモデル SAP ERP Central コンポーネント (SAP ERP Central コンポーネント) |
マッピングのコメント |
| 属性 | メッセージ、テーブルフィールド | |
| 説明 | 簡単な説明 | |
| 名前 | 名前 | |
| オプション | オプション | |
| 位置 | 位置 | |
| クラス | テーブル、IDoctype | |
| 説明 | 説明、短い説明 | |
| 名前 | 名前 | |
| DataAttribute | データフィールド | |
| 名前 | 名前 | |
| DataSet | 構造 | |
| 名前 | 名前 | |
| DatabaseSchema | スキーマ | |
| 説明 | 説明 | |
| 名前 | 名前 | |
| NativeId | ネイティブID | |
| NativeType | ネイティブタイプ | |
| DerivedType | データエレメント、ドメイン | |
| 説明 | 簡単な説明 | |
| 長さ | 長さ | |
| LowerBound | 下限 | |
| 名前 | 名前 | |
| NativeDataType | データ型 | |
| スケール | 小数位 | |
| UpperBound | 上限 | |
| DesignPackage | プログラム、トランザクション、アプリケーションコンポーネント、ファンクショングループ、クラス、パッケージ | |
| 説明 | 説明、短い説明 | |
| 名前 | 名前 | |
| NativeId | ID | |
| PhysicalName | ソフトウェアコンポーネント | |
| ForeignKey | 外部キー | |
| 名前 | 名前 | |
| インデックス | インデックス | |
| 説明 | 短いテキスト | |
| 名前 | 名前 | |
| ユニーク | ユニーク | |
| IndexMember | インデックスメンバー | |
| SortOrder | ソート順序 | |
| SQLViewAttribute | ビューフィールド | |
| 説明 | 簡単な説明 | |
| 名前 | 名前 | |
| 位置 | 位置 | |
| SQLViewEntity | 表示 | |
| 説明 | 簡単な説明 | |
| 名前 | 名前 | |
| ViewStatement | ステートメントを表示 | |
| StoreModel | [Instance] (インスタンス) | |
| Name | 名前 | |
| StoreType | 保管タイプ | |
| SystemType | システムタイプ | |
| StoredProcedure | 関数モジュール | |
| 説明 | 説明 | |
| 名前 | 名前 | |
| TypeValue | ドメイン値 | |
| 説明 | 簡単な説明 | |
| 名前 | 名前 | |
| 位置 | 位置 | |
| 値 | 値 |