Open method: AESection class

Syntax

Open(ae_applid, ae_section, [effdt])

Description

The Open method associates the AESection object with the given Application Engine section, based on the ae_applid and ae_section. If the effdt is specified, this is also used to get the section object. In other words, the Open method sets the base section.

WARNING:

When you open or get an AESection object, (that is, the base section) any existing steps in the section are deleted.

Note:

If the base section you specify doesn’t exist, a new base section is created. This enables you to dynamically create sections as needed. In addition, if the target section doesn't exist, all section-level attributes are copied from the template to the target section. If the target exists, it retains its attribute settings.

If the AESection is still open when you issue the Open method, the previously opened object is discarded and none of the changes saved. To prevent accidentally discarding your changes, you can use the IsOpen property to verify if a section is already open.

The AESection is open based on the Market and database type of your current system.

Parameters

Parameter Description

ae_applid

Specify the application ID of the section you want to access. This parameter takes a string value.

ae_section

Specify the section name of the section you want to access. This parameter takes a string value.

effdt

Specify the effective date of the section you want to access (optional). This parameter takes a string value.

Returns

An AESection object.

Example

Local AESection &SECTION;
&SECTION = GetAESection("RULES1", "DYN_SECT");
/* do some processing */
&SECTION.Close();
&SECTION.Open("RULES2", "DYN_SECT");
/* do additional processing */