{"type":"doc","content":[{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"a7b8b17a-83a3-4da1-bcd3-786e04268d12"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#deebff","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"On this page:","type":"text","marks":[{"type":"strong"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"6"},"include":{"value":""},"outline":{"value":"false"},"indent":{"value":""},"style":{"value":"default"},"exclude":{"value":""},"type":{"value":"list"},"class":{"value":""},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"9e650081-bab8-4bde-9495-962d1562f1b2"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"43e250fe-c222-42e8-abb4-d52a88c294bf"}}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Who can use this information","type":"text"}]},{"type":"paragraph","content":[{"text":"Follow these instructions if you’re an","type":"text"},{"text":" app vendor, developer, or Jira user ","type":"text","marks":[{"type":"strong"}]},{"text":"integrating a ","type":"text"},{"text":"Jira Server or DC app","type":"text","marks":[{"type":"strong"}]},{"text":" with Configuration Manager for Jira (CMJ) through the ","type":"text"},{"text":"Service Provider Interface","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"API reference","type":"text"}]},{"type":"paragraph","content":[{"text":"If you need more technical information on the latest SPI packages and interfaces, follow the link to read the complete ","type":"text"},{"text":"API reference","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.botronsoft.com/cmj/spi/latest/index.html"}}]},{"text":". ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Integrate your server app with the Server SPI","type":"text"}]},{"type":"paragraph","content":[{"text":"The SPI for Jira Server/DC is a set of ","type":"text"},{"text":"REST","type":"text","marks":[{"type":"strong"}]},{"text":" interfaces implemented by server apps and invoked by Configuration Manager for Jira/Cloud Migration Tool during migration when app data is found.","type":"text"}]},{"type":"paragraph","content":[{"text":"Throughout our documentation, we will refer to the SPI for CMJ Server as ","type":"text"},{"text":"Server SPI or CMJ Server SPI","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"To implement the Server SPI, follow these steps:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Initial setup of the Server Service Provider Interface (SPI).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement app-specific ","type":"text"},{"text":"REST endpoints of the Server SPI","type":"text","marks":[{"type":"link","attrs":{"href":"#Step-2%3A-Implement-app-specific-SPI-endpoints"}}]},{"text":".","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 1: Initial SPI setup","type":"text"}]},{"type":"paragraph","content":[{"text":"This part aims to guide you through the initial setup of the Service Provider Interface (SPI). ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Аdd the SPI as a maven dependency in your pom.xml:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n com.botronsoft.cmj.spi\n configuration-manager-spi\n ${cmj.spi.version}\n provided\n","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You need to add the SPI package dependency:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\t\n\t\t\n\t\t\tcom.atlassian.maven.plugins\n\t\t\tmaven-jira-plugin\n\t\t\t${amps.version}\n\t\t\t\n\t\t\t\t.....\n\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\tcom.botronsoft.cmj.spi.*;version=\"${cmj.spi.version}\";resolution:=optional,\n\t\t\t\t\t\n\t\t\t\t\t\n\t\t\t\t\t\t....\n\t\t\t\t\t\t!com.botronsoft.cmj.spi.*,\n\t\t\t\t\t\t....\n\t\t\t\t\t\n\t\t\t\t\n\t\t\t\t.....\n\t\t\t\n\t\t\n\t\n","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the Maven property ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"cmj.spi.version","type":"text","marks":[{"type":"strong"}]},{"text":" to the lowest possible version of the SPI - for example, 1.0.0. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Increment the version when you need new features of the SPI. This will ensure compatibility with a large set of Configuration Manager releases, as older releases come with an older version of the SPI. There is no need to compile to a newer version unless you need some new features, as the SPI is backward compatible.","type":"text"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"DynamicImport-Package Usage","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Make sure that ","type":"text"},{"text":"DynamicImport-Package","type":"text","marks":[{"type":"strong"}]},{"text":" is used instead of ","type":"text"},{"text":"Import-Package.","type":"text","marks":[{"type":"strong"}]},{"text":" Otherwise, the SPI-related packages may not be correctly resolved at runtime.","type":"text"}]},{"type":"paragraph","content":[{"text":"If building with ","type":"text"},{"text":"Atlassian SDK 8.0.0+","type":"text","marks":[{"type":"strong"}]},{"text":", you also need to add the instruction “!com.botronsoft.cmj.spi.*” to ","type":"text"},{"text":"Import-Package","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 2: Implement app-specific SPI endpoints","type":"text"}]},{"type":"paragraph","content":[{"text":"Next, implement the SPI Endpoints from the list below for the types of configurations your app includes. For example, if your app deals with workflows or modifying workflows in Jira, you will need to implement the Workflows SPI Endpoints.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Server SPI endpoints","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Custom fields","type":"text"}]},{"type":"paragraph","content":[{"text":"Custom fields with specific configurations provided by the app:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Custom fields SPI","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/AppIn/pages/197924953"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Custom field data SPI","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/AppIn/pages/198216009"}}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Workflows","type":"text"}]},{"type":"paragraph","content":[{"text":"Custom conditions, validators, and post-functions provided by the app:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Workflows SPI","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/AppIn/pages/198118811"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SPI Tools for workflows","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/AppIn/pages/197925018"}}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Project configuration and data","type":"text"}]},{"type":"paragraph","content":[{"text":"App configuration attached to a project.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Project configuration SPI","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/AppIn/pages/197827174"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Project issue data SPI","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/AppIn/pages/197958179"}}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"App data","type":"text"}]},{"type":"paragraph","content":[{"text":"App data not attached to a Jira object (project, custom field, workflow, etc.). Use this endpoint when the app data does not fit the boundaries of existing Jira objects and extend standard Jira functions.","type":"text"}]},{"type":"paragraph","content":[{"text":"Using this endpoint, you can enumerate the types of app data that can be migrated and the different objects of each type that exist on the Jira instance.","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"ScriptRunner example","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"ScriptRunner","type":"text","marks":[{"type":"link","attrs":{"href":"https://marketplace.atlassian.com/apps/6820/scriptrunner-for-jira?tab=overview"}}]},{"text":" app provides functions such as:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Listeners","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://docs.adaptavist.com/sr4js/latest/features/listeners"}}]},{"text":", which are “listening” for a specific event and triggering an action, and,","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Behaviors","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://docs.adaptavist.com/sr4js/latest/features/behaviours"}}]},{"text":" customizing how fields “behave” based on the context, etc.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The Jira application development platform does not categorize and guide this type of app functionality. Yet, the ","type":"text"},{"text":"App Data SPI ","type":"text","marks":[{"type":"strong"}]},{"text":"endpoint provides the tools to move such configurations between different Jira instances.","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"App Data SPI","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/AppIn/pages/198216064"}}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Dashboards","type":"text"}]},{"type":"paragraph","content":[{"text":"Custom dashboard gadgets provided by the app:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Dashboards SPI","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/AppIn/pages/197924889"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SPI Tools for dashboards","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/AppIn/pages/197894319"}}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"App’s Global Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"The global configuration of the app, not specific to any project or other Jira object:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Global App Configuration SPI","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/AppIn/pages/197858762"}}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"License","type":"text"}]},{"type":"paragraph","content":[{"text":"The Configuration Manager SPI is licensed under the ","type":"text"},{"text":"Creative Commons license","type":"text","marks":[{"type":"link","attrs":{"href":"https://creativecommons.org/licenses/by/4.0/"}}]},{"text":" (CC BY 4.0)","type":"text"}]}],"version":1}

Browser not supported