Chapter 3 DynaScript Predefined Objects

site object

Object

Describes a Web site. Using the site object, you can manage documents and database connections in your site, and customize the management interface to suit your needs.

Syntax

To use a site property:

site.propertyName

To use a site method:

site.MethodName( parameter )

Description

Only one site object allowed
You cannot create additional site objects in your scripts.

Script-based management

Management of Dynamo Web sites is driven by scripts. The site object provides methods that allow you to perform common management tasks:

Creation and management of templates and scripts in your Web site.
Creation and management of the connections to the databases providing the live content for your Web site.
Creation and modification of wizards and property sheets to suit your work style and content needs.
Addition of menu items and icons to the Sybase Central interface, to use the wizards that you create.

Managing documents and connections

In a Dynamo Web site, you can manage documents and database connections either by using Sybase Central or by writing your own scripts. In either case, the site object is responsible for the basic management tasks:

Documents are manipulated using CreateDocument , DeleteDocument , and GetDocument .
Database connections are manipulated using CreateConnection , DeleteConnection , and several GetConnection variants.

Customizing the management interface

Because the Dynamo management tools are script-based, you can alter these scripts or create new ones to tailor the interface to your needs:

You can create your own wizard dialogs using CreateWizard .
You can examine how Dynamo constructs its own wizards by inspecting the NewTempl.ssc, NewConn.ssc, and NewFold.ssc scripts in the Site/system folder.
You can create your own controls (icons, menu items, and so on) by using the OnEvent method.
You can examine how Dynamo adds its own controls at startup by inspecting the Autoexec.ssc script in the Site/system folder.

Example

This example creates a new connection called myConnection , and then creates a new document in the Web site to use the new connection. The contents of the new document is the word "hello":

<!--SCRIPT
  newConn = site.CreateConnection ( "MyConnection", "my new connection", "PowerDynamo Demo" );
  newDoc = site.CreateDocument ( "/Site/myDoc.stm", "text", "my new document", "hello", "MyConnection" );
-->