EMS Platform Services Release Notes V44.1, Update 16

This section describes updates to your EMS software.  

See Also: Contact Customer Support and Updating to the Latest Version of EMS (Patches and Builds).

Name: 
V44.1 Update 16

Release Date: 
September 29, 2017

Patch: 
44.1.16000.201709202

Build #:  
44.1.16000.3579

 

Enhancements

Area

Description

Video Conference (VC)

VC Create – Validate VC Constraints on Event Creation

Video Conferencing reservations are now validated for the following:

  • All booking records have the same GMT start per grouping.
  • For each date, the bookings should all have the same GMT start.
  • A room record is designated as the Host.
  • Only one VC Host can be assigned to a group of bookings with same GMT start time.

Internal Reference # 30279
(For EMS Internal Use Only)

VC Cancel – Bookings and Reservation

Users can cancel individual bookings in a VC. However, a VC Host booking cannot be canceled unless it is the only non-canceled booking in the group. When VC Cancel is enabled, Exchange will be updated.

Internal Reference # 30281
(For EMS Internal Use Only)

VC – Change Host

Added a new route for setting the room associated with bookingID as the host of the reservation VC group in which bookingId belongs.

POST /reservations/{id}/vchost/{bookingId}

Internal Reference # 30282
(For EMS Internal Use Only)

API Calls

 

Get Drawings for Multiple Bookings

Added a new API call that takes multiple booking IDs as inputs and returns drawings.

POST /bookings/actions/search/drawings

Internal Reference # 31201
(For EMS Internal Use Only)

Get Attachments for Multiple Bookings

Added a new API call that takes multiple booking IDs as inputs and returns attachments.

POST /bookings/actions/search/attachments

Internal Reference # 31202
(For EMS Internal Use Only)

Ability to Create and Edit a Reservation with the Conference Code and Conference URL (Skype Meetings)

Added 'conferenceURL' and 'conferenceCode' attributes to these routes:

  • POST /reservations/actions/create
  • PATCH /reservations/{id}

Internal Reference # 31610
(For EMS Internal Use Only)

Add Service Orders to Existing Booking

Added a new API call that inserts records into tblServiceOrder and tblServiceOrderDetail.

POST /bookings/{id}/serviceorders

Internal Reference # 31649
(For EMS Internal Use Only)

Edit Service Order

Added a new API call that allows a parameter validation to allow edit of services and restrict SO times to an event time.

PATCH /serviceorders/{id}

Internal Reference # 31650
(For EMS Internal Use Only)

Delete Service Order Detail

DELETE /serviceorders/{id}/serviceorderdetails/{sodid}

Internal Reference # 31651
(For EMS Internal Use Only)

Delete Service Order

DELETE /serviceorders/{id}

Internal Reference # 31652
(For EMS Internal Use Only)

Edit Service Order Detail

PATCH /serviceorders/{id}/serviceorderdetails/{sodid}

Internal Reference # 31653
(For EMS Internal Use Only)

CRUD (Create, Read, Update, Delete) for Service Order UDF Answers

  • GET /serviceorders/{id}/userdefinedfields
  • PATCH /serviceorders/{id}/userdefinedfields

Internal Reference # 31655
(For EMS Internal Use Only)

Support for Resource Packages

Supports packageResourceId and resourceItems attributes.

POST /serviceorders/{id}/serviceorderdetails

Internal Reference # 31656
(For EMS Internal Use Only)

Can Edit Service Validation

GET /bookings/id/serviceorders includes new 'canEditService' attribute.

Internal Reference # 31675
(For EMS Internal Use Only)

Edit Host Information on Bookings

New route for setting the room associated with bookingID as the host of the reservation VC group in which bookingId belongs.

POST /reservations/{id}/vchost/{bookingId}

Internal Reference # 31735
(For EMS Internal Use Only)

GET Room Set Ups for Multiple Rooms

GET/rooms/{id}/setup can now generate the capacity information.

POST /rooms/actions/search/setups

Internal Reference # 31809
(For EMS Internal Use Only)

Add Building Timezone Detail to GET and POST Room Routes

Added 'timezone' attribute to 'building' attribute of each room for following routes:

  • GET /rooms
  • GET /rooms/{id}
  • POST /rooms/actions/search

Internal Reference # 32059
(For EMS Internal Use Only)

Add Default Set Up Type Capacity Filter to Room Search

'Capacity' attribute added to search criteria for POST /rooms/actions/search. Capacity is compared to the capacity of the defaultSetupType of rooms. Rooms should be returned if they are ≥ the value in the 'capacity' parameter passed.

