In Planner Basics we introduced Element Types and Connections. Once you have created an Element Type, you'll want to add more information than the name of the Element Type. You can accomplish this with Properties. Our Hero City demonstrates how you can add extra information to your Element, like an image and a description.
Adding Properties to your Element Types allows you to add more information in the form of text, numbers, URLs, videos, images, etc.
The following workflow requires that you understand the difference between your model (or schema), and the information that produces the result of the model. Each Element Type can hold information on hundreds or even thousands of Elements of that type.
In the schema below, the "Element Type" called "People" includes 55 Elements (People) listed by their name.
Inevitably, you will want to capture more information about your Elements besides just a name, and that is where properties come in.
Adding a Property to an Element Type
When you have information that is unique to an Element, you can create a Property on that Element Type that can hold that piece of information, for example, a Course (Element Type) can have the default Property of Name, but also have other unique Properties (Description, URL, Syllabus, and Objectives). Entering a Property on an Element type requires 4 easy steps.
1. Select the Field Type
To add a Property to an Element Type, click on the Element Type node to open the detail panel which slides out from the right. From the "Fields" section on the detail panel, click "Add". The modal that opens up describes the types of Properties you can add to your Element Types. Select the field type from the options listed below.
Short Text - A text field with a limit of 200 characters, or a dropdown, or a Radiogroup.
Long Text - A text field with a relatively unlimited character limit, either in plain text or rich text format.
Image - The ability to upload an image and see a preview.
Document - The ability to upload a document from your computer (i.e. .xls, .doc, .pdf).
Video - Ability to include the link to a video from either YouTube or Vimeo. When the embed link is included, the video will play in the detail panel of the Exploratory Viewer.
URL - The URL for a webpage, a document, or an image.
Number - Either an input box or a slider for integers.
Date/Time - A date picker for both the date and time.
True/False - A checkbox with a label.
2. Create the Field Description
In the modal that opens once you have chosen your field type, type the "Name" of the field (the Field ID will be inputted automatically), The Title of the Field (Optional) which will become the column header in the Curator, and Prompt (Optional) which will visible in Graph Forms.
3. Choose the Appearance of the Field
The choices presented in the Appearance section will be based upon the type of Field that you have chosen. All of the options allow you to choose a Default Value for the Field, and choose whether or not to make the field Anonymous or ReadOnly.
Field Specific Instructions
Short Text - Choose between a Textbox, a Radiogroup or a Dropdown (the latter two will require you to enter the possible choices).
Long Text - Choose between plain text or rich text format. You will also get to choose how many rows the Field will have.
Number - Choose between Number or Slider. If you choose Slider, more options will appear allowing you to choose the Slider features.
True/False -This option lets you create a Label (i.e. "Check here to be included in the Directory").
4. Choose Validation Features of the Field
This step lets you choose certain features of the Field i.e whether or not the Field will be Required. All Fields by default will be included in the Graph Database where possible, to exclude that Field, toggle the "Include in Graph" feature off.
Once you have completed these four steps, click "Add field" at the bottom of the modal.