コマンド ラインから Query ソリューションを実行する - 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

コマンド プロンプトで実行されるすべてのコマンドは、クエリ ファイルにすでに含まれている同じコマンドよりも優先されます。

注:

ログ メッセージが確実に保存されるようにするには、Excel の保存オプションを [実行の最後に保存] に設定します。

あなたは、この構文を使用して、コマンド ラインから Query スクリプトを実行することができます (これは、データ ファイルが存在しない場合でも動作することに注意してください)。

"Winshuttle.Studio.Console.exe full path" -SapQuery -run"<Query solution name>” -lib"Qxq lib" -tms"MY App"

注:

このコマンドでは、"Winshuttle.Studio.Console.exe full path" を二重引用符で囲む必要があります。さらに、「Winshuttle.Studio.Console.exe full path」と「Query solution name」の間に 1 つのスペースがあることを確認してください。

例 1: これは、ローカルで実行されるソリューションに適用されることに注意してください。Sample.qsq をデフォルトの場所 C:\MyDocuments\Winshuttle\Studio\Script\ で実行する場合、コマンド ライン構文は次のとおりです。

"C:\Program Files\Winshuttle\Studio\Winshuttle.Studio.Console.exe" -SapQuery -run"C:\MyDocuments\Winshuttle\Studio\Script\Sample.qsq"

このコマンドは、Sample.qsq ファイルがロードされた状態で Studio を起動し、クエリ スクリプトの実行を開始します。このコマンド ライン操作をテストするには、Windows の実行ダイアログ ボックスでこのコマンドを実行します。

注: 例 2:  これは、Evolve から実行されるソリューションに適用されることに注意してください。コマンドの構文は次のとおりです。
注: “C:\Program Files\Winshuttle\Studio\Winshuttle.Studio.Console.exe" -SapQuery -run"Sample" -rfn"C:\Users\msharma\Documents\Winshuttle\Studio\Data\Sample.xlsx" -cnn"W6R Non Prod" -lib"Query lib" -tms"Ms App" -dsr"2" -der"0" -rsn"Test Run reason" -eml"abc@aaa.com" -arf"True" -dsw"True" -irr"True"

コマンド リファレンス

クエリ スクリプト コマンドを使用すると、マッパーに記録されている Transaction スクリプトを編集できます。

注:

電子メール設定が Evolve サイトに追加されておらず、コマンドで -eml (email) パラメーターを指定すると、警告メッセージが表示されます。

パラメータ 説明
-drs 実行シートを設定する

-drs "SheetName"

-cnn

AP 接続名

cnn"W6r-n-800"

-lib ライブラリ名 -lib"Query lib"
-scn SQL 接続名 -scn”SQl1001”
-tms チームスペース名 -tms"Ms App"

-arf

投稿結果をデータ ファイルに添付

-arf"true"

-dsw

本番サーバーの警告を無効にする

-dsw"true"

-rfn

結果ファイル名

-rfn"C:\Users\centraluser\Desktop\MM02.xlsx

-eml

スケジュール確認時に通知メールを送信する

-eml"someone@winshuttle.com,someone@example.com"

-irr

実行理由が必要かどうか

-irr"true"

-rsn

実行理由

-rsn"これはデモの実行です"

-dsr

開始行

-dsr"5"

-rtv

実行時変数

-rtv"TableName.FieldName#Value1#Value2|Value3##Value4|Value5|Value6~TableName.FieldName#Value1#Value2"

技術者への注意事項: 顧客サポートの Joshua Whitener によると、以下の非表示のテキストはすべて 2018 年 7 月に削除されました。再び関係するようになった場合に備えて保持しています。

#AE

任意のコマンドです。

使用すると、Transaction は Transaction スクリプトの実行後に閉じます。

例:

#AE

#AR

任意のコマンドです。

使用すると、Transaction を開いたときに、Transaction スクリプトが自動的に実行されます。処理を実行するために[実行]ボタンは必要ありません。

