====== Repository function ======

 
==== Description ====
 
Use to issue methods to repository objects (entities).  Repository entities are stored as rows in the SYSREPOS table.  See [[sysrepos_col_equates|SYSREPOS_COL_EQUATES]] for the SYSREPOS table layout.
 
==== Syntax ====
 
//methodreturn// = **Repository**(//Message//, //entID//, //arg//n)
 
==== Parameters ====
 
The Repository function has the following parameters.  Arguments for each message vary.  Follow the link in the Message column for syntax and examples.

^Parameter^Description^
|//Message//|A list of valid //Message// types supplied with OpenInsight follows this table|
|//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.|
|//arg//n|Arg1 ..... Arg20.\\ |

This list of methods is not exhaustive.\\ \\ **Note:**  Always call the [[get_status|Get_Status function]] after calling Repository

^Message^Description^
|[[access|ACCESS]]|Method for accessing (i.e., reading) entities of a given type or class, and determining whether an entity exists.|
|[[addmodule|ADDMODULE]]|Method for adding modules to an entity.|
|[[clearflag|CLEARFLAG]]|Method for resetting the evaluation and/or compilation flags for a repository entity.|
|[[clearmodule|CLEARMODULE]]|Method for clearing modules on an entity.|
|[[compile|COMPILE]]|Method for compiling entities of a given type (stored procedures or windows) into an executable form.|
|[[copy|COPY]]|Method for copying entities.|
|[[design|DESIGN]]|Method for designing entities.|
|[[destroy|DESTROY]]|Method for destroying an entity.|
|[[execute_message|EXECUTE]]|Method for executing entities.|
|[[flag|FLAG]]|Method for setting flags in the repository header for this entity.|
|[[get|GET]]|Method for reading the entry in SYSREPOS (the master repository table) for the entity.|
|[[getaccesspermit|GETACCESSPERMIT]]|Method for getting the users who have access (i.e. reading) permission for this entity.|
|[[getappid|GETAPPID]]|Method for getting the application ID (the first part of the key for the SYSREPOS entry corresponding to the entity)|
|[[getdescription|GETDESCRIPTION]]|Method for getting the entity's description information.|
|[[getdocument|GETDOCUMENT]]|Method for getting the document(s) associated with this entity.|
|[[getevaluate|GETEVALUATE]]|Method for getting the entity's evaluate flag and notes information.|
|[[getlastupdate|GETLASTUPDATE]]|Method for getting the date and time of the last update to this entity.|
|[[getloghistory|GETLOGHISTORY]]|Method for getting the history log for an entity.|
|[[getmodule|GETMODULE]]|Method for getting the modules for an entity.|
|[[getpublishable|GETPUBLISHABLE]]|Method for getting the "publishable" flag for an entity.|
|[[getrecompile|GETRECOMPILE]]|Method for getting the recompilation flag for an entity.|
|[[getshareable|GETSHAREABLE]]|Method for getting the shareable flag for an entity.|
|[[getsub|GETSUB]]|Method for getting a list of "sub-entities," (entities using //entID).//|
|[[getsubkey|GETSUBKEY]]|Method for getting the "subkey" (data storage location), for entities such as documents.|
|[[getsuper|GETSUPER]]|Method for getting a list of "super-entities" (entities used by //entID//).|
|[[gettitle|GETTITLE]]|Method for getting the entity's title in the repository.|
|[[getupdatepermit|GETUPDATEPERMIT]]|Method for getting the users who have update permission for this entity.|
|[[lock_method|LOCK]]|Method for locking an entity.|
|[[new|NEW]]|Method for creating new entities.|
|[[removemodule|REMOVEMODULE]]|Method for removing a module from an entity.|
|[[set|SET]]|Method for writing the entry in SYSREPOS (the master repository table) for the entity.|
|[[setaccesspermit|SETACCESSPERMIT]]|Method for updating the list of users who have access (i.e. reading) permission for this entity.|
|[[setdescription|SETDESCRIPTION]]|Method for changing an entity's description in the repository.|
|[[setmodule|SETMODULE]]|Method for setting a module on an entity.|
|[[setpublishable|SETPUBLISHABLE]]|Method for change an entity's publishable flag in the repository.|
|[[setshareable|SETSHAREABLE]]|Method for setting the entity's shareable flag in the repository.|
|[[setsub|SETSUB]]|Method for setting the list of "sub-entities" (entities using //entID//).|
|[[setsubkey|SETSUBKEY]]|Method for setting the "subkey" (data storage location).|
|[[setsuper|SETSUPER]]|Method for setting the list of "super-entities" (entities used by //entID//).|
|[[settitle|SETTITLE]]|Method for setting the entity's title in the repository.|
|[[setupdatepermit|SETUPDATEPERMIT]]|Method for updating the list of users who have update permission for this entity.|
|[[tcompile|TCOMPILE]]|Tree compile (compile entities with their related entities, for example a window and events in the window).|
|[[tcopy|TCOPY]]|Tree copy (copies entities with their related entities, for example a window and events in the window)|
|[[tdestroy|TDESTROY]]|Tree destroy (destroying entities and entities used by this entity, such as a window and events created in the window).|
|[[unlock_method|UNLOCK]]|Method for unlocking entities.|
|[[update|UPDATE]]|Method for updating an entity while allowing the repository routines to record the update.|
|[[write_method|WRITE]]|Method to create new entities, or overwrite existing entities.|

==== See Also ====
 
[[sysrepos_col_equates|SYSREPOS_COL_EQUATES]], [[get_repos_entities|Get_Repos_Entities()]],   [[chapter_reverror.dat_file|RevError.DAT]]. Also, the Stored Procedures chapter in the //Guide to Application Development//.
 
==== Example ====
 
<code>
result = Repository("ACCESS", entid)
if Get_Status(ErrCode) then
       statList<-1> = ErrCode
end
</code>