Versions Compared

Key

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

Introduction

To insert a Part, Chapter or other “grouping” level around existing provisions like sections, you need to use the wrap function.

To remove a Part, Chapter or other “grouping” level without removing the provisions witin within the Part etc., you use the unwrap function.

...

  1. Select the provisions you want to wrap

  2. Either:

    • right-click within the selected provisions in the structure view or the Editor and select Wrap element…,

    • from the toolbar select Tools>Wrap element… or

    • use the keyboard shortcut Alt+w.

  3. Select from the menu that appears the element (e.g. Part) that you want to wrap the provisions with.

To select the provisions you want you can either:

The system will attempt to acquire a lock on the appropriate document fragment if it hasn’t got one already and then will insert the selected grouping-level provision, wrapping it around the selected lower-level provisions to create valid XML

The following tables show the provisions that can be ‘wrapped’ and the specific rules governing when they can be inserted.

In bills (including Acts)

...

Selected provisions being wrapped

...

Wrap option

...

Rules

...

Part

...

Group of Parts

...

If the part isn’t already within a group of parts

...

Chapter

...

Part

...

If the chapter isn’t already within a part

...

Cross heading

...

Part

...

If the cross heading isn’t already within a part

...

Cross heading

...

Chapter

...

If the cross heading isn’t already within a chapter; and the cross heading is within a part

...

Section

...

Cross heading

...

If the section isn’t already within a cross heading; and the section is within a part, chapter or when section has no upper-level grouping provisions.

...

Section

...

Part

...

If the section isn’t already within a part

...

Section

...

Chapter

...

If the section isn’t already within a chapter; and the section is within a part

...

Chapter (in a schedule)

...

Part

...

If the chapter isn’t already within a part

...

Cross heading (in a schedule)

...

Part

...

If the cross heading isn’t already within a part

...

Cross heading (in a schedule)

...

Chapter

...

If the cross heading isn’t already within a chapter; and the cross heading is within a part

...

Schedule paragraph

...

Cross heading

...

If the schedule paragraph isn’t already within a cross heading; and the schedule paragraph is within a part, chapter or when the schedule paragraph has no upper-level grouping provisions

...

Schedule paragraph

...

Part

...

If the schedule paragraph isn’t already within a part

...

Schedule paragraph

...

Chapter

...

If the schedule paragraph isn’t already within a chapter; and the schedule paragraph is within a part

In SI/SSIs

...

Selected provisions being wrapped

...

Wrap option

...

Rules

...

Part

...

Group of parts

...

If the part isn’t already within a group of parts

...

Chapter

...

Part

...

If the chapter is within a part; but not already within a chapter

...

Section

...

Part

...

If the Section isn’t already within a part

...

Section

...

Chapter

...

If the Section is already within a Part but is not within a chapter

...

Sub-section

...

Part

...

If the Sub-section isn’t already within a part

...

Sub-section

...

Chapter

...

If the Sub-section is within a Part but isn’t already within a chapter

...

Sub-section

...

Section

...

If the Sub-section is within a Part and/or Chapter but isn’t already within a Section

...

Cross heading

...

Part

...

If the cross heading isn’t already within a Part

...

Cross heading

...

Chapter

...

If the cross heading is within a Part but isn’t already within a Chapter

...

Cross heading

...

Section

...

If the cross heading is within a Part and Chapter but isn’t already within a Section

...

Cross heading

...

Sub-section

...

If the cross heading is within a Part and/or Chapter and/or Section but isn’t already within a Sub-section

...

Regulation (or article etc.)

...

Part

...

If the Regulation isn’t within a Part

...

Regulation (or article etc.)

...

Chapter

...

If the Regulation is within a Part but isn’t already within a Chapter

...

Regulation (or article etc.)

...

Section

...

If the Regulation is within a Part or Chapter but isn’t already within a Section

...

Regulation (or article etc.)

...

Sub-section

...

If the Regulation is within a Part of Chapter or Section but isn’t already within a Sub-heading

...

Regulation (or article etc.)

...

Cross heading

...

If the Regulation is within a Part or Chapter or Section or Subsection but isn’t already within a cross heading

...

Sch Chapter

...

Sch Part

...

If the chapter is within a part; but not already within a chapter

...

Sch Section

...

Sch Part

...

If the Section isn’t already within a part

...

Sch Section

...

Sch Chapter

...

If the Section is already within a Part but is not within a chapter

...

Sch Sub-section

...

Sch Part

...

If the Sub-section isn’t already within a part

...

Sch Sub-section

...

Sch Chapter

...

If the Sub-section is within a Part but isn’t already within a chapter

...

Sch Sub-section

...

Sch Section

...

If the Sub-section is within a Part and/or Chapter but isn’t already within a Section

...

Sch Cross heading

...

Sch Part

...

If the cross heading isn’t already within a Part

...

Sch Cross heading

...

Sch Chapter

...

If the cross heading is within a Part but isn’t already within a Chapter

...

Sch Cross heading

...

Sch Section

...

If the cross heading is within a Part and Chapter but isn’t already within a Section

...

Sch Cross heading

...

Sch Sub-section

...

If the cross heading is within a Part and/or Chapter and/or Section but isn’t already within a Sub-section

...

Schedule paragraph

...

Sch Part

...

