nisystemlink
0.1
  • Getting Started
  • API Reference
    • nisystemlink.clients.core
    • nisystemlink.clients.alarm
    • nisystemlink.clients.tag
    • nisystemlink.clients.product
    • nisystemlink.clients.testmonitor
    • nisystemlink.clients.dataframe
    • nisystemlink.clients.spec
    • nisystemlink.clients.file
    • nisystemlink.clients.notebook
    • nisystemlink.clients.feeds
    • nisystemlink.clients.assetmanagement
    • nisystemlink.clients.systems
    • nisystemlink.clients.work_item
    • nisystemlink.clients.test_plan
    • nisystemlink.clients.artifact
    • nisystemlink.clients.notification
      • NotificationClient
        • NotificationClient.__init__()
        • NotificationClient.apply_dynamic_notification_strategy()
      • AddressGroup
        • AddressGroup.fields
        • AddressGroup.interpreting_service_name
      • DynamicNotificationConfiguration
        • DynamicNotificationConfiguration.address_group
        • DynamicNotificationConfiguration.address_group_id
        • DynamicNotificationConfiguration.message_template
        • DynamicNotificationConfiguration.message_template_id
        • DynamicNotificationConfiguration.validate_required_pairs
      • DynamicNotificationStrategy
        • DynamicNotificationStrategy.notification_configurations
      • DynamicStrategyRequest
        • DynamicStrategyRequest.message_template_substitution_fields
        • DynamicStrategyRequest.notification_strategy
      • MessageTemplate
        • MessageTemplate.fields
        • MessageTemplate.interpreting_service_name
      • SmtpAddressFields
        • SmtpAddressFields.bcc_addresses
        • SmtpAddressFields.cc_addresses
        • SmtpAddressFields.to_addresses
      • SmtpAddressGroup
        • SmtpAddressGroup.fields
        • SmtpAddressGroup.interpreting_service_name
        • SmtpAddressGroup.set_interpreting_service_name
      • SmtpMessageTemplate
        • SmtpMessageTemplate.fields
        • SmtpMessageTemplate.interpreting_service_name
        • SmtpMessageTemplate.set_interpreting_service_name
      • SmtpMessageTemplateFields
        • SmtpMessageTemplateFields.body_template
        • SmtpMessageTemplateFields.subject_template
    • Indices and tables
nisystemlink
  • API Reference
  • nisystemlink.clients.notification
  • View page source

nisystemlink.clients.notification

class nisystemlink.clients.notification.NotificationClient(configuration=None)[source]
__init__(configuration=None)[source]

Initialize an instance.

Parameters

configuration (Optional[nisystemlink.clients.core.HttpConfiguration]) – Defines the web server to connect to and information about how to connect. If not provided, the HttpConfigurationManager is used to obtain the configuration.

Raises

ApiException – if unable to communicate with the /ninotification service.

apply_dynamic_notification_strategy(request)[source]

Applies the notification strategy from the given request.

Parameters

request (nisystemlink.clients.notification.models.DynamicStrategyRequest) – Request with message template substitution fields and notification strategies.

Return type

None

Returns

None.

Raises

ApiException – if unable to communicate with the /ninotification service or provided invalid arguments.

pydantic model nisystemlink.clients.notification.models.AddressGroup[source]

Model defining notification recipients for generic service.

Show JSON schema
{
   "title": "AddressGroup",
   "description": "Model defining notification recipients for generic service.",
   "type": "object",
   "properties": {
      "id": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Id"
      },
      "displayName": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Displayname"
      },
      "properties": {
         "anyOf": [
            {
               "additionalProperties": {
                  "type": "string"
               },
               "type": "object"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Properties"
      },
      "referencingNotificationStrategies": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Referencingnotificationstrategies"
      },
      "interpretingServiceName": {
         "title": "Interpretingservicename",
         "type": "string"
      },
      "fields": {
         "additionalProperties": {
            "items": {
               "type": "string"
            },
            "type": "array"
         },
         "title": "Fields",
         "type": "object"
      }
   },
   "required": [
      "interpretingServiceName",
      "fields"
   ]
}