Internal Reference # 32060
(For EMS Internal Use Only)

Add Building Timezone Detail to Room Availability Routes

POST /rooms/actions/availability includes a new 'timeZoneSummary' attribute in the response.

Internal Reference # 32065
(For EMS Internal Use Only)

EMS for Outlook

New Parameters

The following parameters have been added to GET /public/parameters:

  • Services_RestrictSOTimeToEvent = "Restrict Service Order Times Within Event Times"
  • Services_PopulateServiceTimesFromBooking = "Set Service Time Default from the Event Time"
  • Services_PopulateEstimatedCount = "Populate Service Setup with Attendance"
  • Services_EnforceInventory = "Maintain Inventory"

The following parameters have been added to the GET /webtemplate/{id} response model:

  • servicesAllowEdit
  • showResourcePricing
  • showRoomPricing
  • defaultRatePlanId

Internal Reference # 32237
(For EMS Internal Use Only)

Resource Images

Retrieving room images (/rooms/{id}/images) and /rooms/{id}/images/{imageId}

GET /resources/{id}/images

Internal Reference # 32239
(For EMS Internal Use Only)

Resource Packages

GET /resources includes a new 'packageResources' attribute.

Internal Reference # 32240
(For EMS Internal Use Only)

Resource Groups/Items (Selections)

Includes fields for tblResourceGroup: ResourceId, SeqNo, Description, MinPick, MaxPick, Active

Includes fields for tblResourceItem: ResourceGroupId, SeqNo, Description, Notes

GET /resources/{id}/selections

Internal Reference # 32241
(For EMS Internal Use Only)

Outlook Room Resource Exclusions

New API call to get a room's resource exclusions.

GET /rooms/{id}/excludedresources

Internal Reference # 32279
(For EMS Internal Use Only)

Category Service Call That Validates a Time Against Category Cutoff Time Settings

POST /categories/{id}/validation

Internal Reference # 32315
(For EMS Internal Use Only)

Service Order UDFs - Return UDF Definitions and Child Definition Items When Requesting a Category

GET /categories/{id}/userdefinedfields

Internal Reference # 32386
(For EMS Internal Use Only)

TimeZones by Date Range

New API call gets a list of distinct time zones and their timezone offset time ranges (Daylight Savings related time offsets) for a buildingId or timeZoneId and a date range. 

  • GET /timezones/{id}/offsets
  • GET /buildings/{id}/timezone/offsets

Internal Reference # 32429
(For EMS Internal Use Only)

API Calls

 

Allow Users to Add Reserve Start Time and Reserve End Time While Creating Booking

Add reserve start time and reserve end time to booking request model. The following routes support optional 'reservedStartTime' and 'reservedEndTime' attributes. These override any pre-existing room setup/teardown settings:

  • POST /reservations/actions/create
  • POST /reservations/{id}/bookings
  • PATCH /bookings/{id}

Internal Reference # 32482
(For EMS Internal Use Only)

CRUD for Webuser UDF Answers

These routes will allow webuser user-defined fields (UDFs) to assign webroles ro webusers. 

  • GET /myuser/userdefinedfields
  • PATCH /myuser/userdefinedfields

Internal Reference # 32483
(For EMS Internal Use Only)

Document Error Codes Each Service Route Can Return

All error responses include new "errorCode" attribute. "MsgId" attribute is deprecated. All service route swagger docs include error codes that can be returned for each http error.

Internal Reference # 32489
(For EMS Internal Use Only)

Check-In Existing Visitor

New 'checkedIn' attribute supported by the following routes:

  • PATCH /serviceorders/{id}/serviceorderdetails/{sodid}
  • GET /serviceorders/{id}
  • GET /serviceorders

Internal Reference # 32572
(For EMS Internal Use Only)

Add New SOD To Existing Service Order

New route includes check in flag and calls existing vems_addServices_AddAttendee. It allows for adding Resource, Notes, or Attendee Type Service Order Details.

POST /serviceorders/{id}/serviceorderdetails

Internal Reference # 32573
(For EMS Internal Use Only)

New Error Code

New 'TokenMissing' Error Code Returned with Http 401 Responses if Client Omits x-ems-api-token Header in Requests

Requests with either no x-ems-api-token request header or a header with an empty token value "" will return a http 401 with an errorCode of 'TokenMissing.'

Internal Reference # 32678
(For EMS Internal Use Only)

Contact Customer Support

If you do not have a customer login, register here.