接続文字列の種類

はじめに

使用できる接続文字列は複数の種類があります。 このガイドでは、さまざまな種類の接続文字列について説明します。

ファイル

{mvfile}、接続文字列の driver パラメーターを設定することで、ファイルを表に読み込むことができます。

driver={mvfile}

次の種類のファイルを読み込むことができます。

• Excel ファイルの .xls と .xlsx
• テキスト ファイルの .csv、 .tsv、 .txt

Additional parameters can be specified to load files.

以下に、ファイルを利用可能または読み込む一般的なパラメーターの概要を示します。

パラメーター	説明
ファイル名	サーバー上のファイルの相対パスまたは HTTP URL を指定できます。 ファイルがサーバー上にある場合、ファイルは [ Development data ] または [ Server data ] タブに配置され、それに応じて テーブルのテーブル スコープ を設定する必要があります。 When you use an HTTP URL, you can specify the user and pass parameters for authentication.
ext	既定では、ファイルの種類の決定にはファイル名拡張子が使用されますが、これを上書きできます。
ユーザー	HTTP URL を使用する場合のリモート ファイルのユーザー名です。
渡す	HTTP URL を使用する場合のリモート ファイルのパスワード。

Excel ファイル

Excel ファイルを読み込む際に使用できるその他のパラメーターの概要は以下のとおりです。

パラメーター	説明
シート	インポートするシートまたは名前付き範囲です。 シート名の末尾にドル記号を付加する必要があります。 指定しない場合、最初のシートが読み込まれます。
最初の列	開始の最初の列です。 既定の設定は . {autodetect}
最初の行	最初の行の開始行。 既定の設定は . {autodetect}

以下の表に、Excel ファイルを読み込む接続文字列の例を示します。

接続文字列	負荷。。。
'driver={mvfile}; filename=Data/Dataset.xlsx;'	Excel ファイルの最初のシート
'driver={mvfile}; filename=Data/Dataset.xlsx; sheet=MySheet$;'	'MySheet' という名前のシート

テキスト ファイル

以下に、テキスト ファイルを読み込む場合に使用できるその他のパラメーターの概要を示します。

パラメーター	説明
先頭行をヘッダーとする	ファイルの最初の行がヘッダー行かどうか。 既定の設定は {true}です。
delim	区切り文字です。 既定の設定は {tab}です。
Quote	値を引用符で囲む文字です。 既定の設定は {autodetect}です。
escape	文字をエスケープするために使用される文字です。 既定の設定は {none}です。
エンコード	ファイルで使用されるエンコード (UTF8、LATIN1 など)。 既定の設定は {UTF8}です。

以下の表に、テキスト ファイルを読み込む接続文字列の例を示します。

接続文字列	テキスト ファイルを読み込みます...
driver={mvfile}; filename=Textfile.txt; delim=,; quote=";'	コンマ (,) 区切り文字と " 引用符で囲む
'driver={mvfile}; filename=Textfile.txt; delim=|; quote=";'	パイプ (|) 区切り文字と " 引用符
"driver={mvfile}; filename=Textfile.txt; delim=9; quote=';"	タブ区切り文字と ' 引用符付き
'driver={mvfile}; filename=Textfile.txt; delim=59; quote=none;'	セミコロン区切り、引用符なし
'driver={mvfile}; filename=Textfile.txt; delim=,; quote="; escape=\;'	コンマ (,) 区切り文字、" 引用符、\ エスケープ文字で囲む
'driver={mvfile}; filename=http://www.example.com/files/example.txt;'	Web サーバーから
'driver={mvfile}; filename=http://www.example.com/files/example.txt; User=Jane; mv-credential-Pass=example_com_credentials'	基本アクセス認証を利用した Web サーバーからの接続

ODBC

ODBC を使用して外部データ ソース (通常はデータベース) に接続します。 これを行うには、Microsoft Windows 内の ODBC データ ソース マネージャーなどのオペレーティング システムを使用するか、接続文字列を正しい形式で直接指定します。

ODBC ドライバーは、実行するためにクエリを必要とする可能性があります。 データベースで実行する必要があるクエリは、[ クエリ ] フィールドに文字列として指定できます。

大事な： ODBC 接続をテストする場合、[ クエリ ] フィールドに有効なクエリが入力されていることを確認してください。

重要: 64 ビット バージョンを持つデータベースには、すべて ODBC 接続を使用してアクセスできます。必要な 64 ビット ODBC ドライバーを UiPath Process Mining サーバーにインストールし、サーバーがその特定のシステムにアクセスできる必要があります。

