› User interface › Forms › Build forms › Build an MFP scan create new job form

Build an MFP scan create new job form

An MFP Scan create new job form allows you to scan documents and create jobs on MFP-friendly scan activities.

You can generate a Scan create new job form on one or more processes. You can generate more than one MFP Scan form for a process, provided the form names are different.

The process initialization variables associated with the processes appear as corresponding controls on the generated forms.

The generated MFP scan create new job form contains the following buttons by default: Scan (scan, submits, and completes the activity), Scan Settings (opens the Scan settings page), and Cancel.

You can open and edit the forms in the design view. See Open and modify a form.

  • You can only create the Tablet version (default) of this form.

  • You cannot generate this form if the process map has the same name as the document type or folder.

  • The Embedded page and File upload controls are not available for a Scan create new job form.

You can highlight invalid fields when creating a job using the MFP scan create new job form. When the MFP scan create new Job form is generated, the validate action called on a field uses the return values of the validate method to set the "ErrorMessage" and "isValid" properties on the input controls. On clicking a button that has the "Causes validation" property enabled, any invalid fields are highlighted, and an error message is displayed.

  1. Navigate to User interface > Forms.
  2. On the Generate list, select MFP scan create new job form.

    Alternatively, select Generate MFP scan CNJ form on the context menu of the process for which you want to build the form.

    The MFP scan create new job form dialog box is displayed.

  3. Select the Process to use and associate with the form.

    When you generate a form on a process that exists in GitHub and the process is not checked out to GitHub or checked out with another user, a warning message appears. When you click OK, an MFP scan create new job form is generated without increasing the process version.

    You can only select a process map that is capture-enabled. See Capture properties of a process.

  4. By default, the form name appears in the Form name field as the process name suffixed with MFPScan. For example, if the process name is LoanApproval, the form name appears as LoanApproval_MFPScan. However, you can modify the name of the form.
  5. By default, the Category is the same category that the process belongs to. However, you can update the category of the form.
  6. Click Generate and save to save the generated form.

    Alternatively, click Generate and release to release the form.

    • For an MFP scan create new job form, the CreateNewJob, FireScannedEvent, RedirectToOrigin and Scan and ScanSettings actions are available by default. The CreateNewJob and Scan actions are associated with the StartButtonPressed event on the form. The FireScannedEvent and RedirectToOrigin action are associated with the ScanComplete event on the form.

    • The ScanStatus variable is available by default.

    • When an MFP user cancels a scan, or when an upload fails, the ScanFailed event is raised.

Edit an MFP scan create new job form

Once an MFP scan create new job form is generated, you can open the form in Design view and edit it.

  1. Navigate to User interface > Forms.

    The Forms page appears.

  2. On the list of MFP scan create new job forms, click the form to open.
    The form opens in a new browser tab. The existing properties of the form are displayed in the properties panel. See Form properties.
  3. Make changes as needed.
  4. Save and close the form.

    You can copy, delete, unlock, regenerate a form, view form versions, debug and also view associations in a form.