ARSperl Programmer's Manual - ars_CreateVUI

## `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