Fields
  • fields

  • interpreting_service_name

field fields: Dict[str, List[str]] [Required]

Address group’s fields. Requires at least one valid recipient.

field interpreting_service_name: str [Required]

Name of the interpreting service.

pydantic model nisystemlink.clients.notification.models.DynamicNotificationConfiguration[source]

Model for notification configuration defining address groups and message template for the notification.

Requires at least one of addressGroupId or addressGroup, and one of messageTemplateId or messageTemplate.

Show JSON schema
{
   "title": "DynamicNotificationConfiguration",
   "description": "Model for notification configuration defining address groups and message template for the notification.\n\nRequires at least one of addressGroupId or addressGroup, and one of messageTemplateId or messageTemplate.",
   "type": "object",
   "properties": {
      "addressGroupId": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Addressgroupid"
      },
      "messageTemplateId": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Messagetemplateid"
      },
      "addressGroup": {
         "anyOf": [
            {
               "$ref": "#/$defs/AddressGroup"
            },
            {
               "$ref": "#/$defs/SmtpAddressGroup"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Addressgroup"
      },
      "messageTemplate": {
         "anyOf": [
            {
               "$ref": "#/$defs/MessageTemplate"
            },
            {
               "$ref": "#/$defs/SmtpMessageTemplate"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Messagetemplate"
      }
   },
   "$defs": {
      "AddressGroup": {
         "description": "Model defining notification recipients for generic service.",
         "properties": {
            "id": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Id"
            },
            "displayName": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Displayname"
            },
            "properties": {
               "anyOf": [
                  {
                     "additionalProperties": {
                        "type": "string"
                     },
                     "type": "object"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Properties"
            },
            "referencingNotificationStrategies": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Referencingnotificationstrategies"
            },
            "interpretingServiceName": {
               "title": "Interpretingservicename",
               "type": "string"
            },
            "fields": {
               "additionalProperties": {
                  "items": {
                     "type": "string"
                  },
                  "type": "array"
               },
               "title": "Fields",
               "type": "object"
            }
         },
         "required": [
            "interpretingServiceName",
            "fields"
         ],
         "title": "AddressGroup",
         "type": "object"
      },
      "MessageTemplate": {
         "description": "Model defining the notification content structure.",
         "properties": {
            "id": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Id"
            },
            "displayName": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Displayname"
            },
            "properties": {
               "anyOf": [
                  {
                     "additionalProperties": {
                        "type": "string"
                     },
                     "type": "object"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Properties"
            },
            "referencingNotificationStrategies": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Referencingnotificationstrategies"
            },
            "interpretingServiceName": {
               "title": "Interpretingservicename",
               "type": "string"
            },
            "fields": {
               "additionalProperties": {
                  "type": "string"
               },
               "title": "Fields",
               "type": "object"
            }
         },
         "required": [
            "interpretingServiceName",
            "fields"
         ],
         "title": "MessageTemplate",
         "type": "object"
      },
      "SmtpAddressFields": {
         "description": "Recipient address fields used in SMTP messaging.",
         "properties": {
            "toAddresses": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Toaddresses"
            },
            "ccAddresses": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Ccaddresses"
            },
            "bccAddresses": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Bccaddresses"
            }
         },
         "title": "SmtpAddressFields",
         "type": "object"
      },
      "SmtpAddressGroup": {
         "description": "Model defining notification recipients for SMTP service.",
         "properties": {
            "id": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Id"
            },
            "displayName": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Displayname"
            },
            "properties": {
               "anyOf": [
                  {
                     "additionalProperties": {
                        "type": "string"
                     },
                     "type": "object"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Properties"
            },
            "referencingNotificationStrategies": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Referencingnotificationstrategies"
            },
            "interpretingServiceName": {
               "const": "smtp",
               "default": "smtp",
               "title": "Interpretingservicename",
               "type": "string"
            },
            "fields": {
               "$ref": "#/$defs/SmtpAddressFields"
            }
         },
         "required": [
            "fields"
         ],
         "title": "SmtpAddressGroup",
         "type": "object"
      },
      "SmtpMessageTemplate": {
         "description": "Model defining message template for SMTP service",
         "properties": {
            "id": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Id"
            },
            "displayName": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Displayname"
            },
            "properties": {
               "anyOf": [
                  {
                     "additionalProperties": {
                        "type": "string"
                     },
                     "type": "object"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Properties"
            },
            "referencingNotificationStrategies": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Referencingnotificationstrategies"
            },
            "interpretingServiceName": {
               "const": "smtp",
               "default": "smtp",
               "title": "Interpretingservicename",
               "type": "string"
            },
            "fields": {
               "$ref": "#/$defs/SmtpMessageTemplateFields"
            }
         },
         "required": [
            "fields"
         ],
         "title": "SmtpMessageTemplate",
         "type": "object"
      },
      "SmtpMessageTemplateFields": {
         "description": "Template fields to construct an SMTP message.",
         "properties": {
            "subjectTemplate": {
               "title": "Subjecttemplate",
               "type": "string"
            },
            "bodyTemplate": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Bodytemplate"
            }
         },
         "required": [
            "subjectTemplate"
         ],
         "title": "SmtpMessageTemplateFields",
         "type": "object"
      }
   }
}

