SheetsNew - ぺったんR Wiki - ぺったんR

new @ SheetsController

用紙新規作成フォームの表示。

url

• http://localhost:3000/sheets/new
• http://localhost:3000/sheets/new.json
• http://localhost:3000/sheets/new.js

リクエスト

認証	ユーザ
権限	作家
method	GET
urlパラメータ	なし
POSTデータ	json形式*
html	○
json	○
jsonp	×
js	○

解説

用紙を作成するための入力フォームをまっさらなページで表示する。このアクションが返すフォームに対し、ユーザが入力して送信ボタンを押すことで、作成アクションSheetsCreateが起動され、新規の行が作成される。だから、フォームの表示のみの処理だけで、これといったdb処理はない。

• セッションまたは認証トークンからユーザアカウントを特定する。
• ユーザアカウントから作家を取得する。
• 用紙モデルの初期データを生成する。
• 用紙モデルにデフォルト値を補充してもらう。
• 作業結果をクライアントに戻す。

urlパラメータ

なし

POSTデータ

auth_token

• jsonで要求する場合、認証処置として認証トークンが必要。

戻り値

正常系

• htmlなら、ステータスコード200 OKとともに、テンプレートから起こしたページを返す。
• jsなら、ステータスコード200 OKとともに、部分テンプレートから起こしたページ部品を返す。
• jsonのとき、ステータスコード200 OKとともに、json構造のデータを返す。
  • 出力フォーマットは用紙モデルのjson単体出力オプションに従う

参考:SheetsNewView

例外系

• ユーザアカウントでサインインしてなかった。(Devise)
  • htmlなら、ステータスコード302 Foundとともに、サインインを促すページ(/users/sign_in)へ遷移する。
  • jsなら、ステータスコード401 Unauthorizedとともに、応答メッセージにUnauthorizedを返す。
  • jsonなら、例外403 forbiddenを返す
• 作家登録してなかった。
  • htmlなら、ステータスコード302 Foundを返すとともに、作家登録を促すページ(/authors/new)へ遷移する。
  • jsonなら、ステータスコード401 Unauthorizedを返すとともに、応答メッセージにUnauthorizedを返す。