ViewletBuilder is a Viewlet authoring program used to create dynamic Flash content used for training and demonstration purposes.

Please visit the ViewletBuilder8 products page or contact sales@qarbon.com for current information.

Please visit ViewletBuilder8's product page and click on the Tech Specs link. Or, contact support@qarbon.com for current information.

Please visit ViewletBuilder8's product page and click on the Tech Specs link. Or, contact support@qarbon.com for current information.

Go to the Qarbon home page and click the Download link. Instructions for downloading will display on the next few pages. Or, email support@qarbon.com for instructions.

Once the installer (exe) file is downloaded, double click it and follow the onscreen prompts to install ViewletBuilder8.

Please contact sales@qarbon.com for details on using the trial versus the registered version of ViewletBuilder8.

You can purchase it directly from Qarbon, just look for a purchasing link on our home page! Or, if you prefer, contact sales@qarbon.com for more information.

The Start Page is the center section of the opening interface panel that displays when ViewletBuilder8 is launched. This section is dynamic and customizable. For more information, email support@qarbon.com.

The menu bar is located at the top of the interface window and contains text menu options for such operations as File, Edit, View, etc. When selected, further options are displayed in a drop-down list menu.

Button toolbars are normally located below the menu bar and contain button icons that, with a single click, provide quick access to tools within ViewletBuilder8.

Tabbed views are tabs that display to the side or below the slide editing area. These views are tabs that allow access to additional functions such as Browsing (file management), Thumbnails (small visuals of slides), Timeline and more. For more information, contact support@qarbon.com.

Yes, ViewletBuilder8 offers enhanced options such as tabbed views and other features that allow you to customize your workspace for optimal productivity.

Select Edit > Preferences from the menu. In the General tab, there are options for setting a default language.

The Transformer feature determines if objects are automatically or manually proportionally resized. This default is found in the Edit > Preferences > General tab.

Yes. Select Edit > Preferences from the menu. Then, select the Spelling tab to set default spelling options.

It's a server that acts as a intermediary between a user's workstation and the Internet, mainly for security reasons. Set up proxy defaults by selecting Edit > Preferences from the menu bar. Then, select the Proxy tab.

The Output window is a tabbed view that displays codes while working in ViewletBuilder. In this tab, coding can be reviewed (by the Qarbon developers) to determine what might be causing any issues that might arise while using ViewletBuilder8.

Error logs are generated and displayed in the Output tab. For more information on reporting performance issues, email support@qarbon.com.

Email support@qarbon.com.

Yes.

ViewletBuilder8 allows you to create interactive, animated Flash demonstrations, as well as videos in the Flash Video (FLV) or MP4 format, accepted by many multimedia players as well as YouTube. The types of projects you can create are myriad, but mainly up to you as an author.

Each time you create a new project, there is a option to define a Slide Size. The slide size you choose for your project is the one that will be used for the entire project from that point on.

A screenshot project is a project made up of animations and/or static shots captured on your screen and are played back as a Flash movie.

Yes.

Automatic capture mode allows ViewletBuilder8 to capture onscreen actions at predefined intervals. So, while action is occurring on the screen, ViewletBuilder8 can be set up to automatically capture it.

Manual capture means that you will need to define a hotkey that is pressed to capture onscreen images one screenshot at a time.

A capture key is a key or keys that are pressed to capture what is viewed on the screen during a manual screen capture. Once you select Manual Capture Mode, click the Options button. In the Capture Options window, in the Hotkey tab, set up your hotkey defaults.

An image project is a project made up from a series of image files such as jpgs, pngs, tiffs, gifs, etc.

ViewletBuilder8 supports the most popular image file formats including jpgs, pngs, tiffs, gifs, etc. For more information, email support@qarbon.com.

In the New Project window, click the Blank Project option.

Yes.

ViewletBuilder8 source files are saved to the XML-based QVPX format. For more information, contact support@qarbon.com.

Select File > Save from the menu. Select a folder to save the project in and type in a name. The project is saved with a .qvp extension.

This will vary depending upon your publishing defaults. After you publish your file, check your project folder (or publishing location folder) to view all the files that make up your source and published projects. If you have any questions on this topic, contact support@qarbon.com.

