This article gives step by step instructions on how to prepare your forms for a record rollover
To access this feature, the Record Rollover Wizard page right is required. A role will also need the Form Manager to flag forms with the rollover style.
Step 1: Determining Which Fields Should Not be Cloned if a Cloning Rollover is Selected
What is a “DoNotClone”?
A
DoNotClone is a flag that can be applied to fields or tabs on a form to
prevent their values from being copied into a cloned record. This
usually includes fields that have signatures, notifications, dates,
fields that only apply to this year’s record, etc.
Signatures: You
should apply a DoNotClone to all signature fields. This is to prevent a
digital signature from existing on a record that the signer has never
viewed.
Notifications: You
should apply a DoNotClone to all notification fields as this will
prevent the appearance that a notification was sent for the newly cloned
record.
Finalization Sections / Locking Triggers: Since
these fields control whether a record is locked (which means a read
only status is applied to the entire record which prevents users from
being able to edit the records), adding a DoNotClone to Finalization
Sections / Locking Triggers is required to prevent the newly cloned
record from being locked.
Functionality: A DoNotClone should be applied to any field that is related to a
JavaScript workflow functionality that shouldn’t contain a value when a
record is cloned. Examples of this could be checkboxes that trigger
disabling functionality, elements that store information related to
other fields that are already set to DoNotClone, and hidden fields that
are used to store information for workflows.
Fields That Only Apply to a Specific Year: DoNotClones are often used on fields or tabs of a form where it doesn’t make sense to have the information copied because the data within the field only applies to the current school year.
If the data in the field is irrelevant for next year, will be replaced
by new data, or will be time consuming for users to manually remove,
then a DoNotClone would apply.
Why Configuring “DoNotClones Before the Rollover is Important
Record Rollovers use DoNotClones for the reasons noted above. When a record is rolled over, sections that do not have a DoNotClone are copied into the new records. All fields flagged with a DoNotClone will be blank when the record is copied.
How to Identify Fields that have been Flagged with “DoNotClone”
The Record Rollover Report will help you to identify all of your forms that are flagged for Record Rollover as well as the fields that are configured with DoNotClones.
From the clevr Navigation Menu > Go to the Configuration menu > Record Rollover Report:
clevr will open a separate tab in your browser indicating that it is generating the report.
Once the report has been created, the additional tab will close and the Record Rollover Report will be downloaded onto your computer.
Tenant Name: Displays the name of your clevr tenant which is the name of your district/division.
Form Name: This field identifies the name of the form. The form name will only
appear on the report if it has been flagged with a Record Rollover type.
Create New Record: This field will identify if a new record for the form will be created during the Record Rollover Process.
- True: Indicates that a new record will be created for the specified form
(this will be true if the form is flagged for a New Record style
rollover or a Cloned Record style rollover).
- False: Indicates that a new record will not be created for the form after it
has been rolled over. This will appear for locked style Record Rollovers
where a new record will not be created.
Copy Existing Data: This field identifies if the form is tagged with a cloning style Record
Rollover and if data from last year’s record will be copied over to the
new record.
- True: Indicates that the data will be copied to over to the new record with the exception of fields tagged with DoNotClone.
- False: Indicates that the data from the old record will not be copied to the new record.
DoNotClone Fields: The fields identified here are fields that have been flagged with DoNotClone in the specified form.
To access this feature, the Form Management and Editor page rights are required.
We're here to help! Please contact us at
support@clevr.ca if you do not have access to the
Clevr Editor or if you would like our team to configure these fields for you
Field(s)
and/or tab(s) that are flagged with a DoNotClone attribute will not
carry over the data within them when the form is copied during the
Record Rollover process – any fields flagged with “DoNotClone” will be
blank when the record is copied. Adding a “DoNotClone” is ideal for fields that will not apply to next year’s
record, saving users from being required to delete the content manually
within the field when updating the cloned record.
The
“DoNotClone” attribute works on individual elements and on parent
containers and can be applied to the form using the clevr Editor.
To edit a specific form, you can select the form name within the Form Management module to open the clevr Form Editor. From the clevr Navigation Menu select the Configuration menu > Form Management module and select the name of the form that you wish to update.
In the Form Details page, click on the Design Form button at the top right of the screen.
This will open the clevr Form Editor allowing you to configure fields that should have a “DoNotClone” applied.
When applied to a field, the “DoNotClone” attribute will cause the field(s) or tab(s) to be blank when a record is cloned. This is perfect for forms that are cloning style Record Rollover candidates. Use “DoNotClones” on
fields that do not apply to next year’s record to save users from
needing to manually delete the information – this can be cumbersome when
there is a lot of data within the record.
The “DoNotClone” attribute works on individual elements and on parent containers. Select the element you’d like to apply the “DoNotClone” to, then enter the DoNotClone attribute on the left with the right side value of true. Hit enter to save the attribute.
You should also include a description so that the fields with “DoNotClones” will have a name appear within the Record Rollover Wizard and Rollover Reports. If you do not assign a description, fields with “DoNotClones” applied to them will will display the element ID number instead of a name within the Rollover Reports.
Important Things to Consider
- “DoNotClone” will not propagate to subtabs. You must apply
“DoNotClones” to each subtab on the form individually on each parent
container (97) in the tab set.
2. When a “DoNoClone” has been applied to a parent container, all child
elements will be blank when the clone is made. There is no way to
exclude “DoNotClone” from a child element if the parent container has a
“DoNotClone”
attribute. If you need a single element to still clone in a
container, it will have to be applied individually to each field as
required, versus the full container.