Companywebcast API Wiki
Navigation
Cwc API Home
PlayerSDK
Meta Service
Getting Started
Creating a client
Methods
Data Types
Understanding Webcast security
Management Service
Getting Started
Creating a client
Methods
Data Types
Quick Search
Advanced Search »
Back
History
Management Service 2.0 : Data Types
These are the DataTypes of the Management Service {TOC} [anchor|#Customer] ===Customer=== An object with the following properties: :''Code'' ::A string. Uniquely identifies this Customer. :''Description'' ::A string. Description of this Customer. :''Modules'' ::A list of ''[#ModuleType|ModuleType]'' objects. Describes which Modules are available for this Customer. :''Name'' ::A string. The name of this Customer. :''Profiles'' ::A list of ''[#Profile|Profile]'' objects. A Profile contains pre-configured settings and data from which all new Webcasts are created. :''Reference'' ::A string. Ignore this for now. :''Tags'' ::A list of strings. This shows all the tags that have been added to Webcasts for this Customer so far. [anchor|#CustomerSummary] ===CustomerSummary=== An object with the following properties: :''Code'' ::A string. Uniquely identifies a Customer. Use it as an input parameter for CustomerGet. :''Name'' ::A string. The name of a Customer. :''Reference'' ::A string. Ignore this for now. [anchor|#Event] ===Event=== An object with the following properties: :''End'' ::A DateTime. UTC representation of the date and time on which an event ended. :''Start'' ::A DateTime. UTC representation of the date and time on which an event started. [anchor|#Form] ===Form=== An object with the following properties: :''Description'' ::A string. Description of this Form. :''Events'' ::A list of ''[#Event|Event]'' objects. :''Id'' ::A string. Uniquely identifies this Form. :''Questions'' ::A list of ''[#Question|Question]'' objects. :''Reference'' ::A string. Use this property for your own identifiers. :''Title'' ::A string. Title of this Form. :''Type'' ::A string. This allows you to define the context in which this Form is to be used. If you're using the Player API and/or a Player provided to you by Company Webcast, you can enter one of the following types : survey, poll, registration (note that these require the corresponding ModuleTypes to be available to you). If you are creating your own Player or Player Module, just enter any other string that makes sense with your application. [anchor|#GenericItem] ===GenericItem=== An object with the following properties: :''Events'' ::A list of ''[#Event|Event]'' objects. :''Id'' ::A string. Uniquely identifies this GenericItem. :''Reference'' ::A string. Use this property for your own identifiers. Anything you enter here is available through the MetaService as well, and is your best route to quickly finding this particular item. :''Value'' ::A string. Enter your own custom data here. [anchor|#Location] ===Location=== An object with the following properties: :''Address'' ::A string. :''City'' ::A string. :''Coordinates'' ::An object with the following properties: :::''Latitude'' ::::A double. :::''Longitude'' ::::A double. :''CountryCode'' ::A string. A 2 character [http://en.wikipedia.org/wiki/ISO_3166-1|ISO 3166-1] country code. :''PostalCode'' ::A string. :''State'' ::A string. :''TimeZoneName'' ::A string. The name of the time zone as defined in [http://en.wikipedia.org/wiki/Zone.tab|Zone.tab]. [anchor|#ModuleType] ===ModuleType=== An enumeration. Can have one of the following values: :''Generics'' :''Poll'' :''Registration'' :''Slides'' :''Speakers'' :''Survey'' :''Topics'' [anchor|#Profile] ===Profile=== An object with the following properties: :''Id'' ::A string. Uniquely identifies this Profile. :''Title'' ::A string. The title of this Profile. [anchor|#Question] ===Question=== An object with the following properties: :''Label'' ::A string. Short form descriptive field. Use for whatever you need. :''Id'' ::A string. Uniquely identifies this Question. :''Mandatory'' ::A boolean. Indicates if an answer to this question is mandatory. If this is set to false, answering this Question is optional. :''MaxLength'' ::An integer. Indicates the maximum amount of characters that we want to accept from the user's answer to this Question. :''Options'' ::A list of ''[#QuestionOption|QuestionOption]'' objects. If the ''Type'' of this Question is NOT ''Open'', this contains the Options from which a user can make a selection. :''Reference'' ::A string. Use this property for your own identifiers. :''Text'' ::A string. The text of the actual question you are posing the user. E.g. "What is your occupation?" :''Type'' ::An enumeration of type ''QuestionType''. :::The ''QuestionType'' enumeration can have one of the following possible values: ::::''MultipleAnswer'' ::::''Open'' ::::''SingleAnswer'' [anchor|#QuestionOption] ===QuestionOption=== An object with the following properties: :''Label'' ::A string. Short form descriptive field. Use for whatever you need. :''Correct'' ::A boolean. Indicates whether this is the correct option. :''Id'' ::A string. Uniquely identifies this QuestionOption. :''Reference'' ::A string. Use this for your own identifiers. :''Text'' ::A string. The actual text of the Option we are presenting to the user. [anchor|#Slide] ===Slide=== An object with the following properties: :''Events'' ::A list of ''[#Event|Event]'' objects. :''Id'' ::A string. Uniquely identifies this Slide. While adding new slides to a Webcast object, you can either leave Id blank, or enter a custom identifier that you use for creating ''Trigger'' objects. :''Reference'' ::A string. Use this property for your own identifiers. Anything you enter here is available through the MetaService as well, and is your best route to quickly finding this particular slide. [anchor|#SlidesModule] ===SlidesModule=== An object with the following properties: :''Slides'' ::A list of ''[#Slide|Slide]'' objects. :''StatusEnabled'' ::A list of ''[#WebcastStatus|WebcastStatus]'' objects. The SlidesModule and all the data it contains is only available in the ''WebcastStatus'' phases you explicitly define here. [anchor|#Speaker] ===Speaker=== An object with the following properties: :''Category'' ::A string. Defines the Category this Speaker belongs to. :''DOB'' ::A DateTime. Defines the date of birth of this Speaker. :''Email'' ::A string. The email address of this Speaker. :''Events'' ::A list of ''[#Event|Event]'' objects. :''Gender'' ::An enumeration that can have one of the following values: :::''Female'' :::''Male'' :::''Unknown'' :''Id'' ::A string. Uniquely identifies this Speaker. While adding new speakers to a Webcast object, you can either leave Id blank, or enter a custom identifier that you use for creating ''Trigger'' objects. :''ImageUrl'' ::A string. A url to a picture of this Speaker. :''Name'' ::An object with the following properties: :::''First'' ::::A string. First name of the Speaker. :::''Last'' ::::A string. Last name of the Speaker. :::''Middle'' ::::A string. Middle name of the Speaker. :::''Title'' ::::A string. Title of the Speaker. :''Phone'' ::A string. The phone number of the Speaker. :''POB'' ::A string. The place of birth of the Speaker. :''Reference'' ::A string. Use this property for your own identifiers. Anything you enter here is available through the MetaService and PlayerSDK as well, and is your best route to quickly finding this particular speaker. :''Role'' ::A string. The role of the Speaker. :''SeatCode'' ::A string. Used for mapping speakers to a specific seat. :''Url'' ::A string. A url to a web page belonging to this Speaker. [anchor|#SpeakersModule] ===SpeakersModule=== An object with the following properties: :''Speakers'' ::A list of ''[#Speaker|Speaker]'' objects. :''StatusEnabled'' ::A list of ''[#WebcastStatus|WebcastStatus]'' objects. The SpeakersModule and all the data it contains is only available in the ''WebcastStatus'' phases you explicitly define here. [anchor|#Topic] ===Topic=== An object with the following properties: :''Attachments'' ::List of ''TopicAttachment'' objects. :::The ''TopicAttachment'' object has the following properties: ::::''Id'' :::::A string. Uniquely identifies this TopicAttachment. ::::''Description'' :::::A string. Description of the Attachment. ::::''Url'' :::::A string. Url that points at the Attachment. :''Description'' ::A string. Description of this Topic. :''Events'' ::A list of ''[#Event|Event]'' objects. :''Id'' ::A string. Uniquely identifies this Topic. While adding new topics to a Webcast object, you can either leave Id blank, or enter a custom identifier that you use for creating ''Trigger'' objects. :''Reference'' ::A string. Use this property for your own identifiers. Anything you enter here is available through the MetaService and PlayerSDK as well, and is your best route to quickly finding this particular topic. :''Tags'' ::A list of strings. This allows you to add tags to this Webcast. The Customer.Tags property contains a list of all Tags used before in the context of this Customer. You can re-use those, or add a new one by just entering it here. :''Title'' ::A string. The title of this Topic. [anchor|#TopicsModule] ===TopicsModule=== An object with the following properties: :''Topics'' ::A list of ''[#Topic|Topic]'' objects. :''StatusEnabled'' ::A list of ''[#WebcastStatus|WebcastStatus]'' objects. The TopicsModule and all the data it contains is only available in the ''WebcastStatus'' phases you explicitly define here. [anchor|#Trigger] ===Trigger=== An object with the following properties: :''ReceiverId'' ::A string. The Id of the data item that receives the trigger to activate. :''SenderId'' ::A string. The Id of the data item that sends the trigger to activate. [anchor|#Webcast] ===Webcast=== An object with the following properties: :''ActiveModules'' ::A list of ''[#ModuleType|ModuleType]'' objects. Each of the currently supported Modules that you want to activate for this Webcast must be included in this list. Note that not all Customers have access to all Modules. Customer.Modules is a list of all Modules this Customer has access to. :''ActualEnd'' ::A DateTime. UTC representation of the actual date and time on which the Webcast ended. :''ActualStart'' ::A DateTime. UTC representation of the actual date and time on which the Webcast started. :''Code'' ::A string. Uniquely identifies a Webcast. It is automatically generated during WebcastCreate, and is a read only property. :''DefaultLanguage'' ::A string. Gets or sets the 2 character country code that defines the default language. :''Description'' ::A string. Description of this Webcast. :''Enlist'' ::A boolean. Gets or sets whether this Webcast should be available through the MetaService's WebcastSearch method. If Enlist is set to ''true'', this Webcast can appear in the results of WebcastSearch. :''Forms'' ::A list of ''[#Form|Form]'' objects. A Form provides a way of presenting interactive content to a user. Forms can take the shape of registration pages, surveys and polls. :''GenericItems'' ::A list of ''[#GenericItem|GenericItem]'' objects. A GenericItem allows for completely custom data to be plotted on a Webcast's timeline. :''Languages'' ::A list of 2 character language codes. Gets or sets the languages in which this Webcast is available. :''Location'' ::A ''[#Location|Location]'' object. Contains information pertaining to the geographical location of the Webcast. :''ProfileId'' ::A string. The Id of the Profile that was used to initially create this Webcast. :''Reference'' ::A string. You can use this property for your own purposes. Whatever you place here will be available through the MetaService as well. One of its intended uses is for you to place your own identifier here. :''Revision'' ::A string. Every time WebcastSave is called on a Webcast, its Revision is updated to reflect its last change date. When you use WebcastSave, your Webcast's Revision has to always contain the latest Revision. Webcasts with an out of date Revision will fail to save. :''ScheduledStart'' ::A DateTime. Gets or sets the date and time on which the Webcast should start. :''SlidesModule'' ::A ''[#SlidesModule|SlidesModule]'' object. Contains configuration information and meta data for slides. :''SpeakersModule'' ::A ''[#SpeakersModule|SpeakersModule]'' object. Contains configuration information and meta data for speakers. :''Status'' ::A ''[#WebcastStatus|WebcastStatus]'' object. This is a read only property that indicates what state this Webcast is in. You can use it to determine if you can still make changes to this Webcast and whether is has been accepted for production. :''Tags'' ::A list of strings. Tags are generally used for indexing purposes. :''Title'' ::A string, the title of the Webcast. :''TopicsModule'' ::A ''[#TopicsModule|TopicsModule]'' object. Contains configuration information and meta data for topics. :''Triggers'' ::A list of ''[#Trigger|Trigger]'' objects. During the Live phase of a Webcast, the activation of one Module's data element can automatically trigger the activation of another. For example, when Slide5 is activated, it can "trigger" Topic2 to become active is well. [anchor|#WebcastSearchOrder] ===WebcastSearchOrder=== An enumeration. Can have one of the following values: :''ClientAsc'' :''ClientDesc'' :''CreatedAsc'' :''CreatedDesc'' :''ModifyAsc'' :''ModifyDesc'' :''StartAsc'' :''StartDesc'' :''WebcastDefaultTitleAsc'' :''WebcastDefaultTitleDesc'' [anchor|#WebcastStatus] ===WebcastStatus=== An enumeration that has one of the following possible values: :''Archived'' ::Indicates that the Webcast has been detached from the editable data model and it now only available for reading. A Webcast will never automatically reach this state, it can only be brought into this state manually by Company Webcast personnel. :''Indexed'' ::Indicates that the Webcast has been Indexed, and MediaStreams are now available for on demand playback. This state is automatically reached once the PreIndex state ends. Auxiliary files, such as mp3 conversions of the Webcast, are now available or will be very soon. :''Live'' ::Indicates that the Webcast is now live. Note that the Management Service only accepts changes to a Webcast's Events once that Webcast has reached the Indexed state. :''PreIndexed'' ::Indicates that the Webcast's MediaStreams and auxiliary files are being post processed for on demand usage. This state is automatically reached once a live Webcast ends. In this state MediaStreams are available, but loop a "please wait" media clip. Webcasts cannot currently be changed through the Management Service once this state is reached. :''PreLive'' ::Indicates that the Webcast is soon to go live. This state is automatically reached 30 minutes before Webcast.ScheduledStart. MediaStreams are now available or will be very soon. MediaStreams loop a "starting soon" clip. Note that the Management Service only accepts changes to a Webcast's Events once that Webcast has reached the Indexed state. :''PreReady'' ::Indicates that the Webcast exists, but cannot yet be taken into production. Webcasts have this state when they're freshly created with WebcastCreate, or when the Webcast object contains data that conflicts with the validation rules. :''Ready'' ::Indicates that the Webcast has been accepted to be taken into production. It will automatically reach the PreLive state 30 minutes before Webcast.ScheduledStart. [anchor|#WebcastSummary] ===WebcastSummary=== An object with the following properties: :''Customer'' ::A ''[#CustomerSummary|CustomerSummary]'' object. Describes the Customer to whom this Webcast belongs. :''Languages'' ::A list of 2 character language codes. Gets or sets the languages in which this Webcast is available. :''Revision'' ::A string. Every time WebcastSave is called on a Webcast, its Revision is updated to reflect its last change. When you use WebcastSave, your Webcast's Revision has to always contain the latest Revision. Webcasts with an out of date Revision will fail to save. :''ScheduledStart'' ::A DateTime. The date and time on which this Webcast is or was scheduled to start. :''Status'' ::A ''[#WebcastStatus|WebcastStatus]'' object. Indicates the current WebcastStatus of this Webcast. :''Title'' ::A string. The title of this Webcast. :''WebcastCode'' ::A string. Uniquely identifies this Webcast.