process-mining

2023.4

false

重要 :

このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。

Process Mining

デリバリー:

Automation Cloud Automation Cloud Public Sector Automation Suite Standalone

Last updated 2024年10月17日

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」をご覧ください。

注:

Theobald Xtract Universal を使用してデータを読み込む場合は、コマンドラインツール (xu.exe) を追加認証なしで実行できる必要があります。

Theobald Xtract Universal をセットアップする

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 チームによる検証が必要です。

SQL Server データベースの資格情報を設定する

Process Mining (Automation Suite) にデータをアップロードするには、抽出したデータをアップロードする必要がある、SQL Server データベースの場所へのアクセス権が必要です。SQL Server の宛先の接続を設定するには、SQL Server データベースの場所へのアクセスを認証するために、次の設定パラメーターが必要です。

サーバー
データベース
スキーマ
ロール

「SQL Server データベースのパラメーターを取得する」をご覧ください。

Theobald Xtract Universal を使用してデータを読み込む

Theobald Xtract Universal を使用したデータ読み込みを設定するには、いくつかの手順を実行する必要があります。

データをアップロードする SQL ユーザーをセットアップする
テンプレートの抽出をインポートする
ソースを構成する
同期先を設定します。
抽出スクリプトを設定する
抽出スクリプトを実行する

手順については、以下で詳しく説明します。

データをアップロードする SQL ユーザーをセットアップする

抽出器でデータをアップロードするオプションを使用する各プロセスアプリには、プロセスアプリに関連付けられたスキーマに固有のアクセス権を持つ、専用の SQL Server ユーザーが必要です。

次の手順を実行します。

手順	操作	構文
1	ログインを作成します。注: ログインはマスターデータベースに作成する必要があります。	`CREATE LOGIN <SQL_login_name> WITH PASSWORD = '<Password>'`
2	ログイン用のデータベースユーザーを作成します。注: このユーザーは、AutomationSuite_ProcessMining_Warehouse データベースに作成する必要があります。	`CREATE USER <User_name> FOR LOGIN <SQL_login_name>`
3	適切なデータベースロールにユーザーを割り当てます。	`SP_ADDROLEMEMBER <Role>, <User_name>`
4	作成されたユーザーに既定のスキーマを設定します。注意: この手順は、Theobald Xtract Universal を使用してデータを読み込む場合にのみ必要です。	`ALTER USER <User_name> WITH DEFAULT_SCHEMA = <Schema>`

テンプレートの抽出をインポートする

Theobald Xtract Universal にテンプレート抽出をインポートするには、以下の手順に従います。

