Viz Multichannel

Version 4.0 | Published January 23, 2019 ©

Hosted Page Editor via ActiveX

Included with the Viz Multichannel package is the Hosted Page Editor, delivered as an ActiveX component. This component can be hosted in a custom web-page or 3rd party application.

Caution: As of v4.0 the Hosted Page Editor via ActiveX is DEPRECATED. This means no more features will be added to it and it may be removed from future releases.

See Also

Register the ActiveX

In the Viz Multichannel installation folder you will find a folder named AX containing the actual ActiveX component, its settings file and an HTML page for testing.

As the ActiveX component is not installed and registered during regular installation you need to register and configure it manually in order to create and test your own Page Editor.

To Register the ActiveX Component

images/download/attachments/30917896/appendix_regsvr32-activex.png

  1. Run Command

  2. Change directory to Viz Multichannel’s AX folder (e.g. C:\Program Files (x86)\vizrt\Viz Multichannel\AX)

  3. Enter regsvr32 VCPAxFiller.ocx and press Enter

  • This will register the ActiveX component.

To Register ActiveX Component Settings

  1. Open the AX folder in the Viz Multichannel installation directory.

    • If Viz Engine and Media Sequencer are not running on your local host you must edit the registry file and set the correct host names.

  2. Double-click the AX-HKEY_LOCAL_MACHINE.reg file.

    • This will set PreviewPort to 50008, PreviewHost to localhost, and MseHost to localhost, and in registry.

Open the ActiveX

Before you can open the ActiveX component and its features you need To Register the ActiveX Component. Once that is done you can continue testing the ActiveX.

Note: The ActiveX component must run in browser mode: Internet Explorer 9.

To open the ActiveX component

images/download/attachments/30917896/appendix_activex.png

  1. Open the AX folder in the Viz Multichannel installation directory.

  2. Open the VizrtActiveXTestPage.html file in Internet Explorer.

    images/download/attachments/30917896/appendix_browser-mode-ie9.png
  3. If Internet Explorer 10 is used, press F12 and set browser mode to Internet Explorer 9.

  4. Allow Internet Explorer to run blocked content (i.e. ActiveX).

Product and Channel Settings

Before you can use the ActiveX to create, edit and delete pages based on already available templates and pages you need to define the product and channel the you will work with.

To Set the Product

  • Click the Get Product button.

  • This will display the configured product in the Result area (at the bottom of the page).

  • If trio is shown, enter multichannel in the Product Name field and click the Set Product button.

To Set a Channel

  1. Click the Get Folder button, and the Result area will show the channel name currently in use.

  2. If nothing is shown in the Result area then press the List Folders button, and the Result area will show a list of channel names stored on the Media Sequencer.

  3. Enter the channel name in the Folder Name field and click the Set Folder button.

    Note: Channel name is case sensitive.

  4. Click the Get Folder button again.

Templates and Pages

To List Templates and Template Fields

  1. Click the List Templates button, and the Result area will show templates currently available.

    <result>
    <item>0400</item>
    <item>0030</item>
    <item>0200</item>
    ...
    </result>
  2. Enter the item value (e.g. 0400) in the Template ID field and click the List Template Fields button, and the Result area will show the templates’ exposed fields.

    <result>
    <item name="001" description="text" type="richtext">Arial-Regular</item>
    </result>

To List Available Pages and Page Fields

  1. Click the List Pages button, and the Result area will show pages currently available.

    <result>
    <item>0011</item>
    <item>0012</item>
    ...
    </result>
  2. Enter the item value (e.g. 0011) in the Page ID field and click the List Page Fields button, and the Result area will show the pages’ filled content.

    <result>
    <item name="001" description="text" type="richtext">Mr. Black</item>
    </result>

The Page Editor

To Create a Page

images/download/attachments/30917896/appendix_edit-page.png

  1. Enter a new item *(e.g. 0010) in the *Page Id field (see how To List Available Pages and Page Fields).

    Note: Alternatively, enter a new Page Id when saving the new page.

  2. Enter an existing item value in the Template Id field (see how To List Templates and Template Fields).

    Note: Alternatively, select the Template Id from the Page Editor’s template list.

  3. Click the Create Page button.

  4. Edit the page and click the embedded page editor’s Save button (see Page Editor).
    Similar to creating a page you may also edit or delete a page by providing an existing Page Id, and then click the corresponding Open Page or Delete Page button.

    images/download/attachments/30917896/appendix_page-name.png

If you do not enter a new Page Id before creating a new page you may enter it before you save the page.

images/download/attachments/30917896/appendix_template-list.png
If you do not enter a Template Id before creating a new page the Page Editor will list all available templates. This also requires that no Page Id has been set before clicking the Create Page button.

To Edit a Single Page Field Without a Page Editor

  1. Enter an existing item *(e.g. 0010) in the *Page Id field (see how To list available pages and page fields).

  2. Click the List Page Fields button, and the Result area will show the pages’ existing content.

  3. Enter the item name in the Field Name field.

  4. Enter the new* item value* in the Field Value field.

  5. Click the Set Page Field button.

  6. Click the List Page Fields button, and the Result area will show the pages’ new content.

To Edit Multiple Page Fields Without a Page Editor

  1. Enter XML to the Fields area in the following format:

    <fields>
    <item name="[field name]">[new value]</item>
    <item name="[field name]">[new value]</item>
    <item name="[field name]">[new value]</item>
    ...
    </fields>
  2. Click the Set Page Fields button.

ActiveX API Error Messages

  • In case of errors in the ActiveX (AX) API, the following list shows the possible messages and error codes that a client can receive:

0: OK
1: No Change Has Occurred During The function Call
2: Unknown Product
3: Unknown Folder
4: Page Id Not Supplied
5: Template Id Not Supplied
6: Page Id Does Not Exists
7: Page Id Already Exists
8: Template Id Does Not Exists
9: Error Opening Page, Ex Info: No templates found for page pagename
9: Error Opening Page, Ex Info: Read canceled because scene does not exist: scenename
9: Error Opening Page, Ex Info: Page 222 refers to /VizRundown/channels/1/sceneinfos/02_GFX\VizMultiChannel\MOVIE\06fullframe which was not found.
10: Error Opening Template, Ex Info: No templates found for page pagename
10: Error Opening Template, Ex Info: Page 06fullframe refers to /VizRundown/channels/1/sceneinfos/02_GFX\VizMultiChannel\MOVIE\06fullframe which was not found.
11: Error Saving Page, Ex Info: A page id cannot contain the character '\q.
12: Invalid Fields XML, Ex Info: invalid fields XML
12: Invalid Fields XML, Ex Info: Invalid at the top level of the document.
13: Field Does Not Exists, Ex Info: field 'fieldname' does not exists
14: List Templates Error
15: List Folders Error
16: Context not Fully Set. Check Folder
17: List Pages Error
900: Last API Call Was Not Completed
1000: Media Sequencer Engine Is Disconnected
1100: Not Connected to Viz Engine
Page already exists, can't overwrite
Unable to save. please enter a page id
Unable to open page
  • Following error messages are present but not displayed in client:

11: Error Saving Page
Unable to save. Page not set
Error Opening Page, Ex Info: can't open a template for editing
Error Opening Template, Ex Info: can't open a template for editing