Writing Scripts - Beyond the Browser
ScriptRunner users work with the software in different ways. You may exclusively use the point-and-click pieces without writing a single line of code, or you may use the best development tools and practices to streamline your scripting experience. You may be somewhere between the two - maybe you can copy and paste code from the documentation, or maybe you write custom scripts and use developer tools like an IDE.
Use this page to determine what group of users you might categorise yourself with. Then, use your group to help you navigate the documentation.
If you don’t have a test or QA instance of your application (Jira, Confluence, or BitBucket), consider obtaining one. They are the best way to test your scripts without fear of creating problems in your production Jira instance. You can get a development license to setup a test server, where you can run a cloned instance of your Atlassian application’s configuration.
If you regularly find yourself on Atlassian’s Community site asking, "I have ScriptRunner, how can I…" questions, you’re an Explorer.
You primarily use ScriptRunner to gather information about your Atlassian application. For example, you may occasionally run a built-in script or copy and paste some code into the Script Console to get information or make a bulk update that the UI just can’t accomplish. In ScriptRunner for Jira, you probably use JQL functions heavily. In Confluence, you probably use the built-in macros quite a bit, and you may have touched a Search Extractor or a custom CQL function on occasion.
For people who need a little something to take their scripting game to the next level, start with IntelliJ IDEA Integration. If you’ve worked on writing your own scripts and want to speed up your development, this should help.
If you’re concerned about continuous integration, infrastructure as code, or automated testing, you’re a Builder.
You may have a job title like "Developer", "Software Engineer", or something with "DevOps" in it. You may even be a Jira or Confluence admin who reads blogs by and for people with the previously mentioned job titles, and you may have an interest in implementing those concepts. If you’re a Bitbucket Server or Bamboo admin and user, you’re probably in this group because you’re using developer tools.
If you are a software developer, you probably have other concerns similar to:
How can I track changes to my scripts and their configuration in a source control tool like Git?
How can I write and run automated tests to make sure my scripts work as I expect across Atlassian product releases, server migrations, and ScriptRunner updates?
How can I build and deploy my scripts as a packaged solution, first to a test or QA environment and then to production?
For the Unsure
Not sure which tidy box to put yourself in? That’s okay! Start with connecting IntelliJ IDEA to your Jira test server to help you write your own custom scripts faster. If you find yourself wanting more, look at the options for Builders. We realize and celebrate that scripters are often programmers and users. Embrace scripting and try something… on your test server, of course.
The goal in this documentation is to help you, no matter what group you categorise yourself in. If you need an experienced traveler to guide you, our growing course offerings at Adaptavist Learn are there to help. If the training that you’re looking for isn’t there yet, let us know.
Have questions? Visit the Atlassian Community to connect, share, and learn with other Atlassian users and experts, including Adaptavist staff.
Want to learn more? Check out courses on Adaptavist Learn, an online platform to onboard and train new users for Atlassian solutions.