Skip to content

Evolveum/midpoint-studio

Repository files navigation

MidPoint Studio

1. Overview

Plugin for Intellij Idea to help identity engineers customize MidPoint identity management solution by Evolveum.

2. Features

  • MidPoint objects manipulation

    • Browse, upload objects

    • Execute tasks, actions

    • Test resources

  • Documentation generator

  • Debugger for Groovy scripts expressions

  • IDE editor capabilities

    • Completions

    • Annotations

    • Reference integrity checks

    • Random OID generator

    • Schema documentation

    • File Templates

  • Support for multiple environments

  • Master password encryption for passwords and other secret values

3. Documentation

Documentation is available here.

4. Installation

It’s available in JetBrains Marketplace here. Installation steps:

  1. Start Intellij Idea (Community/Ultimate)

  2. Go to menu File → Settings (Preferences) → Plugins

  3. For stable releases, they are directly available

    1. Search for "MidPoint Studio" → Install

  4. For other releases

    1. Go to Manage plugin repositories

    2. Snapshot releases (unreleased new major release)

    3. Support releases (unreleased new patch release)

    4. Save & Close dialog

    5. Search for "MidPoint Studio" → Install

5. Issues, Bugs

You’re welcome to file bugs, new feature request or other issues in our issue tracker support. Please don’t forget add this information to new issue:

  • Add component Studio

  • Describe plugin version and Intellij version, OS related information

  • Attach necessary logs, e.g. idea.log ⇒ can be found using menu Help → Show log in Finder

6. Development Notes

6.1. Git Branches

  • Main development branch → master for next major release

  • Support/maintenance branch → support-X.Y for current stable release X.Y.*

6.2. Versions and Releases

  • Releases → <major.minor.patch>, e.g. 4.9.0

  • Snapshot builds → <major.minor.patch>-snapshot-<build_number>, e.g. 4.10.0-snapshot-60

  • Support builds → <major.minor.patch>-support-<build_number>, e.g. 4.8.2-support-78

Versioning scheme for major and minor version aligns to MidPoint releases. MidPoint Studio release 4.6.* will use 4.6 libraries from MidPoint project.

Each type of release (stable, snapshot, support) is published to JetBrains Marketplace.

6.3. Logging settings

Intellij Idea logs to file studio-idea-plugin/build/idea-sandbox/system/log/idea.log. Logging settings can be changed during runtime via top menu Help/Debug Log Settings by adding packages/classes on each line in format:

  • #LOGGER to log LOGGER (package or class) on DEBUG level

  • #LOGGER:trace to log LOGGER (package or class) on TRACE level

7. License

Project is licensed under Apache Licence 2.0. See LICENSE file for more details.