Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page has been replaced with References and will be archived shortly.

Cross references can be created via the Structure View in Lawmaker or using the Tag x-refs feature.  In both cases, Lawmaker will create a reference to the target provision so that if it changes, e.g. through renumbering, promotion, demotion or deletion, the system can detect the change and either update the reference to show the change or flag that the reference has become invalid.

...

To create a cross-reference using the Structure View:

  1. Right-click on the provision in the Structure view you want to refer to (you may want to turn on full-depth mode to see all provisions - see Using the structure view).

  2. From the context menu that appears, select the reference you want to copy from the Select x-ref to copy sub-menu. The menu will show all the different options for referring to the provision so you can select whether or not you want the provision name (e.g. “section”) to be included and whether any ancestor provisions should be included in the reference.

  3. This will place the selected cross-reference in the clipboard.

  4. To insert the reference, place your cursor in the Editor where you would like the cross reference to be inserted and press Ctrl+v to paste in the reference.

Info

In SI/SSIs, Lawmaker will determine whether a provision should be referred to in the reference as a “sub-paragraph” or “paragraph” depending on the provision’s context.

...

If nothing has been selected before you trigger the update then you’ll be given the option of updating references in the current provision (i.e. the current section, article, regulation etc.) or the whole document. Otherwise, Lawmaker will update all references in your selection.

...

.

Both valid and invalid references will be updated. If Lawmaker can no longer find the target of valid reference in the current document then it will change the reference’s status to invalid. Equally, if Lawmaker finds the target of an invalid reference then it will change the reference’s status to valid.

Tagging and updating cross-references when editing a portion of the document

If you have a portion of a document open in the Editor (see Opening and editing a portion of document) and you use the Tag x-ref or Update x-refs feature, Lawmaker will detect when references in the portion do not point to other provisions within the portion and give you option to search the whole document rather than just the portion.

This will take longer than just searching the portion but will mean that references to other parts of the document are tagged and updated correctly instead of being marked as invalid references.

Showing j-refs as part of cross-references

You can make the Editor and any PDF generated show the j-ref of target provisions within cross-references. See Managing J-refs for more about this.

Inserting and updating cross-references between documents within Lawmaker

...

A cross-reference can have one of four statuses. The styling of the reference in the Editor changes to indicate its status. Invalid references are also highlighted in the Document Checks panel.

Status

Styling

Notes

Valid

Orange text

The

system

target provision has been identified

the text to be a cross reference

and

has created a mapping to the corresponding target provision

the citation should update correctly when you update x-refs.

Invalid

Grey highlighted text

The

system has identified the text to be a cross reference but has been unable to find the corresponding

target provision cannot be found in the document.

Users can choose to ignore the invalid cross reference if they knew the target provision hadn’t been written yet.

Or, if the target provision did not exist in the current document (an external x-ref) and the system failed to identify it as such, the user can update the cross reference’s status to ‘ignore’ which means the system will no longer attempt to update the cross reference following an ‘update x-ref’ operation. (in future, pattern matching will be continually refined to minimise this occurrence

(It may, however, exist in another document.)

Can’t resolve

Black text with orange highlight

The system has located

Lawmaker can find the target provision but

has identified that it has either been promoted or demoted and highlights it to the user.Users will have to redo the cross reference for it to become ‘valid’ again (in future the system will attempt to update the cross reference to reflect the promotion/demotion change)

is unable to update the reference text automatically. This is usually because the target provision has changed in some way, e.g. it has be promoted or demoted.

To fix this, it is generally best to remove the existing reference and either re-tag the reference if it remains correct or insert a new reference using the Structure View.

Ignore

Purple text with dotted grey underline

The

user has manually updated the cross-reference’s status to ‘ignore’ so that the system no longer attempts to update the x-ref following an ‘update x-ref’

reference text of this cross-reference will not be updated as part of an Update x-refs operation.