Page Comparison

...

The ScheduledPresentation entity-relation represents the relationship between a Presentation and Group instance in terms of its schedule. This entity-relation has the following properties.

• [int] Id:(read only) The identifier and primary key of the Presentation instance.
• [int] PresentationId: The identifier of the Presentation instance that is scheduled for the associated Group instance. Since a single Presentation instance can be scheduled for a Group instance multiple times, this identifier allows you to distinguish among unique schedule instances.
• [string] PresentationName: The name of the Presentation instance that is scheduled for the associated Group instance.
• [bool] IsRecurrent: A flag specifying whether the related presentation is played periodically at specified times and days of the week.
• [Nullable<DateTime>] EventDate: A DateTime value specifying the date when a non-recurrent presentation should begin playing. A Null value can be set for recurrent presentations that do not have a defined start date.
• [TimeSpan] StartTime: A TimeSpan value specifying the time when a presentation should begin playing.
• [TimeSpan] Duration: A TimeSpan value specifying how long a presentation should play.
• [Nullable<DateTime>] RecurrenceStartDate: A DateTime value indicating the date when a recurrently scheduled presentation should begin playing. A Null value can be set for recurrent presentations that do not have a defined start date.
• [Nullable<DateTime>] RecurrenceEndDate: A DateTime value indicating the date when a recurrently scheduled presentation should terminate. A Null value can be set for recurrent presentations that do not have a defined end date.

• [DayOfWeek] DaysOfWeek: A value indicating the days of the week during which a recurrently scheduled presentation should play. 

  Note
  title Note
  A presentation scheduled for “all day, every day” can be created with the following property settings: StartTime as “00:00:00”, EndTime as “1.00:00:00” (or “24:00:00”), and DaysofWeek as “EveryDay”; EventDate, RecurrenceStartDate, and RecurrenceEndDate are set to Null.

• [DateTime] CreationDate:(read only) A UTC timestamp indicating when the related Presentation instance was scheduled for the associated Group instance.
• [DateTime] LastModifiedDate:(read only) A UTC timestamp indicating when the current schedule was last updated.
• [DateTime] ExpirationDate:(read only) A UTC timestamp indicating when the current schedule will expire.

...

Retrieves the next page of the ScheduledPresentation list associated with a specified Group instance (or ScheduledBrightWallPresnetation list associated with a specified BrightWallGroup instance). The list is sorted by the [DateTime] ExpirationDate of  of the ScheduledPresentation entity-relations. The returned list will contain no more items than the defined page size.

...

Schedule: View Schedule

Parameters

• [int] groupID: The identifier of the Group instance that is associated with the schedule. If a Group instance with the specified identifier does not exist, the method will immediately return Null without an error.
• [string] marker: The [string] ExpirationDate of the last ScheduledPresentation instance on the previous page. If the value is Null, then the method will retrieve the first page.
• [int] pageSize: The maximum number of objects returned by the method. If the list of objects that match the search criteria exceeds the [int] pageSize limit, the returned list will indicate that it is truncated. If the integer is not positive, then the method will return the maximum allowed number of objects. Attempting to request more objects than is allowed will lead to the same result, but without an error.

...

*This permission is only required when scheduling a BrightWallPresentation instance.

Parameters

• [int] groupId: The identifier of the Group/BrightWallGroup instance for which the Presentation/BrightWallPresentation instance should be scheduled.
• [ScheduledPresentation] entity: A ScheduledPresentation or ScheduledBrightWallPresentation object instance with an [int] Id and and/or [string] Name specifying  specifying the Presentation/BrightWallPresentation instance. An [int] Id and and/or [string] Name is  is also required for the Group/BrightWallGroup. If this parameter is set to Null, then this method will immediately return Null without an error. A descriptive error will be returned if any of the following conditions occur:
  • The specified Presentation/BrightWallPresentation [int] Id or  or [string] Name does  does not correspond to an existing instance.
  • The specified Group/BrightWallGroup [int] Id or  or [string] Name does  does not correspond to an existing instance.
  • A Presentation instance is scheduled for a BrightWallGroup instance.
  • A BrightWallPresentation instance is scheduled for a BrightWallGroup instance.
  • The [TimeSpan] StartTime value  value of the ScheduledPresentation/ScheduledBrightWallPresentation entity-relation is less than “00:00:00” or greater than “24:00:00”.
  • The [TimeSpan] Duration value  value of the ScheduledPresentation/ScheduledBrightWallPresentation entity-relation is less than “00:00:00” or greater than “24:00:00” minus the [TimeSpan] StartTime.
  • A recurrent schedule does not have Start Time, Duration, or Days of Week values.
  • A recurrent schedule contains a Recurrence Start Date value but not a Recurrence End Date value, or vice-versa.
  • A specified Recurrence Start Date value is greater than the Recurrence End Date value.
  • A non-recurrent schedule does not have Event Date, Start Time, or Duration values.
  • The specified ScheduledPresentation/ScheduledBrightWallPresentation instance conflicts with another Presentation/BrightWallPresentation instance already scheduled for the group.