Double click on the .qvpx or .qvp source file. Or, while ViewletBuilder is open, select File > Open from the menu.

Slide View is the main slide editing view and where you will spend most of your time while editing slide elements.

Thumbnail View is the expanded thumbnails view where all thumbnails within the project are displayed.

The Browser tab is a tabbed view the offers tools for managing your Viewlet files without leaving the ViewletBuilder8 interface.

The Timeline tab features the Timeline tool that can be used to perform project editing tasks similar to a standard Flash design environment.

For information on working with the Timeline, refer to the ViewletBuilder8 User Manual or email support@qarbon.com with specific questions.

The Stylesheet tab is a tabbed view that offers stylesheet options for your Viewlet project.

Stylesheets, new in ViewletBuilder8, offer features to standardize all or parts of your project. For more information, please refer to the ViewletBuilder8 User Manual or contact support@qarbon.com with any questions you might have.

Click on the message object to select it.

Double click on a message object to enter text edit mode.

Double click on a message object to enter text edit mode. The applicable context sensitive toolbar will display with all of the available text format options.

A balloon is a message style (also referred to as a call out) used to bring attention to a specific area of a slide.

Select Insert Balloon on the Objects toolbar. When the cursor changes to a cross hair shape, click on the slide to insert the balloon.

A note is a message object with a push pin in it used to provide additional information on a slide without calling attention to any specific area of the slide.

Click the Insert Note icon on the Objects toolbar.

A text box is used when you want to add text to a slide so that it blends seamlessly into the background.

Click the Insert Text Box icon on the Objects toolbar. When the cursor changes to a cross hair, drag it on the slide to draw a text box or click to insert it on the slide.

Yes. Right click on any message object and select the applicable Style option from the shortcut menu.

Right click on the message and select the applicable Style from the shortcut menu. In the window that displays, select and new message type.

Right click on the message and select the applicable Style option from the shortcut menu. Select a new style in the window that displays.

There is a bug in the current version of ViewletBuilder 5 which prevents a user from changing the background color of text boxes. The normal procedure, (right click, select Background color, then choose color, and hit apply, then OK) works for balloons and notes but not text boxes. Until this is resolved in a future version, you will need to add a colored rectangle behind the text box.

A cursor indicator is the green, blue or red circle surrounding a cursor.

The green circle indicates the location of the cursor on the current slide.

The red circle indicates the location of the cursor at the end of the cursor path on the next slide.

The blue circle indicates where the cursor will change its shape along the cursor path.

Cursors are captured during screenshot sessions. If your project needs a different cursor, add a screenshot with the cursor you need to your project. Then, right click on the cursor and select Cursor Style to add it to the library of cursors.

Right click on the cursor and select Cursor Style. In the Cursor Style window, select a cursor. Click OK to apply.

Click on the cursor and while holding down your left mouse button, drag it to its new location.

A cursor path is the dotted line between the green and red cursor indicators. This is the path the cursor travels as the project travels from one slide to the next.

There are several cursor path options available. You can select straight or curved paths. You can also add "points" along the path so the cursor changes direction as it travels along its path.

Stray cursor movement occurs when the cursor moves illogically when the Viewlet is played. For more information on this topic, please email support@qarbon.com.

There are various ways to fix stray cursor movement. Please contact support@qarbon.com for more information.

In ViewleBuilder6, the cursors are connected to each other from slide to slide (Green to Red, etc). We were asked how does one insert some Text/Intro slide in the middle of a tutorial and keep from having the extra cursor movement while it lines up for the next movement?

The answer is to go to the timeline and use the EYE to hide the slide element before the intro slides. What this will do is keep the path in place, but it will hide the movement. You can then insert some slides after this and introduce the next action...then when the next visible cursor slide is reached...the beginning point matches the end point of the one you hid...thus keeping the logic in place.

If you delete or move the cursor path on any slide, you affect the beginning or end points on other slides...its better to hide the movement than to delete a cursor unless you want that path point removed/skipped completely.

