Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

ON THIS PAGE

ScheduledPresentation Entity-Relation

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

    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.

Schedule Management Web Methods

PagedList<ScheduledPresentation> GetGroupSchedule(int groupId, string marker, int pageSize)

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 the ScheduledPresentation entity-relations. The returned list will contain no more items than the defined page size.

Required Permissions

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.
ScheduledPresentation AddScheduledPresentation(int groupId, ScheduledPresentation entity)

Schedules a Presentation instance for a specified Group instance (or a BrightWallPresentation instance for a specified BrightWallGroup instance) and updates related service files in the storage. If successful, this method will return a newly created ScheduledPresentation or ScheduledBrightWallPresentation entity-relation. This method will return Null if an error occurs.

Required Parameters

Group: Update Schedule – Presentation: Assign Presentation (BrightWall Presentation: Assign BrightWall Presentation)*

*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/or [string] Name specifying the Presentation/BrightWallPresentation instance. An [int] Id and/or [string] Name 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 [string] Name does not correspond to an existing instance.
    • The specified Group/BrightWallGroup [int] Id or [string] Name 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 of the ScheduledPresentation/ScheduledBrightWallPresentation entity-relation is less than “00:00:00” or greater than “24:00:00”.
    • The [TimeSpan] Duration 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.
bool UpdateScheduledPresentation(ScheduledPresentation entity)

Updates the settings of the specified ScheduledPresentation or ScheduledBrightWallPresentation instance and related service files in storage.

Required Permissions

Group: Update Schedule – Presentation: Assign Presentation, Unassign Presentation [BrightWall Presentation: Assign BrightWall Presentation, Unassign BrightWall Presentation]*

*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 an updated Presentation/BrightWallPresentation [int] Id 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 not correspond to an existing instance.
    • The specified Presentation/BrightWallPresentation [int] Id or [string] Name does not correspond to an existing instance.
    • The [TimeSpan] StartTime value of the ScheduledPresentation/ScheduledBrightWallPresentation entity-relation is less than “00:00:00” or greater than “24:00:00”.
    • The [TimeSpan] Duration 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.
bool OverwriteSchedule(int groupId, ScheduledPresentation[] entities)

Completely overwrites one or more schedules associated with the specified Group or BrightWallGroup instance and updates related service files in the storage. This method returns True only if it is completely successful. Otherwise, it will return False.

Required Permissions

Group: Update Schedule – Presentation: Assign Presentation, Unassign Presentation [BrightWall Presentation: Assign BrightWall Presentation, Unassign BrightWall Presentation]*

*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 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 [string] Name 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 of the ScheduledPresentation or ScheduledBrightWallPresentation entity-relation is less than “00:00:00” or greater than “24:00:00”.
    • The [TimeSpan] Duration 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.
bool RemoveScheduledPresentation(int scheduledPresentationId)

Deletes the specified ScheduledPresentation or ScheduledBrightWallPresentation instance and updates related service files in the storage. This method returns True only if completely successful. Otherwise, it will return False.

Required Permissions

Group: Update Schedule – Presentation: Unassign Presentation [BrightWall Presentation: Unassign BrightWall Presentation]*

*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.


  • No labels