Getting Started

To get started, we must complete the following pair of preliminary steps:

Import the sample data classes: Contact, Address, and PhoneNumber, into Caché. These classes define the Caché data displayed by Zen Contacts. See the note below for a discussion of the structure of these classes and the location of the file containing them.
Populate the classes with sample data.

Here are the steps for importing the classes into Caché:

Open Studio in the USER namespace. If Studio does not open in this namespace automatically, click File–>Change Namespace to change to USER.
On the menu bar click Tools–>Import Local:
On the Open dialog click Contacts.xml and then click Open:
Click ZenTutorial.Contact, ZenTutorial.Address, and ZenTutorial.PhoneNumber. Verify that Compile Imported Items is selected:
Click OK. Studio imports and compiles the classes.

Here are the steps for populating the three classes with sample data. Note that populating ZenTutorial.Contact populates ZenTutorial.Address automatically.

Open Terminal. If it does not open in the USER namespace, use the ZN command to change to USER. Here is an example of switching from SAMPLES to USER:
```
SAMPLES>ZN "USER"
USER>
```

Execute the following command to create 25 ZenTutorial.Contact instances:


USER>Do ##class(ZenTutorial.Contact).Populate(25)

Execute the following command to create 75 ZenTutorial.PhoneNumber instances:
```
USER>Do ##class(ZenTutorial.PhoneNumber).Populate(75)
```

Note:

Click here here for a discussion of the Contact, Address, PhoneNumber data model.

Contacts.xml, CustomComponents.xml, and ZenContacts.xml — the completed Zen application, are in <cachesys>\dev\tutorials\zen.

You must create the ZenTutorial.Contact instances before you create the ZenTutorial.PhoneNumber instances.

To learn more about using Studio, read Using Studio.