Something to note: When you hide the cursor path...its timing is still affecting the slide duration so when the viewlet reaches this slide...it will display for as long as the cursor and other elements equal. Since you planned to hide this cursor anyway, you can always decrease its time by grabbing the ends are shrinking the timing. This will leave the slide at the original timing...but now its adjustable to no shorter than the cursor element.

The Format Painter is a tool that allows you to copy text and certain shape formats from one object to another.

Select the text or shape you want to copy the formatting from and then click the Format Painter button on the toolbar. Click on the text or shape you want to apply the formatting to and it will be applied.

Click the Spelling Mistakes button enable the spell checker. If a typo is found by ViewletBuilder, the typo will be underlined in red. Right click on a typo and choose a spell check option from the shortcut menu.

Search and Replace is a tool that allows you to search through all text within a project for a specific instance of text and replace it. For more information on how to use this feature, refer to the ViewletBuilder8 User Manual or contact support@qarbon.com.

Here is the easiest way to use this feature.

1) Click on the object you want to appear "On Rollover"
2) Click on the Rollover icon from the top tool area (2nd row down). It looks like a gray box with an arrow in it.
3) Then draw the rollover area where you want it to activate

What will happen is the object you assigned to appears on rollover will now be hidden until you activate it by rolling over the new area.

Select Insert > Blank Slide from the menu bar.

Select Insert > Image Slides from the menu bar. In the window that displays, click the Add icon to search for and select images. Click OK to render the selected images as embedded background images on new slides.

Right click on a blank area of a slide and select Slide Properties from the shortcut menu.

Yes, right click on a blank area of a slide and select Background Color to open the color palette.

Right click on a blank area of a slide and select Background Image. Select a new image in the window that displays, choose a layout option as desired and click OK.

There are several ways to do this. While in thumbnail view, click on a slide and while holding down the left mouse button, drag it to its new location.

Select a slide and right click and select Delete. Or, press the Delete key to delete a selected slide.

Select a slide and click the Hide Slide (closed eye) icon on the toolbar.

Select the slide's thumbnail and click the Show Slide (open eye) icon on the toolbar.

Supported audio formats include .mp3, .aif, .au and .wav.

Select the object or slide and click the Attach Sound button on the context sensitive toolbar. Select an audio file or record one and click OK.

Yes.

Yes.

Yes, in the Project Properties window, in the Sound Quality section, select Strip All Sounds.

In the Project Properties window, in the Viewlet Options section, select a sound file in the Soundtrack area of the window.

The following objects can have an associated sound: Slide, Balloon, Note, Text Box or Shape. When a sound is associated with an object, the sound will start playing when the object is displayed. If two or more objects are displayed at the same time, sounds can overlap.

Additionally, a sound can be played via an event associated with an object. For example, an image object could have a sound played when it's clicked on. All of this means that there are a number of ways in which sounds can overlap.

If a slide has an attached sound, you will see a small speaker icon at the bottom of the slide in the thumbnail view. If it has an associated event, you will a lightning bolt.

If the "Attached Sound Icons" menu option is enabled in View menu, you will see a small speaker icon below any slide objects that have an attached sound.

If the "Event Icons" menu option is enabled in the View menu, you will see a lightning bolt next to any object with associated events.

To determine which object's sounds are overlapping, you will need to look at the Attached Sounds and Events associated with the slide and any elements on the slide.

To remove all sounds from a slide, perform the following actions.

Click on the slide

• Click the Attach Sound icon on the Context Toolbar
• Click the Red X on the Sound Dialog to remove the sound.
• Click on Events icon on the Context Toolbar
• Click each tab if there is a Play Sound action, click the Red X to remove it.

Repeat these steps for each object on the slide.

Click the Insert Image icon on the Objects toolbar. Browse for and select your image file. Click Open to insert it on the slide.

ViewletBuilder8 supports .jpeg, .jpg, .gif, .png, .tif, .tiff and .bmp formats.

Once an image is inserted on a slide, you may resize it and change its transparency. You may also move it on a slide and layer it with other objects on a slide. If you need to crop or do any other image enhancing tasks, you will need to do this in a program that supports these operations such as Photoshop, Fireworks, etc.

Yes.

