「実際に動く社」の動作仕様

左ペインの「実際に動く社」は、5社のうちこの1社だけが、本物のデータの保存先と、実際の船会社への問い合わせにつながっている会社です。 入力した内容は保存され、画面を閉じてもう一度開いても残ります。ほかの4社(N社・A社・B社・Y社)は、これまでどおり見本のデータで動きます。

このページは、この会社を選んだときに画面が実際にどう動くかをまとめたものです。

動く範囲

• 対応している船会社は ONE のみです。ほかの船会社の案件を登録しても、取得の対象になりません。
• 自動実行のスケジュールはありません。取得が走るのは「▶ 取得開始」を押したときだけです。
• 案件・コンテナ・日時・手入力した内容は保存されます。画面を再読み込みしても残ります。
• コンテナは取得結果から作られます。追加・削除・番号の書き換えは、コンテナ別入力の画面から行えます(更新区分が半自動・手動の案件のみ。下の「画面の操作はすべて本物です」を見てください)。一覧の Container No のセルは読み取り専用です。

取得から反映までの流れ

取得と、一覧への反映は別の操作です。取得が終わっても、反映を押すまで一覧の値は変わりません。

1. 「+ 案件を追加」で案件を登録する
   • 登録した案件が一覧に出ます。あわせて内部管理番号が振られます(一覧の列には出しません)。
2. 「▶ 取得開始」を押す
   • 対象の案件が順番待ちに積まれ、船会社への問い合わせが始まります。この時点では一覧は変わりません。
   • 積まれた件数がメッセージに出ます。対象が1件も無いときは取得は始まらず、その旨が出ます。
3. 取得が終わるのを待つ
   • 取得中は、上部の稼働状況が「取得中」になります。
   • 画面が数秒ごとに状況を見に行き、終わると「取得完了」に変わります。押しっぱなしで待つ必要はありません。
4. 「取得結果を一覧に反映」を押す
   • ここで初めて一覧の値が書き換わります。反映できた件数と、取得できなかった件数が出ます。
   • 取得結果が届かなかった案件は、値は書き換えられず、エラーの内容が案件に残ります。反対に、反映できた案件に付いていたエラーの表示は消えます。

取得の対象になる案件

「▶ 取得開始」を押したときに問い合わせに行くのは、次の条件をすべて満たす案件です。

• 一覧でチェックした行があれば、その行のうち下の条件を満たすもの。チェックが無ければ、この会社の案件のうち下の条件を満たすものすべて
• 更新区分が「自動」または「半自動」であること(「手動」は対象外)
• 終了していない・アーカイブされていないこと
• Shipment_Reference_No に値が入っていること
• Carrier が ONE であること

反映で値が入る規則

• 空の値では上書きしません。 取得結果にその項目が無いときは、いまの値をそのまま残します。
• 取得結果の値が、いまの値と違うときだけ書き換えます。
• 同じ取得結果をもう一度反映しても、結果は変わりません。 押し間違えて二度反映しても壊れません。
• コンテナは、コンテナ番号が一致するもの同士で対応づけます。番号で一致しなかったぶんは、本数が同じであれば並び順で対応づけます。本数が違うときは、まだコンテナ番号が分かっていない行に順に割り当て、それでも空きが無ければ新しいコンテナとして追加します。

手で入力できるもの

この会社では、次のセルに入力した内容がそのまま保存されます。終了済みの案件のセルは入力できません。

• 発着の日時(POL の Departure、TS1〜TS5 の Arrival・Departure、POD の Arrival)
• 基本情報のテキスト(Booking No / B/L No / Carrier / Origin / POL / POD / Destination)
• TS Ports(TS1〜TS5 の港名)と Vessel1〜6(Name / VoyNo / Service)
• Shipment_Reference_No と Shipment_Reference_Type
• 更新区分
• コンテナごとの日時(右端の「ｺﾝﾃﾅ×n」ボタンから開くコンテナ別入力。ゲート・船積・荷揚・陸送・納入先到着など)。全コンテナへの一括入力と、入力済みのセルに対する上書き確認も同じように保存されます。

