OOQL language localarea


file container on a distributed file system


define - create new localarea definition

  localarea define   AdminName {LocalArea_DefineOption} [force];

clone - duplicate a localarea and set the properties for the new instance

  localarea clone  AdminName define AdminName {LocalArea_EditOption} [force];

edit - update the localarea properties

  localarea edit   AdminName {LocalArea_EditOption} [force];

show - print the localarea properties

  localarea show   AdminName [LocalArea_GetOption] [Token_Option] [ExportFile_Option] ;

select - extract localarea on the base of query filters

  localarea select AdminPatternList {Filter_Option} [LocalArea_GetOption]
                                     [Token_Option] [ExportFile_Option] ;

check - check if all object attached files are phisically present inside the localarea

  localarea check  AdminName ;

defrag - remove all files not related to any object from the localarea

  localarea defrag  AdminName ;

empty - remove all files from the localarea

  localarea empty  AdminName ;

undefine - remove a empty localarea from the database

  localarea undefine AdminName ;


LocalArea_DefineOption
description GenericValue
application AdminName
image  FileName
imagedata GenericString
protocol   LocalArea_Protocol
host GenericString
port NUMBER
path FileName
permission NUMBER
account GenericString
password GenericString
url FileName
[! / not] hashnames
[! / not] subfolders
[! /not] hidden

LocalArea_EditOption
name AdminName
description GenericValue
application AdminName
svnrev NUMBER
image  FileName
imagedata GenericString
protocol   LocalArea_Protocol
host GenericString
port NUMBER
path FileName
permission NUMBER
account GenericString
password GenericString
url FileName
rehash
[! / not] hashnames
[! / not] subfolders
[! /not] hidden

LocalArea_Protocol
file
ftp
http

LocalArea_GetOption
get [LocalArea_GetBasicOption]
   
  LocalArea_GetBasicOption
  { LocalArea_GetBasicToken [as IDENTIFIER] { LocalArea_GetBasicToken [as IDENTIFIER] } }
  LocalArea_GetBasicToken [as IDENTIFIER]
     
    LocalArea_GetBasicToken
    Common_GetBasicOption  
    protocol  
    host  
    port  
    path  
    permission  
    account  
    password  
    url  
    hashnames  
    subfolders  
    filespace   [. FileSpace_GetBasicOption]
    filespace[] [. FileSpace_GetBasicOption]
    filespace[ AdminName ]  



KEYWORDs
account the username to access the localarea (ftp/http types)
application the associated application menu
description the localarea description
filespace list of filespaces supported by this localarea
force this flag allows to ignore errors during the creation/update (for example, the folder physical creation)
hashnames this flag enables the file name encryption to avoid collisions inside the localarea
hidden administration hidden objects are not visible/usable
host localarea host IP address or name (only for ftp type; default = localhost or 127.0.0.1)
image local path for the localarea icon to upload
imagedata base64 code for the localarea icon
moddate last modification date
name the localarea name
password the password to access the localarea (ftp/http types)
path the localarea location path (relative for ftp/http types; absolute for file type)
the root folder is given by the associated filespace subpath
permission folder access permissions ( unix code; ex: 755 ) (ftp/file types)
port localarea host port (only for ftp type; default = 21)
protocol the localarea type:
- file: files are stored in the Network File System (NFS)
- ftp: uses the FTP to exchange and manipulate files over a TCP/IP network
- http: files are exchanged by a "FileSystem" web service.
rehash re-generate the file names according to the hashnames flag
subfolders this flag enables the sub-folders creation based on the encrypted file names (allows to limit the number of files collected into a single folder)
svnrev SVN repository revision number
url the webservice url (only for http type)


SAMPLES

localarea define LA0 description 'My LA0' image "/home/files/imgLA.gif" protocol file path "/home/Local/la0" ;

localarea clone LA0 define "LA1" description 'My LA1' path "/home/Local/la1" !hashnames permission 555 ;

localarea define LA2 description 'My LA2' image "/home/files/imgLA.gif" protocol ftp host "myhost" port 21 path "/opt/Store/la2" account "userla2" password "pwdla2";

localarea show "LA1" get { protocol host path subfolders } token "|";

localarea edit 'LA0' description 'My Local0' hidden ;

localarea select LA? get { name description protocol host port path permission account url subfolders hashnames } token xml ;

 

common syntax

Common_GetBasicOption
Common_GetBasicToken [ as IDENTIFIER ]