Yes.

Start by referring to the ViewletBuilder8 User Manual. If, after reading this information and viewing additional tutorials on this topic, feel free to contact support@qarbon.com for more details.

Embedded movies, in most cases, inherit the Viewlet's frame rate. For example, an embedded SWF movie whose frame rate is 12 fps, when loaded into a Viewlet whose frame rate is 24 fps, will play back at 24 fps. This also means that an embedded movie will play back two times faster than normal. And vice versa, an embedded SWF movie file whose frame rate is 24 fps, when loaded into a Viewlet whose frame rate is 12 fps, will play back at 12 fps, or two times slower.

The only exception is if the embedded movie contains a sound on the timeline whose sync is set to "stream". Then the Viewlet will automatically run at the frame rate of the embedded movie to insure the correct playback of the sound. This is the case for ViewletCam Viewlets with sound.

An event is something that occurs during a specific interval of time. For example, a "slide loading" may be considered an event.

An action is something that is done (whether automatically or by user input) in relation to an event.

There are several ways to add events and actions to a slide. The steps to do this will vary depending upon the object, event or action to occur. Please refer to the ViewletBuilder8 User Manual for more information on this topic. Or, email support@qarbon.com with your questions.

Click the Insert Button icon on the Objects toolbar. Once the button is inserted on the slide, right click the button object for additional options.

When the cursor moves over an area of the slide designated as a "rollover area", a defined action occurs such as an image or menu popup. For more information, contact support@qarbon.com.

Click the Insert Movie icon on the Objects toolbar. In the Insert Movie window, select Embed Movie File. Browse to find and select the movie file. Click OK to embed it on the slide.

Currently the SWF movie format is supported, with the following restrictions:

• Movie must be in version 7 or less. Version 8 is only partially supported.
• ActionScript version 3 isn't currently supported.
• Recommended frame rate is 18 frames per second. Viewlets play at 18 fps and will play any embedded movies at this rate. So if your embedded movie has a higher frame rate, it will appear to be playing slow and vice versa.

A hyperlink allows a user, with a single click, perform an action such as jumping to another web page, open an email window, load an object, etc.

A click zone is a clickable area of a slide (transparent in the published file) that a user must click in order to correctly respond.

Select the Insert ClickZone icon on the Objects toolbar. For more information on working with click zones, please refer to the ViewletBuilder8 User Manual or contact support@qarbon.com.

Please refer to the ViewletBuilder8 User Manual or contact support@qarbon.com for details.

A text zone is a field that the user must input data into in order to respond correctly.

Select the Insert TextZone icon on the Objects toolbar. For more information on working with text zones, please refer to the ViewletBuilder8 User Manual or contact support@qarbon.com.

Please refer to the ViewletBuilder8 User Manual or contact support@qarbon.com for details.

A keystroke zone contains a defined key or keys that the user must press in order to respond correctly.

Select the Insert Keystroke Zone icon on the Objects toolbar.

ViewletBuilder 6.1 introduces the concept of safe and unsafe keys, to better support international keyboard:

• safe keys: keys which have the same keycodes on all keyboards
• unsafe keys: keys that could have different keycodes on other keyboards

An example of an unsafe key is the PLUS Sign (+):

• On English keyboards the PLUS Sign is entered by the combination of the “SHIFT” and “EQUAL” keys.
• On Norwegian keyboards the “PLUS” sign is a single key.

There are many other possible conflicts across keyboards. If you expect your Viewlet might be viewed by clients whose native language is different from yours, you should stick with the safe key list.

Safe list

• keys A-Z
• numbers 0-9
• numpad keys
• keys F1-F12, except the F10
• backspace, caps lock, delete, end, enter, escape, home, insert, num lock, page up/down, pause/break, print screen, scroll lock, space bar, tab
• arrow keys

All other keys are on the unsafe list.

You can use Shift, Ctrl and Alt key combinations with any key with some restrictions:

For example, browsers such as Internet Explorer will trap the Ctrl+F6, Ctrl+D, so these key combinations won’t be passed to the Viewlet.

When the Viewlet is compiled as an executable Alt key combinations do not work.

