使い方３（受信）

AD_ORCAを使ってORCAと自由に対話できるカスタムAppを作り上げましょう！「受信」したデータはカスタムApp内で自由自在！

On this page

送受信の流れ

受信したJSONデータはカスタムApp内で自由自在に展開できます。

受信データの形式

前項のリクエストJSONの作成では、「オブジェクト{}だけのリクエスト」と「配列も含んだ{[,,]}リクエスト」を解説しましたが、ここでも同じ事が言えます。傾向として、

「オブジェクト{}だけのリクエスト」では配列も含んだ{[,,]}結果」
「配列も含んだ{[,,]}リクエスト」では「オブジェクト{}だけの結果」

の様な事が良く発生します。

JSON関数

受け取ったJSONはClaris FileMakerProに標準で実装されている「JSON関数」を使って適宜処理を行います。

標準関数（Claris FileMaker Pro標準）
JSONDeleteElement	オブジェクト名、配列索引、またはパスで指定された JSON データ要素を削除します。
JSONFormatElements	JSON データ内の要素を読みやすい形に書式設定します。
JSONGetElement	JSON データで、オブジェクト名、配列索引、またはパスで指定された要素のクエリーを実行します。
JSONGetElementType	オブジェクト名、配列索引、またはパスで指定された要素の JSON データタイプを検証して返します。
JSONListKeys	オブジェクト名、配列索引、またはパスで指定された要素に対する JSON データ内のオブジェクト名 (キー) または配列索引の一覧を表示します。
JSONListValues	オブジェクト名、配列索引、またはパスで指定された要素に対する JSON データ内の値の一覧を表示します。
JSONSetElement	オブジェクト名、配列索引、またはパスで指定された JSON データ内の要素を追加または変更します。

また「ORCA連携サンプル」 には、 「JSONException」、「JSONExists」 の２種のカスタム関数があります。詳細はご術しますが、これらはスクリプト内でエラーを判定する為に使っており、ANNYYSシリーズでも利用しています。 Clarisのヘルプページには「JSON データのエラー処理」方法についての記載もありますが、ANNYYSではコードを簡素化する目的がありこれらカスタム関数を使いエラー判定しています。

例えば、受け取った配列の件数を知りたい場合
$listLeys = JSONException( JSONListKeys ( $Disease_Information ; "." ))
とすれば戻り値は「""」となり,直後の１行で全てのエラーに対して判定可能にするためです。
if[ ValueCount($listLeys) ]
...（成功時処理）

カスタム関数（「ORCA連携サンプル」に内臓）
JSONException	JSON形式を取得の際「?」が付きエラーが返される場合「""」を返却 ※ANNYYSシリーズでは頻繁に利用しています。
JSONExists	正式なJSON形式の場合は「1」そうでない場合は「0」を返却
その他のカスタム関数	DateFormater：日付フォーマット用関数（"YYYYMMDD" < "20221231"） TimeFormater：時刻フォーマット用関数（"HHMMDD" < "121260"） TimeStampFormater：上記２つの組合せ

受信データの処理

ここでも「日医標準レセプトソフト API」の内容を参考にすると正しいJSON電文の構造が確認し、受信したJSONデータを分解してFileMakerカスタムApp内で適宜処理を行います。ここでも前項のリクエストJSONの作成と同じように 「ORCA連携サンプル」 の病名処理を例に解説します。

仕様確認
例として「/api01rv2/diseasegetv2(患者病名情報の返却)」を開き レスポンスサンプルとレスポンス一覧を確認します。
- レスポンスサンプル（type="array"以下の内容に注目）
- レスポンス一覧（こちらは表形式で必須項目や記述内容が確認できます。）
受信データ確認
実際に受け取ったJSON電文を確認してみましょう。 「ORCA連携サンプル」 の病名処理（diseasegetv2）を例に解説します。
結果の部分に受信した内容が表示されます。スクリプト「」内ではこの値を使ってレコードに情報を登録しています。

「ORCA連携サンプル」 の病名処理（diseasegetv2）スクリプトの内容と以下説明文を照らし合わせながら理解を勧めてください。
内部処理解説
[diseasegetv2]スクリプトステップは大きく分けて４つの内部処理が組まれています。
1. JSONリクエストデータの作成と送信
2. 受信したJSONデータの確認と再構築（[$byomeiObj]を作成）
3. 既存データと病名データ[$byomeiObj]の比較：存在する場合は更新
4. 残りの病名データ（$byomeiObj）を追加登録
あとは任意で最終結果の処理を行い一連のメソッドは完了します。

送信結果JSON
```
  {
    "class" : "01",
    "disease_infores" : 
    {
      "Api_Result" : "00",
      "Api_Result_Message" : "処理終了",
      "BirthDate" : "2017-12-26",
      "Disease_Information" : 
      [
        {
          "Department_Code" : "01",
          "Disease_Name" : "高血圧症",
          "Disease_Single" : 
          [
            {
              "Disease_Single_Code" : "8833421",
              "Disease_Single_Name" : "高血圧症"
            }
          ],
          "Disease_StartDate" : "2023-04-12"
        },
        {
          "Department_Code" : "01",
          "Disease_Name" : "肝機能障害",
          "Disease_Single" : 
          [
            {
              "Disease_Single_Code" : "5738002",
              "Disease_Single_Name" : "肝機能障害"
            }
          ],
          "Disease_StartDate" : "2023-04-12"
        }
      ],
      "Information_Date" : "2023-04-13",
      "Information_Overflow" : "False",
      "Information_Time" : "11:44:58",
      "Patient_ID" : "00000004",
      "Reskey" : "Medical Info",
      "Sex" : "1",
      "WholeName" : "青森　ジロウ",
      "WholeName_inKana" : "アオモリ　ジロウ"
    },
    "postjson" : 
    {
      "data" : 
      {
        "disease_inforeq" : 
        {
          "Base_Date" : "2023-04",
          "Patient_ID" : "4",
          "Select_Mode" : "All"
        }
      }
    },
    "uid" : "78F75FD2D2D073A4371148E169BD1E1B"
  }
```

使い方３（受信）

送受信の流れ

受信データの形式

JSON関数

受信データの処理

仕様確認

受信データ確認

内部処理解説