Companywebcast API Wiki

These are the DataTypes of the Management Service

Table of Contents [Hide/Show]


Edit

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 objects. Describes which Modules are available for this Customer.
Name
A string. The name of this Customer.
Profiles
A list of 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.

Edit

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.

Edit

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.

Edit

Form

An object with the following properties:
Description
A string. Description of this Form.
Events
A list of Event objects.
Id
A string. Uniquely identifies this Form.
Questions
A list of 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.

Edit

GenericItem

An object with the following properties:
Events
A list of 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.

Edit

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 ISO 3166-1 country code.
PostalCode
A string.
State
A string.
TimeZoneName
A string. The name of the time zone as defined in Zone.tab.

Edit

ModuleType

An enumeration. Can have one of the following values:
Generics
Poll
Registration
Slides
Speakers
Survey
Topics

Edit

Profile

An object with the following properties:
Id
A string. Uniquely identifies this Profile.
Title
A string. The title of this Profile.

Edit

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

Edit

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.

Edit

Slide

An object with the following properties:
Events
A list of 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.

Edit

SlidesModule

An object with the following properties:
Slides
A list of Slide objects.
StatusEnabled
A list of WebcastStatus objects. The SlidesModule and all the data it contains is only available in the WebcastStatus phases you explicitly define here.

Edit

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

Edit

SpeakersModule

An object with the following properties:
Speakers
A list of Speaker objects.
StatusEnabled
A list of WebcastStatus objects. The SpeakersModule and all the data it contains is only available in the WebcastStatus phases you explicitly define here.

Edit

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

Edit

TopicsModule

An object with the following properties:
Topics
A list of Topic objects.
StatusEnabled
A list of WebcastStatus objects. The TopicsModule and all the data it contains is only available in the WebcastStatus phases you explicitly define here.

Edit

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.

Edit

Webcast

An object with the following properties:
ActiveModules
A list of 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 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 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 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 object. Contains configuration information and meta data for slides.
SpeakersModule
A SpeakersModule object. Contains configuration information and meta data for speakers.
Status
A 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 object. Contains configuration information and meta data for topics.
Triggers
A list of 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.

Edit

WebcastSearchOrder

An enumeration. Can have one of the following values:
ClientAsc
ClientDesc
CreatedAsc
CreatedDesc
ModifyAsc
ModifyDesc
StartAsc
StartDesc
WebcastDefaultTitleAsc
WebcastDefaultTitleDesc

Edit

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.

Edit

WebcastSummary

An object with the following properties:
Customer
A 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 object. Indicates the current WebcastStatus of this Webcast.
Title
A string. The title of this Webcast.
WebcastCode
A string. Uniquely identifies this Webcast.