Hierarchy

Index

Methods

Static createMetric

Static deleteMetric

Static getMetric

Static getPaginator

Static listMetric

  • listMetric(__namedParameters?: { dataTypeName: string[]; dataTypeVersion: string[]; endingBefore: string; names: string[]; pageSize: number; search: string[]; semanticTypeName: string[]; sortAsc: boolean; sortBy: string; startingAfter: string }, options?: IKvHttpRequestOptions): Observable<MetricListPaginated>
  • List Metric List Metric Returns a dictionary with a data property containing a list of all <a href='https://docs.kelvininc.com/latest/kelvin-overview/kelvin-platform/kelvin-metrics/&#39; target='_blank'>Kelvin Metrics</a> on the <a href='https://docs.kelvininc.com/latest/kelvin-overview/overview/#kelvin-platform&#39; target='_blank'>Kelvin Platform</a>. Pagination Sortable Columns: `metric.name`, `metric.title`, `metric.data_type_name`, `metric.data_type_version`, `metric.display_unit`, `metric.semantic_type_name`, `metric.write`, `metric.created`, `metric.updated`, `semantic_type.title` Permission Required: `kelvin.permission.metric.read`

    Parameters

    • Default value __namedParameters: { dataTypeName: string[]; dataTypeVersion: string[]; endingBefore: string; names: string[]; pageSize: number; search: string[]; semanticTypeName: string[]; sortAsc: boolean; sortBy: string; startingAfter: string } = {}
      • dataTypeName: string[]

        Array of data type names to filter the list. Each string will only return a Data Type Type object with exact matches on the `name` parameter.</p> There are 13 types of data type options; `raw.boolean`, `raw.dynacard`, `raw.float32`, `raw.float64`, `raw.int8`, `raw.int16`, `raw.int32`, `raw.int64`, `raw.uint8`, `raw.uint16`, `raw.uint32`, `raw.uint64` and `raw.text`.

      • dataTypeVersion: string[]

        Array of data type versions to filter the list. Each string will only return a Data Type Type object with exact matches on the `name` parameter.</p> For example; `2.0.0` will return results, but `2.0` will not.

      • endingBefore: string

        An alphanumeric string to move to the previous page of <a href='https://docs.kelvininc.com/latest/kelvin-overview/kelvin-platform/kelvin-metrics/&#39; target='_blank'>Kelvin Metrics</a> in the list.</p> The alphanumeric string which are the bookmarks for the beginning and end of the current list is given in the previous JSON response value under the key pagination -> previous_page and pagination -> next_page respectively.</p> The pagination -> previous_page alphanumeric string should be used here to show a list of the previous page of results.

      • names: string[]

        Filter on the parameter <a href='https://docs.kelvininc.com/latest/kelvin-overview/kelvin-platform/kelvin-metrics/&#39; target='blank'>Kelvin Metric</a> by its name. This is given as an array, for example `[extruder,tank]`.</p> The filter is done on the full name only according to unique identifier name rules (Must contain only lowercase alphanumeric characters. The `.`, `` and `-` characters are also allowed to separate words instead of a space but not at the beginning or end).</p> For example a filter with `[extruder,tank]` will return <a href='https://docs.kelvininc.com/latest/kelvin-overview/kelvin-platform/kelvin-metrics/&#39; target='_blank'>Kelvin Metric</a> with the name `extruder` but not with the names `demo-ch-extruder-gear-setpoint` or `demo-og-gas-tank-level`.

      • pageSize: number

        Number of <a href='https://docs.kelvininc.com/latest/kelvin-overview/kelvin-platform/kelvin-metrics/&#39; target='_blank'>Kelvin Metric</a> objects to be returned. Page size can be between 1 and 1000 objects.</p> The default is 20 <a href='https://docs.kelvininc.com/latest/kelvin-overview/kelvin-platform/kelvin-metrics/&#39; target='_blank'>Kelvin Metric</a> objects.

      • search: string[]

        Search and filter the <a href='https://docs.kelvininc.com/latest/kelvin-overview/kelvin-platform/kelvin-metrics/&#39; target='_blank'>Kelvin Metric</a> list. Both the Display Name and the Name will be included in the filter field criteria. This is given as an array, for example `[extruder,tank]`.</p> The search is case insensitive and will find partial matches as well. For example if a <a href='https://docs.kelvininc.com/latest/kelvin-overview/kelvin-platform/kelvin-metrics/&#39; target='_blank'>Kelvin Metric</a> name or display name is `demo-og-centrifugal-pump-speed`, then a match will be made if the filter string is `demo` or `FUGaL`.

      • semanticTypeName: string[]

        Array of names to filter the list. Each string will only return a Sematic Type object with exact matches on the `name` parameter.</p> This must contain only lowercase alphanumeric characters. The `.`, `_` and `-` characters are also allowed to separate words instead of a space BUT can not be at the beginning or end of the name.

      • sortAsc: boolean

        Sorting order for the results according to the `sort_by` parameter.</p> There are two options; `true` (ascending order) and `false` (descending order).</p> The default is `true` (ascending).

      • sortBy: string

        Sort the results by one of the <a href='https://docs.kelvininc.com/latest/kelvin-overview/kelvin-platform/kelvin-metrics/&#39; target='_blank'>Kelvin Metric</a> parameters. Only one parameter can be selected.</p> There are ten parameter options; `metric.name`, `metric.title`, `metric.data_type_name`, `metric.data_type_version`, `metric.display_unit`, `metric.semantic_type_name`, `metric.write`, `metric.created`, `metric.updated` and `semantic_type.title`.</p> The default is `metric.name`

      • startingAfter: string

        An alphanumeric string to move to the next page of <a href='https://docs.kelvininc.com/latest/kelvin-overview/kelvin-platform/kelvin-metrics/&#39; target='_blank'>Kelvin Metrics</a> in the list.</p> The alphanumeric string which are the bookmarks for the beginning and end of the current list is given in the previous JSON response value under the key pagination -> previous_page and pagination -> next_page respectively.</p> The pagination -> next_page alphanumeric string should be used here to show a list of the next page of results.

    • Optional options: IKvHttpRequestOptions

      Request optional parameters

    Returns Observable<MetricListPaginated>

