GetSiteExtendedNames
Description
Gets site-extended names for a given workspace item.
This method supports MultiSite operations and may be useful in detected or resolving name conflicts. For example, a replica site might have charts, queries, reports, and report formats with the same pathnames as the local site. This means that there is a potential for duplicate names. This method allows you to get site names that uniquely identify a workspace item. An extended name can be used in APIs wherever unextended names are used.
If the specified item is already an extended name, no error will occur and extended names will still be returned. If the specified name is incorrect, the returned array will be empty. You must have access to the specified locations. If you do not have access or if the specified location does not exist, an empty array will be returned. Folder names must be separated with a forward slash (/) character.
Syntax
VBScript
var_site_names = workspace.GetSiteExtendedNames item_path
Perl
$ref_site_names = $workspace->GetSiteExtendedNames(item_path);
- Identifier
- Description
- workspace
- The Workspace object obtained from the current session.
- item_path
- The path to a workspace item.
- Return value
- In Visual Basic, the return value is a Variant containing
extended names.
In Perl, the return value is a reference to an array of strings.