Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5d

Application v 5.25a

  

 

Chapter FourteenProject Functions (continued)

ProjectGetInfo Function

Overview

The ProjectGetInfo function will retrieve project meta data for the currently open project from the Project Info Table for both predefined items and user-defined data.

Syntax/Parameters

Syntax

string = ProjectGetInfo ( string name );

Parameters

name

A string that defines the name of the project meta information. Certain names are predefined.

Return Value

Returns a string containing the project meta information or an empty string on failure. An empty string may indicate there was no information in the name position or that the name does not exist. Use the GetLastError function to retrieve error information.

Remarks

The GetProjectInfo function is the preferred method of accessing named meta data for a project. Project meta data is stored in the Project Info Table via name. See the section on Project File Specification for more information.

Project predefined names are as follows:

“Project-Filename” — Project’s filename.

“Project-Name” — Textual name of project (on Project Properties dialog).

“Project-Description” — Description of project (on Project Properties dialog).

“Project-Matter” — Control number for project (on Project Properties dialog).

“Project-Client-Name” — Client name (on Project Properties dialog).

“Project-Client-ID” — Client ID (on Project Properties dialog).

“Project-Agent-Name” — Agent Name (on Project Properties dialog).

“Project-Manager” — Manager’s name (on Project Properties dialog).

“Project-Revision” — Revision data (on Project Properties dialog).

“Project-Comments” — General Comments (on Project Properties dialog).

Conventionally, other meta names within the Project Info Table names begin with the prefix “ProjectInfo” if they are allowed to be accessed by the application environmental variable functions. If they do not have this prefix, then they can only be accessed from the project functions.

Related Functions

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL