クエリの実行設定 - Automate_Studio - 20.3

Connect オンライン ヘルプを使用して Studio を自動化する

Product type
ソフトウェア
Portfolio
Integrate
Product family
Automate
Product
Automate > Automate Studio
Version
20.3
Language
日本語
Product name
Automate Studio
Title
Connect オンライン ヘルプを使用して Studio を自動化する
Topic type
インストール
リファレンス
管理
操作方法
First publish date
2018

いくつかの高度な機能は、リボンの [実行] タブにあります。その他は[オプション]ボックスにあります。

実行タブ設定

これらの設定の一部は、実行ユーザーが変更できます。その他の設定は、ソリューション開発者のみが変更できます。

指定したシート開始行、または# レコード設定を実行ユーザーが変更できないようにロックするには、左側にある南京錠のアイコンをクリックします。

リンクまたはクロスリンクされたスクリプトを実行する場合 (データ ソースに関係なく)、AppOptions タグ「SuppressPreRunWarning」を true に設定すると、実行、検証、シミュレーション、デバッグ、およびスケジュール アクションの実行時に、一般的なダイアログ メッセージは表示されません。ただし、AppOptions タグ「SuppressPreRunWarning」が false (デフォルト設定) に設定されている場合、または AppOptions タグがない場合は、これらのアクションを実行すると、一般的なダイアログ メッセージが表示されます。一般的なメッセージ ダイアログは、マクロまたはコマンド ラインの実行では表示されません。

(AppOptions タグはデフォルトでは AppOptions ファイルにありません。手動で追加する必要があります。また、「デフォルトに戻す」は、ユーザーがタグを追加した場合、AppOptions ファイルからタグを削除します。)

ヘッダーを書き込む

スクリプト用の Excel データ ファイルが利用できない場合は、新しいシートにヘッダーを書き込む必要がある場合があります。Studio および Excel アドインからヘッダーを書き込むことができます。

注:

[ヘッダーを書き込む] がグレー表示されている場合は、[ヘッダーをロック解除] をクリックします。

ルックアップ値

条件にはルックアップ値を使用できます。

  1. [基準] タブで、フィールドの基準タイプを [セル] に変更します。(これは、セルベースと列ベースの両方のマッピングに適用されます。)
  2. 値ボックスにセルを入力します。たとえば、G2 と入力します。
  3. [実行] タブをクリックして、セルを選択します。
  4. [ルックアップ値] をクリックし、必要に応じて SAP にログオンしてから、基準に使用する値を選択します。

レコードを書き込む

クエリでデータ ファイルに結果を書き込む方法を選択します。

結果ファイルにデータを追加: Query がワークシートの既存データの最後の行に、新しいデータを書き込み始めます。

結果ファイルのデータを上書きする: Query は既存のデータを上書きします。ただし、ダウンロードされたデータの行がワークシートのデータよりも少ない場合は、残りの行のデータはそのまま維持されます。たとえば、ワークシートに 100 行のデータがあり、クエリを実行して 75 行のデータをダウンロードした場合、最後の 25 行はシートに残っています。

結果ファイルからすべてのマップされたデータをクリア: 開始行で開始して、Query が既存データをクリアして、新しいダウンロードされたデータを書き込みます。

開始行

データ シートに上書きしたくないデータがすでに含まれている場合は、別の開始行を入力します。

自動ログオン資格情報

スクリプトを将来実行するようにスケジュールする場合、または定期的に実行するようにスケジュールする場合に、SAP を自動的に開くために使用する自動ログオン資格情報を選択します。この設定は、スクリプトを実行するたびにログオン情報を入力したくない場合にも役立ちます。

自動ログオン資格情報を保存する

  1. [自動ログオン資格情報]をクリックし、[新しい自動ログオン資格情報を追加]をクリックします。
  2. [SAP ログオン]ボックスで、[資格情報]タブをクリックします。
  3. SAP システムを選択し、クライアント番号、ユーザー名、およびパスワードを入力します。
  4. [自動ログオン資格情報として保存] チェック ボックスをオンにし、[自動ログオン名] ボックスに資格情報の名前を入力します。

資格情報は、C:\Users\<ユーザー名>\AppData\Roaming\Winshuttle\Connector\11 に保存されている wsSAPConnector.xml ファイルに保存されます。他のコンピューターから SAP に接続する場合は、ファイルを他のコンピューターにコピーできます。

実行理由を要求

スクリプトが実行されるたびに [実行理由] ボックスを開くには、このボックスをオンにします。Studio はスクリプトに関するいくつかの基本情報を追加しますが、実行を開始する人が詳細を提供できます。

SAP バックグラウンド プロセスとして実行

SAP システムへの処理の影響を減らすには、このボックスをチェックします。

アダプティブ クエリ スロットリングを有効にする

アダプティブ クエリ スロットリング アルゴリズムが適用されると、システムの負荷が増加するにつれてクエリの実行が遅くなります。ただし、アルゴリズムがないと、クエリは一定時間で実行され、システム上の他のトランザクションとリソースを奪い合います。

注:

アダプティブ クエリ スロットリングは、論理データベースまたは InfoSet と SAP クエリでは使用できません。

重要: このオプションをオフにするとクエリのパフォーマンスが向上しますが、サーバーがすでに過負荷になっているとサーバーがクラッシュする可能性があります。最良の結果を得るには、SAP サーバーの負荷が高くないことが確実でない限り、常にこのオプションをオンにしてクエリを実行してください。

データ チャンク

この設定は、多数のレコードをダウンロードする場合のパフォーマンスに役立ちます。デフォルトでは、単一テーブルクエリの場合、Studio クエリは、フィールドの合計の長さやダウンロードするレコード数などのクエリの特性に基づいて、実行に最適なチャンク値を計算します。

データ チャンク値を指定すると、Studio クエリは各チャンクのレコード数のみをフェッチします。チャンク サイズの最大許容値は 450000 です。ダウンロードの実行時間が長すぎる場合にダウンロードを停止できるように、[停止] ボタンも表示されます。

注:

データ チャンク設定は、 InfoSets および SAP クエリでは使用できません。

オプション ボックス設定

[ファイル] タブをクリックし、[オプション] をクリックして、次のタブをクリックします。

[データ設定] タブ

データ ファイルの保存

データ ファイルを保存するためのデフォルトの命令を、 保存しない実行の最後に保存、または [n] レコード後に保存から選択します。ここで [n] は指定する番号です。

データのダウンロードによって既存のデータが上書きされる場合に警告する

クエリのダウンロードによってデータ ファイルの既存の値が上書きされないようにするには、このボックスをオンにします。

[SAP 設定] タブ

クエリ実行タイムアウト (秒)

実行の開始から結果のダウンロードまでの最大時間を指定します。Query がその時間枠内に結果を返すことができない場合、Query は自動的にキャンセルされます。

アダプティブ クエリ スロットリングを有効にする

[オプション] ボックスで [アダプティブ クエリ スロットリング] をオンにすると、すべてのクエリに対してデフォルトで設定されます。