...

*This permission is only required when updating a ScheduledBrightWallPresentation instance.

Parameters

• [ScheduledPresentation] entity: A ScheduledPresentation/ScheduledBrightWallPresentation object instance with an initialized instance [int] Id and  and an updated Presentation/BrightWallPresentation [int] Id and and/or [string] Name. The instance must also contain StartTime, Duration, IsRecurrent, EventDate, RecurrenceStartDate, RecurrenceEndDate, and DaysOfWeek properties. All other properties will be ignored. If this parameter is set to Null, then the method will immediately return Null without an Error. A descriptive error will be returned if any of the following conditions occur:
  • The specified ScheduledPresentation/ScheduledBrightWallPresentation [int] Id does  does not correspond to an existing instance.
  • The specified Presentation/BrightWallPresentation [int] Id or  or [string] Name does  does not correspond to an existing instance.
  • The [TimeSpan] StartTime value  value of the ScheduledPresentation/ScheduledBrightWallPresentation entity-relation is less than “00:00:00” or greater than “24:00:00”.
  • The [TimeSpan] Duration value  value of the ScheduledPresentation/ScheduledBrightWallPresentation entity-relation is less than “00:00:00” or greater than “24:00:00” minus the [TimeSpan] StartTime.
  • A recurrent schedule does not have Start Time, Duration, or Days of Week values.
  • A recurrent schedule contains a Recurrence Start Date value but not a Recurrence End Date value, or vice-versa.
  • A specified Recurrence Start Date value is greater than the Recurrence End Date value.
  • A non-recurrent schedule does not have Event Date, Start Time, or Duration values.
  • The specified ScheduledPresentation/ScheduledBrightWallPresentation instance conflicts with another Presentation/BrightWallPresentation instance already scheduled for the group.

...

*This permission is only required when overwriting schedule(s) associated with a BrightWallGroup instance.

Parameters

• [int] groupId: The identifier of the Group/BrightWallGroup instance to modify. If the [int] Id does  does not correspond to an existing Group/BrightWallGroup instance, the method will immediately return False without an error.
• [ScheduledPresentation[]] entities: A list of ScheduledPresentation instances or ScheduledBrightWallPresentation instances, each containing an initialized [int] Id and/or [string] Name. Each instance should also contain the following properties: StartTime, Duration, IsRecurrent, EventDate, RecurrenceStartDate, RecurrenceEndDate, and DaysofWeek. All other properties will be ignored. If this parameter is set to Null or is passed an empty list, the method will delete all existing presentation entities associated with the specified Group/BrightWallGroup instance. A descriptive error will be returned if any of the following conditions occur:
  • The specified [int] Id or  or [string] Name does  does not correspond to an existing Presentation or BrightWallPresentation instance.
  • The ScheduledPresentation instance(s) are specified for a BrightWallGroup instance.
  • The ScheduledBrightWallPresentation instance(s) are scheduled for a BrightWallGroup instance.
  • The [TimeSpan] StartTime value  value of the ScheduledPresentation or ScheduledBrightWallPresentation entity-relation is less than “00:00:00” or greater than “24:00:00”.
  • The [TimeSpan] Duration value  value of the ScheduledPresentation or ScheduledBrightWallPresentation entity-relation is less than “00:00:00” or greater than “24:00:00” minus the [TimeSpan] StartTime.
  • A recurrent schedule does not have Start Time, Duration, or Days of Week values.
  • A recurrent schedule contains a Recurrence Start Date value but not a Recurrence End Date value, or vice-versa.
  • A specified Recurrence Start Date value is greater than the Recurrence End Date value.
  • A non-recurrent schedule does not have Event Date, Start Time, or Duration values.
  • The specified ScheduledPresentation/ScheduledBrightWallPresentation instances conflict with each other.

...

*This permission is only required when removing a schedule associated with a BrightWallGroup instance.

Parameters

• [int] ScheduledPresentationId: An identifier indicating the ScheduledPresentation instance that should be deleted.

...