Fields
  • address_group

  • address_group_id

  • message_template

  • message_template_id

Validators
  • validate_required_pairs » all fields

field address_group: AddressGroup | SmtpAddressGroup | None = None

Address group defining notification recipients.

Validated by
  • validate_required_pairs

field address_group_id: str | None = None

ID referencing the associated address group.

Validated by
  • validate_required_pairs

field message_template: MessageTemplate | SmtpMessageTemplate | None = None

Message template defining notification content structure

Validated by
  • validate_required_pairs

field message_template_id: str | None = None

ID referencing the associated message template.

Validated by
  • validate_required_pairs

validator validate_required_pairs  »  all fields[source]

Validator to check at least one of address_group_id or address_group, and one of message_template_id or message_template is present.

Return type

nisystemlink.clients.notification.models.DynamicNotificationConfiguration

pydantic model nisystemlink.clients.notification.models.DynamicNotificationStrategy[source]

Model for the notification strategy to be applied.

Show JSON schema
{
   "title": "DynamicNotificationStrategy",
   "description": "Model for the notification strategy to be applied.",
   "type": "object",
   "properties": {
      "notificationConfigurations": {
         "items": {
            "$ref": "#/$defs/DynamicNotificationConfiguration"
         },
         "minItems": 1,
         "title": "Notificationconfigurations",
         "type": "array"
      }
   },
   "$defs": {
      "AddressGroup": {
         "description": "Model defining notification recipients for generic service.",
         "properties": {
            "id": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Id"
            },
            "displayName": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Displayname"
            },
            "properties": {
               "anyOf": [
                  {
                     "additionalProperties": {
                        "type": "string"
                     },
                     "type": "object"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Properties"
            },
            "referencingNotificationStrategies": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Referencingnotificationstrategies"
            },
            "interpretingServiceName": {
               "title": "Interpretingservicename",
               "type": "string"
            },
            "fields": {
               "additionalProperties": {
                  "items": {
                     "type": "string"
                  },
                  "type": "array"
               },
               "title": "Fields",
               "type": "object"
            }
         },
         "required": [
            "interpretingServiceName",
            "fields"
         ],
         "title": "AddressGroup",
         "type": "object"
      },
      "DynamicNotificationConfiguration": {
         "description": "Model for notification configuration defining address groups and message template for the notification.\n\nRequires at least one of addressGroupId or addressGroup, and one of messageTemplateId or messageTemplate.",
         "properties": {
            "addressGroupId": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Addressgroupid"
            },
            "messageTemplateId": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Messagetemplateid"
            },
            "addressGroup": {
               "anyOf": [
                  {
                     "$ref": "#/$defs/AddressGroup"
                  },
                  {
                     "$ref": "#/$defs/SmtpAddressGroup"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Addressgroup"
            },
            "messageTemplate": {
               "anyOf": [
                  {
                     "$ref": "#/$defs/MessageTemplate"
                  },
                  {
                     "$ref": "#/$defs/SmtpMessageTemplate"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Messagetemplate"
            }
         },
         "title": "DynamicNotificationConfiguration",
         "type": "object"
      },
      "MessageTemplate": {
         "description": "Model defining the notification content structure.",
         "properties": {
            "id": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Id"
            },
            "displayName": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Displayname"
            },
            "properties": {
               "anyOf": [
                  {
                     "additionalProperties": {
                        "type": "string"
                     },
                     "type": "object"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Properties"
            },
            "referencingNotificationStrategies": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Referencingnotificationstrategies"
            },
            "interpretingServiceName": {
               "title": "Interpretingservicename",
               "type": "string"
            },
            "fields": {
               "additionalProperties": {
                  "type": "string"
               },
               "title": "Fields",
               "type": "object"
            }
         },
         "required": [
            "interpretingServiceName",
            "fields"
         ],
         "title": "MessageTemplate",
         "type": "object"
      },
      "SmtpAddressFields": {
         "description": "Recipient address fields used in SMTP messaging.",
         "properties": {
            "toAddresses": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Toaddresses"
            },
            "ccAddresses": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Ccaddresses"
            },
            "bccAddresses": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Bccaddresses"
            }
         },
         "title": "SmtpAddressFields",
         "type": "object"
      },
      "SmtpAddressGroup": {
         "description": "Model defining notification recipients for SMTP service.",
         "properties": {
            "id": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Id"
            },
            "displayName": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Displayname"
            },
            "properties": {
               "anyOf": [
                  {
                     "additionalProperties": {
                        "type": "string"
                     },
                     "type": "object"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Properties"
            },
            "referencingNotificationStrategies": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Referencingnotificationstrategies"
            },
            "interpretingServiceName": {
               "const": "smtp",
               "default": "smtp",
               "title": "Interpretingservicename",
               "type": "string"
            },
            "fields": {
               "$ref": "#/$defs/SmtpAddressFields"
            }
         },
         "required": [
            "fields"
         ],
         "title": "SmtpAddressGroup",
         "type": "object"
      },
      "SmtpMessageTemplate": {
         "description": "Model defining message template for SMTP service",
         "properties": {
            "id": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Id"
            },
            "displayName": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Displayname"
            },
            "properties": {
               "anyOf": [
                  {
                     "additionalProperties": {
                        "type": "string"
                     },
                     "type": "object"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Properties"
            },
            "referencingNotificationStrategies": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Referencingnotificationstrategies"
            },
            "interpretingServiceName": {
               "const": "smtp",
               "default": "smtp",
               "title": "Interpretingservicename",
               "type": "string"
            },
            "fields": {
               "$ref": "#/$defs/SmtpMessageTemplateFields"
            }
         },
         "required": [
            "fields"
         ],
         "title": "SmtpMessageTemplate",
         "type": "object"
      },
      "SmtpMessageTemplateFields": {
         "description": "Template fields to construct an SMTP message.",
         "properties": {
            "subjectTemplate": {
               "title": "Subjecttemplate",
               "type": "string"
            },
            "bodyTemplate": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Bodytemplate"
            }
         },
         "required": [
            "subjectTemplate"
         ],
         "title": "SmtpMessageTemplateFields",
         "type": "object"
      }
   },
   "required": [
      "notificationConfigurations"
   ]
}

