The INFOMAPS Procedure

UPDATE FOLDER Statement

Updates the properties of a folder in the current information map.

UPDATE FOLDER "folder-name"
<CUSTOM_PROPERTIES=NONE | ADD (custom-properties-list) |
REPLACE (custom-properties-list) | REMOVE (property-names-list)>
<DESCRIPTION="descriptive-text">
<LOCATION="current-parent-folder-name" | "current-parent-folder-location">
<NAME="new-folder-name">;

Required Argument

"folder-name": specifies the name of the map folder to be updated.

Options

CUSTOM_PROPERTIES=NONE | ADD (custom-properties-list) | REPLACE (custom-properties-list) | REMOVE (property-names-list)

specifies how custom properties for the folder are updated. Custom properties are supported by specific SAS applications such as SAS Marketing Automation. Valid operations are the following:

NONE

removes all custom properties from the folder, if there are any.

ADD (custom-properties-list)

adds the specified custom properties to the folder.

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 UPDATE 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.

REPLACE (custom-properties-list)

replaces the current custom properties for the folder with the specified properties.

See the ADD operation for a description of the form of the custom-properties-list.

REMOVE (property-names-list)

Removes the specified custom properties from the folder.

The form of the property-names-list is

"property-name-1" <... "property-name-n">

Interaction:

If you specify both the ADD and REMOVE operations, then the REMOVE operation occurs first.

DESCRIPTION="descriptive-text"

specifies the description of the folder.

LOCATION="current-parent-folder-name" | "current-parent-folder-location"

specifies the current parent folder of the folder that you are updating.

If the folder is in the root directory of the information map, then you can specify the folder by name without an initial slash. For example, LOCATION="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, LOCATION="/CUSTOMERS/Europe" .

Restriction:

The root folder cannot be updated.

NAME="new-folder-name"

specifies the new name of the folder.

Example

update folder "subsubMeasures" location="/measures/subMeasures"

Top of Page