====== GETSUBKEY Method ======


 
==== 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.

^Parameter^Description^
|//Message//|'GETSUBKEY'|
|//entID//|//entID// 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|Get_Status function]] after calling Repository.
 
==== See Also ====
 
[[repository|Repository() function]], [[setsubkey|SETSUBKEY Method]], [[get_repos_entities|Get_Repos_Entities()]]. Also, Stored Procedures chapter in the //Guide to Application Development//.
 
==== Example ====
 
<code>
/* 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
</code>