Common_GetBasicToken
id  
name  
origdate  
moddate  
moduser  
description  
svnrev  
hidden  
image  
imagedata  
feature[ AdminName ] [. Feature_GetBasicOption]
feature[] [. Feature_GetBasicOption]
feature [. Feature_GetBasicOption]
application [. Menu_GetBasicOption]
super  
admintype  

Edit_Operator
add
remove

Edit_RefOperator
addbefore AdminName set
addafter AdminName set
add
remove
movebefore
moveafter

Edit_AddOperator
addbefore AdminName define
addafter AdminName define
append

Edit_MoveOperator
movebefore
moveafter

Event_Type
action
check

AdminPatternList
AdminNamePattern {, AdminNamePattern}

AdminNamePattern
*
PATTERNIDENTIFIER
STRINGVAL
AdminName

GenericPatternList
GenericPattern {, GenericPattern}

GenericPattern
*
IDENTIFIER
PATTERNIDENTIFIER
GenericValue

AdminActor
user AdminName
team AdminName
assignment AdminName

AdminName
IDENTIFIER
QUOTED_STRING
SQUOTED_STRING

GenericValue
DATETIME
GenericNumber
GenericString
BOOLEANVAL

GenericString
STRINGVAL
QUOTED_STRING
SQUOTED_STRING

GenericNumber
NUMBER
REALNUMBER

Filter_Option
moddate Date_Range
application AdminNamePattern

Date_Range
=  DATETIME  
!= DATETIME
 
<  DATETIME
 
>  DATETIME
 
<= DATETIME
 
>= DATETIME
 
in [ DATETIME , DATETIME ]
 
in ( DATETIME , DATETIME ]
 
in [ DATETIME , DATETIME )
 
in ( DATETIME , DATETIME )  

Token_Option
token { Token_Separator { Token_Separator } }
token Token_Separator

Token_Separator
QUOTED_STRING
SQUOTED_STRING
IDENTIFIER
STRINGVAL
json
json-
json+
xml
xml-
xml+

ExportFile_Option
exportfile FileName [append] [xml | json ]

ImportFile_Option
importfile FileName [xml | json |emxxml]

LogFile_Option
logfile FileName [append]

FileName
QUOTED_STRING
SQUOTED_STRING

basic elements
grammar rules
[ ] = optional element - only one item is allowed : ( 0 or 1 )
{ } = optional element - more than one is allowed : ( 0 or N )
/ = alternative
= one of ...
   
  all bold texts represent keywords or command syntax

IDVAL
#<5 dec digits [ 0-9 ]>-<8 hex digits [ 0-9 A-F ]>
  example:
  #00020-34F2A80E

COMMENT
// <any character until the end of the line(\n \r)>
  example:
  // My single line comment

LONGCOMMENT
/* <any character> */
 

example:
  /* My multi line comment starts here
  continue here
  and finish here */


DATETIME
<year 4 digits>[ - /. ]<month 2 digits>[ - /. ]<day 2 digits>
  examples:
   2009-12-23    2009/03/19   2009.11.14
<year 4 digits>[ - /. ]<month 2 digits>[ - /. ]<day 2 digits> <hours>:<minutes>:[<seconds>]
  examples:
   2009-12-23 10:23   2009/03/19 16:03:34  2009.11.14 00:20:04

NUMBER
[+-]<decimal digits [ 0-9 ]>
  examples:
   -1203   +276   25

BOOLEANVAL
true / false

REALNUMBER
[+-]<decimal digits [ 0-9 ]>.<decimal digits [ 0-9 ]>[E(+-)<esponent [0-9]>]
  example:
   -37.837   +2.3874   13.887   1.4862E-04

QUOTED_STRING
"<any character>"
  example:
   "my quoted string"

SQUOTED_STRING
'<any character>'
  example:
   'my single quoted string'

IDENTIFIER
<one or more of [ a-z A-Z ]><zero or more of [ a-z A-Z 0-9 _ ]>
  example:
   Var1    object_Name_02

VARIABLE
$<one o more of [ a-z A-Z 0-9 ]><zero or more of [ a-z A-Z 0-9 _ ]>
 

example:
   $1   $var_02    $1b


STRINGVAL
<one or more of [ a-z A-Z 0-9 -_ $ ? @ | ~ % & / = : + \ # ' ]>
  a string not recognized as identifier

PATTERNIDENTIFIER
<a string with * (match 0 or more characters) and ? (match 1 character) wildcards>
  example:
   mypa*er?_ide?ti*

© 2008-2015 MS Enterprise Solutions | Website Templates by IceTemplates.com
Please Read: Privacy Policy and Terms of Use