Where does "Custom Action Description" show up?

Question

We have edited our custom action description in a custom command so that in the log and when the user gets an email, it is more clear about what it is doing. This option in the custom command action does not seem to be doing anything. Where does this show up?

Comments

Hello Mark,

Custom action descriptions are displayed when viewing the Custom Command, Business Rule or Scheduled Task which executes the action. Also, the description is displayed in the operation execution log and in approval request notifications.

Could you, please, specify how exactly the description was specified and where you see it not working? Screenshots would be very helpful. You can post them here or send to our support email (support[at]adaxes.com).

---

We were hoping that it would show up in a report on approvals so we could do some compliance reporting. TISAX requires a double approval for account creation. Here is our custom command:

Here is the report:

Here is the script:

# Get parameter values
$days = $Context.GetParameterValue("param-Days")

# Bind to the Approval Requests container
$approvalsPath = $Context.GetWellKnownContainerPath("ApprovalRequests")
$approvals = $Context.BindToObject($approvalsPath)

# Get request GUIDs
$dateFrom = [DateTime]::Now.AddDays(- $days)
$requestGuids = $approvals.GetApprovalRequests2("ADM_APPROVALSTATE_APPROVED",
    $dateFrom, [DateTime]::MinValue)

# Create a request searcher
$requestSearcher = $Context.CreateGuidBasedSearcher($requestGuids)
$requestSearcher.BaseObjectPath = $approvalsPath
$requestSearcher.SearchParameters.VirtualRoot = $False
$propertiesToLoad = $Context.DirectorySearcher.GetPropertiesToLoad()
$requestSearcher.SetPropertiesToLoad($propertiesToLoad)

# Generate report
$Context.Items.Add($requestSearcher)

---

Hello Mark,

As per our check the script works just fine and adds approval requests to the report with their custom descriptions. Could you, please, provide us with all the possible details regarding the workflow you have for which the requests are added to the report incorrectly? Do we understand correctly that both actions in the screenshot stand for execution of the very same Custom Command? If so, could you, please, post here or send us (support[at]adaxes.com) a screenshot of the command? Any additional details would be much appreciated.

---

Here is the workflow:

Let me know if there is something specific I can supply to you.

---

Hello Mark,

What about the Custom Command executed in actions 1st Approval for %param-CFirstName% %param-CLastName% and 2nd Approval for %param-CFirstName% %param-CLastName%? Could you, please, provide a screenshot of the command configuration?

---

They are just approvals the we get before the powershell is run.

Answer 1

Hello Mark,

Thank you for clarifying. The records you see in the report correspond to execution of the Custom Command itself, not for the approvals. As long as the operation has no custom description, it is displayed as default. Also, there are no separate log records created when an operation is submitted for approval and thus you do not see your custom descriptions in the report. However, if you double-click the Execute Create Contractor Account log record in the general log, you will see something like the following in the execution log section (custom descriptions will be present): This behavior is by design. If you want to specify a custom description for execution of the Custom Command itself, you will need to execute it in another Custom Command, however, in this case there will still be a record like Execute Custom Command for in the report and in the general log.

Comments

Anyway to query the execution log and display in a report?

---

Hello Mark,

Unfortunately, there is no such possibility. However, when you generate the Adaxes log report or any other report that contains log records, you can open properties of a log record in the report by clicking it in the Web Interface or by right-clicking and then clicking Properties in the context menu in Adaxes Administration Console.

Also, you can use the following script from our repository: https://www.adaxes.com/script-repository/operations-performed-over-a-predefined-number-of-days-s78.htm.