BAPI からスクリプトまたはテンプレートを作成するコツは、BAPI のすべての要件が分かっていることです。Studio では、[ドキュメント] パネルで詳細を確認できます。
BAPI ベースのスクリプトを Access データ ファイルにマップすることはできません。必ず Excel データ ソース ファイルを使用してください。
このトピックでは、BAPI に基づいて Transaction スクリプト ファイルを作成する基本的なエンド ツー エンドのプロセスを段階的に説明します。
作成方法と SAP へのログオンを選択する
- [ファイル] タブをクリックして、[新規] をクリックします。
- [Direct] をクリックします。
- [作成方法の選択] で、[BAPIから作成] をクリックします。
- Studio のログオン画面で、次のいずれかを実行します。
- [SAP システム] ボックスをクリックしてから、ログオンする SAP システムをクリックします。
- [高度な SAP ログオン] をクリックします。[SAP ログオン] ボックスで、SAP システムを選択し、顧客番号、ユーザー名、およびパスワードを入力します。
注: 将来のセッションのために資格情報を保存するには、[自動ログオン資格情報として保存] チェック ボックスをオンにし、[自動ログオン名] ボックスに資格情報の名前を入力します。次回 Studio から SAP にログオンするときに、[SAP システム] ボックスの自動ログオン名とその他の資格情報が表示されます。[ログオン] ボタンをクリックするだけです。 - [OK] をクリックします。
- [データ タイプ] ボックスで、使用するデータ ファイルのタイプを、Excel ワークシートまたは Aceess データベースから選択します。
- スクリプトに既存のデータ ファイルを使用する場合は、[データ ファイル] ボックスの横にあるフォルダー アイコンをクリックして、使用するファイルを参照します。注: データ ファイルにピボット テーブル、3-D チャート、またはカスタム XML が含まれる場合、ファイルは読み取り専用モードで開きます。ピボット テーブルやその他の要素をファイル内で維持するには、Excel で開いてバックグラウンド モードで実行します。[編集を有効にする] をクリックすると、それらの要素がファイルから削除されます。
- [スクリプトの作成] をクリックします。
BAPI、テーブル、およびフィールドを選択します
- 検索/BAPI パネルで、BAPI または RFM を選択します。
- 名前または名前の一部とワイルドカード文字を入力します。たとえば、*ACC_GL* と入力し、次に [検索] をクリックします。
- 使用する BAPI または RFM をクリックしてから、 [選択した BAPI から作成] をクリックします。
- BAPI にコミット コードが必要な場合は、[コミットが必要] チェックボックスをオンにします。
BAPI が HRBAPI の場合は、 [エンキューが必要] チェックボックスをオンにします。エンキュー ボックスは、更新を行うことができるように人事レコードをロックします。HR 更新 BAPI が実行された後、エンキュー ロックが解除され、レコードが解放されます。
- リストで、使用するテーブルをクリックしてから、ワークスペースで、使用するフィールドのチェックボックスをクリックします。
右側のパネルのテーブル名または構造名の横で、Studio に選択されているフィールドの数が表示されます。
- 使用するテーブルとフィールドを選択したら、[エキスパート ビュー] タブをクリックします。注:
これが探していた BAPI でない場合は、[検索] をクリックして別の BAPI を探すことができます。ただし、新しい BAPI を追加すると、Studio は以前の BAPI とフィールドの選択またはマッピングを削除します。
フィールドをマップする
Studio は、マップにループを自動的に追加し、一部のデータ型のパディングを選択します。
パディングを変更するには、エキスパート ビューが表示されていることを確認します。次に、行をクリックして選択し、[タイプと長さ] の値をクリックし、必要なパディング オプションをクリックします。
フィールドをマップするには、次のいずれかを実行します。
- [データ セット] パネルでセルを選択し、マップのフィールドにドラッグします。スクリプトに含めるフィールドごとに繰り返します。
- [自動マップ] をクリックします。
重複するフィールドをマップする
異なるテーブルにある重複フィールドをデータ ファイルの同じ列にマッピングすることにより、データ エラーを回避します。
- [エキスパート ビュー] で、[データ セット] パネルのフィールドの最初のインスタンスの列をクリックします。
- マップのフィールドの重複インスタンスにドラッグします。
フィールドの両方のインスタンスは、データ ファイルの同じ列にマップされます。
ループを変更する
複数のテーブル (明細のフィールドなど) に関連するデータがある場合は、個別のループを 1 つの長いループに置き換えることができます。
- 行を選択して右クリックし、[削除] をクリックして、2 番目のループを削除します。
- 残りのループをクリックしてから、スルー ボックスの行番号を、ループに含める最後の行に変更します。
- 明細の一部に含める必要がある追加のテーブルとフィールドについて、手順 1 と 2 を繰り返します。
必須フィールドを指定する
BAPI スクリプトを実行する場合、SAP ではいくつかのフィールドが必須です。必須フィールドを見つけるには、 [ドキュメンテーション] パネルでテーブルのドキュメンテーションを確認します。
フィールドをクリックしてから、[値] 列の [必須フィールド] ボタン (*) をクリックすると、データが必須であることを確認できます。 または、 [プロパティ] パネルの [必須データ] ボックスをオンにすることもできます。
ルックアップリストを作成する
BAPI は SAP ルックアップ値を使用しませんが、許可された値を使用してリストを作成できます。
- フィールドをクリックして選択します。
- [許可される値] をクリックします。
- [許容値] ボックスで、[演算子] をクリックして演算子を選択します。
- 値を入力するか、リストを作成します。
SAP からデータをダウンロードする
BAPI を使用して、SAP からデータをダウンロードできます。マップの方向を [SAP からダウンロード] に変更します。
BAPI スクリプトにダウンロードされるデータが XML/SAP API スクリプトに対してループしている場合、異なる並列ループ (単一のループではなく) が異なるテーブルをカバーする必要があります。そうしないと、データの不一致が発生します。
スクリプトを実行します
マップの SAP フィールドをデータ ファイルの列にマッピングした後、データを入力してスクリプトを実行します。データ ファイル内のデータの各行が SAP にアップロードまたは SAP からダウンロードされます。
[実行] タブには、使用されているスクリプトとデータ ファイルに関する詳細が表示されます。スクリプトが実行されている理由に関するコメントを [実行理由] ボックスに追加できます。
- [実行] タブをクリックします。
- 転記するデータを入力します。
BAPI にはいくつかのデータ フォーマットの制限があります。日付形式は、コンピューターの地域設定で指定されている日付形式と一致するか、yyyymmdd である必要があります。一部のフィールドでは、大文字と小文字の形式を大文字にする必要があります。大文字にしないと、SAP は項目を見つけることができません。
- [データの確認] をクリックして、フォーマットが正しいことを確認します。
- 次のいずれかまたは両方を実行します。
- ワークシートの各行を確認するには、[検証]をクリックします。
- [シミュレーション] をクリックして、ワークシートの各レコードまたはトランザクションを確認します (これは、Winshuttle Function Module がインストールされているシステムでのみ使用できます)。
- [実行] をクリックするか、 [実行] ボタンの矢印をクリックして、[実行] オプションの 1 つをクリックします。
スクリプトの実行中にエラーが発生した場合、Studio は残りのレコードのデータをアップロードし続けます。Excel では、SAP から返された成功メッセージとエラー メッセージはすべて、レコードごとに 1 つのログとともにログ結果列に記録されます。
エラーを修正
- 値を修正します。
- [実行]ボタンの矢印をクリックしてから、[エラー行のみを実行]をクリックします。
Studio は、修正されたレコードのみをアップロードします。
実行オプション
これらのオプションは、スクリプト開発者またはスクリプト実行者が設定できます。
- 指定された範囲を実行: データ ファイルの一部の行だけをアップロードします。[開始行]ボックスと[終了行]ボックスを使用して、範囲を指定します。
- 最初の 5 つのトランザクションを実行する: 大規模な実行を開始する前に、データ ファイルの最初の 5 行を実行して、データをテストします。
- エラー行のみを実行: 中のデータを修正後の行を処理します。
- 未処理行のみを実行: 追加された行または実行が停止したために処理されなかった行を実行します。このオプションは、スクリプトの実行者が設定できます。
これらのオプションは、スクリプト開発者のみが設定できます。
- 実行理由が必要: スクリプトの実行時に [実行理由] ボックスを開きます。Studio はスクリプトに関するいくつかの基本情報を追加しますが、実行を開始する人が詳細を提供できます。
- 未処理のみを実行: 追加された行または実行が停止したために処理されなかった行を実行します。このチェック ボックスは、スクリプト開発者のみが選択できます。
- アップロードの遅延 (ms): コミット コードの処理に遅延が必要なトランザクションの各行の間にわずかな処理遅延 (ミリ秒単位) を追加します。