手で入れた日時は、自動取得で上書きされない

手で日時を入れると、その日時には「手入力」の印が付きます。印が付いた日時は、以後の取得・反映で書き換えられません。 船会社から新しい日時が届いても、手で入れた値がそのまま残ります。

手入力を取り消したいとき

そのセルを空にします。日時・予定/実績の別・手入力の印がまとめて消え、保護も外れます。 次に反映したときには、また船会社から届いた日時が入ります。

TST の日時も同じように守られる

TST から入った日時も、手入力と同じ扱いで、自動取得では上書きされません(TST の値が優先されます)。 TST の値を取り込む操作については、下の「TSTデータの読み込み」を見てください。

初期予定(オリジナルスケジュール)の入り方

日時は、船会社から届いた最新の値のほかに、初期予定を別に持っています。初期予定は一覧の表には出しませんが、データとしては保持しています。

• 初期予定は、まだ空のときだけ、そのとき船会社から届いた日時を写して入ります。
• 一度入ったあとは、船会社から届く日時が変わっても、初期予定は変わりません。
• 手で入れた日時は初期予定には入りません。 初期予定は「船会社から最初に届いた予定」を表すものだからです。

画面の操作はすべて本物です

この会社では、一覧に出ている操作はすべて本当に動きます。押した結果は保存され、画面を開き直しても残ります。 唯一の例外は、トラッキング詳細の「この案件を再取得」です。この会社ではまだ動かないので、 1件だけ取り直したいときは、一覧でその行だけチェックして「取得開始」を押してください。

• 終了設定: 4つの条件から選んで保存する、手で終了させる、終了を取り消す。どの条件が効くかは「船会社 → 会社 → 基本」の順で決まります
• 次回更新日: 日付を入れて保存する。人が入れた日付は、そのあとの自動取得で書き換えられません。日付を消すとその守りも外れます。更新区分を変えたときは、自動なら日付を持たなくなり、半自動・手動なら会社の既定の間隔で仮に置きます
• 🗃 終了済みをアーカイブ: 終了した案件をまとめて一覧から外す。「アーカイブ済みも表示」で確認でき、押せば戻せます
• ⬇ CSV出力: 管理画面の取り込みに渡すCSVを本当に書き出します。1行=1コンテナ。トラッキングキーが未設定の案件は出しません。どの行にも値が入らなかった列は、ヘッダーごと省きます
• 取得キャンセル: まだ手を付けていない順番待ちを取り消します。すでに船会社へ問い合わせている分は途中で止められないので、最後まで進みます
• ↥ TSTデータ読込: 下の「TSTデータの読み込み」を見てください
• コンテナの追加・削除・番号の書き換え: コンテナ別入力の画面から行えます。削除したコンテナはグレーで残り、「戻す」で元に戻せます。番号は空き番のままにして使い回しません。⚠ この操作は更新区分が半自動・手動の案件にだけ出ます(ほかの会社と同じ扱い)

TSTデータの読み込み

TST(東洋信号)から買った船のスケジュール表を読み込んで、日本を出る便の出港日時と 日本に着く便の入港日時を埋めます。TSTは日本発着の情報しか持たないので、それ以外の区間は触りません。

突き合わせは、本船名・港・Voyage No の3つがすべて一致したときだけ行います。1つでも食い違うものは、日時を書き換えずに見送ります。

• 日時は実績があれば実績、無ければ予定を使います(出る便は出港実績→出港予定、着く便は入港実績→入港予定)
• Voyage No は、TSTが入港側と出港側で別々に持っています。日本を出る便は出港側、日本に着く便は入港側と突き合わせます
• TSTで抜港になっている寄港は使いません
• 入った日時には「TST」の印が付き、あとの自動取得で上書きされません
• 読み込んだあと、いくつ入って、いくつ見送ったかを画面に出します

港はコード(JPNGO など)と名前(NAGOYA, AICHI, JAPAN など)の両方の書き方があるため、 対応表(港マスタ)を通して突き合わせます。表に無い港は突き合わせできず、見送りになります。