StartForm

You can use this function for Optiva Workflows and Equations.

Purpose

Opens an Optiva form.

Syntax


Dim variable As Long = StartForm(FormName[, Object, Arguments ])

Arguments

Part Description
FormName Optiva name for a form. In Optiva, the form name begins with frm.
Object Optional. Object key to be opened in the form. Do not include an object code here, if you want the object for the workflow to open in the form.
<arguments> Optional. String.

Depends on the form being opened. Most forms do not require additional arguments.

When you open the Compare form, add a semicolon-delimited list of string values. The order of the values is:
  • Symbol of the base compare object
  • Object (key) of the base compare object
  • Symbol of the objects in the compare list
  • One or more objects (keys) to include in the compare list

Use the VERIFY.FORMULA_BTN profile attribute to specify a workflow to use for opening the Compare form from the Verify button in the Formula form. See the Infor Optiva Application Configuration Guide.

When you open the Project Management form, add a semi colon-delimited list of string values. The order of the values is:

  • WipId of the action wip that you want to manage.
  • The symbol of the object that you want to manage.

If you do not specify a symbol, PROJECT is the default symbol.

Description

StartForm opens a form. Use it in the VIEW and EDIT events. Use multiple statements to open more than one form at a time.

Item and formula examples

In this example, the Item form for TOMATOES opens. 


Dim lOpen As Long = StartForm("frmitem","TOMATOES")

In the next example, the Formula form for the current formula opens. 


Dim lOpen As Long = StartForm("frmformula")

In this example, formula FS-0008\0002 is the base formula that is compared to these specifications: FS-0008-FOR\0002 and FS-0008-PKG\0002. 


Dim lOpen As Long = StartForm("FRMCOMPARE", "", "FORMULA;FS-0008\0002;

SPECIFICATION;FS-0008-FOR\0002;FS-0008-PKG\0002")

Two action sets are available in the Optiva seed database in the Lookup by Sets lookup. You can use them to open the Compare form.

You can open the form using the Verify button in the Formula toolbar.

  • VERIFY_FMLA_SPEC (i.e., the default).

    Any specifications on the References tab of the open formula are automatically populated into the Compare List of the Compare form.

  • VERIFY_FMLA_PARENT

    Determines whether the open formula has a parent formula. If it does, the parent is set as the base formula and the open formula as the first line in the Compare List. If the open formula has no parent, then this action set behaves the same as the VERIFY_FMLA_SPEC action set.