例:

#AR

#BD

任意のコマンドです。

使用すると、Transaction は現在の SAP データ フィールド値のバックアップ コピーを自動的に作成します。

例:

#BD

#F1InputExcelFileName

必須のコマンドです。

使用すると、Excel スプレッドシートのパスと名前を指定します。

例:

#F1C:\My Documents\Change MRP Controller.xls

#L1LogColumn

必須のコマンドです。

使用すると、Transaction は選択した Excel ワークシートの指定された列にトランザクション ログを保持します。SAP データと返されたメッセージを同じ Excel ワークシートに保存すると、処理結果を 1 つの共通の場所で表示できます。

注: ワークシートの指定された列が空白であることを確認してください。それ以外の場合、Transaction は、返された SAP メッセージで列に含まれるすべてのデータを上書きします。Transaction が実行を完了すると、スプレッドシートは自動的に保存されます。

例:

#L1G

選択した Excel ワークシートの列 G にトランザクション ログを保持します。

#NTNext linked

完全なパス [,nCarryonSettings] を持つ Transaction スクリプト

任意のコマンドです。

現在の Transaction スクリプトの実行が終了した後、別の (次の) Transaction スクリプトを起動する #NT コマンドを使用します。

nCarryonSettings は次のようになります。

0 [デフォルト値] 現在の Transaction スクリプトからの設定 (Excel スプレッドシート名、シート名、開始行、および終了行) を引き継ぎません。

1 現在の Transaction スクリプトから設定を引き継ぎます。

例:

#NTC:\My Documents\TRANSACTIONscript\ME01.TRANSACTIONscript

[実行]を選択すると、現在の Transaction スクリプトの実行が完了した後、Transaction は ME01.TRANSACTIONscript を起動します。

#NTC:\My Documents\TRANSACTIONscript\ME01.TRANSACTIONscript,1

このステートメントは、ME01.TRANSACTIONscript で指定された Excel ファイル名、シート名、開始行、および終了行の値を無視します。代わりに、Transaction は、現在開いている Transaction スクリプトからこれらの値を引き継ぎます。

キー ポイント:

現在の Transaction スクリプトにリンクできる Transaction スクリプトは 1 つだけです。たとえば、現在の Transaction スクリプトが MM01.TRANSACTIONscript の場合、ME01.TRANSACTIONscript をこのファイルにリンクできます。ただし、ME01.TRANSACTIONscript と ME11.TRANSACTIONscript をリンクすると、TRANSACTION で構文エラーが発生するため、TRANSACTION スクリプトを実行する前に修正する必要があります。

任意の数の TRANSACTION スクリプトを連鎖させることができます。たとえば、MM01.TRANSACTIONscript は ME11.TRANSACTIONscript を指すことができ、ME11.TRANSACTIONscript は ME01.TRANSACTIONscript を指すことができます。TRANSACTION は、最初に MM01.TRANSACTIONscript を実行し、次に ME11.TRANSACTIONscript、および ME01.TRANSACTIONscript を実行します。

現在の TRANSACTION スクリプトをそれ自体にリンクすることはできません。間接リンクを防ぐためのチェックはありません。たとえば、MM01.TRANSACTIONscript が ME01.TRANSACTIONscript にリンクし、ME01.TRANSACTIONscript が ME11.TRANSACTIONscript にリンクし、ME11.TRANSACTIONscript が MM01.TRANSACTIONscript にリンクしているとします。これにより、手動で停止されるまで TRANSACTION が続行される無限ループが作成されます。

現在の TRANSACTION スクリプトのコピーは、元の TRANSACTION スクリプトにリンクすることができます。たとえば、リンクが PA40.TRANSACTION スクリプトで始まるとします。TRANSACTION スクリプトは PA40-1.TRANSACTION スクリプトを呼び出すことができ、PA40-1.TRANSACTION スクリプトは PA40-2.TRANSACTION スクリプトを呼び出します。

