ars_CreateVUI(ctrl, schema, vuiHash)

This function creates a new VUI. You must first populate the vuiHash before calling this routine.

schema is the name of the schema containing the VUI.

vuiHash is an VUI Attributes hash.

On success
Returns 1
On failure
Returns 0

Example:

This example copies an existing VUI to a new VUI. I.e. it simply re-saves the VUI link under a new name.
      ($v = ars_GetVUI( $c, "Schema", $vuiId )) ||
	    die $ars_errstr;
      $v->{vuiId}   = $v->{vuiId} + 100000;
      $v->{vuiName} = "Copy of ".$v->{vuiName};
      ars_CreateVUI( $c, "Schema", $v ) || die $ars_errstr;
      
Notes: Hash keys helpText, owner and changeDiary are optional when calling this routine.

This function was introduced in version 1.90 of ARSperl

<-- Back to Table of Contents