KPI

Это KPI которые являются основой приложения.

Объект KPI

Объект имеет следующие свойства:

Название Тип Только для чтения Обязательный Макс. длина Комментарии
id integer да нет   Автоматически генерируется для KPI
category_id integer да нет   Идентификатор категории к которой принадлежит KPI
image_id integer нет да   Идентификатор иконки, которая присвоена KPI
format_id integer нет да   Идентификатор единицы измерения, которая присвоена KPI
frequency character нет да 1 Идентификатор частоты ввода данных для KPI. Это поле чувствительно к регистру и должно быть в верхнем регистре.
name string нет да 100 Название KPI
description string нет нет 150 Описание KPI
target decimal нет нет   Цель по умолчанию для KPI. Если значение пустое или равно null, то KPI не будет иметь цели
direction character нет да 1 Направление значения чувствительно к регистру и могут быть установлены только значения U(вверх), D(вниз) и N(никакое)
aggregate string нет да 3 Агрегатная функция определяет, как рассчитать KPI, и может принимать значения AVG (Среднее) или SUM (Общая сумма).
disable boolean нет да   В активные KPI можно ввести данные, если они не введены. Неактивные KPI предназначены только для отображения
calculated boolean да нет   Внести изменения в расчетные KPI через API нельзя. KPI должны быть добавлены или изменены в интерфейсе.

Пример JSON

{
  "id":                 1234,
  "category_id":        5478,
  "icon_id":            1,
  "unit_id":            123,
  "frequency_id":       "W",
  "name":               "Sales KPI",
  "description":        "This is the description",
  "target_default":     null,
  "value_direction":    "N",
  "aggregate_function": "SUM",
  "sort_order":         1,
  "is_active":          true,
  "is_calculated":      false,
  "created_at":         "2013-02-21T10:57:00",
  "updated_at":         "2013-02-21T10:58:00"
}

Пример XML

<KPI xmlns="http://schemas.datacontract.org/2004/07/Waytobi.App.Api.Models" 
          xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <id>1234</id>
  <category_id>5478</category_id>
  <icon_id>1</icon_id>
  <unit_id>123</unit_id>
  <frequency_id>W</frequency_id>
  <name>Sales KPI</name>
  <description>This is the description</description>
  <target_default>null</target_default>
  <value_direction>N</value_direction>
  <aggregate_function>SUM</aggregate_function>
  <sort_order>1</sort_order>
  <is_active>true</is_active>
  <is_calculated>false</is_calculated>
  <created_at>2013-02-21T10:12:00</created_at>
  <updated_at>2013-02-21T10:12:00</updated_at>
</KPI>

 

Получить все KPI

GET /api/kpis

Используя curl

curl https://app.waytobi.com/api/kpis
  -v -u {token}

Пример ответа

Status: 200 OK
[
  {
   "id": 111,
   "category_id": 222,
   "icon_id": 1,
   "unit_id": 11,
   "frequency_id": "M",
   "name": "Number of Sales",
   "description": "Kpi description",
   "target_default": null,
   "value_direction": "N",
   "aggregate_function": "SUM",
   "is_active": true,
   "calculated": false,
  },
  {
   "id": 112,
   "category_id": 223,
   "icon_id": 4,
   "unit_id": 2,
   "frequency_id": "D",
   "name": "Calls",
   "description": "Calls kpi description",
   "target_default": null,
   "value_direction": "N",
   "aggregate_function": "SUM",
   "is_active": true,
   "calculated": false,
  }
]

 

Получить KPI

GET /api/kpis/{id}

Используя curl

curl https://app.waytobi.com/api/kpis/{id}
  -v -u {token}

Пример ответа

Status: 200 OK
{
  "id": 111,
  "category_id": 222,
  "icon_id": 1,
  "unit_id": 11,
  "frequency_id": "M",
  "name": "Number of Sales",
  "description": "Kpi description",
  "target_default": null,
  "value_direction": "N",
  "aggregate_function": "SUM",
  "is_active": true,
  "calculated": false,
}

 

Добавить KPI

POST /api/kpis

Используя curl

curl https://app.waytobi.com/api/kpis
  -H "Content-Type: application/json" 
  -d '{"icon_id":1, "unit_id":11, "frequency_id":"M", "name":"Number of Sales", 
       "description":"New description", "target_default":100, "value_direction":"N",
       "is_active":true}'
  -v -u {token} -X POST

Пример ответа

Status: 201 Created
Location: https://app.waytobi.com/api/kpis/{id}
{
  "id": 111,
  "category_id": 222,
  "icon_id": 1,
  "unit_id": 11,
  "frequency_id": "M",
  "name": "Number of Sales",
  "description": "New description",
  "target_default": 100,
  "value_direction": "N",
  "aggregate_function": "SUM",
  "is_active": true,
  "calculated": false,
}

 

Обновить KPI

PUT /api/kpis/{id}

Используя curl

curl https://app.waytobi.com/api/kpis/{id}
  -H "Content-Type: application/json" 
  -d '{"icon_id":1, "unit_id":11, "frequency_id":"M", "name":"Number of Sales", 
       "description":"New description", "target_default":100, "value_direction":"N",
       "is_active":true}'
  -v -u {token} -X PUT

Пример ответа

Status: 200 OK
{
  "id": 111,
  "category_id": 222,
  "icon_id": 1,
  "unit_id": 11,
  "frequency_id": "M",
  "name": "Number of Sales",
  "description": "New description",
  "target_default": 100,
  "value_direction": "N",
  "aggregate_function": "SUM",
  "is_active": true,
  "calculated": false,
}

 

Удалить KPI

DELETE /api/kpis/{id}

Используя curl

curl https://app.waytobi.com/api/kpis/{id}
  -v -u {token}

Пример ответа

Status: 200 OK

Не можете найти ответ?

Ищете что-то конкретное? Попробуйте посмотреть различные папки и категории соответсвующие вашему запросу на предмет необходимой информации.

Связаться с нами