接続文字列の種類

はじめに

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

ファイル

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

driver={mvfile}

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

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

Additional parameters can be specified to load files.

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

パラメーター	説明
ファイル名	サーバー上のファイルの相対パスまたは HTTP URL を指定できます。 ファイルがサーバー上にある場合は、ファイルを [開発データ ] タブまたは [サーバー データ ] タブに配置し、それに応じてテーブルの [テーブル スコープ ] を設定する必要があります。 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=";エスケープ=;'	コンマ (,) 区切り文字、" 引用符、\ エスケープ文字で囲む
'driver={mvfile};filename=http://www.example.com/files/example.txt;'	Web サーバーから
'driver={mvfile};ファイル名=http://www.example.com/files/example.txt;ユーザー=ジェーン;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を設定する場合は、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 エンコードを使用して、[ クエリ ] フィールドにスクリプト パラメーターを指定する必要があります。

[クエリ] フィールドに指定できるパラメーターの概要は以下のとおりです。

パラメーター	説明	Mandatory/Optional
scriptText	スクリプトのテキストです。	必須です。 注: scriptFile を使用しない場合のみ。
scriptFile	スクリプトの読み込み元のファイル名です。 サーバー上のファイルの相対パスを指定できます。 ファイルがサーバー上にある場合は、ファイルを [開発データ ] タブまたは [サーバー データ ] タブに配置し、それに応じてテーブルの [テーブル スコープ ] を設定する必要があります。	必須です。 注: 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 サーバーにインストールされている必要があります。

接続文字列の driver パラメーターを {SAP}に設定することで、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 すべてのフィールド