If the Schedule Paragraph isn’t within a Part

...

Schedule paragraph

...

Sch Chapter

...

If the Schedule Paragraph is within a Part but isn’t already within a Chapter

...

Schedule paragraph

...

Sch Section

...

If the Schedule Paragraph is within a Part or Chapter but isn’t already within a Section

...

Schedule paragraph

...

Sch Sub-section

...

If the Schedule Paragraph is within a Part of Chapter or Section but isn’t already within a Sub-heading

...

Schedule paragraph

...

Sch Cross heading

...

If the Schedule Paragraph is within a Part or Chapter or Section or Subsection but isn’t already within a cross heading

...

Schedule paragraph

...

If the Schedule Paragraph is within a Part or Chapter or Section or Subsection but isn’t already within a cross heading

Info

Hints and tips

There are certain restrictions in place to stop you wrapping elements without the correct structure in place e.g. you cannot wrap a set of sections within a Chapter unless they are already wrapped within a Part

Check the structure view once you’ve wrapped your specified provisions to double-check that they have been correctly ‘wrapped’ (looking for a parent/child relationship)

How to unwrap provisions

Place your cursor in the provision you wish to remove through an ‘unwrap’ function:

  • Right-clicking on the provision in the Structure view or Editor view, or

  • Using the keyboard short-cut Alt + e

  • Select ‘Unwrap element’

The system will attempt to acquire a lock on the appropriate document fragment if it hasn’t got one already before it will remove the provision from the document, leaving behind the child provisions

As well as ‘wrap’ it is possible to ‘unwrap’ provisions.  This is when you want to remove a higher-level grouping provision e.g. a part which contains a set of sections/regulations, without deleting the sections/regulations. 

An ‘unwrap’ operation can be performed on the following provisions:

  • Group of parts

  • Part

  • Chapter

  • Sections (for SIs only)

  • Sub-sections (for SIs only)

  • Cross heading

  • Sch Part

  • Sch Chapter

  • Sch Cross heading

  • Sch Sections (for SIs only)

  • Sch Sub-sections (for SIs only)

...

Hints and tips

If you unwrap a part and there is already a part left in the document, the provisions that were in the removed part will move into the remaining part

If the grouping level being unwrapped has siblings:

  • If it was the first sibling – the child provisions will be automatically moved into the second sibling

  • if it was second or later sibling – the child provisions will be automatically moved into the previous grouping level sibling

...

Info
  • Lawmaker will only show the elements that you can validly wrap the selection in. This will depend on the document type and the provisions you have selected but can also depend on the parent provisions, e.g. you can only wrap provisions in a Chapter if they are already within a Part. You can’t wrap provisions in an element they are already wrapped with, e.g. provisions already within a cross-heading cannot be wrapped in a cross-heading.

  • To wrap provisions, Lawmaker will take a lock on the parent of those provisions. If it can’t get a lock (because someone else is editing the parent) then you won’t be able to complete the wrap operation.

Selecting provisions to wrap

To select the provisions you want you can either:

  • Select the provisions in the structure view - see Using the structure view.

  • Highlight the provisions in the Editor by dragging your cursor from the beginning to the end of them (or vice versa).

How to unwrap provisions

To unwrap provisions do one of the following:

  • Right-click on the grouping level provision you want to remove in the Structure view and select Unwrap element.

  • Right-click on the provisions in the Editor and select Unwrap element.

  • Use the keyboard shortcut Alt+e.

This will remove the grouping level provision but not the content within it, e.g. if you unwrap a Part then the Part will be deleted, but not any sections within the Part.

When you unwrap a provision, Lawmaker will move the existing contents of that provision into another sibling provision if it exists so as to maintain a valid document structure:

  • If the unwrapped provision was the first of its kind, its contents will be moved to the next provision of the same kind, e.g. if you unwrap the first Part in a document, then the contents of that Part will be moved to the beginning of what was the second Part.

  • if the unwrapped provision was the second or later one of its kind, its contents will be moved into the previous provision of the same kind, e.g. if you unwrap the last Chapter within a Part then the contents of that Chapter will be moved to the end of the previous Chapter.

Note

It is possible sometimes by unwrapping a specific provision to create an invalid document structure, e.g. in some cases by unwrapping a Part that contains Chapters. You will see a warning about this in the Document Checks panel. To fix the issue, you may need to unwrap further provisions.

Wrap options

The following tables summarise the wrap options dependent on your selection.

Bills and Acts

Selected provision(s)

Wrap option (depending on context)

Part

Group of Parts

Chapter

Part

Cross heading

Part, Chapter

Section

Part, Chapter, Cross heading

Schedule paragraph

Part, Chapter, Cross heading

SIs and SSIs

Selected provisions(s)

Wrap option (depending on context)

Part

Group of parts

Chapter

Part

Section

Part, Chapter

Sub-section

Part, Chapter, Section

Cross heading

Part, Chapter, Section, Sub-section

Regulation (or article etc.)

Part, Chapter, Section. Sub-section, Cross-heading

Schedule paragraph

Part, Chapter, Section, Sub-section, Cross-heading

Provisions that can be unwrapped

You can unwrap the following provisions:

  • Group of Parts

  • Part

  • Chapter

  • Section (SI/SSIs only)

  • Sub-section (SI/SSIs only)

  • Cross-heading