INFOMAPS Procedure

IMPORT LOCALIZED_PROPERTIES Statement

Imports localized properties from external files into one or more existing information maps.

Alias:

IMPORT LOC_PROPERTIES

Syntax

IMPORT LOCALIZED_PROPERTIES FILE="base-location"
LOCALES=(locale-1 <...locale-n>);

Required Arguments

FILE="base-location": specifies the path and base name for one or more external files that contain localized properties for one or more information maps. The complete names for the imported files are formed by adding the locale values specified in the LOCALES= argument and the file extension .locprop to the specified value. For example, if the filename in the base-location value is mapprops and fr_FR is specified as one of the LOCALES= values, then one of the files that the import process attempts to read is mapprops_fr_FR.locprop.

Note:You can use the EXPORT LOCALIZABLE_PROPERTIES statement to create files that contain the localizable properties for one or more information maps. Those property files can then serve as the source for creating the localized properties files that this statement imports.

LOCALES=(locale-1 <...locale-n>: specifies one or more locales for the localized properties files to import. For more information about locale values, see SAS National Language Support (NLS): Reference Guide.

Details

For each locale value specified in the LOCALES= argument, the import process expects to find a localized properties file for that locale at the path and with the base name specified in the FILE= argument. A localized properties file is a text file containing localized versions of information map properties such as object labels and descriptions. You can use the EXPORT LOCALIZABLE_PROPERTIES statement to create a file that contains the localizable properties of one or more information maps. You can then create new copies of that file in which the values of the properties are translated for a given locale.

The set of localized properties files must use a common base name with the locale added to each file. Localized properties files must use the file extension .locprop. Thus, the French version in a set of localized properties files with the base name localmap would be localmap_fr_FR.locprop and the German version would be localmap_de_DE.locprop.

The import process reads the localized properties files and applies the specified localized properties to the information maps specified in the files. If an information map is open when the import process is started, then the procedure imports the localized properties for only the current information map. You should issue a Save command after the import to store the imported properties. If you want to import localized properties for all of the information maps that are specified in the external files, then you must close the current information map first. You can use the CLOSE INFOMAP statement to close the current information map.

Example

/* Update an information map by adding French and     */
/* Canadian French versions of localizable properties */
update infomap  "my testmap"
       mappath="/Users/myUserID/My Folder";
import localized_properties
       file="c:/locale/mapprops"
       locales=(fr_FR fr_CA);
save;

In this example, the import process expects to find the following localized properties files to import:

c:/locale/mapprops_fr_FR.locprop
c:/locale/mapprops_fr_CA.locprop