A forest specification, or
ForestSpec, is a way for your code to identify the forest that you'd like to access. The forest may come from different sources – it could be a structure, it could be a transformed structure, it could be a result of query or some other types of forest source.
So the first step before you read or update a forest is to create an instance of ForestSpec. Here are some examples of how you can do that.
|Desired forest||ForestSpec expression|
|Result of a JQL query|
|Result of a text query|
|Structure #123, sorted by Priority|
|Structure #123, skeleton only (without dynamic content)|
|Structure #123, with title row|
More details are available in Javadocs for ForestSpec.