LogoLogo
ClausesDatafieldsSpecial FunctionsStylingQ&AAPI
  • Welcome!
  • Getting started
    • What is Clause9?
    • Structuring your clause library
    • Structuring your clauses
    • Drafting modes in Clause9
    • Creating a questionnaire
    • Sample clauses
    • Videos
      • Concepts and datafields
      • Conditions
      • Q&As
      • Binders
      • Styling
      • Enumerations
      • Tables
      • Definitions
      • Snippets
      • Cross-references
      • Special functions
      • Examples of common clauses
      • Import clauses from MS Word
      • Grammatical conjugations
      • Action buttons
      • Alternative clauses
  • Assemble document
    • Document toolbar
    • Clause hierarchies
    • Focus Mode
    • Bulk generation of documents
    • Exporting documents
    • Assemble Document - FAQ
    • How to: Assemble Document
      • Insert images
  • Assemble Document Operations Panel
    • Operations panel
    • File pane
    • Edit pane
    • Document pane
    • Binder pane in the operations panel
    • Search pane
    • Browse pane
    • Terms pane
    • Data dashboard
    • Advanced pane
    • Styling pane
    • Miscellaneous pane
    • Visibility settings & actions menu
  • Binders
    • Binders: general
    • Styling cross-references to subdocuments
    • Global and local definition lists
    • Document and binder properties
    • Styling of a Binder versus subdocuments
    • (Un)locking documents in a binder
    • Binders - FAQ
    • How to: binders
      • Make a subdocument in a binder conditional
  • Clauses
    • Introduction to clauses
    • Clause structure
    • Grammar sheet
    • Writing conditions
    • Examples of conditions
    • Using codes instead of text fragments
    • Bold, italic and underline
    • Special codes
    • Enabled?
    • Links
    • Cross-references
    • Introduction to tables
    • Deviating table styling
    • Shrinking clauses
    • Action buttons
    • Enumerations
    • File position
    • Snippets
    • Parameters
    • Conjugations
    • Mixing data types
    • For-loops
    • Clause versioning
    • Abstract article references
    • Advanced multi-language features
    • Clauses - FAQ
    • How to: clauses
      • Create an ad-hoc clause
      • Create a library clause
      • Make a clause repeat
      • Make a paragraph within a clause conditional
      • Use a shortcut to refer to a concept
      • Insert a line break or page break
      • Creating a list with both predefined options and free input
      • Defining alternative clauses
      • Creating cross-references
      • Creating signature blocks
      • Creating advanced party introduction clauses
      • Automatically numbered annexes or schedules
      • Reuse any clause in a different context
      • Setting MS Word document properties
      • Add action buttons to clauses
      • Electronically signing documents
  • concepts
    • Introduction to concepts
    • Creating concepts
    • Concept labels
    • Links
    • Organising concepts
    • Concepts - FAQ
    • How to: concepts
      • Add predefines to a datafield
  • Datafields
    • Introduction to datafields
    • Types of datafields
    • Rules of thumb for using datafields
    • Data-expressions
    • Datafield aliases
    • Datafield labels
    • Datafield special tags
    • Datafield descriptions
    • Repeating list datafields
    • Datafield predefines
    • Datafields - FAQ
    • How to: datafields
      • Change datafield type
      • Change the datafield's name or alias
  • Definitions
    • Introduction to definitions
    • How to: definitions
      • How do definitions work?
      • Create a definition
  • Files
    • How files are organised
    • Browse files
    • File types
    • Custom styling
    • Legal comments
    • File description
    • Attributes
    • Reporting
    • File name
    • File category
    • Access rights
    • How to: files
      • Creating advanced folders
      • Naming your files
      • Shortcuts to folders or files
  • Q&A
    • About cards
    • Cards pane
    • About changes
    • Changes pane
    • Types of changes
    • Adding conditions
    • Question options
    • Copying & pasting answers
    • Comments, notes & documentation
    • Interactive Q&A inspection
    • Embedding questions into a document
    • “Changes” button
    • Batch create pane
    • Identifiers pane
    • Import pane
    • Edit clauses pane
    • Q&A options
    • Q&A - FAQ
    • How to: Q&A
      • Create predefined answers to a question
      • Add disclaimers
      • Create categories of questions
      • Modify the exported filename
      • Create a question to change the language of a document
      • Send a questionnaire to someone without a ClauseBase account
      • Create questions for repeating list datafields
      • Selecting legal entities & addresses
      • Create a questionnaire using "batch create"
      • Launch other Q&As
    • Leveraging ClauseBuddy Smart Templates in Clause9
  • Import
    • Introduction to importing clauses
    • Uploading clauses
    • Defined terms in Import mode
    • Datafields in Import mode
    • Cross-references in Import mode
    • Assigning folders
    • Conversion process
    • Exporting
    • Stashing intermediate results
    • Tips, tricks & limitations
  • Styling
    • Styling overview
    • Base styling
    • Numbering
    • Definitions styling
    • Enumerations styling
    • Locale styling
    • References styling
    • Page styling
    • Styling of a Binder versus subdocuments
    • Styling: tips and tricks
    • Advanced styling topics
    • Copying headers and footers from an MS Word file
    • How to: styling
      • Using custom fonts
      • Change bullet styling
  • Special functions
    • Introduction
    • Calculations
    • Concepts
    • Conditions
    • Conjugations
    • Content Control Elements
    • Datafields
    • Dates & durations
    • Languages
    • Lists
    • Numbers
    • References
    • Repeating (looping)
    • Special items
    • Text structure
    • Text modification
    • User
    • Q&A
  • Settings
    • Account
    • Preferences
    • Access bundles
    • Favourites
    • Saved searches
    • Saved datafields
    • Styles
    • Default styles
  • Admin
    • General
    • Users
    • User rights
    • Profiles
    • Groups
    • Styles
    • Default styles
    • Attribute models
    • Usage page
    • Custom homepage
    • Global placeholders
    • Access rights
    • How to: admin
      • Adding a new user
      • Disabling a user
      • Managing group memberships
  • Miscellaneous
    • Advanced tips & tricks
    • Typing special symbols on your keyboard
    • Shortcuts
    • Grammar style guide
    • Inserting MS Word files
    • Globo-panel
    • Creating high-quality documents
    • Excel calculations and lookups
  • Integrations
    • Overview
    • Spreadbases
    • E-signing documents
    • Drag & drop integrations
  • For developers
    • Clause9 API
    • Custom functions
    • Example custom functions