Please refer to the ViewletBuilder8 User Manual or contact support@qarbon.com for details.

A pause zone allows a Viewlet to pause on a specified slide.

Select the Insert PauseZone icon from the Objects toolbar. A red triangle will display on the slide, but will be transparent in the published project.

Select the Insert Question icon on the Objects toolbar.

Right click on the message object and select Message Type from the shortcut menu. In the Message Type window, make your selections and click OK.

Right click on the button and select Button Style. In the window that displays, select a new button and click OK.

Right click on the zone and select the applicable Properties option from the shortcut menu. In the window that displays, make your selections and click OK.

Page Layout allows you to set default when printing your slides. To set these defaults, select File > Page Layout from the menu bar and in the Page Layout window, set up your printing defaults.

There are several ways to print slides. The easiest is to select File > Print from the menu options. Select and printer in the Print window and click Print. For additional print options, refer to the ViewletBuilder8 User Manual or contact support@qarbon.com.

Select File > Export > Text for Translation from the menu. If prompted, save the file. In the Export Text window, select a save location and type in a file name. Click Save and the text is exported and saved to an XML file.

Select File > Export > Sounds from the menu. In the Export Sounds window, select your options and click Export. In the Save File In window, select a folder to save the exported sounds in. Click Save and the exported sound files will be saved in the WAV format.

Select Project > Publish Viewlet > PDF from the menu. Select destination and click Publish.

Yes. Select Project > Publish Viewlet > Image Set. In the Image Set window, make your selections including the Destination to save the images in and click Publish. If you have any questions, contact support@qarbon.com.

Yes. While viewing thumbnails, select a slide. All imported slides will be inserted AFTER this selection. Then, select File > Import > Import Slides from the menu. Browse to find and select your project. Select the slides to import and click OK. If you have any questions on importing slides from one project into another, contact support@qarbon.com.

If you previously exported text for translation, you can use the XML file associated with the Viewlet to import edited text back into the same project. Select File > Import > Text for Translation from the menu. Locate and select the XML file and click Open to import the text.

Project Properties are defaults you set up for your Viewlet project such as Viewlet Profile information, image and sound quality, Flash settings and more.

Select Project > Project Properties from the menu. In the Viewlet Profile section, enter all of the Viewlet authoring and company information as needed.

Viewlets may be published using CD, high or standard quality. Or, you can choose to strip all sound when publishing a project without affecting audio in the source file.

Yes, this is set up in the Project Properties window in the Image Quality section.

Global timing options are available for cursor and reading speed in the Timing section of the Project Properties window.

Packaging options include creating a stand alone player and a zip file. These options are found in the Project Properties window in the Packaging section.

Yes, this can be set in the Language section of the Project Properties window.

Yes, these can be edited in the Language section of the Project Properties widow.

Flash publishing defaults may be viewed and selected in the Flash section of the Project Properties window.

You specify the Animated Extras in Project Properties / Flash / Animated Extras panel. Animated Extras are Flash (SWF) movies that are attached to the beginning and/or to the end of the viewlet. This allows you to add a custom introduction or conclusion to your Viewlet.

Currently only the Flash (SWF) movie file format is supported, with additional restictions:

• Movie must be in version 7 or less. Version 8 is only partially supported.
• ActionScript version 3 isn't currently supported.
• SWF movie cannot have embedded video.
• SWF cannot have any exported symbols (symbols that are used via the attachMovie function).
• SWF dimensions must be the same or smaller than the Viewlet.
• SWF should be a simple frame to frame animation, rather than a complex SWF controlled via AcitonScript
• Recommended frame rate is 18 frames per second. Viewlets play at 18 fps and will play animated extras at this rate. So if your animated extra has a higher frame rate, it will appear to be playing slow and vice versa.
• The duration of the animated extras are calculated by multiplying its frame count by 18 fps. It will be displayed for this calculated duration time.
• The begining movie cannot have stop() function call on the timeline.

A ViewletSkin is the wrapper around the Viewlet. To view skinning options, select ViewletSkin in the Project Properties window.

Yes. Contact sales@qarbon.com for more information.

Contact sales@qarbon.com for more information.

