How to Edit Concepts

How to edit ConceptChoir Concepts

To edit an existing concept, you must first highlight the concept, then click from the Vocabulary Explorer tool bar to enter the editing mode. You have to have the editor permission to edit any concepts of the vocabulary. When in editing mode, the Tree Display Area of Vocabulary Explorer will be locked until the completion of your edition. ConceptChoir Concept Editor interface will be displayed in the Node Detail Area of Vocabulary Explorer. Figure 1 is the interface of Node Detail Area in editing mode.

Figure 1. Editing an existing concept

We can further break the ConceptChoir Record Edit Interface into four section: Element Heading section, Stage section, Element Details section, and Editing Action section.

Element Heading

Element Heading section (Figure 2) is located on top of the editing area. It includes all element headings defined in the vocabulary.

Figure 2 Element Heading

You can easily navigate to an element by clicking on its corresponding heading. Click on the element heading will show the element editing interface in the Element Detail section. For vocabularies with many elements defined, you can use the Left and Right arrows to scroll the element heading section till the desired heading is in view.

Stage

Stage section (Figure 3) is located under the Element Heading section. It allows you to adjust the concept stage by using the dropdown menu.

Figure 3 Stage

Element Detail

Element Detail section (Figure 4) is located after the Stage section. When editor click on an element from the Element Heading section, the element editing interface will be populated in this section for you to set the element details. By default, the first element in the Element Heading section will be put into the editing zone when starting the editor.

Figure 4 Element Detail -- Terms Element

Very similar to the concept viewing system, the sign and sign enable/disable the multiple language entries, the sign and sign show/hide relation details that attached to this element all together, while the and sign controls the visibility of the elements they followed . If an attribute or sub element is defined to be repeatable, you will notice a sign at the end of the row, enabling you to add a new record of the element. the sign however, will delete the record it followed once clicked.

For elements that would establish relationships with other concepts in the vocabulary, such as Related Concepts, Broader Concepts, ConceptChoir provides a mini browser to help you choose the target concepts. Let's put the Related Concepts element into the Element Detail section by clicking on "Related Concepts" heading in the Element Heading section (Figure 5).

Figure 5 Element Detail -- Related Concepts Element

You can update the related concept label directly into the first text field, or you can use the mini browser ConceptChoir provided to select a concept to avoid mistakes. To use mini browser, click the browse button to open the mini browser as shown in figure 5.1. Mini browser will automatically expand hierarchy tree to display the current concept's hierarchical position and show the current concept as the selected concept. The mini browser shares the same navigational abilities as ConceptChoir main vocabulary navigation. You can switch between hierarchical display and alphabetical display, expand and collapse branches, set levels of promotion to narrow down the browsing scope, or even use the search function provided to find the desired concept. When target concept is located and selected, click OK button to accept the selection and return to the editing page. Click Cancel button to close the mini browser without making any selection.

Figure 5.1 Mini Browser for choosing concepts from vocabulary

Editing Action

Editing Action section section (Figure 6) is located at the bottom of the Node Detail Area of the Vocabulary Explorer.

Figure 6 Editing Action

Check the Keep checked out checkbox in the Editing Action section to keep the concept in checked out mode for further investigation, or uncheck the checkbox to make it available for others for further investigation. When satisfied with concept definition, click Save button to keep all changes you have made. Save action will validate your input first. If validation failed, save action is aborted, and location of error will be highlighted and presented in Element Detail section, giving you the chance to correct your inputs. If validation process is passed successfully, the concept will be saved with new definition. Click Cancel button to cancel all the pending changes and return to the concept viewing mode.