トランザクション、クエリ、およびサードパーティの Web サービスのインポート - Automate_Evolve - Automate_Studio_Manager - 20.3

Automate Evolve ユーザー ガイド
Product type
ソフトウェア
Portfolio
Integrate
Product family
Automate
Product
Automate > Automate Evolve
Version
20.3
Language
日本語
Product name
Automate Evolve
Title
Automate Evolve ユーザー ガイド
Topic type
管理
概要
リファレンス
First publish date
2018

Web サービスとトランザクションおよびクエリ スクリプトをソリューションにインポートして、アドレスや電子メールの検証などの機能を有効にすることができます。

ソリューションへのサービスまたはスクリプトのインポートは、次の 3 つの主要なアクションで構成されます。

  1. Web サービスまたはスクリプトをインポートします。
  2. スクリプト内のフィールドをフォーム内のフィールドにマップするフィールド マッピングを作成する。
  3. サービスまたはスクリプトのフィールドを編集または再マッピングする。
注:
  • Evolve を介してクエリ スクリプトを実行する場合は、Winshuttle Function Module が必要です。

  • サードパーティの Web サービスの場合、SOAP 1.1 バージョンでのみ Web サービスをサポートします。

Evolve 管理者は、フォームのクエリ Web サービスのガードレールのスループット (クエリによって返される行数) と、Web/Service Worker からサービスのクエリ出力を送信するための再試行制限を制限できます。

新しいワークフロー構成オプション MaxFormQryDataDownload が、ソリューション レベルのスコープとデフォルト値 10,000 で実装されました (つまり、クエリは 10,000 を超えるレコードを返すことができません)。この構成オプションは、Evolve バージョン 20.3 以降からデフォルトで存在し、アップグレードと新規インストールの両方に適用できます。場合によっては、ユーザーがデフォルト値を変更する必要があります (デフォルトの制限を増減します)。これは、構成キー MaxFormQryDataDownload を希望の値に設定することで実行できます。このキーは、フォームでクエリ Web サービスを使用して取得できるレコードの最大数を定義します (バックグラウンドまたはフォアグラウンド実行)。

Web サービスによってフェッチされるレコードの数は、さまざまなポリシーと設定を使用して制限できます。このキーの値は、ポリシーまたは優先設定の値よりも優先されます。いずれの場合も、クエリによってフェッチされたレコードの数が MaxFormQryDataDownload キーで定義された値よりも大きい場合、キーで定義された値が尊重されます。

レコード数が MaxFormQryDataDownload より大きい場合、MaxFormQryDataDownload キーで定義された値のみをダウンロードします。ユーザーは、システム > インフラストラクチャー >「アドバンス キー」に上記のキーを追加することで、デフォルト値を変更できます。このキーがアドバンス キーに存在しない場合、キーに対応するデフォルトの間隔が適用されます。

サポートされている Web サービスのバインディングとメッセージ タイプ

サポートされているメッセージ タイプ

サポートされている WSDL バインディング

  • 入力メッセージ
  • 出力メッセージ
  • 入力ヘッダー
  • 出力ヘッダー

サポートされていないメッセージ タイプ

  • 障害メッセージ
  • base64binary
  • boolean
  • byte
  • 日付
  • dateTime
  • decimal
  • Double
  • int
  • long
  • short
  • 文字列
  • 時間
  • unsignedbyte

Winshuttle 更新プラグインの場合、runnernode パラメータによって返されるユーザーが以下の目的で使用されます。

  • Web サービスがシステム アカウントで設定されている場合を除き、SAP にログインするための認証情報を取得するため。

  • Web サービスがシステム アカウントで構成されている場合でも、適切なライセンスを検証するため。

トランザクションまたはクエリ スクリプトをインポートする

ソリューションで使用するトランザクション スクリプトまたはクエリ スクリプトをインポートするには、次の手順に従います。

  1. [ソリューション] タブをクリックします。
  2. [ソリューション] ウィンドウで、[トランザクション スクリプト] または [クエリ スクリプト] を右クリックし、[インポート] をクリックします。
  3. [インポート] 画面で、[ファイルを選択] をクリックしてスクリプト XML ファイルを参照し、XML ファイルを選択します。
  4. [次へ] をクリックして、[フィールド マッピングの作成] (下記) を参照してください。

Web サービスのインポート

ソリューションで使用する Web サービスをインポートするには:

  1. [ソリューション] タブをクリックします。
  2. [ソリューション] ウィンドウで、[Web サービス] を右クリックし、[インポート] をクリックします。
  3. [インポート] ペインに、グローバル レベルまたは現在のアプリ レベルで追加されたすべての Web サービス接続のリストが表示されます。必要に応じて、資格情報 (ドメイン、ユーザー名、パスワード) を入力します。
    注:

    Web サービス接続の詳細については、[外部の Web サービス] ページを参照してください。このソリューションにインポートする Web サービスを選択します。

  4. [次へ] をクリックして、[フィールド マッピングの作成] (下記) を参照してください。