Static listSemanticType

  • List Semantic Type List Semantic Type Returns a dictionary with a data property containing a list of all available Semantic Type options on the <a href='https://docs.kelvininc.com/latest/kelvin-overview/overview/#kelvin-platform&#39; target='_blank'>Kelvin Platform</a>. Sematic Types are sensors that stream data to the Kelvin Metric. Depending on the options chosen, there may be more properties available which will be saved to the SemanticTypeProperties parameters. Sortable Columns: `semantic_type.name`, `semantic_type.title`, `semantic_type.created`, `semantic_type.updated` Permission Required: `kelvin.permission.metric.read`

    Parameters

    • Default value __namedParameters: { names: string[]; search: string[]; sortAsc: boolean; sortBy: string } = {}
      • names: string[]

        Array of names to filter the list. Each string will only return a Sematic Type object with exact matches on the `name` parameter.</p> This must contain only lowercase alphanumeric characters. The `.`, `_` and `-` characters are also allowed to separate words instead of a space BUT can not be at the beginning or end of the name.

      • search: string[]

        Search and filter the <a href='https://docs.kelvininc.com/latest/kelvin-overview/kelvin-platform/kelvin-metrics/&#39; target='_blank'>Kelvin Metric</a> list. Both the Display Name and the Name will be included in the search field criteria. This is given as an array, for example `[accelerometer,event]`.</p> The search is case insensitive and will find partial matches as well. For example if a <a href='https://docs.kelvininc.com/latest/kelvin-overview/kelvin-platform/kelvin-metrics/&#39; target='_blank'>Kelvin Metric</a> name or display name is `Accelerometer`, then a match will be made if the search string is `acc` or `rOmeT`.

      • sortAsc: boolean

        Sorting order for the results according to the `sort_by` parameter.</p> There are two options; `true` (ascending order) and `false` (descending order).</p> The default is `true` (ascending).

      • sortBy: string

        Sort the results by one of the <a href='https://docs.kelvininc.com/latest/kelvin-overview/kelvin-platform/kelvin-metrics/&#39; target='_blank'>Kelvin Metric</a> parameters. Only one parameter can be selected.</p> There are four parameter options; `semantic_type.name`, `semantic_type.title`, `semantic_type.created`, `semantic_type.updated`.</p> The default is `semantic_type.name`

    • Optional options: IKvHttpRequestOptions

      Request optional parameters

    Returns Observable<SemanticTypeList>

Static onError

Static request

Static requestUrl

  • requestUrl<T>(request: IKvHttpRequest, modelClass?: IModel, autenticated?: boolean): Observable<T>

Static updateMetric

Static uploadMetrics