INFOMAPS Procedure

INSERT FOLDER Statement

Inserts a folder into the current information map.

Syntax

INSERT FOLDER "folder-name" <options>;

Summary of Optional Arguments

specifies additional properties for the folder.
specifies the description of the folder that is created.
specifies the parent folder of the folder that you are inserting into the information map.

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.

Optional Arguments

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 value 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.
Restriction:Property names cannot begin with an underscore (_) character.
Requirement:Property names must be unique. If a specified 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.
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" </CREATE>
LOCATION="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=
Restrictions:The following characters are not valid in a parent folder name:
  • / \
  • null characters
  • non-blank nonprintable characters

A parent folder name can contain blank spaces, but it cannot consist only of blank spaces.

Examples

Example 1

insert folder "measures";

Example 2

insert folder "subMeasures" parent="measures";

Example 3

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