ODBC 接続に使用できるパラメーターの概要は以下のとおりです。

パラメーター	説明
ドライバー	この接続に使用する ODBC ドライバーです。 'dsn' パラメーターを使用する場合は不要です。
dsn	この接続に使用する ODBC DSN です。 'driver' パラメーターを使用する場合は不要です。 メモ： 接続文字列で使用する DSN を設定する場合は、その DSN が 64 ビットシステム DSN であることを確認してください。
ユーザー	外部データソースに接続するために使用するユーザー名です。
渡す	外部データソースに接続するために使用するパスワードです。
個のオプション	その他のすべてのパラメーターが、指定されたとおりに ODBC ドライバーに渡されます。

以下の表に、ODBC 接続の接続文字列の例を示します。

接続文字列	接続。。。
'Driver={SQL Server Native Client 11.0};Server=SERVERNAME;Database=MyDatabase;'	to a SQL Server database
'Driver={Oracle in OraClient12Home1};Dbq=MyTSN;'	to an Oracle database
'DSN=MyDSN; User=MyUser; Pass=MyPass;'	ユーザー名とパスワードを含む設定済みの DSN を使用する

[接続文字列] と [クエリ ] フィールドはどちらも式です。たとえば、仮想データベースへの接続文字列テーブルを作成できます。

以下の画像でご確認ください。

メモ： テーブル内のデータは、テーブルが読み込まれたときにのみ使用できます。 この例では、他のテーブルのデータを使用するために グローバル テーブルが必要です。

ヒントとコツ

他のシステムの接続文字列の形式については、そのシステムの製造元に問い合わせるか、https://www.connectionstrings.com/ などのオンライン リソースを参照してください。

データベースへのアクセス権を持つユーザーが Windows ユーザーである場合は、この Windows ユーザーを確認します。

• サービス アカウントであり、実際のユーザーではありません。
• Process Mining のインストール フォルダーに対する読み取り/書き込みアクセス権を持ちます。
• データの読み込み用にスクリプト (スケジュールされたタスクなど) を実行するユーザーです。
• IIS で アプリケーション プール を実行するために使用されます。

SAP HANA

ODBC 接続を使用して、SAPHANA に接続できます。

以下に、SAPHANA の接続文字列の例を示します。

'Driver={HDBODBC};User=MyUser;Pass=MyPass;ServerNode=MyServer:30015;DatabaseName=TDB1'

メモ： SAP データベースに接続する代わりに、SAP アプリケーション サーバーに接続する場合は、 SAP 接続文字列の種類を使用することをお勧めします。

汎用スクリプト

接続文字列を使用してスクリプトを実行し、データソースからデータを読み込むことができます。

大事な： 実行するスクリプト ハンドラーを UiPath Process Mining サーバーにインストールする必要があります。

接続文字列の driver パラメーターを {mvscript} に設定し、 script パラメーターを "generic" に設定すると、ファイルを表に読み込むことができます。

driver={mvscript}; script=generic

メモ： URL エンコードを使用して、[ Query] フィールドにスクリプト パラメーターを指定する必要があります。

以下に 、[クエリ ] フィールドで指定できるパラメーターの概要を示します。

パラメーター	説明	Mandatory/Optional
scriptText	スクリプトのテキストです。	必須です。 注: scriptFile を使用しない場合のみ。
scriptFile	スクリプトの読み込み元のファイル名です。 サーバー上のファイルの相対パスを指定できます。 ファイルがサーバー上にある場合、ファイルは [ Development data ] または [ Server data ] タブに配置され、それに応じて テーブルのテーブル スコープ を設定する必要があります。	必須です。 注: scriptText を使用しない場合のみ。
入力データ	スクリプトの入力を含む列ヘッダーを含む、セミコロンで区切られたテキスト。 メモ： csvtable 関数を使用すると、正しい形式でデータを生成できます。	必須です。
スクリプトの種類	サーバー設定の GenericScriptHandlers の設定で指定したとおりに使用するハンドルの名前です。 メモ： scriptFile 指定すると、ファイル拡張子に基づいて自動的に検出されます。	Optonal
args	スクリプトに渡す引数をカスタマイズします。 これは 、JSON エンコードされたリストである必要があります。 2 つの特殊な引数があります。 '<SCRIPT>'し、 '<INPUT>'します。 出現 '<SCRIPT>' はスクリプト ファイルのパスに置き換えられ、出現した '<INPUT>' は入力ファイルへのパスに置き換えられます。 これにより、追加の引数を使用して、スクリプト ハンドラーへの呼び出しをカスタマイズできます。 既定では、 ["<SCRIPT>", "<INPUT>"]です。	任意です。
debugPath	フォルダーへの絶対パスです。 このパラメーターを指定すると、 UiPath Process Mining はデバッグ目的でこのフォルダーに入力ファイル (外部プロセスに指定された) と外部プロセスの出力 (外部プロセスの標準出力から読み取るように) を出力します。	任意です。

