Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Description

Method for getting the "subkey" (data storage location), for entities such as documents. The subkey is found on the Entity...Properties dialog in the Repository outline.

Syntax

retval = Repository("GETSUBKEY" entID)

Parameters

The GETSUBKEY method has the following parameters.

ParameterDescription
Message"GETSUBKEY"
entIDentID consists of four elements, which are '*' (asterisk) delimited:
 
  • Application name
  • Type ID
  • Class ID
  • Entity name
 Methods are executed as follows: if class specific, execute at the class level; if type specific, execute at the type level; otherwise, execute the method.

Returns

The entity's sub-key.

Note: Always call the Get_Status function after calling Repository.

See also

Repository() functionSETSUBKEY MethodGet_Repos_Entities().

Example

 
Code Block
/* Get the path for the INET_INVOICE_RPT HTML document, stored in the SUB-KEY, in the result variable */
 
Declare Function Repository, Get_Status
 
AppID = @APPID<1>  ;* current application
 
TypeID = "DOC"  ;* ;* document type
 
ClassID = "HTML"  ;*  HTML class
 
Report_Name = 'INET_INVOICE_RPT'
 
entid = AppID : '*' : TypeID : '*' : ClassID : '*' : Report_Name
 
 
result = Repository("GETSUBKEY", entid)
 
/*  result now contains the path to the INET_INVOICE_RPT HTML report. */
 
If Get_Status(ErrCode) then
 
  call msg(@window, 'Error Message returned: ' : ErrCode)
 
  return 1
 
end