The INFOMAPS Procedure

INSERT FOLDER Statement

Inserts a folder into the current information map.

INSERT FOLDER "folder-name"
<CUSTOM_PROPERTIES=(custom-properties-list)>
<DESCRIPTION="descriptive-text">
<LOCATION="parent-folder-name" | "parent-folder-location" </CREATE>>;

Required Argument

"folder-name"

specifies the name of the map folder to insert into the current information map.

Tip:	When referring to the folder, remember that case is important.

Options

CUSTOM_PROPERTIES=(custom-properties-list)

specifies additional properties for the folder. Custom properties are supported by specific SAS applications such as SAS Marketing Automation. The form of the custom-properties-list is

("property-name-1" "property-value-1" <"description-1">)
...
("property-name-n" "property-value-n" <"description-n">)

where

property-name

specifies the name of the property.

Requirement:	Property names must be unique. If a property name already exists in the folder, then the INSERT FOLDER statement will fail. Therefore, it is recommended that you add a prefix or suffix to the property name to ensure uniqueness.
Restriction:	Property names cannot begin with an underscore (_) character.

property-value

specifies the value of the property.

description

specifies the description of the property. The description is optional.

DESCRIPTION="descriptive-text"

specifies the description of the folder that is created.

Alias:

DESC=

LOCATION="parent-folder-name" | "parent-folder-location" </CREATE>

specifies the parent folder of the folder that you are inserting into the information map. By specifying the parent folder, you specify where in the information map to insert the folder.

If the parent folder is in the root directory of the information map, then you can specify the parent folder by name without an initial slash. For example, FOLDER="CUSTOMERS" .
If the parent folder is not in the root directory, then you must qualify it with a location that starts with a slash. For example, FOLDER="/CUSTOMERS/Europe" .

/CREATE: specifies that the named folder or location is created automatically if it does not already exist.

Alias:	PARENT=
Restriction:	The following characters are not valid in a parent folder name: / \ null characters non-blank nonprintable characters
Restriction:	A parent folder name can contain blank spaces, but it cannot consist only of blank spaces.

Examples

insert folder "measures";
insert folder "subMeasures" parent="measures";
insert folder "subsubMeasures" location="/measures/subMeasures";

Top of Page