Fields
  • notification_configurations

field notification_configurations: Annotated[List[DynamicNotificationConfiguration]] [Required]

Notification configurations associated with this strategy.

Constraints
  • min_length = 1

pydantic model nisystemlink.clients.notification.models.DynamicStrategyRequest[source]

Request model for applying a dynamic notification strategy.

Show JSON schema
{
   "title": "DynamicStrategyRequest",
   "description": "Request model for applying a dynamic notification strategy.",
   "type": "object",
   "properties": {
      "messageTemplateSubstitutionFields": {
         "anyOf": [
            {
               "additionalProperties": {
                  "type": "string"
               },
               "type": "object"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Messagetemplatesubstitutionfields"
      },
      "notificationStrategy": {
         "$ref": "#/$defs/DynamicNotificationStrategy"
      }
   },
   "$defs": {
      "AddressGroup": {
         "description": "Model defining notification recipients for generic service.",
         "properties": {
            "id": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Id"
            },
            "displayName": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Displayname"
            },
            "properties": {
               "anyOf": [
                  {
                     "additionalProperties": {
                        "type": "string"
                     },
                     "type": "object"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Properties"
            },
            "referencingNotificationStrategies": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Referencingnotificationstrategies"
            },
            "interpretingServiceName": {
               "title": "Interpretingservicename",
               "type": "string"
            },
            "fields": {
               "additionalProperties": {
                  "items": {
                     "type": "string"
                  },
                  "type": "array"
               },
               "title": "Fields",
               "type": "object"
            }
         },
         "required": [
            "interpretingServiceName",
            "fields"
         ],
         "title": "AddressGroup",
         "type": "object"
      },
      "DynamicNotificationConfiguration": {
         "description": "Model for notification configuration defining address groups and message template for the notification.\n\nRequires at least one of addressGroupId or addressGroup, and one of messageTemplateId or messageTemplate.",
         "properties": {
            "addressGroupId": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Addressgroupid"
            },
            "messageTemplateId": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Messagetemplateid"
            },
            "addressGroup": {
               "anyOf": [
                  {
                     "$ref": "#/$defs/AddressGroup"
                  },
                  {
                     "$ref": "#/$defs/SmtpAddressGroup"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Addressgroup"
            },
            "messageTemplate": {
               "anyOf": [
                  {
                     "$ref": "#/$defs/MessageTemplate"
                  },
                  {
                     "$ref": "#/$defs/SmtpMessageTemplate"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Messagetemplate"
            }
         },
         "title": "DynamicNotificationConfiguration",
         "type": "object"
      },
      "DynamicNotificationStrategy": {
         "description": "Model for the notification strategy to be applied.",
         "properties": {
            "notificationConfigurations": {
               "items": {
                  "$ref": "#/$defs/DynamicNotificationConfiguration"
               },
               "minItems": 1,
               "title": "Notificationconfigurations",
               "type": "array"
            }
         },
         "required": [
            "notificationConfigurations"
         ],
         "title": "DynamicNotificationStrategy",
         "type": "object"
      },
      "MessageTemplate": {
         "description": "Model defining the notification content structure.",
         "properties": {
            "id": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Id"
            },
            "displayName": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Displayname"
            },
            "properties": {
               "anyOf": [
                  {
                     "additionalProperties": {
                        "type": "string"
                     },
                     "type": "object"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Properties"
            },
            "referencingNotificationStrategies": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Referencingnotificationstrategies"
            },
            "interpretingServiceName": {
               "title": "Interpretingservicename",
               "type": "string"
            },
            "fields": {
               "additionalProperties": {
                  "type": "string"
               },
               "title": "Fields",
               "type": "object"
            }
         },
         "required": [
            "interpretingServiceName",
            "fields"
         ],
         "title": "MessageTemplate",
         "type": "object"
      },
      "SmtpAddressFields": {
         "description": "Recipient address fields used in SMTP messaging.",
         "properties": {
            "toAddresses": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Toaddresses"
            },
            "ccAddresses": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Ccaddresses"
            },
            "bccAddresses": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Bccaddresses"
            }
         },
         "title": "SmtpAddressFields",
         "type": "object"
      },
      "SmtpAddressGroup": {
         "description": "Model defining notification recipients for SMTP service.",
         "properties": {
            "id": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Id"
            },
            "displayName": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Displayname"
            },
            "properties": {
               "anyOf": [
                  {
                     "additionalProperties": {
                        "type": "string"
                     },
                     "type": "object"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Properties"
            },
            "referencingNotificationStrategies": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Referencingnotificationstrategies"
            },
            "interpretingServiceName": {
               "const": "smtp",
               "default": "smtp",
               "title": "Interpretingservicename",
               "type": "string"
            },
            "fields": {
               "$ref": "#/$defs/SmtpAddressFields"
            }
         },
         "required": [
            "fields"
         ],
         "title": "SmtpAddressGroup",
         "type": "object"
      },
      "SmtpMessageTemplate": {
         "description": "Model defining message template for SMTP service",
         "properties": {
            "id": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Id"
            },
            "displayName": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Displayname"
            },
            "properties": {
               "anyOf": [
                  {
                     "additionalProperties": {
                        "type": "string"
                     },
                     "type": "object"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Properties"
            },
            "referencingNotificationStrategies": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Referencingnotificationstrategies"
            },
            "interpretingServiceName": {
               "const": "smtp",
               "default": "smtp",
               "title": "Interpretingservicename",
               "type": "string"
            },
            "fields": {
               "$ref": "#/$defs/SmtpMessageTemplateFields"
            }
         },
         "required": [
            "fields"
         ],
         "title": "SmtpMessageTemplate",
         "type": "object"
      },
      "SmtpMessageTemplateFields": {
         "description": "Template fields to construct an SMTP message.",
         "properties": {
            "subjectTemplate": {
               "title": "Subjecttemplate",
               "type": "string"
            },
            "bodyTemplate": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Bodytemplate"
            }
         },
         "required": [
            "subjectTemplate"
         ],
         "title": "SmtpMessageTemplateFields",
         "type": "object"
      }
   },
   "required": [
      "notificationStrategy"
   ]
}

