- リリース ノート
- はじめる前に
- 基本情報
- アクセス権を管理する
- プロセス アプリを使用する
- プロセス アプリを作成する
- データを読み込む
- データをアップロードする
- SQL Server データベースのパラメーターを取得する
- 抽出器を使用してデータをアップロードするための SQL Server アカウントを設定する
- Theobald Xtract Universal を使用してデータを読み込む
- プロセス アプリをカスタマイズする
- データ変換
- TemplateOne アプリ テンプレート
- Purchase-to-Pay アプリ テンプレート
- Order-to-Cash アプリ テンプレート
- 基本的なトラブルシューティング ガイド
![](https://docs.uipath.com/_next/static/media/grid.05ebd128.png?w=3840&q=100)
Theobald Xtract Universal を使用してデータを読み込む
このページでは、Theobald Xtract Universal (XU) を使用して、Process Mining (Automation Suite) のプロセス アプリに SAP のソース システムからデータを読み込む方法について説明します。Theobald Xtract Universal (XU) について詳しくは、Theobald Software の公式 Web サイトをご覧ください。
Theobald Xtract Universal を使用すると、SAP ECC や SAP HANA のデータ ソースに対するデータ アクセスと抽出を高速で行うことができます。Theobald Xtract Universal の使用方法に関する一般的な説明については、Theobald Software の公式ドキュメント「Getting Started with Theobald Xtract Universal」をご覧ください。
以下を前提条件とします。
- 有効な Theobald Xtract Universal ライセンス。
-
インストール済みの Theobald Xtract Universal。詳しい情報は、Theobald Software の公式ドキュメント「Installation and Update」および SAP での「Custom function module for Table」をご覧ください。
xu.exe
) を追加認証なしで実行できる必要があります。
Theobald Xtract Universal は、SAP のソース システムからデータを抽出するために使用される、SAP が認定した抽出ツールです。リモート関数呼び出し (RFC) を介して SAP と連携しています。 Theobald Xtract Universal には、SAP にインストールする、読み取り専用のカスタム関数モジュールが含まれています。カスタム モジュールをダウンロードするには、次のリンクを使用します: Z_THEO_READ_TABLE-transport1.zip
このライセンスは、Process Mining のために UiPath によって提供されます。
Theobald Xtract Universal をセットアップするには、以下の手順に従います。
-
Theobald Xtract Universal の最新の無料トライアル版を UiPath の Web サイトからダウンロードする方法について詳しくは、「Download Trial Version」をご覧ください。Theobald Xtract Universal を Windows Server/仮想マシンにインストールします。
-
SAP システムへのネットワーク アクセスが開いているかどうかを確認するには、「SAP TCP/IP Ports」をご覧ください。
-
SAP インスタンスへのアクセス権を SAP ユーザーに付与するには、「Authority Objects - SAP User Rights for Table」をご覧ください。
-
次の Theobald Xtract Universal のコンポーネントは、SAP でのカスタマイズが必要です:
Z_THEO_READ_TABLE
。 -
目的のアプリ テンプレートに Theobald Xtract Universal を設定します。詳しくは、「アプリ テンプレート」をご覧ください。
手順 2~4 では、社内の SAP チームによる検証が必要です。
Process Mining (Automation Suite) にデータをアップロードするには、抽出したデータをアップロードする必要がある、SQL Server データベースの場所へのアクセス権が必要です。SQL Server の宛先の接続を設定するには、SQL Server データベースの場所へのアクセスを認証するために、次の設定パラメーターが必要です。
Server
Database
Schema
Role
「SQL Server データベースのパラメーターを取得する」をご覧ください。
Theobald Xtract Universal を使用したデータ読み込みを設定するには、いくつかの手順を実行する必要があります。
- データをアップロードする SQL ユーザーをセットアップする
- テンプレートの抽出をインポートする
- ソースを構成する
- 同期先を設定します。
- 抽出スクリプトを設定する
- 抽出スクリプトを実行する
手順については、以下で詳しく説明します。
抽出器でデータをアップロードするオプションを使用する各プロセス アプリには、プロセス アプリに関連付けられたスキーマに固有のアクセス権を持つ、専用の SQL Server ユーザーが必要です。
次の手順を実行します。
手順 |
操作 |
構文 |
---|---|---|
1 |
ログインを作成します。 注:
ログインはマスター データベースに作成する必要があります。 |
|
2 |
ログイン用のデータベース ユーザーを作成します。 注:
このユーザーは、AutomationSuite_ProcessMining_Warehouse データベースに作成する必要があります。 |
|
3 |
適切なデータベース ロールにユーザーを割り当てます。 |
|
4 |
作成されたユーザーに既定のスキーマを設定します。 注意:
この手順は、Theobald Xtract Universal を使用してデータを読み込む場合にのみ必要です。 |
|
Theobald Xtract Universal にテンプレート抽出をインポートするには、以下の手順に従います。
手順 |
操作 |
---|---|
1 | [アプリ テンプレート] ページに移動して、アプリ テンプレートのドキュメント ページを開きます。 |
1 |
[Theobald Xtract Universal を使用してデータを読み込む] セクションを見つけ、アプリ テンプレートのための XU_template_extractions_as.zip ファイルをダウンロードします。詳しくは、「アプリ テンプレート」をご覧ください。この
XU_template_extractions_as.zip ファイルには、destinations 、extractions 、sources のフォルダーが含まれています。
|
2 |
ダウンロードした
XU_template_extractions_as.zip ファイルのフォルダーを、Xtract Universal の config フォルダーにコピーします。このフォルダーの場所は [XU_installation_path] /config です。
|
3 |
Xtract Universal Designer を開き、更新ボタンをクリックしてすべての抽出を読み込みます。 |
既定のユーザーを使用してログインできます。
すべての抽出のリストが表示されます。そのそれぞれが 1 つのテーブルを SAP システムから抽出します。テンプレート ソースの名前は SAP で、テンプレートのターゲットの名前は SQL Server です。
Theobald Xtract Universal に SAP ソースを設定するには、以下の手順に従います。
手順 |
操作 |
---|---|
1 |
[Server] - [Manage sources] に移動し、SAP ソースを編集します。 |
2 |
[General] タブと [Authentication] タブの設定を入力して、SAP システムに接続します。 |
3 |
接続をテストします。 |
Theobald Xtract Universal に SQL Server の同期先を設定するには、以下の手順に従います。
- [Server - Manage destinations] に移動して、SQL Server のターゲットを編集します。
- SQL Server の同期先に接続するための設定を入力します。
抽出スクリプトを構成するには、以下の手順に従います。
手順 |
操作 |
---|---|
1 | [アプリ テンプレート] ページに移動して、アプリ テンプレートのドキュメント ページを開きます。 |
2 |
[Theobald Xtract Universal を使用してデータを読み込む] セクションを見つけ、アプリ テンプレートのための
extract_theobald_as.zip ファイルをダウンロードします。この extract_theobald_as.zip ファイルには、extract_theobald.ps1 スクリプトと config.json ファイルが含まれています。
|
3 |
Theobald Xtract Universal がインストールされているサーバーで、
extract_theobald_as.zip ファイルの内容を解凍します。
|
4 |
以下に示すように、
config.json でスクリプトの変数を設定します。
|
変数 |
説明 |
---|---|
|
Xtract Universal のインストール フォルダーです。このフォルダーには
xu.exe が格納されています。例: C:\\MyFolder。
|
|
Xtract Universal がインストールされているサーバーのアドレスです。既定では
localhost です。
|
|
Xtract Universal がインストールされているサーバーのポートです。インストールの既定のポートは
8065 です。
|
|
アプリが作成されるサーバーを表す URL の一部分です。「SQL Server データベースのパラメーターを取得する」をご覧ください。 |
|
作成されるアプリの組織を表す URL の一部分です。「SQL Server データベースのパラメーターを取得する」をご覧ください。 |
|
アプリが作成されるテナントを表す URL の一部分です。「SQL Server データベースのパラメーターを取得する」をご覧ください。 |
|
作成したアプリのアプリ ID です。 |
|
抽出を制限するために使用する開始日です。この日付では、日付フィルターが適用されたテーブルのみがフィルター処理されます。形式は
YYYYMMDD です。既定の開始日は 19700101 であるため、制限はありません。
注:
extraction_start_date 値を設定する必要があります。
|
|
抽出を制限するために使用する終了日です。この日付では、日付フィルターが適用されたテーブルのみがフィルター処理されます。形式は
YYYYMMDD です。既定の終了日は 20991231 であるため、制限はありません。
注:
extraction_end_date 値を設定する必要があります。
|
|
ソース システムからデータを抽出する言語です。既定では
E です。
|
|
通貨変換に使用する為替レートの種類です。既定では
M です。
|
extract_theobald.ps1
ファイルを実行する必要があります。
このタスクにかかる時間は、読み込まれるデータの量によって大きく異なります。
ファイルを手動で開始する
データ実行を開始するには以下の手順に従います。
手順 |
操作 |
---|---|
1 |
extract_theobald.ps1 ファイルを実行し、データ実行を開始します。
|
extraction.log
ファイルには、前回のデータ実行のログが含まれています。失敗した各抽出に対して、リターン コードが表示されます。詳しくは、Theobald Software の公式ドキュメント「Call via Commandline」をご覧ください。セットアップに何らかの誤りがあると、それがエラー メッセージに表示されます。
データ実行のタスクのスケジュールを設定する
ファイルを手動で実行する代わりに Windows のタスク スケジューラを使用すれば、バッチ スクリプトを実行するタスクをスケジュールでき、データの更新を自動化できます。
利用できるデータがない間隔を追加すると、ダッシュボードにエラー メッセージが表示されます。
抽出に成功した場合、欠陥のあるデータが抽出されたため、データの取り込みに失敗することがあります。Theobald Xtract Universal で WHERE 句を使用すると、このようなデータをフィルター処理して除外できます。WHERE 句について詳しくは、Theobald の公式ドキュメントをご覧ください。
変数 (例: 抽出日) を使用する WHERE 句がある場合、UI でフィルター処理できません。
extraction.log
ファイルには、前回のデータ実行のログが含まれています。失敗した各抽出に対して、リターン コードが表示されます。詳しくは、Theobald Software の公式ドキュメント「Call via Commandline」をご覧ください。セットアップに何らかの誤りがあると、それがエラー メッセージに表示されます。
HANA 以外の一部の古いシステムでは、CDPOS はクラスター テーブルであり、以下のような「join with pool table」のエラーが発生する可能性があります。
CDPOS
テーブルの抽出には、既定で CDHDR
テーブルとの結合が含まれており、抽出する必要のあるレコードの数が制限されます。このエラーを解決するには、以下の手順に従います。
- Xtract Universal Designer で CDPOS 抽出を編集して、テーブルから CDDHR を削除します。
CDHDR~UDATE between @extraction_start_date and @extraction_end_date
を次の値で置き換えます。
CHANGENR between @CHANGENR_min and @CHANGENR_max
extract_theobald.ps1
で、&"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "P2P_CDPOS_raw" -o "extraction_start_date=$extraction_start_date"
-o "extraction_end_date=$extraction_end_date"
を以下に示すコードに置き換えます。
&"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "P2P_CDHDR_raw_CSV" -o "extraction_start_date=$extraction_start_date" -o "extraction_end_date=$extraction_end_date"
CheckExtractionError('P2P_CDHDR_raw_CSV')
$CDHDR = Import-Csv -Path "$xu_location\p2p_output\CDHDR_raw_CSV.csv" -Delimiter "`t"
$CDHDR_sorted = $CDHDR | Sort-Object -Property CHANGENR
$CHANGENR_min=$CDHDR_sorted.GetValue(0).CHANGENR
$CHANGENR_max=$CDHDR_sorted.GetValue($CDHDR_sorted.Count-1).CHANGENR
&"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "P2P_CDPOS_raw" -o "CHANGENR_min=$CHANGENR_min" -o "CHANGENR_max=$CHANGENR_max"
&"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "P2P_CDHDR_raw_CSV" -o "extraction_start_date=$extraction_start_date" -o "extraction_end_date=$extraction_end_date"
CheckExtractionError('P2P_CDHDR_raw_CSV')
$CDHDR = Import-Csv -Path "$xu_location\p2p_output\CDHDR_raw_CSV.csv" -Delimiter "`t"
$CDHDR_sorted = $CDHDR | Sort-Object -Property CHANGENR
$CHANGENR_min=$CDHDR_sorted.GetValue(0).CHANGENR
$CHANGENR_max=$CDHDR_sorted.GetValue($CDHDR_sorted.Count-1).CHANGENR
&"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "P2P_CDPOS_raw" -o "CHANGENR_min=$CHANGENR_min" -o "CHANGENR_max=$CHANGENR_max"