IRPCNotificationRules.GetNotificationRules

Vault API / standard read session idempotent returns metadata structure version

Gets the caller's private notification rules and the common rules that apply to the caller.

Service	Notification rules `MFiles.IRPCNotificationRules`
gRPC method	`/MFiles.IRPCNotificationRules/GetNotificationRules`
HTTP (mf-http-grpc)	`POST /grpc/v1/get-notification-rules`
Request	`GetNotificationRulesRequest`
Response	`GetNotificationRulesResponse`
Book and level	Vault API, standard
Kind	read
Session	Required: the session ID from LogIn in the mfiles-session-id-bin metadata.
Idempotent	yes
Returns metadata structure version	yes (in the mfiles-metadata-version-bin trailer)
Streaming	none (unary)

Remarks

Requires a vault session. No special vault rights are needed.
Common rules are returned when the caller is among their recipients, or when the caller has the vault right see_all_objects. Private rules of other users are never returned.
The order of the rules is not specified.

Request: GetNotificationRulesRequest

No fields.

Response: GetNotificationRulesResponse

Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page. Fields marked (recursive) refer to a type already on their path.

Field	Type	Description
`rules[]`	repeated `NotificationRule`	The rules. Built-in common rules, such as "Assigned to me", have small fixed IDs.
`rules[].id`	`int32`	The ID of the rule. Assigned by the server when the rule is created.
`rules[].name`	`string`	The name of the notification rule.
`rules[].object_filter[]`	repeated `SearchCondition`	The search conditions that an object must meet for the rule to apply, combined with AND. The built-in rules include a "not deleted" condition (`STATUS_TYPE_IS_DELETED` equal to false).
`rules[].object_filter[].expression`	`Expression`	The left side of the condition: what is evaluated for each object, such as a property value, a status value or any field (full-text search).
`rules[].object_filter[].type`	`ConditionType`	The comparison operator.
`rules[].object_filter[].value`	`TypedValue`	The right side of the condition: the value to compare with. Its data type must suit the expression, for example a lookup for a lookup property, Boolean for `STATUS_TYPE_IS_DELETED`.
`rules[].subscriptions[]`	repeated `EventSubscription`	The events that trigger a notification. A single `EVENT_TYPE_OBJECT_NOTIFICATION` subscription makes the rule filter-based: it then notifies about the objects that match `object_filter`.
`rules[].subscriptions[].type`	`EventType`	The type of the event. [ switch_is( eventtype ) ] EventTypeSpecificDataUnion etsdu; //!< Additional event type -specific data as a union.
`rules[].options`	`NOTIFICATIONFLAGS`	`is_enabled` turns the rule on, `send_digest` combines the day's notifications into one message, `exclude_self_triggered` leaves out events caused by the user, and `recurring` (filter-based rules only) repeats the notification for objects that still match.
`rules[].options.all`	`bool`	Specifies all flags set; Including any future flags.
`rules[].options.is_enabled`	`bool`	Notifications enabled.
`rules[].options.send_digest`	`bool`	Combine the day's notifications into a single message.
`rules[].options.exclude_self_triggered`	`bool`	Exclude notifications of events caused by me.
`rules[].options.recurring`	`bool`	Notifications are recurring (not only appear once per a matching object).
`rules[].is_common`	`bool`	True for a common rule that notifies the users and groups in `recipients`; false for a private rule of its owner.
`rules[].recipients`	`AccessControlList`	For a common rule, the users and groups to notify. Not used by private rules.
`rules[].recipients.checked_out_to_user`	`int32`	Specifies the ID of the user who has extended rights because of the checkout operation performed by her. 0 if such user does not exist.
`rules[].recipients.is_fully_authoritative`	`bool`	Specifies whether this access control list is set to ignore the secondary permissions that come from the latest checked in version.
`rules[].recipients.custom_component`	`AccessControlListComponent`	Accesses the custom component of this ACL.
`rules[].recipients.restrictive_components[]`	repeated `AccessControlListComponentMapEntry`	Accesses the restrictive automatic components of this ACL.
`rules[].recipients.secondary_access_control_list`	`AccessControlList` (recursive)	Secondary ACL used for latest version ACL. Not used for access check if null.
`rules[].recipients.additive_components[]`	repeated `AccessControlListComponentMapEntry`	Accesses the additive automatic components of this ACL.
`rules[].notification_days_of_week`	`uint32`	For filter-based rules, the days on which the rule is processed, as a bit mask: 1 Sunday, 2 Monday, 4 Tuesday, 8 Wednesday, 16 Thursday, 32 Friday, 64 Saturday. 127 means every day.