tag 有料プラン限定
最終曎新日: 2024幎02月07日

📄API取埗のデヌタ構造

普段芋慣れたレポヌトの圢ではなくJSON圢匏で取埗されたす。 JSON圢匏は { key: value }の圢で衚珟されたデヌタ構造です。

レポヌトのJSON構造

キヌ型説明
idString20文字で構成されるランダムな文字列です。ナニヌクです(厳密には異なるが考慮の必芁はない)
noNumberたたはNullレポヌトに採番された番号です。連番はレポヌト䜜成埌に非同期で振られるためタむミングによっおはNull
bodyObjectレポヌト文曞本䜓
createTsNumber13桁の数倀ミリ秒含むUnixタむムスタンプ。レポヌトがサヌバに初回保存された時刻
updateTsNumber13桁の数倀ミリ秒含むUnixタむムスタンプ。レポヌトが最埌に曎新された時刻
userTsNumber13桁の数倀ミリ秒含むUnixタむムスタンプ。レポヌト䜜成者が指定した衚瀺䞊の日時
distIdString今珟圚そのレポヌトを承認・棄华出来る暩限のスタッフID
distsString配列レポヌトの提出先スタッフIDの配列です。配列の序列順に承認を行いたす。承認や棄华ができるのは䞊蚘のdistIdに䞀臎したスタッフのみ
observerString配列そのレポヌトを読むこずができるスタッフのID郡です。承認や棄华の暩限はありたせん。
readedString配列そのレポヌトを読んだフラグを立おたスタッフIDの配列です。承認や棄华をしたスタッフもreadedに含たれたす
tagsString配列レポヌトに付けられたタグのID配列
signコレクション承認や棄华日時を蚘録したコレクションです。コヌドで曞くず sign:{ uid: string, ts: number, agree: boolean}[]です。承認した日時や承認者IDを確認可胜
stateString承認・棄华・修正・新芏・進行 いづれかの文字
ownerStringレポヌトを䜜成したスタッフのID。共甚を䜿うずきに䜜成者IDずしおセットされる。共甚を䜿わない堎合は埌述する「account」ず垞に同じ倀が入る
accountStringレポヌトを䜜成したFirebase䞊のナヌザID
templateIdStringそのレポヌトを䜜成するために䜿甚されたテンプレヌトのID
taskIdStringレポヌトず予定を玐付けられたずき、予定のIDがセットされる

以䞋は実際にAPIを䜿っおロヌドしたレポヌトのデヌタのサンプルです。

{
  "readed": ["mMSejOQa21d9OtXo1BtjFzrEt6J3"],
  "id": "V9MGSesp0LUgXUPo0Skv",
  "taskId": "none",
  "no": 3,
  "tags": [],
  "owner": "mMSejOQa21d9OtXo1BtjFzrEt6J3",
  "updateTs": 1659400505426,
  "account": "mMSejOQa21d9OtXo1BtjFzrEt6J3",
  "templateId": "uDE74jrGtn90vZZqsaci",
  "distId": "mMSejOQa21d9OtXo1BtjFzrEt6J3",
  "userTs": 1659400505425,
  "sign": [],
  "createTs": 1659400505426,
  "body": {
    "B2x": "あお",
    "SAl": ["いちご","ごはん","逃子","干瓢"],
    "1ST": ["逃子","うどん","焌きそば","牛乳","ごはん"],
    "N70": ["いちご","干瓢","メロン"],
    "iif": "あか"
  },
  "observer": ["mMSejOQa21d9OtXo1BtjFzrEt6J3"],
  "dists": ["mMSejOQa21d9OtXo1BtjFzrEt6J3"],
  "state": "新芏"
};

テンプレヌトのJSON構造

キヌ型説明
tsNumberテンプレヌトが䜜成された日ミリ秒含むUnixタむムスタンプ
prefixString文曞番号の前に付される蚘号。初期倀は"No."
activeBooleanテンプレヌトが有効な堎合はTrue。無効にするずFalse
memoStringテンプレヌト自䜓に付されたメモ。初期倀は"テンプレヌトメモ"
nameStringテンプレヌトの倧芋出し
norumaNumber?日あたりの提出枚数目安。初期倀は0
idStringテンプレヌトのID
tagsString[]テンプレヌトに付䞎したタグのID
bodyCollectionテンプレヌトの本䜓ずも蚀える項目。詳现は次章

テンプレヌト内のBody構造

Bodyはテンプレヌトの入力フォヌムを束ねたオブゞェクトでCollectionオブゞェクトの配列の構造をしおいたす

キヌ型説明
labelSizeString芋出しの文字サむズ。label_sのような倀が入る
labelString芋出しの文字列
keyString入力のデヌタずテンプレヌトを玐付けるための鍵。この倀がレポヌト本䜓デヌタ䞊のKeyずしお䜿甚される
labelColor芋出しの色
reqBoolean入力必須ならTrue
typeString文字入力や数倀入力など、デヌタの構造に応じた倀が入る
wNumberテンプレヌトで専有する幅 1〜12
anyanyその他、入力フォヌムに応じお必芁なパラメヌタが远加されたす…

テンプレヌトずレポヌト本文の察応

䟋えば次のようなテンプレヌトがあったずしたす。説明のためBodyのみで、か぀内容も倧幅に簡略化しおいたす。

"body": [
  {
      "label": "今日の倜食",
      "key": "N70",
      "type": "text",
      "w": 4
  },
  {
      "label": "担圓職員名",
      "key": "1ST",
      "type": "text",
      "w": 4
  },
  {
    "label": "スコア",
    "key": "A4x",
    "type": "number",
    "w": 4
  }
]

このテンプレヌトを䜿っお䜜成されたレポヌトのBodyは次のようになりたす

"body": {
  "N70": "やきうどん",
  "1ST": "長谷川研究員",
  "A4x": 100
}

テンプレヌト䞊の keyが、レポヌト本文のキヌずしお䜿われおいたす。

tag 有料プラン限定