以下に、簡易クエリの例を示します。

+'&scriptFile=' + urlencode("script.py")
+'&inputData='  + urlencode("a;b;c"+#10+"1;2;3"+#10+"4;5;6")

以下に、より高度なクエリの例を示します。

+'&scriptText=' + urlencode(/* your script as text */)
+'&scriptType=' + urlencode("HandlerName")
+'&inputData='  + urlencode(csvtable(
    "Case_ID", jsontolist(InputData_Case_ID)
    "Amount" , jsontolist(InputData_Amount)
))
+'&args='       + urlencode(listtojson(["<SCRIPT>", "--filename", "<INPUT>"]))

「 汎用スクリプトのデータソースを使用する」もご覧ください。

SAP

SAP 接続文字列を使用すると、SAP R3、SAP ERP、SAP ECC 5.0、SAP ECC 6.0、S/4HANA などの SAP アプリケーション サーバーに接続できます。

大事な： 接続文字列から SAP データソースを使用するには、 SAP NWRFC ライブラリを UiPath Process Mining サーバーにインストールする必要があります。

SAP データソースを読み込むには、接続文字列の driver パラメーターを {SAP}に設定します。

driver={SAP}

SAP のデータソースに使用できるパラメーターの概要は以下のとおりです。

パラメーター	説明	Mandatory/Optional
ホスト	SAP アプリケーション サーバーのホスト名または IP アドレスです。	必須です。
SystemNumber	指定したインスタンスを識別する、00 から 99 の間の 2 桁の数字です。	必須です。
関数モジュール	ネイティブな SAP データの抽出を設定する場合は、SAP Z_XTRACT_IS_TABLE 関数モジュールが必要です。 たとえば、この関数モジュールの名前が SAP システムで変更されている場合、SAP 接続文字列の FunctionModule パラメーターで正しい名前を指定できます。FunctionModule パラメーター。 この表のクエリ時に使用される既定 Z_XTRACT_IS_TABLE 関数モジュールをオーバーライドします。	任意です。
ユーザー名	SAP インスタンスへのログインに使用する、アカウントのユーザー名です。	必須です。
渡す	上記のユーザーのパスワードです。 資格情報ストアと組み合わせて使用できます。この場合は mv-credential-pass を使用します。	必須です。
Client (クライアント)	使用するクライアントです。	必須です。
言語	ログイン時に使用される言語です。	必須です。

以下に 、[クエリ ] フィールドで指定できるパラメーターの概要を示します。

パラメーター	説明	Mandatory/Optional
表	データの読み込み元となる SAP テーブル名です。 たとえば、 EKPOです。	必須です。
フィールド	[ table ] プロパティに指定した SAP テーブルから取得するフィールドの配列です。 メモ： fields プロパティが空の場合、すべてのフィールドが取得されます。	必須です。
場所	表のサブセットを取得する where 句。	任意です。
limit	テーブルから取得するレコードの固定数を指定する整数です。 注: limit が '0' に設定されている場合、制限はありません。	任意です。

メモ： SAP のすべてのフィールドの長さがあります。 パフォーマンスの理由から、テーブルに対して取得されたすべてのフィールド長の合計が 512 を超えないようにしてください。

SAP 接続文字列の例を以下に示します。

'Driver={SAP};Host=10.10.10.10;SystemNumber=00;Username=MyUser;pass=secretPassword;client=100;Language=EN'

以下に、クエリの例をいくつか示します。

クエリ	取得。。。
'table=' + urlencode("EKPO")	テーブル EKPOのすべてのレコードのすべてのフィールド
'table=' + urlencode("EKPO") + '&fields=' + urlencode(listtojson(["MANDT", "EBELN"]))	EKPO テーブルのすべてのレコードの MANDT と EBELN フィールドです。
'table=' + urlencode("EKPO") + '&where=' + urlencode("EBELN = 4500000001")	EBELN が4500000001と等しいテーブル EKPO すべてのフィールド