Jump to

• Request
• Response

Create an Event Display Conversion

post

/api/event/DisplayConversions

Creates a new event display conversion.
The minimum required properties in the request body are:

• Field
• Conversions

Caution: If you add a display conversion for a field that is used as a token in an event tool path, you must update the event tool to add Raw to the end of the field name.
For example, if you create a conversion for ZoneID, you must update the paths for the Device Overview and View Metric tools to use <ZoneIDRaw> instead of <ZoneID>.
If you later disable the conversion, you do not have to update the tool path again. The path will still work with the Raw field name, even when the conversion is disabled. If you delete the conversion, you must update the path to remove Raw.
See the /api/event/tools endpoints for more information about getting, updating, and creating event tools.

Request

There are no request parameters for this operation.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Show Source

• Conversions: array Conversions
  List of unordered conversions for the given field. Array of field value conversion mappings
• Field: string
  Name of Events field

  Example: EventCategory

{
    "type":"object",
    "properties":{
        "Field":{
            "$ref":"#/components/schemas/eventDisplayConversionRead/properties/Field"
        },
        "Conversions":{
            "$ref":"#/components/schemas/eventDisplayConversionRead/properties/Conversions"
        }
    }
}

Nested Schema : Conversions

Type: array

List of unordered conversions for the given field. Array of field value conversion mappings

Show Source

• Array of: object items

{
    "description":"List of unordered conversions for the given field. Array of field value conversion mappings",
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "CompareValue":{
                "description":"DB value in the Event database in the related field",
                "type":"integer",
                "example":1
            },
            "DisplayValue":{
                "description":"Converted value the user will see instead of the raw DB value",
                "type":"string",
                "example":"Resolution"
            }
        }
    },
    "example":[
        {
            "CompareValue":1,
            "DisplayValue":"Resolution"
        },
        {
            "CompareValue":2,
            "DisplayValue":"Problem"
        },
        {
            "CompareValue":3,
            "DisplayValue":"Discrete"
        }
    ]
}

Example:

[
    {
        "CompareValue":1,
        "DisplayValue":"Resolution"
    },
    {
        "CompareValue":2,
        "DisplayValue":"Problem"
    },
    {
        "CompareValue":3,
        "DisplayValue":"Discrete"
    }
]

Nested Schema : items

Type: object

Show Source

• CompareValue: integer
  DB value in the Event database in the related field

  Example: 1
• DisplayValue: string
  Converted value the user will see instead of the raw DB value

  Example: Resolution

{
    "type":"object",
    "properties":{
        "CompareValue":{
            "description":"DB value in the Event database in the related field",
            "type":"integer",
            "example":1
        },
        "DisplayValue":{
            "description":"Converted value the user will see instead of the raw DB value",
            "type":"string",
            "example":"Resolution"
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

200 Response

Successful operation

Body ()

Root Schema : schema

Match All

Show Source

• object SuccessfulAddOperation
  The response body for a successful add operation.
• object type

{
    "allOf":[
        {
            "$ref":"#/components/schemas/SuccessfulAddOperation"
        },
        {
            "type":"object",
            "properties":{
                "data":{
                    "description":"The properties of the new event display conversion.",
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/eventDisplayConversionRead"
                    }
                },
                "total":{
                    "description":"The total number of results regardless of paging.",
                    "type":"integer",
                    "example":"1"
                }
            }
        }
    ]
}

Nested Schema : SuccessfulAddOperation

Type: object

The response body for a successful add operation.

Show Source

• message: string
  The response message.

  Example: Added record
• success: boolean
  Whether the operation was a success (true) or a failure (false).

  Example: true

{
    "description":"The response body for a successful add operation.",
    "properties":{
        "success":{
            "description":"Whether the operation was a success (<b>true</b>) or a failure (<b>false</b>).",
            "type":"boolean",
            "example":"true"
        },
        "message":{
            "description":"The response message.",
            "type":"string",
            "example":"Added record"
        }
    },
    "type":"object"
}

Nested Schema : type

Type: object

Show Source

• data: array data
  The properties of the new event display conversion.
• total: integer
  The total number of results regardless of paging.

  Example: 1

{
    "type":"object",
    "properties":{
        "data":{
            "description":"The properties of the new event display conversion.",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/eventDisplayConversionRead"
            }
        },
        "total":{
            "description":"The total number of results regardless of paging.",
            "type":"integer",
            "example":"1"
        }
    }
}

Nested Schema : data

Type: array

The properties of the new event display conversion.

Show Source

• Array of: object eventDisplayConversionRead

{
    "description":"The properties of the new event display conversion.",
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/eventDisplayConversionRead"
    }
}

