Workflow Question

Question

Is it possible to craft a Business Rule that would send an email notification only if the request for an action was denied?

Thanks

Answer 1

Update 2018

Starting with Adaxes 2018.1, Adaxes automatically sends email notifications to approvers and the operation initiator when an approval request is denied. For details on configuring the notifications, have a look at the following help article: https://www.adaxes.com/help/CustomizeEmailNotifications.

Original

Hello Brad,

By default, Adaxes sends a notification to the operation initiator when the operation is denied.
Unfortunately it is impossible to create a Business Rule that will send a notification when a request is rejected.
However, you can create a Scheduled Task that will execute a script that will send email notifications for all requests rejected during the last hour/day/month.
We can implement such a script for you.

Comments

It would be great to see an example script.

Thanks

---

No problem.

$Hours = 24 # TODO: must depend on the schedule of the task

$admNS = New-Object("Softerra.Adaxes.Adsi.AdmNamespace")
$admService = $admNS.GetServiceDirectly("localhost")

function SendNotification($approval)
{
    $to = "%mail%"
    if ([System.String]::IsNullOrEmpty($to))
    {
        $Context.LogMessage("Email address is empty!", "Error")
        return
    }
    $subject = "My Subject"
    $bodyText = $NULL
    $requestorName = $approval.Requestor.Get("name")
    $deniedBy = $approval.ProcessedBy.Get("name")
    $operation = $approval.DescriptionOfOperationToApprove
    $reason = $approval.DenialOrCancelingReason
    $bodyHtml = @"
Requestor: $requestorName<br />
Denied by: $deniedBy<br />
Reason: $reason<br />
Operation: $operation<br />
"@
    $Context.SendMail($to, $subject, $bodyText, $bodyHtml)
}
# Bind to the Approval Requests container
$approvalsPath = $admService.Backend.GetConfigurationContainerPath("ApprovalRequests")
$aprovalsContainer = $admService.OpenObject($approvalsPath.ToString(), $NULL, $NULL, 0)
# Get all denied approval requests
$aprovals = $aprovalsContainer.GetApprovalRequests("ADM_APPROVALSTATE_DENIED")

foreach ($requestID in $aprovals)
{
    # Bind to the approval request
    $guid = New-Object "System.Guid" (,$requestID)
    $guid = $guid.ToString("B")
    $approvalsPath = "Adaxes://<GUID=$guid>"
    $approval = $admService.OpenObject($approvalsPath, $NULL, $NULL, 0)

    # Check whether the request was modified during the last N hours
    $modificationDate = $approval.Get("whenChanged");
    if ([System.DateTime]::Now -gt $modificationDate.AddHours($Hours))
    {
        continue
    }

    SendNotification($approval)
}

1. Open the PowerShell script in a text editor and customize it for your needs (2012.1 will introduce an embedded PowerShell script editor).
2. Launch Adaxes Administration Console.
3. Run the Scheduled Task Creation wizard.
4. On the 3rd step of the wizard select the User object type.
5. On the 4th step, click Add Action.
6. Select the Run a program of PowerShell script action.
7. Paste the script to the Script edit box, click OK, and then click Next.
8. On the 5th step of the wizard, click Add.
9. In the dialog that opens select the User object type in the Object Types drop-down dialog.
10. In the list of available objects, select the users you want to receive email notifications.
    
11. Click OK and then click Finish.

That's it :) Little bit tricky, but works.