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.
- 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:
-
-
-
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";
Copyright © SAS Institute Inc. All rights reserved.