XML Interface Properties Overview

Selecting Other allows you to create an XML Interface to communicate with other systems through XML. This option opens the XML Interface Properties dialog box.

Each of the objects on this dialog box is described below.

Interface

Use the Interface field to provide a name. This name will be shown on the Genesys Agent Scripting button associated with this XML interface.

Send and Receive Tabs

The Send and Receive tabs are used to display the XML tags that are defined for the post of the XML interface data.

Add

Use the Add button to add a new tag. The new tag will be added as a child to the tag currently selected.

Clicking the Add button opens the XML Tag dialog box. This dialog box has four tabs:

Edit

Use the Edit button to modify existing XML tags. In order to edit an XML tag, you must select a tag in the Send or Receive tabs and click Edit. Selecting this option opens the XML Tag dialog box. You can then edit any item on this dialog box.

Delete

Use the Delete button to delete an XML tag from the list. Use caution when using the Delete button. When you delete a tag, all of its child tags are also deleted.

In order to delete an XML interface, you must select an XML tag and click Delete. A confirmation message will appear:

WSDL

Click to trigger the XML Import Wizard for WSDL. This button is present only if the interface you are editing is of the type WSDL.

Import

Use the Import button to import a DTD or XSD (XML Schema) file. This function allows you to save a tremendous amount of time in defining an XML interface, and also helps prevent errors.

A DTD file is a file that defines the XML tags for the interface. An XSD file specifies how to formally describe the elements in an XML document. This description can be used to verify that each item of content in a document adheres to the description of the element in which the content is to be placed.

When you click on import a Windows Open File dialog box appears. Navigate to the DTD or XSD file for this XML interface and open it. The tags and many of their options that are defined in the DTD or XSD file will automatically be set up in Genesys Agent Scripting.

Look in

This drop-down list provides the user with the directory path in which the DTD or XSD to be imported into Genesys Agent Scripting exists.

File Name

This is the name of the DTD to be imported into Genesys Agent Scripting.

Files of Type

Select either DTD or XSD from the drop down list.

Cancel

Cancel closes the Import dialog box without importing the selected DTD or XSD.

Open

Swap Send <-->Receive

Clicking this button will cause the contents of the Send tab to switch places with the contents of the Receive tab.

Settings

Click Settings to open the XML Settings dialog box.

Server URL

The Server URL is the address of the XML server that will handle this XML post. It is the beginning part of the URL.

Note: This is the design-time URL; it can be different from the run-time URL.

The drop-down list is populated with Genesys Agent Scripting configuration file fields. Select the field that contains the Server URL. It is not mandatory, but if left blank, the Server Name must contain the fully qualified URL for the XML Server.

Server Name

The Server Name is the name of the XML Server that will handle this XML post. It should be either the file name of the server or the fully qualified URL. This field is mandatory.

http://localhost/website/WWGEMail.asp is an example of a fully qualified URL.

DTD URL

The DTD URL is the location of the definition filed to be used for the XML post if one is required.

The drop-down list is populated with Genesys Agent Scripting configuration file fields. Select the field that contains the DTD URL. It is not mandatory, but if left blank, the DTD Name must contain the fully qualified URL for the DTD.

DTD Name

The DTD Name is the name of the definition file to be used for the XML post if a DTD is required.

XML Prefix

This is the XML declaration that appears at the top of an XML file. If the file has a prefix, it must contain ?xml, the XML version, the type of encoding, and whether or not the document needs an outside DTD.

Do Not Perform Any XML Preprocessing

If this box is selected, Genesys Agent Scripting will not perform any XML Preprocessing for this interface. This refers to the global preprocessing that occurs from the file WWGXMLPost.inc.

Enclose All Tag Values with CDATA Indicators

If this option is selected, all tag values will be enclosed with CDATA Indicators. This means that everything between the CDATA indicators is treated as raw data rather than XML (for example, < do not start tags).

Cross Reference

The Cross Reference button allows the user to see where an XML Interface is being used. Clicking the Cross Reference button opens the Object Cross Reference dialog box.