Documentation

No results
    gitHub

    Tips and tricks

    The following tips and tricks may be useful to quickly become a Hackolade power user!

    Where does the name Hackolade come from?

    ;-) Hackolade is derived from a pun in French.  We're quite focused on JSON, to say the least, and in French a {curly bracket} is called an "accolade".  It is a "double entendre" as it also has the primary meaning "acknowledgment of merit".  So we thought it was creative to play with the words and have a distinctive trademark brand for which the .com domain was available.  This name is obviously tongue-in-cheek. Just like a hackathon has a positive connotation and does not imply breaching security or privacy, Hackolade conveys a positive message of innovative and clever data quality.

     

    What is the End-of-Life (EOL) policy for Hackolade Studio?

    Hackolade continues to provide support for version X for one calendar year after the release date of major version X+1, provided that you are current with maintenance fees for your perpetual license key, or with your subscription.

     

    Release the license key from one computer to move to another

    If you need to move your license key to another computer, you first need to release it on the PC where your key is currently validated.  The procedure is also detailed in this page.

     

    To do so, go to the option Help > Software Key Validation, and choose the action 'I want to...':

    Registration -- release license key

    and click the Send button.  This will free up the key on our license server.  

     

    Registration -- un-register confirmation

    Make sure to copy the license key and store it (or find your original license key confirmation email) as you will need it to activate on the other computer where you will want to use Hackolade.

     

    As of this moment, you can no longer use Hackolade on the original computer, unless you you re-register it.

     

    Go to the other computer where you want to use Hackolade and validate your license key using the instructions above '2. Validate your license key'

     

    TIP: if your company has many licenses, your administrator may require that you enter your name in the Identifier (optional) field.  You will find more details in this page.

     

    TIP: if you're a license administrator, you may want to track who's using your licenses.  You may do so by accessing the URL https://quicklicensemanager.com/hackolade/QlmCustomerSite/qlmlicenseinfo.aspx

     

    License Information webpage

     

     

    To have identification information appear in the Computer Name column, users need to go to Help > Software Key Validation, then release their key, copy it to their clipboard, then fill in the identifier  (name or whatever other standard you decide), paste the key, and validate again.

    License dialog

     

    The identifier entered in the this screen will appear in the web page:

     

    License Information webpage w username

     

    Workspace

    TIP: you may create extra space on your desktop by sliding the Object Browser or Properties panes with this control Image appearing between the panes. You may also toggle the appearance of these panes in the View menu, or by double-clicking on the separation control.

     

    TIP: to go back to the Welcome Page, simply choose View > Welcome Page.  You may close the page, with the Close button on the lower right.

     

    TIP: in any of the Comments dialogs, you may press the timestamp button to log data and time for your entires.

     

    TIP: you many start multiple instances of Hackolade so as to work on multiple models simultaneously.  You may also merge 2 Hackolade models, or combine elements from another model with copy/paste from one model in one application instance, to the other model in the second application instance.  On Windows, right-click on the Hackolade icon in the toolbar then choose Hackolade:

    Multiple instances

     

    On Mac/Linux, this is done with the command: open -n /Applications/Hackolade.app/

    Running multiple instances on the same PC does not require additional license seats.

     

    TIP: using the mouse wheel in both the ER Diagram and the hierarchical schema view:

    -- up/down: move up or down

    -- shift+up/down: move left or right

    -- ctrl+up/down: zoom in or zoom out

     

     

    Object Browser

     

    TIP: it is very convenient to use the search for any string of text to locate one or multiple objects in the model

    Object Browser search

     

    TIP: from the Object Browser, simply click on an attribute, and the central pane will switch to its location in the hierarchical schema view, with all the details in the Properties Pane.

     

    TIP: you may add attributes from the Object Browser with a right-click to display a contextual submenu.

     

    ERD

    TIP: you may automatically resize an entity shape in the Entity Relationship Diagram view by clicking the double-sided arrow icon ERD shape auto-resize icon at the top right corner of the shape

    ERD - Collection Title

    TIP: you may change the color of a shape title and frame by choosing from a palette that you can access by clicking the eye-dropper icon Toolbar - Select color code just to the left of the auto-resize icon.

    TIP: if you want to get the maximum level of zoom possible while showing all shapes in your diagram, simply click on the double-sided arrow icon Toolbar - Resize box to fit content in the application toolbar.

     

    TIP: after you've created shapes and relationships in the ER diagram, you may want to let Hackolade perform a basic distribution of the shapes according to an orthogonal formula, by choosing this grid-like icon Toolbar - orthogonal distributionin the toolbar..

     

    TIP: to select multiple shapes, keep the Ctrl/Cmd key pressed.  Then you can move, align, distribute, etc...

     

    TIP: when you select 2 or more shapes, these shape alignment toolbar icons become active: ERD shape alignment toolbar icons

    You may also do a right-click and access the same functions through the contextual menu.

    TIP: when you select 3 or more shapes in line, you may distribute them evenly with these toolbar control icons:ERD shape distribution

     

    TIP: create a relationship with drag-and-drop: simply grab a field from one collection with your mouse, and drop it on a type-compatible field in another collection (type-compatible fields in other collections are highlighted as long as the mouse button is pressed.)  Be careful that the application considers the source as the child in the foreign key relationship, and the destination is the parent.  After the relationship is created, you may change the relationship type (foreign key or foreign master) and the cardinality in the Properties Pane.

     

    TIP: with denormalization, an ERD can quickly become very busy with all the foreign master lines displayed.  You may toggle these lines on or off with this toolbar button Toolbar - Toggle foreign master lines button

     

    TIP: All of the controls to view properties for and manipulate attributes are also available now from the ERD view and the Object Browser, without having to necessarily open the entity in a new separate tab.

     

    Hierarchical hierarchical schema view of entities (collections/tables/nodes & edges)

    TIP: you may change the order of the fields/attributes with these control icons: Toolbar field order up-down arrows

     

    TIP: you may toggle more or less details in the view with this toolbar control: Schema hierarchical treeview details toggle

     

    TIP: you may copy attributes by using the copy/paste function.  Of course you can only paste attributes to complex types (sub-documents/maps or arrays/lists.)

     

    TIP: when you enter data in the Sample field of the Properties Pane, Hackolade dynamically generates a sample JSON Data document in the JSON Preview lower tab.

     

    JSON Preview

     

    TIP: there are 3 types of validations being performed in this double-pane view: JSON Schema errors, JSON Data errors, sample document errors.  You may click on each title's button to view the individual errors, or ALL to see a consolidate view.

     

    TIP: changes being performed directly in this view can only be saved if they are properly validated.  A button is provided to that effect.

     

    TIP: DynamoDB only: the sample document in JSON data is displayed by default as plain JSON.  It can also be displayed as 'DynamoDB JSON'.

     

    Reverse-Engineering

     

    TIP: if you encounter issues during the Reverse-Engineering process, there is a log file HackoladeRE.log located on your drive at C:\Users\%userprofile%\AppData\Roaming\HackoladeLogs (Windows), or /home/$[user]/Documents/HackoladeLogs (Linux), or Documents\HackoladeLogs (Mac).  If you send this file to support@hackolade.com, we'll be have more information to investigate.

     

    TIP: in MongoDB reverse-engineering, if you have instances with a very large number of databases, you may wish to declare a particular database directly in the connection string by appending the address with: /<name of the database you wish to access directly>, for example: localhost/NBA.  Or you may declare the database name in the Advanced tab.

     

    TIP: if you get an error "not master and slaveOk=false" when connecting to a MongoDB instance, on a secondary member (for example, a replica set connection using a read preference of secondary or secondaryPreferred), you first need to run rs.slaveOk() to be able to freely run Hackolade's reverse-engineering. This is because, by default, MongoDB does not permit read operations from non-master (i.e., slave or secondary) instances.

     

    In MongoDB, reads to a primary have strict consistency, meaning that the data it provides reflects the latest writes at all times.  Reads from secondaries in MongoDB have eventual consistency, meaning that changes to the system can propagate gradually and readable members are not required to reflect the latest writes at all times.

    By calling rs.slaveOk() you are indicating to the system that you acknowledge that reads will be eventually consistent and wish to be able to run reverse-engineering from the secondary anyway.

    General

     

    TIP: log files, relating to reverse-engineering or general application errors or license authorization, can be found:

    - Windows: in the C:\Users\%username%\AppData\Roaming\HackoladeLogs directory

    - Mac/Linux: in the Users/$USER/Documents/HackoladeLogs folder.

    They may be useful to troubleshoot issues, and requested when opening a support ticket.

    TIP: you may wish to perform a bulk update of properties, for example changing the color of attributes, or making a bunch of attributes required, or change enter  descriptions, etc.  The best way to leverage this is by leveraging the Excel export/import capability:

    1) export your model to Excel

    2) perform your changes in the Excel file and save it

    3) import the Excel file back into your Hackolade model.