Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Anchor
    publish
    publish
    system.cirruslink.transmission.publish(mqttServerName, topic, payload, qos, retained) → void
    • Parameters
      • String mqttServerName
        • The name of the server connection to use in the MQTT Transmission Server configuration. This must match an existing server name in the configuration.
      • String topic
        • The MQTT topic to publish on. This must be a valid MQTT topic
      • byte[] payload
        • An array of bytes representing the MQTT payload
      • int qos
        • The MQTT 'Quality of Service' to use. This must be either 0, 1, or 2
      • boolean retained
        • Whether or not to publish this message with the retained flag set
    • Return Value
      • None
  • Anchor
    createConfig
    createConfig
    system.cirruslink.transmission.createConfig(type, props) → void

    • Parameters
      • String type
        • The type of configuration to create with valid options:

          • History Stores
          • Cert Files
          • Servers
          • Sets
          • Transmitters
          • Records
          • Files
      • Map props
        • Dictionary of properties making up the configuration with the following keys and datatypes:
          • History Stores
            • Id (long)

            • Name (str)

            • Enabled (bool)

            • TransmissionHistoryStoreType (str) "IN_MEMORY" or "DISK_BACKED"

            • EdgeNodeTagCapacity (int)(deprecated 4.0.19)

            • DeviceTagCapacity (int)(deprecated 4.0.19)

            • HistoryMaxAge (int) (added 4.0.19)
            • FlushQuantity (int)

            • FlushPeriod (long)

          • Cert Files
            • Id (long)

            • Name (str)

            • FileContents (str)

            • Description (str)

            • RollingHistoryBufferEnabled (boo)(added 4.0.17)
            • RollingHistoryMaxAge (int) (added 4.0.17)
            • RollingHistoryPruneInterval (int)(added 4.0.17)
          • Cert FilesServers
            • Id (long)

            • Name (str)

            • FileContents (str)

            • Description (str)

          • Servers
            • Id (long)

            • Name (str)

            • Url (str)

            • ServerSetId (str) (must be included)

            • Username (str)

            • Password (str)

            • CaCertFileId (long)

            • ClientCertFileId (long)

            • ClientPrivateKeyFileId (long)

            • ClientKeyPassword (str)

            • HostnameVerification (bool)

            • TlsAlpnExtensions (str)
            • ClientId (str)

            • KeepAlive (int)

            • RandomStartupDelay (str)

            • ReconnectDelay (long)AutoReconnectRpcClient (bool)

            • DataFormatTypeWrapper (str) "Sparkplug_B_v1_0_Protobuf" or "Sparkplug_B_v1_0_JSON"

            Sets
            • Id AutoReconnectRpcClient (longbool)
            • Name RpcClientKeyPassword (str)
            • Description (str)

            • PrimaryHostId (str)

          • Transmitters
            • Id (long)

            • Name (str)

            • Enabled (bool)

            • TagProvider (str)

            • TagPath (str)

            • TagPacingPeriod (long)

            • ServerSetId (long)

            • DiscoveryDelay (long)

            • AliasedTags (bool)

            • CompressionTypeWrapper (long) "NONE" "DEFLATE" or "GZIP"

            • BlockCommands (bool)

            • ConvertUdts (bool)

            • PublishUdtDefinitions (bool)

            • OptimizeUdts (bool)

            • CacheBirthsEnabled (bool)

            • HistoryStoreId (long)

            • EnableStoreForwardByDefault (bool)

            • InOrderHistory (bool)

            • GroupId (str)

            • EdgeNodeId (str)

            • DeviceId (str)

            • FilteredProperties (str)

            • RebirthDebounceDelay (long)

          • Records
            • Id (long)

            • TagProvider (str)

            • TagFolderPath (str)

            • RecordType (long)

            • GroupId (str)

            • EdgeNodeId (str)

            • DeviceId (str)

            • OverridePublishTag (bool)

            • PublishTagPath (str)

            • (added 4.0.18)
            • RpcClientEnabled (bool) (added 4.0.18)
            • RpcClientPrivateKeyFileId (long) (added 4.0.18)
            • RpcTlsAlpnExtensions (str) (added 4.0.18)
            • RpcHostnameVerification (bool) (added 4.0.18)
            • RpcUsername (str) (added 4.0.18)
            • RpcClientId (str) (added 4.0.18)
            • RpcClientCertFileId (long) (added 4.0.18)
            • RpcPassword (str) (added 4.0.18)
            • RpcCaCertFileId (long) (added 4.0.18)
          • Sets
            • Id (long)

            • Name (str)

            • Description (str)

            • PrimaryHostId (str)

          • Transmitters
            • Id (long)

            • Name (str)

            • Enabled (bool)

            • TagProvider (str)

            • TagPath (str)

            • TagPacingPeriod (long)

            • ServerSetId (long) (must be included)

            • DiscoveryDelay (long)

            • AliasedTags (bool)

            • CompressionTypeWrapper (long) "NONE" "DEFLATE" or "GZIP"

            • BlockCommands (bool)

            • ConvertUdts (bool)

            • PublishUdtDefinitions (bool)

            • OptimizeUdts (bool)

            • CacheBirthsEnabled (bool)

            • HistoryStoreId (long)

            • EnableStoreForwardByDefault (bool)

            • InOrderHistory (bool)

            Files
            • Id (long)

            • TagProvider (str)

            • TagFolderPath (str)

            • EnableAutoPublishing (bool)

            • FileScanRate (int)

            • GroupId (str)

            • EdgeNodeId (str)

            • DeviceId (str)

            • MessageSize FilteredProperties (intstr)

            • MessagePacingPeriod RebirthDebounceDelay (intlong)

          • Records
            • Id MessageAckTimeout (intlong)

    • Return Value
      • None
            • TagProvider (str)

            • TagFolderPath (str)

            • RecordType (long)

            • GroupId (str)

            • EdgeNodeId (str)

            • DeviceId (str)

            • OverridePublishTag (bool)

            • PublishTagPath (str)

            • EnableSignature (bool)(added 4.0.20)
            • SignaturePassword (str)(added 4.0.20)
            • HashingAlgorithm (str)(added 4.0.20)"SHA_1","SHA_224","SHA_256","SHA_384" or "SHA_512"
          • Files
            • Id (long)

            • TagProvider (str)

            • TagFolderPath (str)

            • EnableAutoPublishing (bool)

            • FileScanRate (int)

            • GroupId (str)

            • EdgeNodeId (str)

            • DeviceId (str)

            • MessageSize (int)

            • MessagePacingPeriod (int)

            • MessageAckTimeout (int)

    • Return Value
      • A map representing the newly created configuration after it has been written to the database. (added 4.0.16)
  • Anchor
    readConfig
    readConfig
    system.cirruslink.transmission.readConfig(type) → List

    • Parameters
      • String type
        • The type of configuration to read with valid options:

          • History Stores
          • General
          • Cert Files
          • Servers
          • Sets
          • Transmitters
          • Records
          • Files
    • Return Value
      • A List of Dictionaries of properties making up the configurations with the following keys and datatypes:
        • History Stores
          • Id (long)

          • Name (str)

          • Enabled (bool)

          • TransmissionHistoryStoreType (str) "In-Memory" or "Disk-Backed"

          • EdgeNodeTagCapacity (int)(deprecated 4.0.19)

          • DeviceTagCapacity (int)(deprecated 4.0.19)

          • HistoryMaxAge (int)(added 4.0.19)
          • FlushQuantity (int)

          • FlushPeriod (long)

          • RollingHistoryBufferEnabled (bool)(added 4.0.17)
          • RollingHistoryMaxAge (int)(added 4.0.17)
          • RollingHistoryPruneInterval (int)(added 4.0.17)
        • General
          • Id (long)

          • Enabled (bool)

          • AuditProfileRecordId (long)(added 4.0.16)
        • Cert Files
          • Id (long)

          • Name (str)

          • FileContents (str)

          • Description (str)

        • Servers
          • Id (long)

          • Name (str)

          • Url (str)

          • ServerSetId (str)

          • Username (str)

          • Password (str)

          • CaCertFileId (long)

          • ClientCertFileId (long)

          • ClientPrivateKeyFileId (long)

          • ClientKeyPassword (str)

          • HostnameVerification (bool)

          • ClientId (str)

          • KeepAlive (int)

          • RandomStartupDelay (str)

          • ReconnectDelay (long)

          • DataFormatTypeWrapper (str) "Sparkplug_B_v1_0_Protobuf" or "Sparkplug_B_v1_0_JSON"

          • AutoReconnectRpcClient (bool)
          • RpcClientKeyPassword (str) (added 4.0.18)
          • RpcClientEnabled (bool) (added 4.0.18)
          • RpcClientPrivateKeyFileId (long) (added 4.0.18)
          • RpcTlsAlpnExtensions (str) (added 4.0.18)
          • RpcHostnameVerification (bool) (added 4.0.18)
          • RpcUsername (str) (added 4.0.18)
          • RpcClientId (str) (added 4.0.18)
          • RpcClientCertFileId (long) (added 4.0.18)
          • RpcPassword (str) (added 4.0.18)
          • RpcCaCertFileId (long) (added 4.0.18)
        • Sets
          • Id (long)

          • Name (str)

          • Description (str)

          • PrimaryHostId (str)

        • Transmitters
    AnchorreadConfigreadConfigsystem.cirruslink.transmission.readConfig(type) → List
    • Parameters
      • String type
        • The type of configuration to read with valid options:

          • History Stores
          • General
          • Cert Files
          • Servers
          • Sets
          • Transmitters
          • Records
          • Files
    • Return Value
      • A List of Dictionaries of properties making up the configurations with the following keys and datatypes:
        • History Stores
          • Id (long)

          • Name (str)

          • Enabled (bool)

          • TagProvider (str)

          • TagPath TransmissionHistoryStoreType (str) "In-Memory

          • TagPacingPeriod (long)

          • ServerSetId (long)

          • DiscoveryDelay (long)

          • AliasedTags (bool)

          • CompressionTypeWrapper (long) "NONE" "DEFLATE" or "Disk-BackedGZIP"

          • EdgeNodeTagCapacity BlockCommands (intbool)

          • DeviceTagCapacity ConvertUdts (intbool)

          • FlushQuantity PublishUdtDefinitions (intbool)

          • FlushPeriod OptimizeUdts (longbool)

          General
          • CacheBirthsEnabled (bool)

          • HistoryStoreId

          • Id (long)

          • Enabled EnableStoreForwardByDefault (bool)

          Cert Files
          • Id (longInOrderHistory (bool)

          • Name GroupId (str)

          • FileContents EdgeNodeId (str)

          • Description DeviceId (str)

          Servers
          • Id FilteredProperties (longstr)

          • Name RebirthDebounceDelay (strlong)

        • Records
          • Id (long

          • Url (str)

          • ServerSetId (str)

          • Username TagProvider (str)

          • Password TagFolderPath (str)

          • CaCertFileId RecordType (long)

          • ClientCertFileId GroupId (longstr)

          • ClientPrivateKeyFileId EdgeNodeId (longstr)

          • ClientKeyPassword DeviceId (str)

          • HostnameVerification OverridePublishTag (bool)

          • ClientId PublishTagPath (str)KeepAlive (int

          • EnableSignature (bool)(added 4.0.20)
          • RandomStartupDelay SignaturePassword (str)ReconnectDelay (long(added 4.0.20)AutoReconnectRpcClient
          • HashingAlgorithm (bool)
          • DataFormatTypeWrapper (str) "Sparkplug_B_v1_0_Protobuf" or "Sparkplug_B_v1_0_JSON"

          • str)(added 4.0.20)"SHA_1",SHA_224","SHA_256","SHA_384" or "SHA_512"
        • FilesSets
          • Id (long)

          • Name TagProvider (str)

          • Description TagFolderPath (str)

          • PrimaryHostId EnableAutoPublishing (strbool)

          Transmitters
          • Id FileScanRate (longint)

          • Name GroupId (str)

          • Enabled EdgeNodeId (boolstr)

          • TagProvider DeviceId (str)

          • TagPath MessageSize (strint)

          • TagPacingPeriod MessagePacingPeriod (longint)

          • ServerSetId MessageAckTimeout (long)

          • DiscoveryDelay (long)

          • AliasedTags (bool)

          • CompressionTypeWrapper (long) "NONE" "DEFLATE" or "GZIP"

          • BlockCommands (bool)

          • ConvertUdts (bool)

          • PublishUdtDefinitions (bool)

          • OptimizeUdts (bool)

          • CacheBirthsEnabled (bool)

          • HistoryStoreId (long)

          • EnableStoreForwardByDefault (bool)

          • InOrderHistory (bool)

          • GroupId (str)

          • EdgeNodeId (str)

          • DeviceId (str)

          • FilteredProperties (str)

          • RebirthDebounceDelay (long)

          Records
          • int)

  • Anchor
    updateConfig
    updateConfig
    system.cirruslink.transmission.updateConfig(type, id, collisionPolicy, props) → void
    • Parameters
      • String type
        • The type of configuration to update with valid options:

          • History Stores
          • General
          • Cert Files
          • Servers
          • Sets
          • Transmitters
          • Records
          • Files
      • Long id
        • The ID of the record to update
      • String collisionPolicy
        • "MergeOverwrite" or "Overwrite"
          • "MergeOverwrite" will replace the existing properties in the record ID with only those included in the call
          • "Overwrite" will replace all properties in the record ID with those in the call
      • Map props
        • Dictionary of properties making up the configuration with the following keys and datatypes:
          • History Stores
            • Id (long)

            TagProvider OverridePublishTag (
            • Name (str)

          • TagFolderPath (str)

          • RecordType (long)

          • GroupId (str)

          • EdgeNodeId (str)

          • DeviceId (str)

            • Enabled (bool)

            PublishTagPath
            • TransmissionHistoryStoreType (str)

        • Files
          • Id (long)

          • TagProvider (str)

          • TagFolderPath (str)

          • EnableAutoPublishing (bool)

          • FileScanRate (int)

          • GroupId (str)

          • EdgeNodeId (str)

          • DeviceId (str)

          • MessageSize (int)

          • MessagePacingPeriod (int)

          • MessageAckTimeout (int)

    AnchorupdateConfig
            • "IN-MEMORY" or "DISK_BACKED"

            • EdgeNodeTagCapacity (int)(deprecated 4.0.19)

            • DeviceTagCapacity (int)(deprecated 4.0.19)

            • HistoryMaxAge (int)(added 4.0.19)
            • FlushQuantity (int)

            • FlushPeriod (long)

            • RollingHistoryBufferEnabled (bool)(added 4.0.17)
            • RollingHistoryMaxAge (int)(added 4.0.17)
            • RollingHistoryPruneInterval (int)(added 4.0.17)
          • General
            • Id (long)

            • Enabled (bool)

            • AuditProfileRecordId (long)(added 4.0.16)
          • Cert Files
            • Id (long)

            • Name (str)

            • FileContents (str)

            • Description (str)

          • Servers
    updateConfigsystem.cirruslink.transmission.updateConfig(type, id, collisionPolicy, props) → void
    • Parameters
      • String type
        • The type of configuration to update with valid options:

          • History Stores
          • General
          • Cert Files
          • Servers
          • Sets
          • Transmitters
          • Records
          • Files
      • Long id
        • The ID of the record to update
      • String collisionPolicy
        • "MergeOverwrite" or "Overwrite"
          • "MergeOverwrite" will replace the existing properties in the record ID with only those included in the call
          • "Overwrite" will replace all properties in the record ID with those in the call
      • Map props
        • Dictionary of properties making up the configuration with the following keys and datatypes:
          • History Stores
            • Id (long)

            • Name (str)

            • Url (str)

            • ServerSetId (str)

            • Username (strEnabled (bool)

            • TransmissionHistoryStoreType Password (str) "IN-MEMORY" or "DISK_BACKED"

            • EdgeNodeTagCapacity (int)

            • DeviceTagCapacity (int)

            • FlushQuantity (int)

            • FlushPeriod (long)

          • General
            • Id (long)

            • Enabled (bool)

          • Cert Files
            • Id (long)

            • Name (str)

            • FileContents (str)

            • Description (str)

            • CaCertFileId (long)

            • ClientCertFileId (long)

            • ClientPrivateKeyFileId (long)

            • ClientKeyPassword (str)

            • HostnameVerification (bool)

            • ClientId (str)

            • KeepAlive (int)

            • RandomStartupDelay (str)

            • ReconnectDelay (long)

            • DataFormatTypeWrapper (str) "Sparkplug_B_v1_0_Protobuf" or "Sparkplug_B_v1_0_JSON"

            • AutoReconnectRpcClient (bool)
            • RpcClientKeyPassword (str) (added 4.0.18)
            • RpcClientEnabled (bool) (added 4.0.18)
            • RpcClientPrivateKeyFileId (long) (added 4.0.18)
            • RpcTlsAlpnExtensions (str) (added 4.0.18)
            • RpcHostnameVerification (bool) (added 4.0.18)
            • RpcUsername (str) (added 4.0.18)
            • RpcClientId (str) (added 4.0.18)
            • RpcClientCertFileId (long) (added 4.0.18)
            • RpcPassword (str) (added 4.0.18)
            • RpcCaCertFileId (long) (added 4.0.18)
            Servers
            • Id (long)

            • Name (str)

            • Url (str)

            • ServerSetId (str)

            • Username (str)

            • Password (str)

            • CaCertFileId (long)

            • ClientCertFileId (long)

            • ClientPrivateKeyFileId (long)

            • ClientKeyPassword (str)

            • HostnameVerification (bool)

            • ClientId (str)

            • KeepAlive (int)

            • RandomStartupDelay (str)

            • ReconnectDelay (long)

            • AutoReconnectRpcClient (bool)

            • DataFormatTypeWrapper (str) "Sparkplug_B_v1_0_Protobuf" or "Sparkplug_B_v1_0_JSON"
          • Sets
            • Id (long)

            • Name (str)

            • Description (str)

            • PrimaryHostId (str)

          • Transmitters
            • Id (long)

            • Name (str)

            • Enabled (bool)

            • TagProvider (str)

            • TagPath (str)

            • TagPacingPeriod (long)

            • ServerSetId (long)

            • DiscoveryDelay (long)

            • AliasedTags (bool)

            • CompressionTypeWrapper (long) "NONE" "DEFLATE" or "GZIP"

            • BlockCommands (bool)

            • ConvertUdts (bool)

            • PublishUdtDefinitions (bool)

            • OptimizeUdts (bool)

            • CacheBirthsEnabled (bool)

            • HistoryStoreId (long)

            • EnableStoreForwardByDefault (bool)

            • InOrderHistory (bool)

            • GroupId (str)

            • EdgeNodeId (str)

            • DeviceId (str)

            • FilteredProperties (str)

            • RebirthDebounceDelay (long)

          • Records
            • Id (long)

            • TagProvider (str)

            • TagFolderPath (str)

            • RecordType (long)

            • GroupId (str)

            • EdgeNodeId (str)

            • DeviceId (str)

            • OverridePublishTag (bool)

            • str)

            • OverridePublishTag (bool)

            • PublishTagPath (str)

            • EnableSignature (bool)(added 4.0.20)
            • SignaturePassword (str)(added 4.0.20)
            • HashingAlgorithm (str)(added 4.0.20PublishTagPath (str)
          • Files
            • Id (long)

            • TagProvider (str)

            • TagFolderPath (str)

            • EnableAutoPublishing (bool)

            • FileScanRate (int)

            • GroupId (str)

            • EdgeNodeId (str)

            • DeviceId (str)

            • MessageSize (int)

            • MessagePacingPeriod (int)

            • MessageAckTimeout (int)

    • Return Value
      • NoneA map representing the updated configuration after it has been written to the database. (added 4.0.16)
  • Anchor
    deleteConfig
    deleteConfig
    system.cirruslink.transmission.deleteConfig(type, id) → void

    • Parameters
      • String type
        • The type of configuration to delete with valid options:

          • History Stores
          • General
          • Cert Files
          • Servers
          • Sets
          • Transmitters
          • Records
          • Files
      • Long id
        • The ID of the record to delete
    • Return Value
      • NoneTrue if the record is successfully deleted otherwise False is returned (added 4.0.16)


Anchor
SampleScripts
SampleScripts
Sample Script

...