Fields
  • message_template_substitution_fields

  • notification_strategy

field message_template_substitution_fields: Optional[Dict[str, str]] = None

Defines the fields used for substituting values in the message template.

Example: { “replacement”: “value” }

field notification_strategy: DynamicNotificationStrategy [Required]

Notification strategy containing configurations for address groups and message templates.

pydantic model nisystemlink.clients.notification.models.MessageTemplate[source]

Model defining the notification content structure.

Show JSON schema
{
   "title": "MessageTemplate",
   "description": "Model defining the notification content structure.",
   "type": "object",
   "properties": {
      "id": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Id"
      },
      "displayName": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Displayname"
      },
      "properties": {
         "anyOf": [
            {
               "additionalProperties": {
                  "type": "string"
               },
               "type": "object"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Properties"
      },
      "referencingNotificationStrategies": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Referencingnotificationstrategies"
      },
      "interpretingServiceName": {
         "title": "Interpretingservicename",
         "type": "string"
      },
      "fields": {
         "additionalProperties": {
            "type": "string"
         },
         "title": "Fields",
         "type": "object"
      }
   },
   "required": [
      "interpretingServiceName",
      "fields"
   ]
}

Fields
  • fields

  • interpreting_service_name

field fields: Dict[str, str] [Required]

Template fields for message.

