Skip to main content

This is documentation for Caché & Ensemble.

For information on converting to InterSystems IRISOpens in a new window, see the InterSystems IRIS Migration Guide and Migrating to InterSystems IRIS, both available on the WRC Distributions pageOpens in a new window (login required).

Getting Started

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

  1. 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.

  2. Populate the classes with sample data.

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

  1. Open Studio in the USER namespace. If Studio does not open in this namespace automatically, click File–>Change Namespace to change to USER.

  2. On the menu bar click Tools–>Import Local:

    generated description: importclasses 20101

  3. On the Open dialog click Contacts.xml and then click Open:

    generated description: importclasses2 20131

  4. Click ZenTutorial.Contact, ZenTutorial.Address, and ZenTutorial.PhoneNumber. Verify that Compile Imported Items is selected:

    generated description: importclasses3 20131

    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.

  1. 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:

    Copy code to clipboard
  2. Execute the following command to create 25 ZenTutorial.Contact instances:

    USER>Do ##class(ZenTutorial.Contact).Populate(25)                
    Copy code to clipboard
  3. Execute the following command to create 75 ZenTutorial.PhoneNumber instances:

    USER>Do ##class(ZenTutorial.PhoneNumber).Populate(75)
    Copy code to clipboard

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.

FeedbackOpens in a new window