リンクされた TRANSACTION スクリプトは、現在の TRANSACTION スクリプトのすべてのレコードが処理された後にのみ開始されます。

リンクされた TRANSACTION スクリプトの AutoLogon (ALF ファイル) 情報は無視されます。リンクされたすべての TRANSACTION スクリプトは、現在の TRANSACTION スクリプトの SAP ログ オン セッションを使用します。つまり、元の TRANSACTION スクリプトのみが SAP にログオンできます。後続のすべての TRANSACTION スクリプトは、同じ SAP セッションを使用します。

リンクされたすべての TRANSACTION スクリプトは、同じ Excel スプレッドシートまたは異なるスプレッドシートを使用できます。1 つの Excel スプレッドシート内で同じワークシートを使用したり、別のワークシートを使用したりすることもできます。理想的には、Excel でログを解析した後、ログを比較して再利用できるようにするために、同じワークシートを使用する必要があります。

TRANSACTION は、リンクされているすべての TRANSACTION スクリプトの実行が終了すると、最後にリンクされた TRANSACTION スクリプトを表示します。つまり、チェーンを開始した元の TRANSACTION スクリプトは再ロードされません。

ログ ファイルは、リンクされた TRANSACTION スクリプトの実行アクティビティを示します。

次の TRANSACTION スクリプトのパスが空白のままで、ファイル名のみが指定されている場合、TRANSACTION は現在の TRANSACTION スクリプトパスで次の TRANSACTION スクリプトを検索します。

#S1SheetName

任意のコマンドです。

