Managing Truffle Hunt baskets
Last updated
Last updated
ClauseBuddy strongly encourages you to create different baskets (Truffle Hunt) — e.g., one for your Corporate Department, one for your Employment Department, and one private basket for each individual legal expert. For , you want to subdivide a department into such separate baskets.
Truffle Hunt allows you to create different "baskets" with documents & clauses — e.g., one for the Corporate department, one for Employment, one for IT/IP, and perhaps also a personal basket for every legal expert.
Creating different baskets is not only recommended to create a primary segmentation within your clauses (i.e., most of the time an employment lawyer is not interested in finding IP-related documents & clauses), but is also useful for compliance reasons and to ensure internal information rules are met.
Baskets can be managed by clicking on the "Manage" top of the screen. You will then see the following interface, containing a list of all your baskets at the left side.
To create a new basket, you click on the big green plus icon, configure it, and click on the Apply button.
The label should contain a friendly description of your locker/basket (e.g., "Commercial Templates" or "Mary Johnsson's Documents") — if relevant even translated into different languages.
When you activate the Allow upload by email? option, authorised users can upload documents by sending an email to the specified email address. See the separate section below for more details.
The primary way to get documents into Truffle Hunt is by dragging them onto the "Upload documents" button from your Windows Explorer or Mac Finder window. Alternatively, you can click on this button and select one or more documents through your operating systems' file selection dialog box.
Some tips & tricks:
You can drag multiple files at once. In fact, you can even drag an entire folder that contains subfolders, sub-sub-folders, etc. ClauseBuddy will completely ignore the folder structure and extract all your DOC/DOCX/PDF files from it.
There is a limit of 1000 files that you can drag in one go. Technically a basket can contain as many documents as you want, although in practice — to avoid noisy results — you will probably want to limit yourself to a few thousand documents anyway.
There is a limit of 15MB per file. PDF files are usually much larger, but you can get around this by converting the PDF file to Word and removing any images.
If you upload less than 20 files at once, then ClauseBuddy will process them in real-time for you, meaning that ClauseBuddy will send a file to the server, wait for it to be processed, and only then send the next file.
If you upload more than 20 files at once, then ClauseBuddy will transfer them all at once to the server. The server will then process these files in the background and send you an email once it's done.
Through the checkboxes above the "Upload documents" button, you can indicate whether you are interested in both the full document's content and the extracted clauses, or only one of them. If, for example, you do not want clauses to be automatically extracted for a particular set of documents, you can uncheck the "Clauses" checkbox.
ClauseBuddy will automatically extract metadata from the DOCX/PDF file that you are uploading. However, you should be aware that the information in these files is generally noise — as most lawyers know, the DOCX properties often refer to the law firm that happens to have created the first draft, perhaps more than 15 years ago. If you want to manually set the author, year, client, dossier, etc. for an entire batch of files before uploading them, then you can do so through the Additional data to enrich uploaded files... form. Alternatively, metadata can be edited on individual files after upload — either on the same Upload tab or the Inventory tab — by clicking the 'Edit' icon:
Uploading documents by email can be a very convenient feature to gradually upload documents, considering that most legal experts make heavy use of email. When an interesting document is drafted — e.g. a new template — you can simply forward this file to the specified email address, instead of having to manually drag in the file.
Notes:
Any PDF, DOC or DOCX attachment will be automatically extracted from the email, and uploaded, as if you had manually dragged the file onto the "Upload documents" button.
You can attach multiple files to the same email.
The software platform will check the sender's email address; if the user is not allowed to manually upload documents to a basket, then sending by email will be refused as well.
All the other data within the email (subject; body; persons in CC or BCC; etc.) will be completely ignored.
It can take about one minute for the file to get processed; the sender will also receive an email confirmation with an overview of all the documents that got uploaded.
Immediately afterwards, the email will be completely and permanently destroyed.
The email address to which you have to send the emails looks a bit funny, but this is intended as a security measure, because the address is generated semi-randomly, so is difficult to guess. Should you ever want to change the address, you can click on the "Regenerate" button.
If you happen to use iManage as a document management system, then you can also send files or folders to ClauseBuddy using dedicated buttons in iManage. This requires a significant technical setup, so please have your administrator contact us if you are interested in this feature.
You can also upload documents in batch through our so-called "REST API", e.g. to perform server-to-server transfers of thousands of files from some filing system to ClauseBuddy. Also this requires significant technical expertise, so will need to involve your IT-team.
To edit the name, access rules and email upload settings of a basket, you click on the ... at the right-side, and select Settings.
You can edit the year, author, client, dossier and category of an individual file by going to the Inventory tab of a basket and clickin on the pencil icon at the right side.
Next, you can edit all properties through the popup dialog box.
You can delete a document by going to the Inventory tab, holding Shift on your keyboard and clicking on the trash-can icon at the right side. (You must hold Shift to avoid accidental clicks.)
Alternatively, you can delete a document by clicking on the "..." button in the upper-right corner of the currently visible document in the Documents mode.
You can delete an individual clause by going to the Clauses mode and clicking on the "..." button in the upper-right corner of a clause.
You can delete a basket by clicking on the ... at the right side, and then selecting Delete.
You will have to confirm that you truly want to delete the basket, because this process will irreversibly delete all your documents and clauses in it.
However, many customers want to automatically give personal baskets to each of their users. ClauseBuddy therefore allows customers to have personal baskets automatically set up for both existing and new users.
In order to create personal baskets for existing users, you must do the following as an administrator:
Go to the Manage tab of Truffle Hunt and click on the green + button, and then the "..." button in the lower-right corner of the popup-dialog box. Choose Create missing Personal baskets in bulk
In the new popup-window that appears, choose either All (create the missing baskets for everyone), Groups (create them for a specific group of users) or User (create a Personal basket for one specific user).
You can configure ClauseBuddy to automatically create personal baskets by going to the User setttings as an administrator, and choosing New user defaults.
At the bottom of the settings pane that then appears, you can enable the Personal Truffle baskets. When you activate this option, you can see a few more settings:
The Prefix of the personal baskets, in the various languages you're dealing with. Technically speaking, the values you enter here will be used for the Category of the new basket.
The Include checkboxes allow you to specify whether the personal baskets should store clauses, documents, or both.
Most legal drafting software packages claim to be "language-agnostic". This sounds fancy, but "language unaware" would actually be a nicer term, because such software does not try to understand the words inside a document or clause. So whether you're uploading a document in English, Spanish, Chinese or Klingon — it does not matter for that software, it will simply allow you to search for individual characters.
ClauseBuddy does the opposite: it is very much language aware, and will determine the language of each document, so that you can perform a better search. For example:, when you search for "agreement" in English, it will also automatically search for "agreements" in plural; but the rules for what constitutes a singular or plural differ between languages. Similarly, when splitting a document into individual clauses, ClauseBuddy will use different anchoring points depending on the language (e.g., "Chapter 5" in English, but "Chapitre 5" in French) to decide how to split up clauses and how to understand numbering.
Truffle Hunt will automatically determine the language of your document based on its contents. While this almost always works correctly, you should be aware of a few caveats:
Truffle Hunt automatically subdivides a basket into different languages and will then search in one of the sub-baskets depending on the search term that you enter. If, for example, you search for "logiciel licence" then Truffle Hunt will search in the French sub-basket of your selected basket, and only return French documents & clauses. Conversely, if you would search for "assignment confidentiality", it will search in the English sub-basket.
If you enter only a single word, then ClauseBuddy may end up searching in the wrong basket. For example, the word "software" will be a valid word in many different languages. The solution is simple: just add one or more terms to your search query, so that ClauseBuddy can correctly determine the language and subsequently search in the right basket.
ClauseBuddy accepts .DOC, .DOCX and .PDF files. In the background, it will automatically convert all of them into .DOCX and store them in the database. Also useful to know that it is even possible to upload scanned documents.
You should be aware, however, that the conversion process for PDF-files is inherently noisy, and will always result in files of lesser quality than .DOCX files.
In the Access-bundle box you should select an , to define who gets access to a certain locker/basket, and who can upload / remove documents from it. Users need "Read & Use" rights to search, and need "Edit" rights in order to upload or remove documents from a locker/basket. See also .
Through its system, ClauseBuddy allows you precisely configure which users have access to certain baskets. Without any special facilities, it is therefore possible to create baskets that only grant access to a specific user.
The Allow upload by email? setting allows users to .
