Documentation

No results
    gitHub

    Download additional target plugins

    The latest version of each plugin is always available for download from the Plugin Manager?  Just go to Help >  Plugin Manager

     

    Plugin Manager menu new

     

     

    You may choose which plugin to install on your computer.

    Plugin - manager available custom props

     

    This will result in the plugin appearing in the Installed tab of the plugin manager.

    Plugin - Manager installed custom props

     

     

     

    Are you experiencing issues with plugin download?

    Do you have your network proxy set correctly?  See more details here.

     

    Does  your organization prevent access to GitHub?  You may need to have https://github.com/hackolade whitelisted.

     

    There is an alternative: you may download the plugin from our GitHub repo, then go to the plugin of your choice, and click on link in the About section on the right-hand side of the page:

     

     

     

    GitHub Plugin Download

     

    This link leads you to a page with the latest release, where you can click on the link <plugin>-<version>.zip link to download the zip file:

     

     

    GitHub Plugin Download step 2

     

     

     

    Then to install the plugin, go to Help > Plugin Manager and click the button Install from Zip.

     

    Plugin Manager - Install from zip

     

     

    You get the message "Hackolade Studio doesn't have enough rights to install a plugin..."

    While you, as a user may have the rights to the folder where plugins are installed, it is possible that some environments limit the rights of our application.  It can be a virtualization or sandboxing setup or most likely an anti-virus software.  

    Plugins - Virus Threat Protection error

     

    If your anti-virus is Windows Defender, you, or your IT department, can create an exclusion in Windows Defender. Follow these steps:

    Open Windows Security:

    - Press the Windows key + I to open Settings.

    - Select "Privacy & Security."

    - Click on "Windows Security" in the left sidebar.

     

    Access Virus & Threat Protection Settings:

    - In the Windows Security window, click on "Virus & threat protection."

    Image

     

     

    Manage Settings:

    - Under the "Virus & threat protection settings" section, click on "Manage settings."

     

    Plugins Windows Defender Manage settings

     

     

    Add or Remove Exclusions:

    - Scroll down to the bottom, to the "Exclusions" section.

    - Click on "Add or remove exclusions."

     

    Plugins Windows Defender add exclusion

     

    Add a Folder Exclusion:

    - Click on "Add an exclusion."

    - Choose "Folder" from the drop-down menu.

     

    If you get the message that you don't have the permission to create this exclusion, you will need for your IT Security team to access your machine and allow this operation.  Or ask them to perform it for you.

     

    Image

     

     

    Specify the Folder Path:

    - Navigate to the folder C:\Users\%username%\.hackolade and select it.

    Plugins Windows Defender add folder path

     

    Save Changes:

    - Save your changes.

    This exclusion tells Windows Defender not to scan or interfere with files and processes within the specified folder. Hackolade Studio should now have the necessary WRITE or EXECUTE permissions in the specified directory.

    Remember to replace %username% in the folder path with the actual username. After making these changes, the application should be able to operate in the specified directory without being blocked by Windows Defender.

     

    Plugin Manager options for an installed plugin

    In the Installed tab of the Plugin Manager, you may see multiple buttons:

    Plugin Manager Installed tab - buttons

     

    Remove: this button deletes the plugin from your machine

    Disable: this button keeps the plugin on your machine but turns it OFF, so it no longer appears in the targets available to create models.

    Migrate:  this has to do with customizations you may have made to this plugin.  The whole thing is documented in this page. If you don't have customizations dating prior to v3.6.2, you may probably ignore.  But it is safer to first migrate just in case, then update to the latest version of the plugin.

     

     

    Share downloaded plugins with team members

    While this step is not required, and may not be desirable if some teams work with different targets, it is possible, in some organizations, to centralization the installation and update of plugins. In such case, one user would download and install the plugin or plugin updates in their Git-enabled folder, then push the changes to the remote Git repository so other users could pull them on their local machine.

     

    In such scenario, there 2 options: the Git enabling of only the folder of the plugins, or (preferably) Git-enabling the folder that contains both the plugins and the custom properties.  In the latter case, this would replace the process described here.

     

    For the rest of the description below, we assume the latter scenario.  In such case, the useruser clones locally in C:\Users\%username%\.hackolade (on Mac in Users/$USER/.Hackolade)  That way, all that teams members need to do is to pull regularly, and they will get your latest plugins and custom properties.

     

    For changes to take effect on each computer, it is required to exit Hackolade Studio and restart it.

     

    One-time setup of the Git repository for the organization's custom properties

    This step is required once per organization, to be executed by the Hackolade Studio superuser or maintainer.

     

    The process to git-enable your options folder may vary, depending on your OS and your repo provider.  Here is an example using GitHub and Windows:

     

    1) in Windows Explorer, go to C:\Users\%username%\.hackolade and make sure that the folder is empty.  

    2) if the folder C:\Users\%username%\.hackolade is not empty, then cut the content and place it in a safe place

    3) in GitHub, create a new repository, for example called "hck_plugins_and_custom_props" and copy the Git URL, for example in our case "https://github.com/\<yourorg>/hck_plugins_and_custom_props.git" (finishing in .git)

    4) in Hackolade Studio, go to the repository context (or the menu option "Repository > Open Repository Context, or keyboard shortcut Ctrl + G) 

    5) in the top bar, select the Source "URL", then paste the Git URL you had copied in step 3), then click the Clone button

    6) in the OS destination folder dialog, select the folder C:\Users\%username%\.hackolade which must be an empty folder

    7) if you had in step 2) to put in a safe place previous content of the options folder, now is the time to copy it back to the C:\Users\%username%\.hackolade folder

    8) commit and push to the central remote repository the changes of step 7) and any other changes to custom properties

     

    One-time setup of each user's plugins and custom properties

    When a new user installs the application, it should be part of the organizations documented process, right after license key validation, to clone locally the organization's custom properties repository.

    1) in Hackolade Studio, go to the repository context (or the menu option "Repository > Open Repository Context, or keyboard shortcut Ctrl + G) 

    2) in the top bar, select the Source "URL", then paste the Git URL you copied in step 3) , then click the Clone button

    3) in the OS destination folder dialog, select the folder C:\Users\%username%\.hackolade\ which must be an empty folder

    4) select or possibly clone locally the models repository

     

    Share plugin or custom properties changes with Hackolade Studio users

    When the superuser(s) or maintainer(s) downloads plugin updates, or develop, fine-tune and test new or adapted custom properties, it is useful to share them with the rest of the Hackolade Studio community of users in the organization.

     

    They should:

    1) using Hackolade Studio, select the custom props repository

    2) go to the Commit screen and click the Push button

    3) notify your community of Hackolade users to pull the changes from the remote repo of custom properties

    4) go back to your models repository

     

    Other users should simply:

    1) using Hackolade Studio, select the custom props repository

    2) go to the Pull screen and click the Pull button

    3) close and restart Hackolade Studio

    4) go back to your models repository