Документация / API / Json / Компоненты / UpdateComponent

---

Обновление информации о компоненте

Обновляются только заполненные свойства.
Свойства, которые не переданы в запросе, сохранят свои текущие значения.

АдресВашегоСервисаApi/UpdateComponent

{
    "Token": {
        "SecretKey": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
    },
    "Data": {
        "Id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "ParentId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "SystemName": "ComponentSystemName",
        "DisplayName": "ComponentDisplayName",
        "TypeId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "Version": "1.0.0.0",
        "Properties": [
            {
                "Name": "Property1",
                "Value": "10.0",
                "Type": "double"
            },
            ...
        ]
    }
}

Здесь:

• Token — раздел с токеном авторизации. В нём:
  • SecretKey (string) — ключ доступа к Api, посмотрите в Личном кабинете в разделе Управление — Ключи доступа к Api
• Id (guid) — Уникальный Id компонента, для которого будет обновлена информация.
• ParentId (guid) — Уникальный Id нового компонента-родителя.
• SystemName (string) — Новое системное имя.
• DisplayName (string) — Новое отображаемое имя.
• TypeId (guid) — Уникальный Id нового типа компонента.
• Version (string) — Новая версия компонента.
• Properties (array) — Массив новых дополнительных свойств компонента:
  • Name (string) — Название свойства.
  • Value — Значение свойства.
  • Type (string) — Тип свойства. Может быть одним из: Boolean, DateTime, Double, Int32, Int64, Binary, String, Guid.

{
    "Data": {
        "Id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "ParentId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
        "SystemName": "ComponentSystemName",
        "DisplayName": "ComponentDisplayName",
        "CreatedDate": "2016-04-30T23:25:43.511Z",
        "Version": "1.0.0.0"
        "Type": {
            "Id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
            "SystemName": "ComponentTypeSystemName",
            "DisplayName": "ComponentTypeDisplayName",
            "IsSystem": false
        },
        "Properties": [
            {
                "Name": "Property1",
                "Value": "10.0",
                "Type": "double"
            },
            ...
        ]
    },
    "Code": 10
}

Здесь:

• Id (guid) — Уникальный Id компонента.
• ParentId (guid) — Уникальный Id компонента-родителя.
• SystemName (string) — Системное имя компонента.
• DisplayName (string) — Отображаемое имя компонента.
• CreatedDate (datetime) — Дата и время создания компонента.
• Version (string) — Версия компонента.
• Type — Информация о типе компонента:
  • Id (guid) — Уникальный Id типа компонента.
  • SystemName (string) — Системное имя типа компонента.
  • DisplayName (string) — Отображаемое имя типа компонента.
  • IsSystem (bool) — Является ли тип компонента системным (общим для всех аккаунтов).
• Properties (array) — Массив дополнительных свойств компонента:
  • Name (string) — Название свойства.
  • Value — Значение свойства.
  • Type (string) — Тип свойства. Может быть одним из: Boolean, DateTime, Double, Int32, Int64, Binary, String, Guid.

Если компонента или компонента-родителя с указанным Id не существует, то Code будет равен 1100, а Data будет пустым.

Если типа компонента с указанным Id не существует или системное имя перестаёт быть уникальным в рамках поддерева родителя, то Code будет равен 1141, а Data будет пустым.