Setting up dynamically changing selection items using master selection

Overview

In this tutorial, we will use the master selection items to set up dynamically changing selection items.

What you will learn

You will learn how to set up selection items that change dynamically in content structures.

• Master Setup
• Content Structure Setup
• Confirming Content Editing Screen

Master Setup

First, register the key and label that will be options in the master.

Click on [Content] -> [Master].

Click on [Add].

In the master editor, set it up as follows and click [Add].

Field	Content
Title	City
Table	Not necessary to set
Update by CSV (Charset)	Select the character encoding of the CSV you created
Update by CSV (File)	Save the following content as a CSV file and set it up

"city_cd","city_name","prefecture_cd","prefecture_name"
"13101","Chiyoda-ku","13","Tokyo"
"13102","Chuo-ku","13","Tokyo"
"14101","Tsurumi-ku, Yokohama","14","Kanagawa"
"14102","Kanagawa-ku, Yokohama","14","Kanagawa"

The master has been registered.

Content Structure Setup

In any content structure, set up two items using the master selection for parent-child relationships.
This allows you to dynamically change the keys that can be selected in the child item based on the key selected in the parent item.

Parent Item

Field	Content
Field name	Prefecture
Field settings	Master selection
Options (Master)	Select the master created in Master Setup
Options (Key)	Specify the column number (0-based) of the data to use as the key. In the parent item, use 2 for prefecture_cd.
Options (Value)	Specify the column number (0-based) of the data to use as the label. In the parent item, use 3 for prefecture_name.
parent id	Blank

Child Item

Item	Content
Field name	City, town, village
Field settings	Master selection
Options (Master)	Please select the master created in Master Setup.
Options (Key)	Specify the column number (starting from 0) of the data to be used as the key. In this case, filtering will be done based on the prefecture_cd (2) selected in the parent item and city_cd (0) will be used as the key, so set it as [2,0].
Options (Value)	Specify the column number (starting from 0) of the data to be used as the label. In the child item, city_name will be used, so please set it as 1.
parent id	Set the extension ID to be used as the parent item. In this example, set it as 6. (The ext_ at the beginning is not necessary)

info

• Settings for dynamically changing selection items are available in master selection and master (checkbox).

• The key for child items is set in the format [a,b].

  • a: Specify the column number to match with the key selected in the parent item (prefecture_cd).
  • b: Specify the column number to be used as the key for this item itself (city_cd).

  For example, when selecting "Tokyo" (prefecture_cd="13") in the parent item, only city_cd and city_name from the row where prefecture_cd is "13" will be displayed as options.

Confirming Content Editing Screen

Refer to Editing Content Access the article editing page and select a parent item to confirm that the selection items are dynamically filtered as shown below.

• Select Tokyo as the parent item

• Select Kanagawa as the parent item

Related Documents

• Editing Content Definitions
• Editing Content