field interpreting_service_name: str [Required]

Name of the interpreting service

pydantic model nisystemlink.clients.notification.models.SmtpAddressFields[source]

Recipient address fields used in SMTP messaging.

Show JSON schema
{
   "title": "SmtpAddressFields",
   "description": "Recipient address fields used in SMTP messaging.",
   "type": "object",
   "properties": {
      "toAddresses": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Toaddresses"
      },
      "ccAddresses": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Ccaddresses"
      },
      "bccAddresses": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Bccaddresses"
      }
   }
}

Fields
  • bcc_addresses

  • cc_addresses

  • to_addresses

field bcc_addresses: Optional[List[str]] = None

List of blind carbon copy recipient addresses.

field cc_addresses: Optional[List[str]] = None

List of carbon copy recipient addresses.

field to_addresses: Optional[List[str]] = None

List of primary recipient addresses.

pydantic model nisystemlink.clients.notification.models.SmtpAddressGroup[source]

Model defining notification recipients for SMTP service.

Show JSON schema
{
   "title": "SmtpAddressGroup",
   "description": "Model defining notification recipients for SMTP service.",
   "type": "object",
   "properties": {
      "id": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Id"
      },
      "displayName": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Displayname"
      },
      "properties": {
         "anyOf": [
            {
               "additionalProperties": {
                  "type": "string"
               },
               "type": "object"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Properties"
      },
      "referencingNotificationStrategies": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Referencingnotificationstrategies"
      },
      "interpretingServiceName": {
         "const": "smtp",
         "default": "smtp",
         "title": "Interpretingservicename",
         "type": "string"
      },
      "fields": {
         "$ref": "#/$defs/SmtpAddressFields"
      }
   },
   "$defs": {
      "SmtpAddressFields": {
         "description": "Recipient address fields used in SMTP messaging.",
         "properties": {
            "toAddresses": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Toaddresses"
            },
            "ccAddresses": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Ccaddresses"
            },
            "bccAddresses": {
               "anyOf": [
                  {
                     "items": {
                        "type": "string"
                     },
                     "type": "array"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Bccaddresses"
            }
         },
         "title": "SmtpAddressFields",
         "type": "object"
      }
   },
   "required": [
      "fields"
   ]
}

