使用Domino數據服務創建客房預訂REST API

Question

我一直在嘗試使用Domino數據服務REST API創建客房預訂，但我似乎錯過了一個技巧。

發送POST請求發送到文檔端點我可以提交和創造出現在的房間和資源視圖，但底層的房間預訂文件仍然顯示在Notes客戶端可用。

這裏是請求主體的樣本：

{ 
    "@authors": [ 
    "CN=Andrew Jones/O=MyCorp", 
    "" 
    ], 
    "@form": "Reservation", 
    "From": "CN=Andrew Jones/O=MyCorp", 
    "Chair": "CN=Andrew Jones/O=MyCorp", 
    "AltChair": "CN=Andrew Jones/O=MyCorp", 
    "Principal": "CN=Andrew Jones/O=MyCorp", 
    "SequenceNum": 1, 
    "OrgState": "5", 
    "ResourceType": "1", 
    "ResourceName": "Room/Office", 
    "ROOM": "Room/Office@MyCorp", 
    "Capacity": 1, 
    "AppointmentType": "3", 
    "StartTimeZone": "Z=0$DO=1$DL=3 -1 1 10 -1 1$ZX=47$ZN=GMT", 
    "EndTimeZone": "Z=0$DO=1$DL=3 -1 1 10 -1 1$ZX=47$ZN=GMT", 
    "TOPIC": "Test", 
    "SendTo": "CN=Room/O=Office", 
    "SelectedRR": "CN=Room/O=Office", 
    "$BusyName":"CN=Room/O=Office", 
    "Encrypt": "0", 
    "Categories": "", 
    "RouteServers": "CN=dominonode/O=MyCorp", 
    "DeliveredDate": { "data":"2017-03-09T12:38:34Z","type":"datetime"}, 
    "StartDate": {"data":"2017-03-09T20:00:00Z","type":"datetime"}, 
    "StartTime": {"data":"2017-03-09T20:00:00Z","type":"datetime"}, 
    "StartDateTime": {"data":"2017-03-09T20:00:00Z","type":"datetime"}, 
    "EndDate": {"data":"2017-03-09T21:00:00Z","type":"datetime"}, 
    "EndTime": {"data":"2017-09-03T21:00:00Z","type":"datetime"}, 
    "EndDateTime": {"data":"2017-03-09T21:00:00Z","type":"datetime"}, 
    "CalendarDateTime": {"data":"2017-03-09T20:00:00Z","type":"datetime"}, 
    "UpdateSeq": 1, 
    "Author": "CN=Andrew Jones/O=MyCorp", 
    "ResourceOwner": "", 
    "ReservedFor": "CN=Andrew Jones/O=MyCorp", 
    "ReservedBy": "CN=Andrew Jones/O=MyCorp", 
    "RQStatus": "A", 
    "Purpose": "API Test", 
    "NoticeType": "A", 
    "Step": 3, 
    "Site": "Office", 
    "ReserveDate": {"data":"2017-03-09T20:00:00Z","type":"datetime"} 
} 

This question建議我應該改爲嘗試創建日曆事件，但一切我送似乎變得不好的請求被拒絕，其中包括sample

我也看過another question這表明我需要創建一個約會，然後爲該房間的通知文件，但雖然我可以創建這些文件，但它似乎並沒有創建一個保留。

有沒有人嘗試這樣做，得到它的工作還是我剛剛加盟了大象的墓地？

Answer 1

我建議註冊一個特殊的「用戶」作爲預訂代理。然後，您可以使用日曆API來預訂任何房間。我認爲這種方法比數據API更好。

詳情：

• 註冊一個新的 「用戶」 作爲訂艙代理。讓我們打電話給用戶「Room Agent/MyCorp」。用戶的郵件文件是「mail/ragent.nsf」。

• 確保日曆API是在郵件服務器上啓用了「郵件/ ragent.nsf」的翻版。

• 當某人使用您的平板電腦應用預訂房間時，應用會發送請求在房間代理的日曆上創建活動（POST /mail/ragent.nsf/api/calendar/events）。新活動應包括與會者名單中的房間。

• 日曆API發送邀請室（實際上是資源數據庫）。只要房間尚未預訂，資源數據庫就會接受邀請，並且該房間在該時間段內變得繁忙。

這使您不必處理數據API和資源數據庫的複雜性。您的平板電腦應用程序只需知道郵件服務器主機名，郵件文件的名稱和房間代理的憑證。我也喜歡能夠「審覈」來自平板電腦應用的所有預訂的想法。您可以在房間代理的郵件文件中找到所有事件和通知（接受或拒絕）。

一個缺點是預訂不會瞬間，但資源數據庫應該能夠接受在幾秒鐘之內發出了邀請。

順便說一句，這裏是你的POST請求的一些示例JSON輸入：

{ 
    "events":[ 
    { 
     "summary":"Calendar API test", 
     "location":"test", 
     "description":"test", 
     "start":{"date":"2018-01-01","time":"13:00:00","utc":true}, 
     "end":{"date":"2018-01-01","time":"14:00:00","utc":true}, 
     "organizer":{"email":"ragent@mycorp.com"}, 
     "attendees":[ 
     { 
      "role":"req-participant", 
      "userType":"room", 
      "status":"needs-action", 
      "rsvp":true, 
      "email":"room@mycorp.com" 
     } 
     ] 
    } 
    ] 
} 

爲與會者指定"userType":"room"是很重要的。否則，資源數據庫將不接受邀請。