flexagon.fd.services.groovy.functions

Class SlackFunctions

java.lang.Object

flexagon.fd.services.groovy.functions.BaseFunctions

flexagon.fd.services.groovy.functions.SlackFunctions

Direct Known Subclasses:

WebhookSlackFunctions

public class SlackFunctions
extends BaseFunctions

Utility functions used to get information from a Slack payload

Since:

5.3

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	APPROVE_STRING
protected java.lang.String	REJECT_STRING

Fields inherited from class flexagon.fd.services.groovy.functions.BaseFunctions

mExecute, mFLOG, mScriptRef

Constructor Summary

Constructors

Constructor and Description
SlackFunctions(boolean isExecute, LogFunctions pFLOG)

Method Summary

Modifier and Type	Method and Description
void	cleanup()
java.lang.String	getGroovyKey()
FDUser	getUserFromSlackId(java.lang.String pSlackId) Returns the FlexDeploy User corresponding to the given Slack user id.
void	postAttachment(java.lang.String pSlackAccountCode, java.lang.String pChannel, java.io.File pInput, java.lang.String pMessage, java.lang.String pParentMessage) Uploads an attachment to the given Slack channel.
void	postAttachment(java.lang.String pSlackAccountCode, java.lang.String pChannel, java.io.InputStream pInput, java.lang.String pMessage, java.lang.String pParentMessage) Uploads an attachment to the given Slack channel.
java.lang.String	postMessage(java.lang.String pSlackAccountCode, java.lang.String pChannel, FlexSlackMessage pMessage) Posts a Slack message using JSON formatted based on Slack API.
java.lang.String	postMessage(java.lang.String pSlackAccountCode, java.lang.String pChannel, java.lang.String pJson) Posts a Slack message using JSON formatted based on Slack API.
java.lang.String	postSimpleMessage(java.lang.String pSlackAccountCode, java.lang.String pChannel, java.lang.String pMessageText) Posts a simple Slack message to the specified channel.

Methods inherited from class flexagon.fd.services.groovy.functions.BaseFunctions

decryptIntegrationInstance, doSimpleGet, findIntegrationInstanceByCode, getLogFunctions, getServerBaseUrl, setScriptRef

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

APPROVE_STRING

protected final java.lang.String APPROVE_STRING

See Also:

Constant Field Values

REJECT_STRING

protected final java.lang.String REJECT_STRING

See Also:

Constant Field Values

Constructor Detail

SlackFunctions

public SlackFunctions(boolean isExecute,
                      LogFunctions pFLOG)

Method Detail

getUserFromSlackId

public FDUser getUserFromSlackId(java.lang.String pSlackId)
                          throws FlexCheckedException,
                                 FlexNotFoundException

Returns the FlexDeploy User corresponding to the given Slack user id. This will only work if the user has added their Slack Id in their FlexDeploy User Profile

Parameters:

pSlackId - The Slack user id. This can be found in the Slack payload from incoming webhook messages.

Returns:

FlexDeploy User Object.

Throws:

FlexNotFoundException - If no FlexDeploy user was found for the given Slack id.

FlexCheckedException - All other exceptions

postAttachment

public void postAttachment(java.lang.String pSlackAccountCode,
                           java.lang.String pChannel,
                           java.io.InputStream pInput,
                           java.lang.String pMessage,
                           java.lang.String pParentMessage)
                    throws FlexCheckedException,
                           FlexNotFoundException

Uploads an attachment to the given Slack channel. The bot being used should have the file:write scope.

Parameters:

pSlackAccountCode - Messaging account code for Slack account.

pChannel - Name or Id of channel where the attachment will be uploaded. Use user channel Id to send direct messages.

pInput - The input stream to upload.

pMessage - Text to display giving context about the attachment

pParentMessage - Parent message/ts id if you wish to post attachment as a reply, leave as null otherwise

Throws:

FlexNotFoundException - If no account is found for give code

FlexCheckedException

Since:

5.4

postAttachment

public void postAttachment(java.lang.String pSlackAccountCode,
                           java.lang.String pChannel,
                           java.io.File pInput,
                           java.lang.String pMessage,
                           java.lang.String pParentMessage)
                    throws FlexCheckedException,
                           FlexNotFoundException

Uploads an attachment to the given Slack channel. The bot being used should have the file:write scope.

Parameters:

pSlackAccountCode - Messaging account code for Slack account.

pChannel - Name or Id of channel where the attachment will be uploaded. Use user channel Id to send direct messages.

pInput - The file to upload.

pMessage - Text to display giving context about the attachment

pParentMessage - Parent message/ts id if you wish to post attachment as a reply, leave as null otherwise

Throws:

FlexNotFoundException - If no account is found for give code

FlexCheckedException

Since:

5.4

postMessage

public java.lang.String postMessage(java.lang.String pSlackAccountCode,
                                    java.lang.String pChannel,
                                    FlexSlackMessage pMessage)
                             throws FlexCheckedException

Posts a Slack message using JSON formatted based on Slack API.

Parameters:

pSlackAccountCode - Messaging account code for Slack account.

pChannel - Name or Id of channel where the notification will be sent. Use user channel Id to send direct messages.

pMessage - FlexSlackMessage to post. Formatted based on Slack API.

Returns:

Slack ts message value. This string can be used to reply to this message or start a thread

Throws:

FlexCheckedException

Since:

5.4

postMessage

public java.lang.String postMessage(java.lang.String pSlackAccountCode,
                                    java.lang.String pChannel,
                                    java.lang.String pJson)
                             throws FlexCheckedException

Posts a Slack message using JSON formatted based on Slack API.

Parameters:

pSlackAccountCode - Messaging account code for Slack account.

pChannel - Name or Id of channel where the notification will be sent. Use user channel Id to send direct messages.

pJson - Json string of your Slack message body. Formatted based on Slack API.

Returns:

Slack ts message value. This string can be used to reply to this message or start a thread

Throws:

FlexCheckedException

Since:

5.4

postSimpleMessage

public java.lang.String postSimpleMessage(java.lang.String pSlackAccountCode,
                                          java.lang.String pChannel,
                                          java.lang.String pMessageText)
                                   throws FlexCheckedException

Posts a simple Slack message to the specified channel. Slack account code that is passed must have the bearer token which is generated by Slack after adding the app to the workspace.

Parameters:

pSlackAccountCode - Messaging account code for Slack account.

pChannel - Name or Id of channel where the notification will be sent. Use user channel Id to send direct messages.

pMessageText - Text for the message that will be sent.

Throws:

FlexNotFoundException

FlexCheckedException

Since:

5.4

getGroovyKey

public java.lang.String getGroovyKey()

Specified by:

getGroovyKey in class BaseFunctions

cleanup

public void cleanup()

Specified by:

cleanup in class BaseFunctions