ここでは、ワークステーションおよび人の例外を作成、更新、削除する方法について説明します。例外とは、ワークステーションの能力または人のシフトにおける休憩のことです。マシンの例外は、例えば、サービスやメンテナンスの休憩であり、人の例外は、休日、病気休暇、休暇である。
ワークステーションの例外 #
ワークステーションの例外は、/workstation-exceptionsエンドポイントからアクセスできる。
Person exceptionsは/person-exceptionsエンドポイントからアクセスできます。
例外の取得 #
以下のようなGETリクエストを送信して、既存の例外を取得する:
ワークステーションの例外は、タイプ、ワークステーション ID、external_id、または変更された条件でフェッチできます。
タイプ、person_id、または変更された条件によって、人物の例外を取得できます。
例外の作成 #
次のようなPOSTリクエストを送ることで、ワークステーション例外を作成できる:
どのワークステーションに例外をスケジューリングするかを指定するには、workstation_idフィールドを使用します。
ワークステーションで許可される例外の種類は以下の通り:メンテナンス、清掃、 移動/整理。
ワークステーション例外にはexternal_idを指定することもできる。
人物例外を作成するには、次のようなPOSTリクエストを送信する:
例外を作成する人を指定するには、person_idを使用する必要があります。
例外として認められるのは以下の通りである:休暇、病気休暇、フレックス休暇、無給休暇。
例外の更新 #
例外を更新するには、GETリクエストを送るか、例外を発生させたときの応答メッセージから得られる例外IDを使う必要がある。
例外の削除 #
ワークステーション例外の削除は、内部例外ID、external_ID 、または workstation_ID を指定して行うことができる。
人物の例外を削除するには、内部例外IDまたはperson_idsを指定する。
複数の例外セットを1回のリクエストで削除するには、idを配列で指定します:
DELETEリクエストの応答メッセージは、いくつの例外が削除されたかを教えてくれる。