Web サービスやその他の場所で、あらゆるタイプの繰り返し要素 (例: 繰り返しグループや繰り返しテーブルなど) を扱う際には、以下のことを確認してください。

  • [フォーム データ ツリー] 内の [繰り返しコンテンツ] フォルダ内のフィールドは、繰り返しコンテナ内のフォームにも含まれている。
  • [フォーム データ ツリー] の繰り返しでないフィールドは、すべてフォーム内で繰り返しでない。

これらのガイドラインに従わないと、Web サービスの実行時に繰り返し要素を操作する際に、意図しない動作をする可能性があります。

フィールド マッピングの作成

インポートされた Web サービスのフィールド マッピングを作成するには:

  1. [ソリューション] ペインで、[Web サービス] をクリックして展開します。
  2. Web サービスを右クリックし、[フィールドマッピングの作成] をクリックします。
  3. [説明] の下に、Web サービスの説明を入力します。

  4. [グループ名] で、メニューからグループを選択するか、グループの名前を入力します。名前は、アルファベットまたはアンダースコアで始まり、アルファベットとアンダースコアのみを含むことができます。名前には、既存のグループの名前、または作成する新しいグループの名前を指定できます。

    注:

    既存のグループを選択し、[既存の入出力フィールドを使用] を選択すると、インポートの際にそのグループに既存のフィールドを探します。

  5. [繰り返しセクションの生成] をオンまたはオフにします (必要に応じて)。

  6. アップロード オプションを選択します。

    • 単一アップロード - レコードを順番にアップロードする場合。一括アップロード オプションと比較すると遅くなります。アップロードが完了すると、ログはレコードごとに順番に更新されます。

    • 一括アップロード - レコードを一括でアップロードする場合。レコード数が 100 未満の場合は、このオプションを使用することをお勧めします。一括アップロードが完了するとすぐに、ログは複数のエントリ (各レコードに 1 つ) と同時に更新されます。一括アップロード機能にアクセスしたい場合は、詳細について営業アカウント担当者にお問い合わせください。

    注:

    南

    • このオプションは、[繰り返しセクションの生成] チェック ボックスをオンにした場合にのみ有効になります。

    • タイムアウトの問題が発生する可能性があるため、100 レコードを超える一括アップロードを使用することはお勧めしません。

    • この数値はフォームによって異なる場合があり、Excel データ ソースでテストしてしきい値を決定することをお勧めします。

    • Web サービスのインポート タイプを変更して既存のスクリプトの一括アップロード オプションを有効にするには、マッピングを再作成するか、スクリプトを再度追加する必要があります。マッピングを削除して、新しいマッピングを作成することもできます。

  7. [Web サービス名] に、サービスの名前を入力します。
  8. [操作] で、矢印をクリックして、メニューから操作を選択します。これは、サードパーティの Web サービスにのみ適用されます。
  9. [次へ] をクリックして [フィールド マッピングの編集] ボックスを開き、 手順 4 からフィールド マッピングの編集 (下記) に進みます。

フィールド マッピングの編集

複数のスクリプトで同じ入力値を使用しているが、フォームに同じフィールドを複数回使用したくない場合は、フィールドのマッピング方法を変更できます。

  1. [ソリューション] タブをクリックします。
  2. ソリューション ツリーで、[トランザクション スクリプト]、[クエリ スクリプト]、または [Web サービス] を展開して、マップされたスクリプトを表示します。
  3. ソリューション ツリーでスクリプト マッピングを右クリックし、[フィールド マッピングの編集] をクリックします。
  4. [Web サービス フィールド] の下に、フィールドのリストが表示されます。
  5. [フォーム フィールド] 列で、ドロップダウン メニューをクリックして、Web サービス フィールドをマップするフィールドを選択します。マップするフィールドごとに繰り返します。
  6. [OK] をクリックします。
注:

フォームから入力フィールドを削除しないでください。その代わり、スキップ フィールド インジケーター (デフォルトは「/」) を入力し、フィールドを非表示にして使用しないようにします。転記中に日付フィールドをスキップするには、日付ピッカーで値を 01/01/1700 として使用します。詳細については、[トランザクションの実行設定] および [フィルター マッパー設定] の [スキップ インジケーター] セクションを参照してください。入力フィールドを削除すると、スクリプトは空白のフィールドをアップロードし、既存の値を上書きします。

詳しい情報:
  • [既存のフィールドを使用] がチェックされている場合、Solution Designer は、同じ名前のスキーマ内のフォーム フィールドにマップします。[フォーム フィールド] リストで、アスタリスクが付いているフィールド (*) [既存のフィールドを使用] がオン になっているかどうかに関係なく、スキーマにまだ存在せずに作成されるフィールドを示します。
  • [既存のフィールドを使用] がチェックされておらず、フィールドにアスタリスクが付いていない場合、Solution Designer は「_n」 (n=数字) という接尾語を使用して、新しい固有のフィールド名を生成します。

クエリまたはトランザクション スクリプトにマッピングする場合は、[SAP 認証情報を使用] チェック ボックスが有効になります。このオプションは、 マッピングに [SAP 認証情報] フィールド追加し、フォーム使用者の認証を SAP に移転できるようにします。