INCLUDED property

Checks whether the setting "Generate section in the output" is activated

For a form, the setting “include this section in the output” can be activated (only on the section level in the Page Store). By activating this option, the editor can define whether or not the section's contents in the respective language are to be taken into account during the next generation.

This setting can be checked using a rule. The expression <PROPERTY source='#global' name='INCLUDED'/> can be set in the value determination of the rule definition and checks whether or not the option is set for this section. The expression returns a Boolean value. Since this is a generally applicable form property, the object#global has to be assigned the attribute source.

This setting at the section level is related to the setting “Page fully translated for this language” at the page level. This can be checked with the TRANSLATED attribute.

Examples

A form element is displayed if the section is to be generated in the output

The following form contains two design elements of the type CMS_GROUP with different form contents. A dynamic form is to be used to ensure that only one specific form page is shown depending on the setting “include this section in the output”.

Because this option is only available in the Page Store, two conditions are checked in the value determination.

• The content of form A is displayed if the form has been opened in the Page Store AND the option “include this section in the output” has been activated.
• The content of form B is displayed if the form in the Page Store has been opened AND the option “include this section in the output” has been deactivated.

...
<ON_EVENT>
        <WITH>
            <AND>
                <EQUAL>
                    <PROPERTY source="#global" name="STORETYPE"/>
                    <TEXT>pagestore</TEXT>
                </EQUAL>
                <!-- global property: INCLUDED -->
                <PROPERTY source="#global" name="INCLUDED"/>
                <!-- /global property: INCLUDED -->
            </AND>
        </WITH>
        <DO>
            <PROPERTY source="#form.A" name="VISIBLE"/>
        </DO>
</ON_EVENT>

<ON_EVENT>
        <WITH>
            <AND>
                <EQUAL>
                    <PROPERTY source="#global" name="STORETYPE"/>
                    <TEXT>pagestore</TEXT>
                </EQUAL>
                <NOT>
                    <!-- global property: INCLUDED -->
                    <PROPERTY source="#global" name="INCLUDED"/>
                    <!-- /global property: INCLUDED -->
                </NOT>
            </AND>
        </WITH>
        <DO>
            <PROPERTY source="#form.B" name="VISIBLE"/>
        </DO>
    </ON_EVENT>
...