デフォルトは Sheet1 です。Excel スプレッドシートにワークシートが 1 つしかない場合、TRANSACTION はそれを自動的に選択します。Excel スプレッドシートに複数のワークシートがある場合は、どのワークシート (Sheet#) を使用するか指定してください。

例:

#S1Sheet2

指定された Excel スプレッドシートでワークシート 2 を選択します。

#XS{ 0 | nnnnn | End } , [CLOSE]

任意のコマンドです。

このコマンドは、TRANSACTION が各実行中および実行後に Excel スプレッドシートを保存および閉じる方法を制御します。

#XS0 TRANSACTION が実行の終了時に Excel スプレッドシートを保存しないことを示します。この場合、Excel スプレッドシートを手動で保存する必要があります。そうしないと、SAP から返されたログ メッセージなどの変更が失われます。このサブコマンドは、同じ Excel スプレッドシートで実行されている TRANSACTION のセッションが複数あり、それらの Excel スプレッドシートの 1 つだけを保存する必要がある場合に役立ちます。

#XSnnnnnトランザクションごとに Excel スプレッドシートを保存するように TRANSACTION にプロンプトを表示します

#XSEnd 実行の最後に Excel スプレッドシートを保存します。特に指定がない限り、#XSEnd がデフォルト値です。

CLOSE これらのサブコマンドのいずれかに CLOSE が含まれている場合、TRANSACTION は実行のたびに Excel を閉じます。CLOSE サブコマンドが発行され、Excel セッションに保存するファイルがある場合、Excelは閉じる前にファイルを保存するように要求します。

例:

#XS100

100 回目のトランザクション実行ごとに Excel スプレッドシートを保存します。

#XS0

Excel スプレッドシートを保存しません。手動で保存する必要があります。

#XSEnd

実行の最後に Excel スプレッドシートを保存します。

#XSEND,CLOSE

実行の最後に Excel スプレッドシートを保存して Excel を閉じます。Excel に保存するファイルがある場合、ユーザーは閉じる前にファイルを保存するように求められます。

#XS0,CLOSE

実行中に Excel スプレッドシートを保存しません。実行が終了すると、TRANSACTION は Excel を閉じようとします。Excel は、閉じる前にファイルを保存するようにユーザーに促します。

*Fv!FieldValue (スプレッドシートの列から値を読み取ります)

任意のコマンドです。

このコマンドは、スプレッドシートに保存されているデータ値を SAP にマップするために使用されます。*FV コマンドは常に +Fn コマンドの後に来る必要があります。

例:

+FnRMMG1-MATNR

-FnMaterial Number

*Fv!A

マテリアル番号を Excel スプレッドシートの列 A にマップします。

*Fv?<Excel レシーバーの列 ID>

任意のコマンドです。

TRANSACTION は SAP からデータをダウンロード (読み取り) 可能です。このコマンドを使用すると、ダウンロードする SAP フィールドに列を割り当てることができます。

推奨事項: マッパーを使用して Read From SAP 値を割り当て、必要な場合を除いて、TRANSACTION スクリプトを手動で変更しないようにします。

例:

+FnEKKO-EKORG

*Fv?K

SAP フィールド EKKO-EKORG が SAP から読み取られ、Excel スプレッドシートの列 K に追加されていることを示します。

キー ポイント:

このコマンドは、SAP リリース 4.6 以降でのみ使用できます。

データのない列をレシーバー列として割り当てます。TRANSACTION は、割り当てられた Excel レシーバー列に値が存在するかどうかをチェックしません。SAP から値が返されない場合でも、レシーバー列のすべての値が上書きされます。

TRANSACTION は、Excel レシーバー列をフォーマットしません。TRANSACTION スクリプトを実行する前に、Excel 列を適切なデータ型にフォーマットする必要があります。たとえば、列がテキストとしてフォーマットされておらず、値 004 がその列に割り当てられている場合、Excel はこの値を 4 に変換します。004 の値を保持するには、実行前にその列をテキストとしてフォーマットします。

このコマンドには、SAP での追加の権限が必要です。

このコマンドを実行すると、TRANSACTION の実行速度が少し遅くなる場合があります。このため、このコマンドは必要な場合にのみ使用してください。TRANSACTION スクリプトに Read From SAP としてマークされたフィールドがない場合、TRANSACTION は自動的に更新専用モードに戻ります。

注: このコマンドは、Access データベースでも同じように機能します。単に<Access レシーバー フィールド名> を <Excel レシーバー列 ID> に置換します。

+ALautologin file.ALF

任意のコマンドです。

使用すると、TRANSACTION はこのコマンドで指定された自動ログオン ファイル (ALF) を使用して SAP システムにログオンします。

例:

#ALC:\MY DOCUMENTS\TRANSACTION\TestSystem.ALF

この TRANSACTION スクリプトを実行すると、TRANSACTION は TestSystem.ALF ファイルに保存されているログオン情報を使用します。その結果、ログオンのプロンプトは表示されません。

+BI

任意のコマンドです。

このコマンドは、トランザクションの実行方法を制御します。

例:

+BI1

バッチ入力モード [デフォルトの設定] でトランザクションを実行します。

+BI0

非バッチ入力モードでトランザクションを実行します。これは、GUI でトランザクションを実行するのと似ています。

詳細については、記録モードを参照してください。

+DBnnnnnn (SAP ログ オン前の遅延)

任意のコマンドです。

このコマンドは、SAP へのログ オンを nnnnnn ミリ秒遅らせます。このコマンドを使用して、スケジューラーが 1 分未満の間隔でセッションをスケジュールできず、その時間枠内にセッションを開始する必要がある場合など、さまざまな TRANSACTION セッション間の遅延を維持します。詳細については、実行のスケジューリングを参照してください。

この TRANSACTION スクリプト コマンドは、コマンド ラインからパラメーターとして渡すことができます。これを行うと、コマンド ライン パラメーターが TRANSACTION スクリプトで指定された値よりも優先されます。

+DLnnnnnn (トランザクション実行間の遅延)

任意のコマンドです。

このコマンドは、SAP への呼び出しを nnnnnn ミリ秒遅らせます。このコマンドを使用して、TRANSACTION スクリプトの処理を遅くすることができます。

+Do-While ループ

任意のコマンドです。

このコマンドは、複数行のトランザクションを処理するための Do ... While ループ メカニズムを提供します。指定された条件が満たされると、TRANSACTION は Do ... While ループに入ります。通常、この条件は動的に決定されます。固定値 <チェック値> は、<Excel 識別子列 ID> で示されるように Excel 列の値と比較されます。

推奨事項: マッパーを使用して Do-While ループを管理し、手動での変更を回避します。

例 1:

+Do While <A:Excel レコード タイプ識別子 ID>,<H:ヘッダー識別子文字列>,<L:行項目識別子文字列>

...

*Fv!<Excel 列 ID>

......

@Fv!<Excel 列 ID>

...

+Fv<固定値>

...

*Fv!<Excel 列 ID>

...

+Fv<固定値>

...

+LOOP

例 2:

この例は、Excel の列 A に、その列の文字 D で識別されるループ用のアイテム レコードがあることを示しています。TRANSACTION は、Excel スプレッドシートのすべての行をループしますが、その行の列 A の値は D で埋められます。

+DO WHILE A,H,L

'次の行から Do While ループを開始します、行識別子は Excel 列 A に保存されます、値 "H" はヘッダー行を示し、値 "L" はライン アイテム行を示します

'----------------------------------------------------------------------------

+SpSAPMF05A

+Sn1200

-SpMain Screen for Single-Screen Transaction: Outgoing Invoice

+FnBDC_OKCODE

?

この画面の -FnOK コード

+Fv=0005

 

+FnACGL_ITEM-HKONT(01)

-FnGeneral 元帳勘定

@Fv!C

 

+FnACGL_ITEM-WRBTR(01)

ドキュメント通貨での -FnAmount

@Fv!F

 

+FnACGL_ITEM-MWSKZ(01)

-FnTax

@Fv!G

 

+FnACGL_ITEM-MARKSP(01)

+FvX

 

+LOOP

'ここで do while ループを終了します。

'----------------------------------------------------------------------------

+SpSAPMF05A

+Sn1200

-SpMain Screen for Single-Screen Transaction: Outgoing Invoice

+FnBDC_OKCODE

この画面の -FnOK コード

+Fv=BU

'----------------------------------------------------------------------------

キー ポイント:

Excel には、個別のヘッダー行とラインアイテム (詳細) 行が必要です。ヘッダー レコードは 1 つだけで、その後に 1 つ以上のライン アイテム レコードが続きます。

ヘッダーとライン アイテムのレコードは、識別子の Excel 列に明確にマークする必要があります。TRANSACTION は、ヘッダー行またはライン アイテム行の Excel ID 値を検証している間、大文字と小文字を区別しません。また、ループ行にヘッダーのデータを含めることはできません。ただし、ヘッダー情報は各ライン アイテムで使用できます。

TRANSACTION は、ヘッダーとして識別された行からトランザクションの構築を開始します。H または D 以外の値が検出された場合、TRANSACTION は、次のヘッダー行が見つかるまですべての行をスキップします。

ライン アイテム レコードの間に空の行を残さないでください。

Do ... While ループを使用している間は、不要なキー フィールドを作成しないでください。(空の場合はトランザクションをスキップするか、 *FV#<列 ID>)。TRANSACTION は、行タイプ ID 列をキー列として使用します。この列がいずれかの行で空白のままになっている場合、TRANSACTION は行全体を無視し、次のレコードに進みます。

キー フィールド (そのフィールドにおいて Excel の値が空の場合は行をスキップ) は、Do ... While ループ中のヘッダー/ライン アイテム行タイプよりも優先されます。つまり、TRANSACTIONは 最初に、キー フィールド設定に基づいて行が選択可能かどうかをチェックします。次に、Do ... While ループ処理の行タイプに基づいて検証を実行します。キー フィールドの検証のために行がスキップされた場合、Do ... While ループ処理の一部としては使用されません。

注: Do-While ループ内で使用されるフィールドをキー フィールドとしてマークしないでください。Do ... While ループ内のフィールドのいずれかがキー フィールドとしてマークされている場合、予期しない結果が生じる可能性があります。

増分 Excel 行を使用する場合は、Do ... While ループ内にいる間、+ や * の代わりに @ 識別子を使用します。次のチャートは、Excel のどの行を使用してデータを取得するかを示しています。

Do While ループ ステートメントの間にある TRANSACTION スクリプト要素 読取元

*Fv!<Excel 列 ID> または *Fv#<Excel 列 ID> (Excel の値) ヘッダー行

@Fv!<Excel 列 ID> (Excel の値) 対応するループ行

注: このコマンドは、Access データベースでも同じように機能します。単に <Access フィールド名> を <Excel 列 ID> に置換します。

複数行トランザクションの処理も参照してください。

+EL[!ExtendedLogColumn]

任意のコマンドです。

このコマンドを使用すると、ユーザーはトランザクションの拡張ログ情報を取得できます。拡張ログ情報には、SAP で実行されるトランザクションの完全なメッセージ スタックが含まれます。

+EL 拡張ログを取得し、Excel の各ログ セルにコメントとして書き込みます。

+EL!ExtendedLogColumn/+EL!Table。拡張ログを取得し、Access データベースの指定された Excel 列またはテーブル フィールドに書き込みます。

例:

+EL

+EL!G

Excel スプレッドシートの列 G に拡張ログを書き込みます。

+EL!MaterialMaster.ExtendedLog

Access データベースのマテリアル マスター テーブルの[拡張ログ]フィールドに拡張ログを書き込みます。

+EM

任意のコマンドです。

このコマンドを使用すると、SAP から返された拡張メッセージがログに記録されます。通常、TRANSACTION は SAP メッセージ テキストのみを保存します。このテキストは、割り当てられたログ列に配置されます。ただし、メッセージ タイプ (E、I、Sなど)、メッセージ番号、およびメッセージ ID は、TRANSACTION スクリプトで指定できます。

返されるメッセージには、以下に示す順序でこれらのフィールドが含まれています。

メッセージ タイプ:メッセージ ID - メッセージ番号 - メッセージ テキスト

例:

「選択基準が保存されました」

+EM コマンド (上記) なしのメッセージ。

「S:F4-431-選択基準が保存されました」

+EM コマンドありの同じメッセージ。ここで、S はメッセージ タイプ、F4 はメッセージ ID、431 はメッセージ番号、残りは実際のメッセージ テキストです。

&EndSession

任意のコマンドです。

ML81N およびその他のトランザクションの場合、最初の購買伝票であるヘッダー明細に対してサービス入力シートが作成されますが、後続の購買伝票はエラーになります。EndSession コマンドは、実行するたびに SAP セッションをリセットします。

&EndSession:<数字>

数字は、SAP セッションをリセットする必要があるトランザクションまたは行の数を指定します。

+FnFieldName

必須のコマンドです。

このコマンドは +Sn コマンドの後に来る必要があります。各画面番号 (+Sn) には使用可能なフィールドが複数ある場合があります。

例:

+FnRMMG1-WERKS

(WERKS = Plant)

+FvFieldValue (固定済)

必須のコマンドです。

+Fv コマンドを使用して、特定のフィールドに固定値を指定します。このコマンドは +Fn コマンドの後に来る必要があります。

例:

+FnRMMG1-WERKS (WERKS = Plant)

+Fv0001

現在のトランザクションの Plant フィールドに固定値 0001 を割り当てます。

+HTHeader テキスト

任意のコマンドです。

このテキストは、TRANSACTION スクリプトを開くときにタイトルとして表示されます。

例:

+ HtTRANSACTION for Tcode MM02

+IF!Condition

任意のコマンドです。

このコマンドは、SAP にデータをアップロードするための条件を制御します。条件パラメーターの構文は次のとおりです。

Excel 列 ID =, >, <, <=, >=, <>, {Starts_With}, {Contains}, {Ends_With} 定数値

上の演算子の左側は、右側の定数値に対してチェックされる Excel 列です。+IF 条件を含むファイルが実行されると、指定された条件が真である Excel 行のみが実行されます。

例:

+IF!AH=08/08/02004

Excel 列 AH に 08/08/2004 を有するこれらの Excel 行のみを SAP へアップロードします。

+IF!A{Starts_With} K

Excel 列 A に文字 K で始まるデータを含む Excel 行のみを処理します。

+LG

任意のコマンドです。

このコマンドは、TRANSACTION スクリプトの実行中に SAP GUI を起動します。TRANSACTION では、ファイル入力/出力ダイアログ ボックス、レポートの生成、ファイル (画像、PDF ....) のアップロード、多くの HR トランザクションなどの特定のタイプのトランザクションに対して SAP GUI を起動する必要があります。

これらのタイプのトランザクションの処理を容易にするために、[実行]タブの[SAP GUI の開始]オプションを使用できます。[SAP GUI の開始]チェック ボックスを選択すると、+LG コマンドが有効になります。チェック ボックスを空白のままにすると、+LG コマンドが無効になります。

推奨事項: 処理が遅くなる可能性があるため、どうしても必要な場合を除いて、このオプションを選択しないでください。

注: 「SAP GUI との通信時のプロトコル エラー」というエラー メッセージが表示された場合は、GUI の起動フラグを有効にして問題を解決できます。

+MBn

任意のコマンドです。

このコマンドは、Excel の文字を Unicode から Shift-JIS などのネイティブ SAP 言語形式に変換します。これは、Unicode でデータを非 Unicode SAP システムに入力するときに役立ちます。この場合、エディタで +Tx コマンドの前に +MB1 コマンドを入力します。Excel で、変換する各列の最初のセルに言語コードを挿入します。

例:

+MB 1000

たとえば、Excel の列 A から日本語の材料の説明をアップロードするには、エディターで、セル A1000 に、+MB100 を指定し、日本語のコードページである *DB982 を指定します。

+MTMsgID-MsgNo

任意のコマンドです。

メッセージ変換 (MT) コマンドは、Excel スプレッドシートに保存されているログ メッセージをカスタマイズします。このコマンドを使用して、メッセージを単純化し、ログをより意味のあるものにするなど、メッセージを変更できます。たとえば、「画面 RFEPOS00 0100 のバッチ入力データがありません」を「レコードが見つかりません」に変更します。

特定のメッセージを変換するには、適切なメッセージ ID とメッセージ番号が必要です。+EM コマンドを使用してメッセージ タイプ、メッセージ ID、メッセージ番号を順番に取得するします。MT コマンドにはメッセージ タイプは必要ありません。

例:

この例では、「画面 RFEPOS00 0100の バッチ入力データがありません」というエラー メッセージを使用しています。+EM コマンドをオンにすると、次の展開されたメッセージが受信されます。

「S:00-344-画面 RFEPOS00 0110 のバッチ入力データがありません」

ここで、S はメッセージ タイプ、00 はメッセージ ID、344 はメッセージ番号、残りは SAP から返される実際のテキストです。

次に、+MT コマンドを使用してテキストを変更します。

+MT00-344=レコードが見つかりません

TRANSACTION がメッセージ 00-344 を検出すると、SAP テキストを上記 +MT コマンドで指定されたテキストに置き換えます。

+NE[暗号化されたパスワード]

任意のコマンドです。

NE (編集なし) コマンドを使用して、ユーザーがマッピング情報を変更して TRANSACTION スクリプトを実行しようとするたびに、パスワードの入力を求めます。

+RE

任意のコマンドです。

エラーが表示された場合でも、RE (エラー時に実行) コマンドを使用してスクリプトを実行します。

+RP

任意のコマンドです。

使用すると、TRANSACTION により、実行用のデータ ファイル (Microsoft Excel または Microsoft Access) が以前に使用されていないことをユーザーが確認できます。

+RS (グローバル読み取り SAP オプション)

任意のコマンドです。

このコマンドは、トランザクション フィールドの読み取り要求を SAP に送信します。

+RS1 読み取り要求を SAP に送信します。

+RS0 読み取り要求を SAP に送信しません。

キー ポイント:

このオプションは、SAP リリース 4.6 以降でのみ使用できます。

Read From SAP にマップされたフィールドがない場合、TRANSACTION はこのコマンドを無効にします。後で Read From SAP のマークが付けられたフィールドがある場合、このコマンドが有効になり、選択と選択解除が可能になります。

詳細については、"*Fv?<Excel レシーバー列 ID> を参照してください。

 

+RT

任意のコマンドです。

このコマンドは、特定の実行の理由を含むテキスト レコードをログ ファイルに追加します。

例:

Steve の要求に応じ、+RTRequired によりマテリアル グループを修正します。

+SAnnn: StopAfter Transaction nnn

任意のコマンドです。

このコマンドにより、TRANSACTION は nnnトランザクションの後にトランザクション呼び出しの実行を停止します。

例:

+SA100

TRANSACTION は100 トランザクションのみを実行します。

 

+SF

任意のコマンドです。

このコマンドは、特定の文字をスキップ フィールド インジケーターとして指定します。TRANSACTION が Excel スプレッドシートでスキップ フィールド インジケーター (文字) を検出すると、SAP のそのフィールドは更新されません。

例:

選択したいくつかのマテリアルを除いて、すべてのマテリアルの (特に) マテリアル グループの更新が必要であるとします。TRANSACTION スクリプト内の +SF コマンドを使用して、 スキップ フィールド インジケーター (文字) を指定します。

+SF\

ここで、\ は我々のスキップ フィールド インジケーターです。

さらに、更新が不要な行すべてのマテリアル グループ列に \ を挿入して Excel スプレッドシートを更新します。

キー ポイント:

比較では大文字と小文字は区別されません。たとえば、TRANSACTION スクリプトで +SFbaddata が指定され、Excel 列に BADdata または BADDATA の値が含まれている場合、このフィールドはスキップされます (更新は行われません)。

スキップ フィールド インジケーターは、TRANSACTION スクリプトに対してグローバルです。TRANSACTION スクリプトで指定すると、マップされたすべてのフィールドに適用されます。Excel からの値が任意のフィールドに対して読み取られると、SAP に送信される前に、最初にスキップ フィールド インジケーターと比較されます。

スキップ フィールド インジケーターも参照してください。

 

+SnScreenNumber

必須のコマンドです。

このコマンドは画面番号を指定し、+Sp コマンドに続く必要があります。このコマンドには常に対応する +Sp コマンドが必要です。

例:

+Sn0060

+SpScreenProgramName

必須のコマンドです。

トランザクションはいくつかの画面プログラムに分割され、事前定義された順序で呼び出されます。通常、複数の +Sp コマンドが使用されます。

例:

+SpSAPLMGMM

 

+SRStartFromRow

任意のコマンドです。

使用すると、[開始行]フィールドのデフォルト値である 2 が、このコマンドで指定された値に変更されます。

例:

+SR7

選択したシートの最初の 6 行は無視され、7 行目から処理が開始されます。

 

+TxSAPR/3TransactionCode

必須のコマンドです。

このコマンドは、TRANSACTION スクリプトのトランザクション コードを指定します。TRANSACTION スクリプトにはトランザクションを 1 つだけ含めることができます。

例:

+TxMM02