Courier Editor

Overview

This page describes how to use CourierEditor.
CourierEditor is an editor for creating data binding sources. A data binding source can have multiple data binding items. The created data binding source is saved as an .xcdl file. Additionally, Scene Composer allows you to bind arbitrary properties and data binding items.

Please refer to data binding basics here.
Please refer to data binding with Scene Composer here.
For more information about data binding items that you configure within a data binding source, see the Xml Courier Definition Language (XCDL) schema documentation.

---

Starting Courier Editor

Courier Editorion can be started following process.

1. Opne "Select specification file and search path" dialog via menu "File" > "Define applecation specification".
2. Select the "Open CourierEditor...".

Courier Editor main window

---

CourierEditor user interface

Menu bar

Please see the table below for details on CourierEditor menu bar.

Menu name
Description File
New Create a new data binding source. Open Open an existing data binding source. Close Closes the currently open data binding source. Save

Overwrites the currently open data binding source.

Save As

Save the currently open data binding source as.

Edit
Undo Undo the previous operation. Redo Redo the previous operation. Validate Validate the currently open data binding source. Add Include Add another data binding source to "include". Add Message Add a message item to "messages". Add Message Group Add a group item to "messages". Add Compound Add the compound item to "types". Add Binding Source Add a bindingSource item to "bindingSources". Help View Schema Help Open an "Xml Courier Definition Language (XCDL) schema documentation".

UI item

Details of the UI items on CourierEditor main window. The numbers in the diagram match the numbers in the explanations for each item below.

UI item
Description 1. Data binding source path information
Include Path Set the save destination of the referenced Data binding source. Definition path Set the save destination of the Data binding source. Definition name Set the Data binding source file name. 2. Data binding item editing area

The top row of tabs is for selecting the data binding source. (When setting Include path)

Raw XML tab

Information on all items included in the Data binding source is displayed.
You can add/edit/delete items.

Types tab Only items included in "types" in Raw XML are displayed in list format.
You can add/edit/delete items.
Binding Sources tab Only items included in "bindingSources" in Raw XML are displayed in list format.
You can add/edit/delete items.
3. Verification result view
ー The data binding source validation results are displayed.

---

Create new definition

ACreate newa definitionData filebinding cansource befrom created[ viaFile > New ] on the CourierEditor menu "File"bar.

> "New".

1. In Definethe include path
   • „;“ seperatedInclude path listdialog, set Include path. If you do not need to set Include path, select [ OK ] and skip this operation. For more information about Include path, please refer to Setting the Include Path. 
   
   

Set the save destination for the newly created Data binding source.

Set Select definition folder

Definethe name of the definitionnewly created Data binding source. Set the file extension to ".xcdl".

A

Bynew shortcutData UIbinding (presssource „...“-Buttonswill tobe activatecreated specific editors)

 Define include path
• „;“ seperated path list
Select definition folder Define name ofin the definitionsave Createdestination set in step 2.

In addition to the steps above, you can also create a new Data binding source from the CourierEditor main window. In that case, click the [ ... ] button at the far right of each item, set the path required to create the data binding source, and click [ Create ] at the far right of Definition name.

---

Open existing definition

AOpen an existing definitionData filebinding cansource befrom opned[ viaFile > Open ] in CourierEditor menu "File" > "Open".bar.

1. DefineIn includethe path
   • „;“ seperatedInclude path listdialog, set Include path. If you do not need to set Include path, select [ OK ] and skip this operation. For more information about Include path, please refer to Setting the Include Path.
   
   

Select an existing Data binding source.

SelectExisting definitionData folderbinding sources are displayed in the CourierEditor.

In addition to the steps above, you can also open an existing Data binding source from the CourierEditor main window. In that case, click the [ ... ] button at the far right of each item, set the path required to open the existing Data binding source, and click [ Open ] at the far right of Definition name.

---

Setting the Include Path

You can set the Include Path when creating a new Data binding source or opening an existing Data binding source. Include path allows you to pre-include the contents of a specific Data binding source in the Data binding source you are editing by setting the path of the specific Data binding source. For example, by setting a Data binding source that is used for general purposes to a Include Path, there are advantages such as eliminating the need to create a similar Data binding source for each solution.

How to set Include Path

Include Path is set from the Include path dialog that is displayed when you select [ New (create a new data binding source) ] or [ Open (open an existing data binding source) ] from [ File ] on the menu bar. 

The details of the Include path dialog are as follows. Use [ Add path ] to set the destination for any Data binding source.

UI item Description Add path Sets the path for a specific Data binding source. Remove path Removes the path selected in the Include path dialog. Move up Moves the display order of the paths selected in the Include path dialog in ascending order. Move down Moves the display order of paths set in the Include path dialog in descending order. OK Finish setting Include path and proceed to the next step.

After setting the Include Path in the Include path dialog, perform the following operations in the editing area of the Data binding item.

Add an include element by selecting [ Add new include ] from the context menu of include in the Raw XML tab.

Enter the file name of specific Data binding source in [ href ] of the added include element.

From the context menu of the added include element, choose [ Edit (filename of specific Data binding source) ].

The "(specific Data binding source name).xcdl" tab is displayed at the top of the Data binding item editing area.

By shortcutperforming UIthe (pressabove „...“-Buttons to activateoperations, specific editors)

Data

binding Definesource includecan path
• „;“ seperated path list
• Used forbe included defintionin filesthe SelectData definitionbinding filesource Open
being edited.

---

Edit definition

Adding new item

UseAdd the context manu to adda new articatsitem likeby uncludingselecting another[ definition

Right-Click the include entry and select „Add new include“(addable Useitem „...“-Buttonname) to] selectfrom aeach definitionitem filecontext or enter manually menu.

Specify optional artifacts like the message distribution

If not specified the inherited distribution is used Activate the Checkbox on the left side of the entry Select the value Note:

The broadcast value is edited by the checkbox on the right side Uid will be automatically created by the editor

Deleting the item

Select [ Delete artifacts(item byname usingyou want to delete) ] from the context menu of the itamitem thatyou shouldwant beto deleted
delete.

Right-Click Select Delete .....

Choose references from the dropdown list e. g.

The definition contains a message „Test“ The messageRef of a pool is not set which resluts in a validation error Click the dropdown lost to select the message „Test“ The messageRef will be set to the uid of message „Test“

Types / Binding Sources tabs

The Types and Binding Sources tabs are duplicates of the Raw XML tab's types and bindingSources. By using the Types tab and Binding Sources tab, you can edit the types and bindingSources items in the Raw XML tab, and display them in a list. Edits in the Raw XML tab and the Types/Binding Sources tab are synchronized with each other.

Raw XML tab and Type tab

Raw XML tab and Binding Sources tab

To make the information easier to understand, the Types and Binding Sources tabs display only the important properties of the Raw XML tab.

---

Specify optional artifacts like the message distribution

Check the checkbox to the left of each artifact to set the value. Note:

If not specified the inherited distribution is used The broadcast value is edited by the checkbox on the right side Uid will be automatically created by the editor

Choose references from the dropdown list e. g.

The definition contains a message „Test“ The messageRef of a pool is not set which resluts in a validation error Click the dropdown lost to select the message „Test“ The messageRef will be set to the uid of message „Test“

Validation

Validation willcan be startedperformed byin two ways.

• Activate validation the Edit menu
• Using the shortcut Alt+V

Validation output is shown on the lowe part.

---