This is the frame that the Viewlet plays in on a web page. Refer to the ViewletBuilder8 User Manual for more information or contact support@qarbon.com.

You can edit HTML Frame defaults in the HTML Frame section of the Project Properties window.

Click the Preview button from the toolbar and select an preview option from the drop-down list.

Yes.

Click the Publish button on the toolbar and in the window that displays, select the local folder and click Next. Follow the rest of the screen prompts to publish to a local folder.

Click the Publish button on the toolbar and in the window that displays, select the FTP server and click Next. Follow the rest of the screen prompts to publish to your ftp server.

Click the Publish button on the toolbar and in the window that displays, select the Qarbon ViewletCentral and click Next. Follow the rest of the screen prompts to publish your project to ViewletCentral.

Note: ViewletBuilder8 has replaced the JavaScriptFlashGateway with a new approach that uses the ExternalInterface class in the Flash core.

To call methods in the Viewlet, you first need to create a flashObject variable, as follows ("viewletName" is the ID of your viewlet):

	var flashObject = window.document.viewletName; 

The variable should be created in the html file that includes the FlashTag.js file and also contains your Viewlet. You can then call methods in the Viewlet as follows:

	<a href="javascript:flashObject.viewletPause()">Pause Viewlet</a>

	<a href="javascript:flashObject.viewletUnpause()">Play Viewlet</a>

You can also access runtime variables in the Viewlet by calling the viewletGetVariable method on the flashObject, for example:

	alert(flashObject.viewletGetVariable("SLIDE_COUNT"));

Tip: Each time you recompile the viewlet, the HTML will get regenerated and you will loose your updates. The solution is to update your HTML Frame in Project Properties, rather than editing the HTML after the Viewlet has been compiled. You can do this in a generic way so that you can use this HTML Frame in any project, by using ViewletBuilder $VARS$.

To create the flashObject variable in an HTML frame you would use the following code.

	var flashObject = window.document.$VIEWLET_NAME$;

$VIEWLET_NAME$ will automatically get replaced with the current Viewlet name.

Here is an example Viewlet that calls methods on the flashObject

Methods
This table shows the methods that are available in Viewlets compiled with VB6/VQuiz3.

Method	Description
viewletReset()	Restart the Viewlet.
viewletGotoSlide(slideNum)	Goto the the specified slide number.
viewletJumpToNextSlide()	Move to the next slide.
viewletJumpToLastSlide()	Move the the previous slide.
viewletPause()	Pause the Viewlet.
viewletUnpause()	Run the Viewlet again.
viewletGetVariable(varname)	Get the variable value from the viewlet. The list of viewlet variables is bellow.

Variables:
This table lists properties available in Viewlets compiled with VB4/VACE/VB5/VB6/VQuiz2/VQuiz3.

Variable	Description
isplaying	True when the Viewlet is playing, false when the Viewlet is paused/stopped. [Boolean]
viewletwidth	Represents the width of the Viewlet, including the size of the Table of Contents. [Number]
viewletheight	Represents the height of the Viewlet. [Number]
vbversion	Contains the version number in format #.#.#. [String]
viewletName	The name of the Viewlet. [String]
quizTime	The timelimit of the quiz in milliseconds. [Number]
passingScore	Score that must be reached to pass the quiz. [Number]
totalScore	The maximum score that can be reached. [Number]
slidecount	The number of slides. [Number]
totalframecount	The total number of frames. [Number]
currentframe	The number of the frame in which the playhead is located. [Number]
currentslide	The number of the slide which is currently displayed. [Number]

Variables:
This table lists properties available in Viewlets compiled with VB5/VB6//VQuiz2/VQuiz3.

