Recipe overview

This recipe provides step-by-step instructions on building a self-service form in Confluence that can be used to run a report when needed to monitor public HipChat rooms for references to a sensitive term, such as conversations that may be discussing pending merger or acquisition talks.

This recipe utilizes the following items:

• The Run macro of the Run Self-Service Reports for Confluence add-on which runs the provides the self-service form used to solicit the term to monitor.
• The CLI macro of the Run CLI Actions in Confluence add-on, along with the HipChat Command Line Interface (CLI) add-on, to retrieve the public HipChat room references to the specified term with its output directed to a CSV file.
• The CSV macro of the Advanced Tables for Confluence add-on to present the HipChat CLI output in a table.
• The Macro Security for Confluence add-on to safeguard the self-service form by ensuring that only Administrators can use the Run macro.

It will take you approximately 14-15 minutes to complete this recipe.

Note that an Intermediate version of this recipe is also available: How to Monitor Language in Public Chat Rooms (Intermediate)

Recipe level

Ingredients

Ingredients for Bonus Tip

Preparation

• Install the latest downloadable HipChat CLI Client on your computer, following all of the /wiki/spaces/HCLI/pages/70353210 including the steps marked optional.
• Configure a profile which Run CLI Actions for Confluence will use to connect to your HipChat instance and make sure it references an API Access Token of a HipChat user who has access to all of the public rooms you wish to monitor.
• Create rooms in HipChat for your team, if you have not done so already.

• Open a command window you'll use to execute CLI commands.

Steps