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 4 Next »

ON THIS PAGE

Group Entity

The Group entity has the following properties:

  • [int] Id:(read only) The identifier and primary key of the Group instance.
  • [string] Name: The user-defined name of the Group instance. This is an alternate key and must be unique within the scope of the account.
  • [DateTime] CreationDate:(read only) A UTC timestamp indicating when the Group instance was created within the BrightSign Network.
  • [string] MinAutorunVersion:(read only) The minimum version of device autorun required to play presentations scheduled for the Group instance.
  • [string] HD9XXFirmware: The minimum version of device firmware required to play presentations for the HD970 model.
  • [string] HDx10Firmware: The minimum version of device firmware required to play presentations for the following player models: HD210w, HD1010, HD1010w.
  • [string] HDx20Firmware: The minimum version of device firmware required to play presentations for the following player models: AU320, HD220, HD1020.
  • [string] HDx22Firmware: The minimum version of device firmware required to play presentations for the following player models: HD222, HD1022.
  • [string] XDx30Firmware: The minimum version of device firmware required to play presentations for the following player models: XD230, XD1030, XD1230.
  • [string] XDx32Firmware: The minimum version of device firmware required to play presentations for the following player models: XD232, XD1032, XD1132.
  • [string] 4Kx42Firmware: The minimum version of device firmware required to play presentations for the following player models: 4K242, 4K1042, 4K1142.
  • [bool] EnableSerialDebugging: A flag specifying whether serial debugging should be enabled for all players assigned to the Group instance.
  • [bool] EnableSystemLogDebugging: A flag specifying whether system log debugging should be enabled for all players assigned to the Group instance.
  • [int] DevicesCount:(read only) An integer indicating the number of players assigned to the Group instance.
  • [bool] EnableStorageSpaceLimit: A flag specifying whether the player storage will be divided into different segments. This allows the user to allot maximum sizes to different segments to ensure that a certain type of data does not take up too much space on the storage device.
  • [StorageSpaceLimitUnit] StorageSpaceLimitUnits: A StorageSpaceLimitUnit enumeration specifying whether the following limits are measured in percentages or megabytes.
  • [ushort] PublishedDataSizeLimit: The maximum size allotted to all presentation and content files that are written to the storage device during the publish process. This includes audio, video, images, text, and HTML content files.
  • [ushort] DynamicDataSizeLimit: The maximum size of all dynamic content, including Dynamic Playlists and MRSS feeds. When this segment runs out of space, dynamic content files will be deleted to create space, starting with the oldest files first.
  • [ushort] HtmlDataSizeLimit: The maximum size of the HTML application cache.
  • [ushort] HtmlLocalStorageSizeLimit: The maximum size of all JavaScript variables and data.
  • [List<Device>] Devices:(read only) A list of Device entities that are assigned to the current group.
  • [PresentationInfo[]]Presentations:(read only) An array of PresentationInfo structures denoting presentations that are currently scheduled for the Group instance.

StorageSpaceLimitUnit Enumeration

The StorageSpaceLimitUnit enumeration has the following values:

  • Percentage
  • Megabyte

Group Management Web Methods

PagedList<Group> GetGroups(string marker, int pageSize)

Retrieves the next page of the Group list, sorted by [string] Name. The returned list will contain no more items than the defined page size.

Required Permissions

Group: View Groups

Parameters
  • [string] marker: The [string] Name of the last Group 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.
List<Group> GetSpecifiedGroups(int[] presentationIds)

Description

Retrieves a list of Group instances matching the specified identifiers. The list is sorted by the [string] Name of the Group instances. The identifiers of nonexistent Group instances will be ignored.

Required Permissions

Group: View Groups

Parameters
  • [int[]]groupIds: An array of [int] Id values for the Group instances being requested. The number of returned items is limited to 100 by the server. Attempting to request more than the maximum allowed number of objects will cause an error, while passing an empty array will lead to an immediate empty response without an error.
PagedList<Group> FindGroups(string namePattern, string marker, int pageSize)

Retrieves the next page of a Group list containing names matched with the specified pattern. The returned list is organized by [string] Name and may not contain more items than the defined page size.

Required Permissions

Presentation: View Presentations

Parameters
  • [string] namePattern: The exact [string] Name of the Group instance (or its wildcard-based pattern). Supported wildcards currently include “*”, “?”, and “[‘and’]”.
  • [string] marker: The [string] Name of the last Group 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.
Group GetGroup (int groupId, bool loadDevices)

Retrieves a single Group instance with the specified [int] Id. This method returns Null if he Group instance with the specified identifier does not exist.

Required Permissions

Group: View Groups

Parameters
  • [int] groupId: The identifier and primary key of the Group instance to be retrieved.
  • [bool] loadDevices: A flag specifying whether the method should also initialize and return a list of all Device instances that are assigned to the specified Group.
Group GetGroupByName(string name, bool loadContent)

Retrieves the Group instance with the specified [string] Name. This method returns Null if the Group instance with the specified name does not exist.