Variable	Description
SLIDE_COUNT	The number of slides. [Number]
MAXIMUM_SCORE	The maximum score that can be reached. [Number]
PASSING_SCORE	Score that must be reached to pass the quiz. [Number]
PASSING_GRADE	Percentage that must be reached to pass the quiz. [Number]
VIEWLET_WIDTH	The width of the Viewlet, including the size of the Table of Contents. [Number]
VIEWLET_HEIGHT	The height of the Viewlet including the title and player bars. [Number]
SLIDE_WIDTH	The width of the slide. This is the width of the Viewlet Project. [Number]
SLIDE_HEIGHT	The height of the slide. This is the height of the Viewlet Project. [Number]
VIEWLET_NAME	The name of the Viewlet. [String]
VIEWLET_TITLE	The title of the Viewlet. [String]
VIEWLET_DESCRIPTION	The description of the Viewlet. [String]
AUTHOR_NAME	The name of the Viewlet author. [String]
AUTHOR_EMAIL	The email address of the Viewlet author. [String]
AUTHOR_COMMENTS	The author's comment. [String]
COMPANY_NAME	The name of the company. [String]
COMPANY_DEPARTMENT	The department of the company. [String]
COMPANY_WEBSITE	The URL of the company website. [String]
VIEWLET_LOCALE	The locale code of the Viewlet. [String]
VIEWLET_LANGUAGE	The language of the Viewlet. [String]
TIME_LIMIT	The timelimit of the quiz in milliseconds. [Number]
APPLICATION_NAME	The name of the application that was used to create the Viewlet. [String]
QUESTION_COUNT	The number of question/zone slides. [Number]
CURRENT_SLIDE_NUMBER	The number of the currently displayed slide. [Number]
CURRENT_SLIDE_NAME	The name of the currently displayed slide. [String]
CURRENT_SLIDE_NOTES	The slide notes of the currently displayed slide. [String]
CURRENT_SCORE	The users current question score. [Number]
USERNAME	The username the user entered into the login panel. [String]
TIME_ELAPSED	The current time elapsed in milliseconds.[Number]
IS_PLAYING	True when the Viewlet is playing, false when the Viewlet is paused/stopped. [Boolean]
IS_PAUSED	True when the Viewlet is paused, false when the Viewlet is playing. [Boolean]
QUESTION_CORRECT_TOTAL	The number of questions answered correctly so far. [Number]
QUESTION_INCORRECT_TOTAL	The number of questions answered incorrectly so far. [Number]
QUESTION_INCOMPLETE_TOTAL	The number of questions not completed so far. [Number]
CURRENT_QUESTION_NUMBER	The number of the current question. [Number]
CURRENT_QUESTION_ID	The id of the current question. [Number]
CURRENT_QUESTION_NAME	The name of the current question. [String]
CURRENT_QUESTION_TEXT	The text of the current question. [String]
CURRENT_QUESTION_TYPE	The type of the current question. Possible values are: none, shortAnswer, multipleChoice, likert, clickZone, keystrokeZone, textZone, pauseZone. [String]
CURRENT_QUESTION_POINTS	The points assigned to the current question. [Number]
CURRENT_QUESTION_ATTEMPTS	The number of attempts allowed for the current question. [Number]
CURRENT_QUESTION_IS_SURVEY	True if the current question is a survey. [Boolean]
CURRENT_QUESTION_TIME_LIMIT	The amount of time specified for the current question in milliseconds. [Number]
CURRENT_QUESTION_CORRECT_VALUE	The correct answer for the current question. This is updated on every prepare method call. [String]
CURRENT_RESPONSE_VALUE	The user's response for the current question. The value is updated after each user attempt. [String]
CURRENT_RESPONSE_TIME	The amount of time it took the user to respond to this question in milliseconds. [Number]
CURRENT_RESPONSE_IS_CORRECT	True if the current question was answered correctly. [Boolean]
CURRENT_RESPONSE_POINTS	The total points awarded to the user for answering the question correctly. [Number]
CURRENT_RESPONSE_ATTEMPTS	The number of attempts it took the user to answer the question. [Number]

Upon successful activation you may see a message such as:

Type: 1 User License
Status: 2 Activations Used "Over Allowed Limit"


The over allowed limit message means that you have activated the product on more machines than your license allows.. We allow some extra "grace" activations, however if this is activated on more machines than you intend, you should go to the other machine and deactivate.

You can deactivate by using the "Deactivate" command from the "Help" menu.

If you exceed the number of allowed activations and grace activations you will see a message that says "The license code you entered has exceeded its total number of activations".