Fields
  • fields

  • interpreting_service_name

Validators
  • set_interpreting_service_name » all fields

field fields: SmtpAddressFields [Required]

Recipient address fields used for SMTP notifications.

Valid fields:
  • to_addresses

  • cc_addresses

  • bcc_addresses

Example

{

to_addresses: [ “address1@example.com” ], cc_addresses: [ “address2@example.com” ], bcc_addresses: [ “address3@example.com” ]

}

Validated by
  • set_interpreting_service_name

field interpreting_service_name: Literal['smtp'] = 'smtp'

Service name for SMTP-based interpretation.

Validated by
  • set_interpreting_service_name

validator set_interpreting_service_name  »  all fields[source]
Return type

nisystemlink.clients.notification.models.SmtpAddressGroup

pydantic model nisystemlink.clients.notification.models.SmtpMessageTemplate[source]

Model defining message template for SMTP service

Show JSON schema
{
   "title": "SmtpMessageTemplate",
   "description": "Model defining message template for SMTP service",
   "type": "object",
   "properties": {
      "id": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Id"
      },
      "displayName": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Displayname"
      },
      "properties": {
         "anyOf": [
            {
               "additionalProperties": {
                  "type": "string"
               },
               "type": "object"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Properties"
      },
      "referencingNotificationStrategies": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Referencingnotificationstrategies"
      },
      "interpretingServiceName": {
         "const": "smtp",
         "default": "smtp",
         "title": "Interpretingservicename",
         "type": "string"
      },
      "fields": {
         "$ref": "#/$defs/SmtpMessageTemplateFields"
      }
   },
   "$defs": {
      "SmtpMessageTemplateFields": {
         "description": "Template fields to construct an SMTP message.",
         "properties": {
            "subjectTemplate": {
               "title": "Subjecttemplate",
               "type": "string"
            },
            "bodyTemplate": {
               "anyOf": [
                  {
                     "type": "string"
                  },
                  {
                     "type": "null"
                  }
               ],
               "default": null,
               "title": "Bodytemplate"
            }
         },
         "required": [
            "subjectTemplate"
         ],
         "title": "SmtpMessageTemplateFields",
         "type": "object"
      }
   },
   "required": [
      "fields"
   ]
}

Fields
  • fields

  • interpreting_service_name

Validators
  • set_interpreting_service_name » all fields

field fields: SmtpMessageTemplateFields [Required]

Subject and body template fields for SMTP messages.

Validated by
  • set_interpreting_service_name

field interpreting_service_name: Literal['smtp'] = 'smtp'

Service name for SMTP-based interpretation.

Validated by
  • set_interpreting_service_name

validator set_interpreting_service_name  »  all fields[source]
Return type

nisystemlink.clients.notification.models.SmtpMessageTemplate

pydantic model nisystemlink.clients.notification.models.SmtpMessageTemplateFields[source]

Template fields to construct an SMTP message.

Show JSON schema
{
   "title": "SmtpMessageTemplateFields",
   "description": "Template fields to construct an SMTP message.",
   "type": "object",
   "properties": {
      "subjectTemplate": {
         "title": "Subjecttemplate",
         "type": "string"
      },
      "bodyTemplate": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Bodytemplate"
      }
   },
   "required": [
      "subjectTemplate"
   ]
}

Fields
  • body_template

  • subject_template

field body_template: Optional[str] = None

Body template of the message.

field subject_template: str [Required]

Subject template of the message.

Previous

© Copyright 2020, National Instruments.

Built with Sphinx using a theme provided by Read the Docs.