About • Prerequisites • Creating Templates • Sharing Templates
Correlations Recorder Central Repository it is a community where users can share their Correlation Templates to be used, and automatically downloaded into the Correlation's Recorder JMeter Plugin.
In order to download, update and share templates you need to:
- Download and Install JMeter
- Install JMeter Plugin Manager
- Install Correlations Recorder Plugin
From there, you can either start creating your templates from scratch or, load and edit one from the Central Repository (loaded by default).
Here you can use the Template we prepare for you or, just add the Component as it is.
- Go to JMeter Templates
- Select "Correlation Recorder"
- Select the "Correlation Recorder" component
- Click in your Test Plan
- Follow this route: Add > Non-Test Element > "Correlation Recorder"
From this point onwards, it is just about adding Rules by clicking the "Add Button" and, when you are ready, save your Correlation Template.
Loading one from the Central Repository saves you time and effort for the setting up part.
- Just go to Load Template button. (If the desired template its installed, go to the "Installed" Tab, if it isn't, then go to the "Available" Tab)
- Pick the template that you want to use
- Select the Version you want to load
- If the template's version ain't installed: you must click on install button, before loading it.
- If the template's version is installed: click the load button to load it.
Note: If you installed a template that required external dependencies, this will trigger a JMeter reset (otherwise ask you to manually reset). After that, just repeat the process until the point where you can load it, and click the load button.
Just like in the Building from Scratch section, after doing this, you only need to edit and save the template.
When it comes to load and share the Correlations Templates, there are some steps you need to follow to do so. In this section, we will talk about them.
- Clone the actual repository into your machine
git clone https://github.com/Blazemeter/CorrelationsRecorderTemplates.git
- Edit the central-repository.json file
- Adding the name of the template, follow by a pair of
{}
"myTemplate" : {}
- Adding a version array inside, with all the versions you want to add
"myTemplate" : {
"versions": ["1.0", "2.0"]
}
- Just add the new version into the array.
NOTE: Don't modify pre-registered versions, since it could affect the behavior for those users who have downloaded and installed that version.
-
Copy the files for those versions into the same level of that central-repository.json file
-
Add the files into git
The easiest way always is
git add .
or one by one
git add central-repository.json
git add myTemplate-1.0-template.json
git add myTemplate-2.0-template.json
- Push to our repository and make a PR.
At the end, should look like this
+ central-repository.json (updated)
+ myTemplate-1.0-template.json
+ myTemplate-2.0-template.json
- Remember that, if your template contains dependencies, those must be uploaded into public external cloud were everyone can access without logging in.
- All the versions mentioned in your template MUST be in the same level as the central repository (don't create sub folders for any reason).
- Don't edit others template but your own.
- Be nice.
Apache License 2.0
A permissive license whose main conditions require preservation of copyright and license notices.
Contributors provide an express grant of patent rights. Licensed works, modifications, and larger
works may be distributed under different terms and without source code.
To know more about it, read the license here