$ude

Perform actions on Repository data and resources, including compiling, exporting, importing, and converting.

Example: $result = $ude("copy", "misc", "myexportfile.xml", "def:")

Processing Information and Error Handling

$ude is usually used as a batch processing function, so it is possible for errors to occur either in executing $ude itself, or while processing an operation that it invokes. For example, if you specify an import file that does not exist, $ude itself returns an error -1718.

However, if $ude returns 0, this indicates the $ude executed successfully, but does not indicate that the operation itself succeeded. For example, the following instructions could all result in 0 being returned, but the reasons may vary:

• vReturn = $ude("import", "misc", "myexport.xml","","supersede=false,"")

  Returns 0 if the contents of myexport.xml are already in the Repository.

• vReturn  = $ude("export", "component", "myf*","")

  Returns 0 if no components matched the profile.

• vReturn  = $ude("compile", "form", "my*","")

  Returns 0 if the forms matching the profile were compiled, but also if no forms were compiled.

For more information, see $procReturnContext.

For example, if $ude("compile") successfully compiled the forms, $procreturncontext returns the following (formatted for readability):

Context=UDE compile;
InputComponents=2;
OutputComponents=1;
Infos=32;
Warnings=2;
Errors=1;
Details=
 ID=1016!!;
  MESSAGE=(Fields for) entity DEBUG not found in application model, generating now...!!;
  SEVERITY=Warning!;
 ID=1301!!;
  MESSAGE=Component variable "LNR" is not referenced in the component.!!;
  SEVERITY=Info!;

However, if $ude("compile") executed successfully but no forms were compiled, $procreturncontext returns the following:

Context=UDE Compile

This could be because no forms matched the profile.