Your Viewlet may display the following error message "Due to the security settings of your Flash Player plugin, some advanced features of this Viewlet are disabled."

This is displayed because the Flash 8 security model has restrictions against accessing the local machine. This only applies if the Viewlet is run from the local machine. For example if the HTML and SWF file are in a folder on your machine and you run by opening the main html page in your browser. If the Viewlet will be run from a webserver, this error message won't be displayed.

This error message will happen if you have actions in your viewelt that call Javascript in the HTML, such as the "Display URL" action or "Javascript" action, and its run from a non trusted folder. The way to resolve this issue is to notify Flash that the folder the Viewlet is running from is "trusted".

There are several ways to mark a folder as trusted.

1. Any "Local or Network Folders" that are added to the Publishing Wizard in ViewletBuilder are automatically trusted. VielwetBuilder will automatically setup this folder as trusted. This is why Viewlets run from "My Viewlets" won't display the error message.

2. Open the Adobe Global Security Settings Panel in your browser and click on "Edit Locations..." and add the folder your Viewlet is in on the local machine to the list of trusted folders.

3. Add a text file to the following directory (where <username> is the currently logged in user) that lists the names of the trusted directories, one per line:

C:\Documents and Settings\<username>\Application Data\Macromedia\Flash Player\#Security\FlashPlayerTrust

You can take a look at the file ViewletBuilder sets up in this folder named QarbonTrustLocations.txt for an example.

If you are setting up Computer Based Training where a users installs Viewlets from a CD. You will need to modify your installation script to add an a trust entry for the location where the Viewlets were installed.

For more details Adobe's website that explains Flash Trust in detail.

ViewletCentral offers three types of accounts, Discovery, Unlicensed, and Licensed.

The Discovery account is free. It allows up to two Viewlets in the account at any one time. Discovery accounts will accept Viewlets created with both the Licensed and Unlicensed versions of ViewletBuilder or ViewletQuiz. Unlicensed Viewlets published to a Discovery account will be displayed without watermarks that are normally found in Unlicensed Viewlets.

Licensed and Unlicensed ViewletCentral accounts are fee-based accounts. Please review our fee structure.

Licensed ViewletCentral accounts only accept Viewlets created with a Licensed copy of ViewletBuilder or ViewletQuiz

Unlicensed ViewletCentral accounts will accept Viewlets created with either Licensed or Unlicensed copies of ViewletBuilder or ViewletQuiz.

With an unlicensed version of ViewletBuilder you can create as many projects as you want, on the same machine, without activating. Once you activate the watermark will be removed from the projets when they are recompiled.

However you can only open those projects created on that machine. You can not open projects created by an unlicensed version of ViewletBuilder8 on another machine. In other words projects created by an unlicensed version of ViewletBuilder8 are tied to that machine.

These restrictions only apply to projects created with unlicensed versions of ViewletBuilder8. Projects created with licensed versions can be opened by any other licensed version of ViewletBuilder8.

The reason Qarbon enforces this rule is because in the past some customers have purcahsed one version of ViewletBuilder for an entire department. The licensed version was used to compile and publish Viewlets, while all of the authors used free versions to create projects. We feel that it wasn't fair use and didn't comply with the terms of our license.

With ViewletBuilder4 we prevented this by adding a 30 day limit to Viewlets created with the a trial version, but this caused many problems with our customers who couldn't open projects created after the 30 day limit expired. ViewletBuilder8 avoids this restriction by embeddding a unique machine id into the project.

If you get this error message it means that you are attempting to open a project created on another machine with an unlicensed version of ViewletBuilder8. To resolve this issue, the project must be opened on the machine it was created on. If ViewletBuilder8 on that machine is activated and then, the the unlicensed project opened and recompiled, then all restrictions will be removed.

Unlicensed versions of ViewletBuilder8 can only open projects created with an unlicensed version of ViewletBuilder8. This allows our customers to try ViewletBuilder8 and determine if meets thier needs.

The unlicensed version of ViewletBuilder8 is feature complete the only restriction is that published Viewlets will have a watermark. Viewlets previewed using Project > Preview in Browser will not have a watermark.