Powered by GitBook
On this page
  • Choosing the folder where to store the converted clause
  • Other points of attention during conversion
  • Errors during conversion
  • Removing and re-applying conversions
  • Color codes for converted clauses
  • Dealing with definitions
Export as PDF
  1. Import

Conversion process

PreviousAssigning foldersNextExporting

Last updated 1 year ago

Converting the clauses to Clause9 grammar

Once you have altered the structure of the clauses, and optionally assigned defined terms, datafields and subfolders, you are ready to actually convert clauses into the Clause9 grammar.

In order to convert an individual block, you first have to select it, by clicking on the grey dot that appears at its left side when you hover over a block.

You can only select blocks that are specified to be converted into a separate file (as visually indicated by a dotted top border. If you cannot select a certain block, then this block will get converted as part of a (grand)parent block.

When you click this button, Clause9 will perform the conversion and show the familiar content editor inside the

Choosing the folder where to store the converted clause

You will probably want to specify the subfolder in which this clause will get stored, by choosing the relevant folder from the popup-list. If you do not choose a subfolder, then the clause will get stored in the top-level folder.

“Child” clauses will automatically end up in the same subfolder as their “parent” clause, unless you choose a(nother) subfolder for the child clause.

Other points of attention during conversion

  • Defined terms are converted into #hashtags, with their associated article removed. Those #hashtags get an initial capital when necessary.

  • Associated articles are removed, but may get integrated into the defined terms, in different ways:

    • “this” (French: “ce / cette / ces”, Dutch: “dit / deze”) will get converted into #°hashtag

    • Undefined articles (English: “a / an”, French”: “un / une / des”, Dutch: “een”) will get converted into #?hashtag.

    • Defined articles (English: “the”, French: “le / la / les”, Dutch: “het / de”) will get converted into #hashtag, unless those articles were forced to get converted into a defined article, because the user alt-clicked (Option-clicked on Mac) on the article. In such case, the article will get converted into #+hashtag.

  • The original clause numbers are replaced by 1., 2., or sub-articles thereof (1.1, 1.2, etc.).

  • The filename of a clause will be generated on the basis of the first 10 words of the contents. The filename of a definition will be the name of its Concept.

  • When the converted clause is the target of a cross-reference, and a Concept is associated with that clause, then an implementation link will be included in the links section.

Errors during conversion

When errors occur, you will get an error message at the bottom of the screen.

When errors occur, you will get an error message at the bottom of the screen.

Error
Description & solution

Missing Concept for a defined term

Missing cross-reference

When your original MS Word document refers to a certain clause (e.g., clause 2.1), but you did not associate that target clause with a certain implementation Concept, the cross-reference will be converted into §#xxx-undefined-term-xxx.

To resolve this error, you can either add an implementation Concept to the target clause (through the editor), or manually edit the §#xxx-undefined-term-xxx in the Clause9 grammar (e.g., refer to some other Concept, or remove it).

Grammatical errors

If your source document contains characters that have a special meaning in the Clause9 grammar — e.g., [square brackets] or {curly parentheses} — then these characters may cause errors. You will have to manually resolve these errors by editing the text.

Removing and re-applying conversions

If you are no longer interested in converting a block to Clause9 grammar, you can click on the button. The block when then no longer be included in the list of exported clauses.

Color codes for converted clauses

  • blocks that have not yet been converted, have a thick grey left border — see clauses 3. and 3.1 in the screenshot above

  • blocks that will not get converted into a separate file (and will thus end up within the same file as their parent), will have a thin grey left border — see clause 3.1.1 in the screenshot above

  • blocks that are successfully converted, and have been assigned to a specific subfolder, will get a green left border

  • blocks that are successfully converted, but have not been assigned a specific subfolder (so that they will end in their parent clause’s subfolder, or in the top-most folder), will get a blue border

  • blocks that have been unsuccessfully converted due to errors, will have a red left border

Dealing with definitions

However, it can become tedious to perform this conversion manually for an entire list of definitions. Clause9 therefore provides special facilities for the bulk conversion of definitions contained in a definitions list of a contract:

  1. Find the clause that is the “parent” clause of all definitions. (Typically, this parent clause is either a just a title such as “Definitions”, or some subclause with introductory wording such as “In this clause, the following terms will have the meaning as set forth below.”)

  2. Convert the parent clause (e.g., by double-clicking on the small grey dot at the left of it.)

  3. Convert all the individual definitions (e.g., by double-clicking on the small grey dot at the left of the first definition, while holding Shift.)

During the automatic conversion to a definition, Clause9 will try to:

  • find the Concept to which the definition refers, by looking for a defined term in bold, between quotes, or with initial capitals;

  • set the filename of the definition file to the name of the Concept; and

  • remove unnecessary initial wording in the clause — e.g., a clause that states “The term “Account” shall mean the combination of username and password” will be truncated to “the combination of username and password”. (When this definition is later on used in a Clause9 definition list, the name of the Concept and the truncated bridge wording may get reinserted, depending on the styling setttings defined by the user of the definition.)

The will now show a green button that invites you to convert the selected block:

Instead of clicking on a clause to select it, and then clicking the button inside the , you can also double-click on the grey dot that appears when you hover over a block. If you hold down Shift when double-clicking, all sibling blocks will be converted as well. Accordingly, if you hold down Shift and double-click on any top-level block, all those top-level blocks will be converted at once.

Go to the editor, and choose a Concept for the defined term (or create a new one, or load a Concept from the database).

You may instead also be interested in re-applying the conversion. This can be useful when you received errors during your first conversion attempt. The re-applying can however also be useful when you converted the clause at a certain stage, but then later on made a few more modifications in the other editors — e.g., you may have changed the #hashtag of a certain Concept, or assigned a different Concept to a defined term or cross-reference. If you want to apply those modifications to existing conversions, you can either remove the conversion and re-perform the conversion, or perform both actions at once by clicking on the button in the top right corner of the , and choosing the “re-perform conversion” option from the pop-up menu that appears.

If your modifications were limited to loading certain Concepts, then you can instead choose the “reload Concepts”option in the pop-up menu. This will leave the converted text intact, and will only reload the list of Concepts within the .

To easily see how blocks are converted, Clause9 uses different color codes for their left border in the editor:

You can change any converted block from a clause to a definition, by clicking on the button in the top right corner of the , and choosing the Switch between definition & clause option. You will then have to manually choose the Concept for the definition.

Make sure that all the actual definitions are “children” of that parent clause. If necessary, perform some restructuring through the structure subpanel of the editor.

Make sure that each of the definitions will get its own file, by clicking on of the first definition while in the structure subpanel of the document editor. (Subsequently, all definitions will get a purple dotted top border.)

Click on the button in the top right corner of the clause editor for this parent clause, and choose “definitions list clause”.