CREATE ALIAS

version 6.7

CREATE ALIAS (targetPath; aliasPath)

The CREATE ALIAS command creates an alias (named "shortcut" under Windows) for the target file or folder passed in targetPath. The name and location are defined by the targetPath parameter.

An alias can be made for any kind of document or folder. The alias icon will be the same as the target item. The icon contains a small arrow at the bottom left side. Under Mac OS, the icon name is also displayed in italics characters.

This command does not assign a name by default, the name has to be passed in the aliasPath parameter. If just a name is passed in this parameter, the alias is created in the current working folder (usually the folder containing the structure file).

Note: Under Windows, the shortcuts are designated by a ".LNK" extension (invisible). If this extension is not passed, it is automatically added by the command.

If an empty string is passed in the targetPath, the command does nothing.

Your database generates text files called "Report Number" sorted in the database folder. The user would like to create shortcuts to these reports and to store them at a convenient location:

      `Method CREATE_REPORT
   C_TEXT($vtRport)
   C_STRING(250;$vtpath)
   C_STRING(80;$vaname)
   C_TIME(vDoc)
   C_INTEGER($ReportNber)

   $vTReport:=...    `Create report
   $ReportNber:=...   `Compute the report number
   $vaName:="Report"+String($ReportNber)+".txt"   `File name
   vDoc:=Create document($vaName)
   If (OK=1)
      SEND PACKET(vDoc;$vTReport)
      CLOSE DOCUMENT(vDoc)
         `Add the alias
      CONFIRM("Create an alias for this report?")
      If (OK=1)
         $vtPath:=Select folder("Where do you want the alias to be created?")
         If (OK=1)
            CREATE ALIAS ($vaName;$vtPath+$vaName)
            If (OK=1)
               SHOW ON DISK($vtPath+$vaName)
                  `Show the alias location  
            End if
         End if
      End if
   End if

The OK system variable is set to 1 if the command execution was successful; otherwise it is set to 0.

RESOLVE ALIAS.