Mingle API Workshop

ThoughtWorks Mingle API Workshop is an on-site training offering for organizations looking to get the most out of their Mingle experience. By the end of this 1-day, hands-on course, participants should have a working knowledge of how to automate interactions with a Mingle server.
The class is split into two main areas of focus. The first half of the day deals with the various entry points available to the RESTful Mingle API. Using simple tools such as cURL, the participants will learn to control almost all aspect of the Mingle instance., from creating new cards, accessing the Murmur feed, to performing automated administration tasks.
The focus of the second half of the day is the Mingle Macro Development Toolkit. After an introduction to the toolkit, participants will work together to create a brand new macro, using requirements found in real world projects. Special focus will be given to security and performance considerations.

Overview

Audience

Software Developers

Duration

1 day

Objectives
  • Understand the possible API integrations with Mingle
  • Understanding of the Mingle Macro Development Toolkit
  • Understanding of the security and performance considerations with API integrations

Course Outline

Introduction
  • Purpose and Philosophy
  • Refresher of Mingle concepts
  • Introduction to the example Mingle instance
RESTful API -  Introduction
  • Security Requirements
  • Server Setup
  • Useful Tools
RESTful API  – User focused actions
  • Card Actions
  • Comments
  • Attachment
  • Favorite
  • Transitions
  • Murmurs
  • Wiki
  • Execute arbitrary MQL
RESTful API  – Admin focused  actions
  • Mingle Version Info
  • Murmurs Channels
  • Projects
  • User
  • SCM Configuration
RESTful API – Metadata
  • MingleVersion Info
  • Property Definition
  • Card Types
Macro Development Toolkit -­  Introduction
  • Getting the toolkit
  • Server Setup
  • Security Implications
  • Performance considerations
Macro Development Toolkit  – Development & Testing
  • Project structure
  • Simple hands-on lab
  • Complex hands-on lab
  • Unit testing
  • Integration testing
  • Deployment