Studio を使用すると、SAP Data API にアクセスできます。Studio を使用してスクリプトを作成し、Evolve に送信できます。Studio には、トランザクション/クエリ スクリプト向けの JSON 形式である、データ ソース タイプ SAP API (JSON) があります。アドバンス キー SapIntegrationAPIEnable は、有効な SAP Data API ライセンスの可用性に基づき、true/false に設定されます。アドバンス キー SapIntegrationAPIEnable が true の場合、JSON は Studio でデータ ソース タイプとして表示され、SAP API ライブラリ は Evolve でも表示されます。このキーが有効になっていない場合、ユーザーは JSON マップ ファイルを開くことはできません。
Studio から SAP Data API にアクセスするには、次のステップに従います。
- 有効な SAP Data API ライセンスをアクティブにします。
-
Evolve に SAP API ストア ライブラリを作成します。「Evolve を使用した SAP Data API」 の SAP API ストア ライブラリを参照してください。
SAP Data API と統合するためのスクリプトの作成します (トランザクション/クエリ/ダイレクト)
スクリプト統合を作成するには、ユーザーはそれぞれの製品のライセンスを持っている必要があり (つまり、トランザクション/クエリ)、 また対応する製品ライブラリのソリューション開発者の役割も必要です。スクリプト統合を作成するには、以下のステップに従う必要があります。
-
[ファイル] → [新規] → SAP Data API として作成するスクリプトのタイプの順にクリックして選択します。
-
[SAP Recording から作成] をクリックします。
-
有効な資格情報を使用して SAP サーバーにログインします。
-
[トランザクション コード] テキスト ボックスに記録用の有効な TCode を入力し、データ タイプ ドロップダウンから [SAP API (JSON)] を選択します。このデータ タイプは、Evolve でアドバンス キー SapIntegrationAPIEnable 値が true の場合にのみ表示されます。
-
[記録の開始] をクリックして、新しい SAP Data API スクリプトを作成します。
ユーザーは、有効な JSON スキーマを使用して既存の JSON ファイル (.txt および .json) を選択することもできます。
新しいスクリプトの作成後、マッパーは無題のファイルを表示します。既存のファイルが渡された場合、データ ソース ビューは、有効な JSON スキーマがある既存のファイルを使用して入力されます。参照ボタンをクリックして、有効な JSON スキーマを使用し、他のファイル (.txt/JSON) を開くことができます。提供された JSON が逆シリアル化されていない場合は、エラーがスローされます。トランザクションの場合は、[更新] ボタンを使用して、マッパーの最新の変更を含む JSON ペイロードを生成できます。JSON ペイロードは、単一のトランザクションに対してのみ生成されます。SAP Data API では、一括アップロードは利用できません。クエリの場合は、[実行時] の基準ダイアログで入力基準が尋ねられるため、[更新] ボタンは必要ありません。
-
SAP API 呼び出しでの不正なエラー 403 は、必要な権限がないか、SAP が実行を継続する上で認識されない壊れた URL があることを意味している可能性があります。SAP は、どちらの場合も 403 エラーを発生します。
-
この場合は SAP トレース (/IWFND/TRACES) を使用し、ペイロード トレースを有効にします。これにより、問題が表示されます
次に、以下のステップに従います。
-
ペイロード トレース出口を設定します。
-
tcode に移動し、[ペイロード トレース] タブに移動します。
-
Evolve からの呼び出し後に更新します。
-
エラーとしてリストされている呼び出しを開き、[エラー ログ] をクリックします。
-
ソリューションの Evolve への送信
SapIntegrationAPIEnable キーが有効になっている場合、ユーザーは Evolve で作成された SAP API ライブラリでソリューションを送信し、Evolve を使用した SAP Data API で SAP API ストア ライブラリを参照できるようになります。SAP API ライブラリでソリューションを送信するには、ユーザーはいずれかの SAP API ライブラリでソリューション開発者の役割を持っている必要があります。以下のステップに従って、ソリューションを送信します。
-
ソリューションを Evolve に送信するには、[Evolve] タブに移動し、[送信] をクリックします。送信ウィザードがポップアップ表示されます。
-
[スクリプト情報] タブで、[ソリューション名]、[カテゴリ]、[説明] を追加します。[カテゴリ] フィールドと [説明] フィールドは必須ではありません。
-
[データ テンプレート] タブは、トランザクションとクエリの両方で無効になります。
-
[ソリューション ファイルのワークフロー] タブで、[宛先] には SAP API ライブラリのみが表示されます。[ソリューションの承認] のみが有効になっている場合は、レビュー担当者リストが表示され、選択したアプリのすべてのレビュー担当者が表示されます。自己承認設定が無効になっている場合、現在のユーザーはレビュー担当者リストに表示されません。
-
[サポート ドキュメント] タブが有効になり、トランザクションとクエリの両方のソリューションでサポート ドキュメントを追加できるようになります。
-
[概要] タブで、[送信] をクリックしてソリューションを Evolve に送信します。
すべての ソリューション (トランザクション/クエリ) が、SAP Data API タイプの同じライブラリに入れられます。[ソリューションの承認] 設定が無効になっている場合、ソリューションは実稼働状態になります。無効になっていない場合、選択したレビュー担当者に対してレビュー タスクが作成されます。レビュー担当者は、ソリューションを実稼働状態に移行するためにソリューションを承認する必要があります。
Evolve の [デフォルト] の宛先を追加できます。[アプリ オプション] → [Evolve] → [ソリューション ライブラリ] ダイアログの順に移動して SAP API ソリューションを追加します。このソリューションは、SapIntegrationAPIEnable 値が true に設定されている場合にのみ表示されます。Evolve にはデフォルトの「SAP API」ライブラリがないため、デフォルトのテキストは空白です。[参照] ボタンは、ログインしたアプリの権限に従って、すべての「SAP API」ライブラリを表示します。選択したライブラリがテキスト ボックスに表示され、同じものが [Evolve に保存] アクションで Evolve に保存されます。
SAP Data API のオープン ソリューション (トランザクション/クエリ/ダイレクト)
「SapIntegrationAPIEnable」キーが有効になっている場合、ユーザーは「SAP API ライブラリ」を表示できます。Studio は、Excel ソリューション ライブラリの下に「SAP API ライブラリ」ライブラリを表示します。「SAP API」ライブラリには、デフォルトで選択されたライブラリのすべてのソリューションが表示されます。ライブラリが選択されていない場合は、リストに含まれているライブラリが表示されます。「SAPAPIライブラリ」には、トランザクション ソリューションとクエリ ソリューションの両方が表示されます。残りの動作は他のライブラリと同じです (つまり、ステータス、検索ソリューション、ライブラリの閲覧)。ソリューションをクリックすると、それぞれのビューがロードされます。
[Evolve] タブは、ソリューションのステータスに基づいて入力されます。ソリューションが設定に応じてレビュー プロセスを経由する場合は、プロセス履歴が表示されます。それ以外の場合は、履歴は表示されません。ソリューションがサポート ドキュメントとともに提出されている場合は、サポート ドキュメントが [Evolve] タブに表示されます。
SAP Data API (トランザクション) の実行
[マップ] タブのデータ ソース ビューで [JSON の生成] ボタンを押すと、スクリプトに従って単一トランザクションの JSON ペイロードが生成されます。[参照] ボタンは、既存の JSON ファイルを渡すために使用されます。Studio は、単一トランザクションの実行のみをサポートします。XML データ ソースでサポートされているローカル スケジューリングとチェーン スクリプトはサポートされていません。残りの実行設定の動作は、XML データ ソースと同様です (つまり、検証がオンの場合、「検証」と「シミュレーション」が表示されます)。リスト値が指定されている場合は、データのチェックが機能します。[テスト] ボタンをクリックすると、[実行] タブからローカルで SAP Data API を実行できます。スクリプトが実稼働状態の場合は、[実行] ボタンが使用可能になります。
SAP Data API (クエリ) の実行
[アプリ] → [設定] → [実行設定] → [スケジュール] の順に移動して SAP API (JSON) のオプションを切り替え、Studio クライアントを介してローカル スケジュールを制御できます。「SAP API (JSON)」オプションが true を返す場合、Studio はローカル スケジューリングを表示します。デスクトップ スケジューリングのその他の動作は、XML データ ソース タイプと類似しています。データ ソース ビューには、有効な JSON スキーマを持つ任意の .txt ファイルを選択するための [参照] のみが表示されます。レコードの書き込みには、結果ファイルからすべてのマップされたデータをクリアするオプション 1 つだけがあります。レコードとヘッダーの区切り文字は無効になっていることが示され、残りのオプションは XML データ ソースと類似しています。スクリプトのチェーンは許可されていません。[テスト] ボタンをクリックし、[実行] タブからローカルで SAP Data API を実行します。スクリプトが実稼働状態の場合は、[実行] ボタンが使用可能になります。