接続の前に、双方の約束を揃える
| 接続の前に、双方の約束を揃える | 連携元で整理すること | 連携先と確認すること |
|---|---|---|
| 渡す内容 | 処理の目的、必要な項目、依頼を識別する情報。 | 受け付ける形式、必須項目、対象外の入力。 |
| 返される内容 | 業務が次へ進むために必要な結果。 | 受付と完了の違い、結果の取得方法、失敗の伝え方。 |
| 実行する権限 | 誰の依頼として、どの操作を実行するか。 | 認証の方式、許可される操作、権限変更時の扱い。 |
| 処理の量と時間 | 想定する依頼の頻度、待てる時間、集中する場面。 | 利用上限、待ち時間、保守や停止時の条件。 |
つながらない理由を、担当範囲まで追えるようにする
- 依頼と結果の対応
- 同じ仕事の依頼、送信、受け付け、結果をたどれる情報を決めます。記録に残す内容と、残してはいけない情報も分けます。
- 認証と接続設定
- 接続に使う設定の管理者と更新手順を確認します。個人の権限に依存する部分がないか、担当交代や有効期限の変更時にどう見直すかを整理します。
- 変更を伝える窓口
- 項目や仕様、接続先の変更を誰が受け取り、どの環境で確認するかを決めます。連携元と連携先それぞれの修正・確認範囲を残します。
返答がないとき、同じ依頼を送る前に確かめる
- 受け付けと完了を分けて調べる
返答が届かなくても、相手側で処理が進んでいる場合を想定します。依頼が届いたか、完了したかを、確認できる記録や問い合わせ先と対応させます。
- 再開できる単位を決める
未処理、一部反映済み、結果不明を分けます。同じ依頼を再送してよい条件と、重複更新を避けるために確認する条件を決め、判断できない状態は担当者へ渡します。
- 確認した結果を残す
再開、中止、手作業への切替を行った理由と処理の範囲を記録します。業務データが元に戻せるかは接続先ごとに確認し、自動で取り消せることを前提にしません。
接続試験は、正常な返答以外も含める
案件で接続を確かめるときは、想定する入力に加え、権限不足、待ち時間の超過、同じ依頼の重複、接続先の停止などの扱いを確認します。どの条件を再現できるかは、利用できる検証環境と連携先の協力範囲に合わせて決めます。
確認できた入出力と残った制約を記録し、運用の連絡先や再開手順へ結び付けます。一度の接続成功だけで、すべてのデータや稼働条件で使えると判断しない進め方を取ります。
既存システムの条件がまだ分からないとき
接続先の仕様書が手元になくても相談できますか。
つなぎたい業務とシステム、管理担当者、分かっている入出力から共有できます。接続可否や方法を決める前に、公式の仕様や契約上の利用条件を管理担当者と確認します。
エラーなら、自動で何度も再送すればよいですか。
再送できるかは処理の性質と接続先の契約によって異なります。既に反映されたか分からない更新を繰り返すと重複の原因になるため、状態の照合方法と再開条件を先に整理します。