はじめに

WinActorのノード等のWinActorモジュールを使用して、OBC奉行クラウドシリーズの商奉行クラウドで売上伝票登録を行うサンプルシナリオ（以降、本サンプルシナリオ）について説明します。

本サンプルシナリオの概要

本サンプルシナリオは、以下の処理を行います。

• CSVファイルから情報を読み込みます。
• 売上伝票画面にデータを入力します。
• データ入力の完了後、売上伝票を登録します。

使用するWinActorモジュール

本サンプルシナリオでは、以下のWinActorモジュールを使用します。

• ノード/アクション/画像マッチング
• ノード/アクション/ウィンドウ状態待機
• ノード/アクション/指定時間待機
• ノード/アクション/文字列送信
• ノード/アクション/Excel操作
• ノード/アクション/クリップボード
• ノード/変数/カウントアップ
• 04_自動記録アクション/エミュレーション.ums6
• 18_Excel関連/01_ファイル操作/Excel操作(保存なしで閉じる).ums6

本サンプルシナリオの入力ファイル

売上データが記載されたCSVファイルを入力ファイルとします。
シナリオ内でCSVファイルをオープンし、処理の実施に必要な情報を取得します。
入力ファイルの詳細は、入力ファイルの形式を参照してください。

本サンプルシナリオの想定レベル

本ドキュメントは、以下の技術レベルのユーザーを対象としています。

• 商奉行クラウドの使い方について理解している。

動作確認環境

本サンプルシナリオは以下の環境で確認しています。

• Windows 10、WinActor 6.3.0、Microsoft Excel 2019、商奉行クラウド Ver.210224
• Windows 10、WinActor 7.1.0、Microsoft Excel 2019、商奉行クラウド Ver.210224

制約事項

• 本サンプルシナリオを実行するためには、商奉行クラウドにアクセスするためのインターネット環境が必要です。
• 本サンプルシナリオおよびドキュメントは商奉行クラウドにログインできる状態を前提に記載されています。
• 本サンプルシナリオは WinActor 6.0 より古いバージョンでは動作しません。
• 本サンプルシナリオは、商奉行クラウドお試し版に用意されているデータを使用しています。本サンプルシナリオの実行対象となるデータが存在しない場合は、商奉行クラウドにデータを登録いただくか、入力ファイルのデータを変更してください。

本サンプルシナリオの使い方

本サンプルシナリオの実施方法は以下の通りです。

Step1.商奉行クラウドへのログイン

本サンプルシナリオではシナリオ実行前に商奉行クラウドにログインする必要があります。
商奉行クラウドをお持ちでない場合は、以下のURLから商奉行クラウドお試し版を入手し、ログインしてください。
https://www2.obc.co.jp/trial/cloud/akinai/

商奉行ログイン後の画面

Step2.売上伝票画面の短縮設定

本サンプルシナリオの実行に先立ち、商奉行クラウドの売上伝票画面で入力しない項目の短縮設定(カーソル移動させない設定)を事前に行います。
以下の手順で設定をしてください。

1. 商奉行クラウド画面の[売上伝票]ボタンを押下します。
2. 売上伝票画面の売上日付欄にカーソルを移動し、[短縮設定]ボタンを押下します。
3. 売上伝票画面の売上を入力する表内の入力欄(以下を除く)を押下します。　※既に短縮設定済み(緑色)の入力欄の場合、押下する必要はありません。
　・商品コード
　・数量

売上伝票画面の短縮設定

4. 売上伝票画面の[登録]ボタンを押下します。
5. 売上伝票画面を閉じます。

Step3.入力ファイルの配置

本サンプルシナリオに添付されているサンプルのCSVファイル(売上データ.csv)を、任意のディレクトリに配置します。 本サンプルシナリオでは、このファイルの内容を用いて売上伝票を登録します。

Step4.WinActorで本サンプルシナリオを読み込み

WinActorを起動し、本サンプルシナリオを読み込みます。

Step5.動作に必要な変数の設定

本サンプルシナリオを実行するために必要な値を、変数一覧で設定します。
設定が必要な変数は下記の通りです。

• 売上データファイルパス
  • 本サンプルシナリオの入力ファイルのファイルパスを指定します。
    例) C:\sample\売上データ.csv

本サンプルシナリオ変数一覧の入力ファイル設定

Step6.WinActorで本サンプルシナリオを実行

本サンプルシナリオを実行します。
商奉行クラウドで入力ファイル内のすべてのデータが入力され、売上伝票が登録されます。

Step7.サンプルシナリオ実行終了後の確認

実行終了後、商奉行クラウドの売上伝票画面に"伝票No.[XXXXXX]で登録しました。"と表示されていることを確認してください。

売上伝票画面の確認

トラブルシューティング

本サンプルシナリオでは、指定秒数待機している箇所があります。
以下に、固定秒数待機不足により失敗する動作に対しての修正箇所を記載します。
シナリオ内の対象となる指定時間待機モジュールの待機時間プロパティの秒数を増やす対応をしてください。

指定秒数待機不足によるエラーの修正箇所一覧

サンプルシナリオ解説

本サンプルシナリオで使用している実装テクニックについて説明します。

入力ファイルの形式

入力ファイル(csv)の内容は以下のとおりです。

入力ファイルサンプル

ヘッダー情報

入力情報

本サンプルシナリオは、以下の場合にエラーとなります。

• 商奉行クラウドに登録されていない企業コードを使用すると、その後の入力処理等でエラーとなります。
• 商奉行クラウドに存在しない商品名を使用すると、商品確定時にエラーとなります。