Operators - SailPoint Identity Services

Operators allow you to choose the path your workflow should take. Use choice operators to compare two items, or use a loop to perform a set of actions on every item in a list. Operators also include the end steps, used to mark the end of a workflow. Review the operators listed below for more information.


This is the companion discussion topic for the documentation at https://documentation.sailpoint.com/saas/help/workflows/workflow-operators.html

For Define Variable, it is possible in here to get the current timestamp by using a particular function, however this function is not visible in the documentation. It would be nice if this is added, together with all other functions we can call that are so far not documented.

Kind regards,
Angelo

1 Like

Hi Angelo! Thanks for the feedback! I’ve created a Jira ticket (SAASDOCS-7446) to update our operators documentation.

1 Like

Hi Angelo. Thanks again for your feedback.

Since the creation of this ticket additional information has been added to the documentation for the Variable Selectors generation of JSONPath expressions using the JSON Slice implementation of JSONPath. This information can be used to create customized expressions.

1 Like

Hi @rachel_rigdon, what’s the ETA for adding a sentence about the function mentioned by @angelo_mekenkamp ?

I can’t seem to find anything here: https://documentation.sailpoint.com/saas/help/workflows/workflow-operators.html#define-variable


@adamian We do not currently document custom functions, so the Variable Selectors documentation was updated to include information about using the JSON Slice implementation of JSONPath to create custom configurations like the $.now() function.

@GraemeF has created an action item for the new year to explore documenting common custom functions and use cases, including the $.now() function. We appreciate your help improving our docs!

I assume you refer to this paragraph:

The Variable Selector generates a JSONPath expression using the JSON Slice implementation of JSONPath. You can learn more about the JSON Slice implementation of JSONPath, used in actions and operators, including the specifications it is based on at the JSON Slice GitHub repository. You can use the evaluator at jsonpath.com to practice and test your JSONPath expressions against sample inputs. Note that this implementation is not used for trigger filters.

I think this reply doesn’t answer my initial question.

From what I can see, and please correct me where I am wrong:

You are saying that the documentation can be used to create custom configurations like the $.now() function. I have no idea how any customer would be able to implement a function, let’s call it $.now2(), to return the same information as $.now() in an ISC workflow.

Thanks for your reply @adamian. We’re going to follow up again with the PM and engineering teams to see how we can improve this information. We appreciate your patience with the holiday delays. :christmas_tree:

Hi @adamian. Thank you for helping us improve our documentation. Based on your feedback, we’ve added a new page to our documentation named JSON Path Expressions within Workflows providing details of all standard and enhanced functions currently supported by all workflow actions and operators.

3 Likes

The section on Compare Timestamps states that ISO 8601 date/time formats are accepted, but I’ve had real trouble getting some of the ISO 8601 compliant formats to work in Workflows. Is ISO 8601 correct, or is it meant to be RFC 3339 (RFC 3339: Date and Time on the Internet: Timestamps) compliant?

Since both of the above have a range of date/timestamp formats that are acceptable, it would be handy to have the documentation include some examples of formats that are accepted by Workflows, otherwise we spend a bunch of time trialling different formats.

Hi @RRLatFlinders! Thank you for your input. We’ve created a Jira issue to review your feedback and we’ll update the comment thread when it’s been addressed: SAASDOCS-9125.