| Section | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
Form requirements may change over time. What happens if you need to add or delete Searchable fields and you want your previous submissions to reflect your changes? Designers, tenant or superuser administrators or any user given the permission to edit a form can initiate a Refresh Searchable Fields process for a particular form. Once the process completes, previous new submissions will reflect the changes made to the Searchable Fields but to show them in previous submissions you must run the Refresh Searchable Fields process for your form.
For example, let's say you have an Invoice form with the First Name and Last name Name fields set up as searchable fields. You can search existing submissions or tasks by setting up a filter using the data in these fields.
.
Your users have requested the ability to search submissions and tasks by product name in addition to the First and Last name of the customer. . You must add the Product Name field to
- Login as a designer user or your production account if the form is deployed.
- Navigate to the Forms Home Page.
Add the Product Name control in your form to the Searchable Fields list using the Setup Searchable Fields wizard.
Expand title Click here to to see how to do that. Insert excerpt Form Setting Properties Form Setting Properties nopanel true - Follow these steps to run the Refresh Searchable Fields process.
- Click the
Refresh icon for the form you want to update.
- Information about previously run Refresh processes for the form display in a table.
- Starting and Ending date/Time of the process
- Status of the process - completed/failed/stopped
- The user id and name of the process initiator
- A description providing the Application/Form Name
- Click the
- Click Submit.
- The message "Index batch was successfully started" displays and the submitted process shows in the Refresh Process list table.
- Click the
- Click the
The Refresh Process can be stopped or abandoned once started.
Stopping the Refresh Searchable Fields Process
Once you have initiated the Refresh Searchable Fields process, the UI allows for the job to be stopped or aborted. The process can be stopped if it is in the STARTING or STARTED state.
You will notice a Stop column in the row in the table for the process that was started. To stop the job:
- Click the Stop icon
- Click Ok to confirm.
- When the process is stopped, the status column will update.
Restarting a Stopped Insight Data Batch Process
When the Refresh process runs, tables that store the state of the job are created in the frevvo database. By default, if a job were to fail or be stopped, starting the job again would restart the failed/stopped job from where it failed/stopped.
To restart a Stopped/Failed batch job, simply start the batch job again with same tenant and it will resume the last stopped job.
To prevent the last stopped job from restarting, change the status to Abandoned.
Abandoning the Insight Data Batch Process
The Refresh Searchable Fields process can be abandoned if it is not in the STARTING or STARTED state. The process must be stopped to mark it as abandoned. This prevents it from being restarted. You may want to abandon a batch job if it failed and restarting it would result in another failure. Abandoning the batch job allows you to start over again with a new process.
When you stop a batch process, you will notice Stop and Abandon columns in the row in the table for the process that was started. To abandon the job:
- Stop the Refresh Searchable Fields Process
- Click the
- Click Ok to confirm.
- The Refresh Job Status screen will update.
Assigning a Thumbnail Icon to a Form
...