Required Permissions

Group: View Groups

Parameters
  • [string] name: The user-defined Name of the Group instance to be retrieved.
  • [bool] loadDevices: A flag specifying whether the method should also initialize and return a list of all Device instances that are assigned to the specified Group.
Group CreateGroup(Group entity)

Creates a new Group instance with the specified name and settings. If successful, this method will return a Group instance with all initialized properties. If an error occurs, the method will return Null.

Required Permissions

Group: Create Group

Parameters
  • [Group] entity: A Group object instance with an initialized name, device autorun version, firmware versions, and debugging settings. Other property values will be ignored. If this parameter is set to Null, the method will immediately return False without an error. A descriptive error will be returned if any of the following conditions occur:
    • The length of the specified Group [string] Name is greater than 50 characters.
    • The specified Group [string] Name is already in use by another Group instance within the account.
    • Creating the Group instance will cause the total number of Group instances to exceed the limit set on the server.
bool UpdateGroup(Group entity)

Updates the specified Group instance using the values passed in the Group entity. This method returns True only if completely successful; otherwise, it will return False.

Required Permissions

Group: Update Group

Parameters
  • [BrightWallGroup] entity: A Group object instance specifying the [int] Id of the Group instance to update, as well as other new properties for the updated instance: [string] HD9XXFirmware, [string] HDX10Firmware, [string] HDX20Firmware, [string] HDX22Firmware, [string] XDX30Firmware, [string] XDX32Firmware, [string] 4KX42Firmware, [bool] EnableSerialDebugging, [bool] EnableSystemLogDebugging, [StorageSpaceLimitUnit] StorageSpaceLimitUnits, [ushort] PublishedDataSizeLimit, [ushort] DynamicDataSizeLimit, [ushort] HtmlDataSizeLimit, and [ushort] HtmlLocalStorageSizeLimit. If this parameter is Null or Invalid, the method will immediately return Null without an error. A descriptive error will be returned if any of the following conditions occur.
    • The specified [int] Id does not correspond to an existing Group instance.
    • The [string] Name of the Group entity does not correspond to the original instance (i.e. Group instances cannot be renamed using this method).
    • The sum of the [ushort] PublishedDataSizeLimit, [ushort] DynamicDataSizeLimit, [ushort] HtmlDataSizeLimit, and [ushort] HtmlLocalStorageSizeLimit values does not equal 100 when the StorageSpaceLimitUnits enumeration is set to Percentage.
    • One of the specified model firmware versions is invalid or not supported. A firmware version value can be set to Null or left empty without error.
bool UpdateGroupsFirmware(int[] groupIds, string hd9xxFirmware, string hdx10Firmware, string hdx20Firmware, string hdx22Firmware, string xdx30Firmware, string xdx32Firmware, string 4kx42Firmware)

Updates one or more model firmware versions for devices associated with the specified Group instances. This method returns True upon success and False upon failure.

Required Parameters

Group: Update Group, Update Firmware

Parameters
  • [int[]]groupIds: An array of [int] Id values specifying the Group instances to be updated. The maximum number of items is limited to 100 by the server. Attempting to request more than the maximum allowed number of objects will cause an error, while passing an empty array will lead to an immediate empty response without an error.
  • [string] hdx10Firmware: A new value for the [string] HDX10Firmware property of the specified Group instance(s).
  • [string] hdx20Firmware: A new value for the [string] HDX20Firmware property of the specified Group instance(s).
  • [string] hdx22Firmware: A new value for the [string] HDX22Firmware property of the specified Group instance(s).
  • [string] xdx30Firmware: A new value for the [string] XDX30Firmware property of the specified Group instance(s).
  • [string] xdx32Firmware: A new value for the [string] XDX32Firmware property of the specified Group instance(s).
  • [string] 4kx42Firmware: A new value for the [string] 4KX42Firmware property of the specified Group instance(s).

 

A descriptive error will be returned if any of the following conditions occur:

  • One or more of the [int] Id values does not correspond to an existing Group instance.
  • One of the specified firmware versions is invalid or not supported. A firmware version value can be set to Null or left empty without error.
bool DeleteGroup(int groupId, int reassignmentGroupId)

Deletes the specified Group instance and assigns all devices within it to another specified Group instance. This method only returns True if completely successful. Otherwise, it returns False.

Required Parameters

Group: Delete Group, Remove Device – Device: Change Target Group

Parameters
  • [int] groupId: The identifier of the Group instance to be deleted. If the [int] Id value is negative, the method will immediately return False without an error. A descriptive error will be returned if the Group specified for deletion is reserved (i.e. the default “Unassigned” Group instance) or if the [int] Id value is positive and does not correspond to an existing Group instance.
  • [int] reassignmentGroupId: The identifier of the Group instance to which affected devices should be reassigned. If this value is negative, the devices will be reassigned to the default “Unassigned” Group instance. If a Group instance with the specified positive [int] Id does not exist, the method will return a descriptive error.

 

  • No labels