手順	操作
1	[アプリテンプレート] ページに移動して、アプリテンプレートのドキュメントページを開きます。
2	[Theobald Xtract Universal を使用してデータを読み込む] セクションを見つけ、アプリテンプレートのための XU_template_extractions_as.zip ファイルをダウンロードします。詳しくは、「アプリテンプレート」をご覧ください。この `XU_template_extractions_as.zip` ファイルには、`destinations`、`extractions`、`sources` のフォルダーが含まれています。
3	ダウンロードした `XU_template_extractions_as.zip` ファイルのフォルダーを、Xtract Universal の `config` フォルダーにコピーします。このフォルダーの場所は `[XU_installation_path]`/config です。
4	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` でスクリプトの変数を設定します。

変数	説明
`xu_location`	Xtract Universal のインストールフォルダーです。このフォルダーには `xu.exe` が格納されています。例: C:\\MyFolder。
`xu_server`	Xtract Universal がインストールされているサーバーのアドレスです。既定では `localhost` です。
`xu_port`	Xtract Universal がインストールされているサーバーのポートです。インストールの既定のポートは `8065` です。
`as_server`	アプリが作成されるサーバーを表す URL の一部分です。「SQL Server データベースのパラメーターを取得する」をご覧ください。
`as_organization`	作成されるアプリの組織を表す URL の一部分です。「SQL Server データベースのパラメーターを取得する」をご覧ください。
`as_tenant`	アプリが作成されるテナントを表す URL の一部分です。「SQL Server データベースのパラメーターを取得する」をご覧ください。
`as_app_ID`	作成したアプリのアプリ ID です。
`extraction_start_date`	抽出を制限するために使用する開始日です。この日付では、日付フィルターが適用されたテーブルのみがフィルター処理されます。形式は `YYYYMMDD` です。既定の開始日は `19700101` であるため、制限はありません。注: `extraction_start_date` には値を設定する必要があります。
`extraction_end_date`	抽出を制限するために使用する終了日です。この日付では、日付フィルターが適用されたテーブルのみがフィルター処理されます。形式は `YYYYMMDD` です。既定の終了日は `20991231` であるため、制限はありません。注: `extraction_end_date` には値を設定する必要があります。
`language`	ソースシステムからデータを抽出する言語です。既定では `E` です。
`exchange_rate_type`	通貨変換に使用する為替レートの種類です。既定では `M` です。

抽出スクリプトを実行する

Process Mining で使用するためにデータを読み込んでアップロードするには、extract_theobald.ps1 ファイルを実行する必要があります。

このタスクにかかる時間は、読み込まれるデータの量によって大きく異なります。

ファイルを手動で開始する

データ実行を開始するには以下の手順に従います。

手順	操作
1	`extract_theobald.ps1` ファイルを実行し、データ実行を開始します。

データ実行ではログファイルも作成されます。これは、予期しない結果が発生した場合や、データアップローダーでのデータのアップロードが失敗した場合に役立ちます。extraction.log ファイルには、前回のデータ実行のログが含まれています。失敗した各抽出に対して、リターンコードが表示されます。詳しくは、Theobald Software の公式ドキュメント「Call via Commandline」をご覧ください。セットアップに何らかの誤りがあると、それがエラーメッセージに表示されます。

データ実行のタスクのスケジュールを設定する

ファイルを手動で実行する代わりに Windows のタスクスケジューラを使用すれば、バッチスクリプトを実行するタスクをスケジュールでき、データの更新を自動化できます。

注: Windows のタスクスケジューラでタスクを作成する場合は、[タスクの作成] ウィンドウでタスクの実行者にローカルの SYSTEM ユーザーアカウントを選択し、[最上位の特権で実行する] オプションを選択することをお勧めします。

重要:

利用できるデータがない間隔を追加すると、ダッシュボードにエラーメッセージが表示されます。

抽出に成功した場合、欠陥のあるデータが抽出されたため、データの取り込みに失敗することがあります。Theobald Xtract Universal で WHERE 句を使用すると、このようなデータをフィルター処理して除外できます。WHERE 句について詳しくは、Theobald の公式ドキュメントをご覧ください。

注:

変数 (例: 抽出日) を使用する WHERE 句がある場合、UI でフィルター処理できません。

トラブルシューティング

HANA 以外のシステム向けの CDPOS の抽出の問題

HANA 以外の一部の古いシステムでは、CDPOS はクラスターテーブルであり、以下のような「join with pool table」のエラーが発生する可能性があります。

CDPOS テーブルの抽出には、既定で CDHDR テーブルとの結合が含まれており、抽出する必要のあるレコードの数が制限されます。このエラーを解決するには、以下の手順に従います。

Xtract Universal Designer で CDPOS 抽出を編集して、テーブルから CDHDR を削除します。
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 "CDPOS" -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 "CDHDR_CSV" -o "extraction_start_date=$extraction_start_date" -o "extraction_end_date=$extraction_end_date"
CheckExtractionError('CDHDR_CSV')
$CDHDR = Import-Csv -Path "$xu_location\<app_template_specific>output\CDHDR_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 "CDPOS" -o "CHANGENR_min=$CHANGENR_min" -o "CHANGENR_max=$CHANGENR_max"&"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "CDHDR_CSV" -o "extraction_start_date=$extraction_start_date" -o "extraction_end_date=$extraction_end_date"
CheckExtractionError('CDHDR_CSV')
$CDHDR = Import-Csv -Path "$xu_location\<app_template_specific>output\CDHDR_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 "CDPOS" -o "CHANGENR_min=$CHANGENR_min" -o "CHANGENR_max=$CHANGENR_max"