Overview
The Appfire Docs+ app provides two-way integration for Slack and Confluence.
Docs+ streamlines communication offering real-time updates, and enhances collaboration. The Comala Document Management integration with the Docs+ app, allows you to send all your workflow notifications directly to one or more named users in a linked Slack workspace.
This integration supports optimization of your document management and control, cross-functional collaboration, and aligns with modern workflow practices, increasing document management efficiency.
Requires Comala Document Management Data Center v7.3.0 or later and a minimum of Confluence v7.19.15 in your instance together with Docs+ vx.x.x
For Comala Document Management Data Center v7.2.0 or later and a minimum of Confluence v7.19.15, the macro and related features are under a dark feature: you must add the following flag: comalatech.workflows.slack.docs.enabled.
Generating the Slack message from Comala Document Management
The Slack message is generated using a workflow trigger listening for a Comala Document Management workflow event in an applied workflow. The workflow trigger uses the send-slack-user macro to create and send the message to one or more named users.
Comala Document Management must be configured to alow Slack notifications to be sent to users. The configuration is set globally for all spaces in the instance. A space administrator can override the global notifications configuration by setting the notifications in a space.
Global configuration
Space configuration
Workflow setup
Ensure that Comala Document Management Data Center v7.3.0 or later and a minimum of Confluence v7.19.15 are installed in your instance to access the send-slack user macro.
create a new Confluence space
In the newly created space
go to Space Tools > Document Management
choose Create workflow in the space document management dashboard
add a unique name for the workflow in workflow builder
Save
In workflow builder choose markup editor option
replace the existing workflow markup by copying and pasting the following workflow markup
{workflow:name=my workflow}
{state:In Progress|approved=Approved}
{approval:Review|assignable=true}
{state}
{state:Approved|final=true|updated=In Progress|hideselection=true}
{state}
{trigger:pageapproved|approval=Review}
{send-slack-user:user=@user@,@creator@|subject=You have just approved: @pagetitle@}
The page @page@ has just been approved by you.
{send-slack-user}
{trigger}
{workflow}
You can use any existing workflow and edit the workflow to add the trigger markup and editing the trigger for the event and state in this workflow.
Save the workflow in the workflow builder
Exit to return to the space document management dashboard