Nested Schema : eventDisplayConversionRead

Type: object

Show Source

• ConversionCount: integer
  The number of conversions related to the field

  Example: 3
• Conversions: array Conversions
  List of unordered conversions for the given field. Array of field value conversion mappings
• Field: string
  Name of Events field

  Example: EventCategory
• FieldID: string
  Name of Events field.

  Example: EventCategory

{
    "type":"object",
    "properties":{
        "FieldID":{
            "description":"Name of Events field.",
            "type":"string",
            "example":"EventCategory"
        },
        "Field":{
            "description":"Name of Events field",
            "type":"string",
            "example":"EventCategory"
        },
        "ConversionCount":{
            "description":"The number of conversions related to the field",
            "type":"integer",
            "example":"3"
        },
        "Conversions":{
            "description":"List of unordered conversions for the given field. Array of field value conversion mappings",
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "CompareValue":{
                        "description":"DB value in the Event database in the related field",
                        "type":"integer",
                        "example":1
                    },
                    "DisplayValue":{
                        "description":"Converted value the user will see instead of the raw DB value",
                        "type":"string",
                        "example":"Resolution"
                    }
                }
            },
            "example":[
                {
                    "CompareValue":1,
                    "DisplayValue":"Resolution"
                },
                {
                    "CompareValue":2,
                    "DisplayValue":"Problem"
                },
                {
                    "CompareValue":3,
                    "DisplayValue":"Discrete"
                }
            ]
        }
    }
}

Nested Schema : Conversions

Type: array

List of unordered conversions for the given field. Array of field value conversion mappings

Show Source

• Array of: object items

{
    "description":"List of unordered conversions for the given field. Array of field value conversion mappings",
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "CompareValue":{
                "description":"DB value in the Event database in the related field",
                "type":"integer",
                "example":1
            },
            "DisplayValue":{
                "description":"Converted value the user will see instead of the raw DB value",
                "type":"string",
                "example":"Resolution"
            }
        }
    },
    "example":[
        {
            "CompareValue":1,
            "DisplayValue":"Resolution"
        },
        {
            "CompareValue":2,
            "DisplayValue":"Problem"
        },
        {
            "CompareValue":3,
            "DisplayValue":"Discrete"
        }
    ]
}

Example:

[
    {
        "CompareValue":1,
        "DisplayValue":"Resolution"
    },
    {
        "CompareValue":2,
        "DisplayValue":"Problem"
    },
    {
        "CompareValue":3,
        "DisplayValue":"Discrete"
    }
]

Nested Schema : items

Type: object

Show Source

• CompareValue: integer
  DB value in the Event database in the related field

  Example: 1
• DisplayValue: string
  Converted value the user will see instead of the raw DB value

  Example: Resolution

{
    "type":"object",
    "properties":{
        "CompareValue":{
            "description":"DB value in the Event database in the related field",
            "type":"integer",
            "example":1
        },
        "DisplayValue":{
            "description":"Converted value the user will see instead of the raw DB value",
            "type":"string",
            "example":"Resolution"
        }
    }
}

Default Response

Failed operation

Body ()

Root Schema : schema

Type: object

Show Source

• errors: array errors
  The list of errors reported. Validation errors will be keyed by record field.
• message: string
  The response message.

  Example: Exception thrown
• success: boolean
  Whether the operation was a success (true) or a failure (false).

  Example: false

{
    "properties":{
        "success":{
            "description":"Whether the operation was a success (<b>true</b>) or a failure (<b>false</b>).",
            "type":"boolean",
            "example":"false"
        },
        "message":{
            "description":"The response message.",
            "type":"string",
            "example":"Exception thrown"
        },
        "errors":{
            "description":"The list of errors reported. Validation errors will be keyed by record field.",
            "type":"array",
            "items":{
                "description":"An error.",
                "type":"object"
            }
        }
    },
    "type":"object"
}

Nested Schema : errors

Type: array

The list of errors reported. Validation errors will be keyed by record field.

Show Source

• Array of: object items
  An error.

{
    "description":"The list of errors reported. Validation errors will be keyed by record field.",
    "type":"array",
    "items":{
        "description":"An error.",
        "type":"object"
    }
}

Nested Schema : items

Type: object

An error.

Back to Top