DashboardControlsAdd

Синтаксис

DashboardControl DashboardControlsAdd(string mon, DashboardControl arg)

Параметры

mon. Моникёр для работы с элементами управления в информационной панели.

arg. Настройки создаваемого элемента управления.

Описание

Операция DashboardControlsAdd создаёт элемент управления в информационной панели.

Комментарии

Для выполнения операции укажите в поле mon моникёр открытого экземпляра информационной панели с постфиксом «!Controls», а в поле arg настройки создаваемого элемента управления. Моникёр может быть получен при выполнении операции OpenDashboard. Минимальными требуемыми полями являются arg.id (можно указать пустую строку) и arg.k (можно указать -1). Для всех настроек, которые не были заданы, будут сгенерированы значения по умолчанию.

Результатом операции будут настройки созданного элемента управления.

Пример

Ниже приведён пример создания нового элемента управления. В запросе передаётся моникёр для работы с элементами управления, пустой идентификатор и ключ. В ответе возвращаются базовые настройки созданного элемента управления.

SOAP-запрос:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<DashboardControlsAdd xmlns="http://www.fsight.ru/PP.SOM.Som">
  <mon xmlns="">DDAHEFONHJEHGOAEEDLJNELPBEBAIMJEJILGKJKBBPLABDMK!M!S!PMAMCNGONHJEHGOAEGHJFDCONGPFPHECEDKMIJJCJCFJDMONM!Controls</mon>
<arg xmlns="">
  <k>-1</k>
  <id />
  </arg>
  </DashboardControlsAdd>
  </s:Body>
  </s:Envelope>

SOAP-ответ:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<DashboardControlsAddResult xmlns="http://www.fsight.ru/PP.SOM.Som" xmlns:q1="http://www.fsight.ru/PP.SOM.Som" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <k xmlns="">2</k>
  <id xmlns="">ITEM1</id>
<title xmlns="">
  <text>Элемент управления 1</text>
  <title>Элемент управления 1</title>
<font>
  <family>Roboto</family>
<style>
  <it>Regular</it>
  </style>
<size>
  <width>-1</width>
  <height>14</height>
  <units>Pt</units>
  </size>
  </font>
  <textColor>#54575B</textColor>
  <backgroundColor>#FFFFFF</backgroundColor>
  <textAlignment>Near</textAlignment>
  <verticalTextAlignment>Center</verticalTextAlignment>
<size>
  <width>-1</width>
  <height>8000</height>
  <units>Mkm</units>
  </size>
  <visible>1</visible>
  <htmlText><span style="font-weight: normal;font-size: 14pt;color: #54575b;background-color: #ffffff;text-align: left;font-family: Roboto; "><span style="color: #54575b;background-color: #ffffff;font-size: 14pt;font-weight: normal;font-family: Roboto; ">Элемент управления 1</span></span></htmlText>
  <htmlTitle><span style="font-weight: normal;font-size: 14pt;color: #54575b;background-color: #ffffff;text-align: left;font-family: Roboto; "><span style="color: #54575b;background-color: #ffffff;font-size: 14pt;font-weight: normal;font-family: Roboto; ">Элемент управления 1</span></span></htmlTitle>
  <isControl>1</isControl>
  <autoHeight>0</autoHeight>
  <customFormat F="" FT="0" />
  </title>
  <visualizerKey xmlns="">-1</visualizerKey>
  <fieldKey xmlns="">-1</fieldKey>
  <binding xmlns="" />
<slideKeys xmlns="">
  <u>1</u>
  <u>2</u>
  </slideKeys>
  <reciveKeys xmlns="" />
<font xmlns="">
  <family>Roboto</family>
<style>
  <it>Regular</it>
  </style>
<size>
  <width>-1</width>
  <height>14</height>
  <units>Pt</units>
  </size>
  </font>
  <textColor xmlns="">#54575B</textColor>
  <backgroundColor xmlns="">#FFFFFF</backgroundColor>
  </DashboardControlsAddResult>
  </soapenv:Body>
  </soapenv:Envelope>

JSON-запрос:

{
"DashboardControlsAdd" :
{
"mon" : "DDAHEFONHJEHGOAEEDLJNELPBEBAIMJEJILGKJKBBPLABDMK!M!S!PMAMCNGONHJEHGOAEGHJFDCONGPFPHECEDKMIJJCJCFJDMONM!Controls",
"arg" :
{
"k" : "-1",
"id" : ""
}
}
}

JSON-ответ:

{
"DashboardControlsAddResult" :
{
"k" : "2",
"id" : "ITEM1",
"title" :
{
"text" : "Элемент управления 1",
"title" : "Элемент управления 1",
"font" :
{
"family" : "Roboto",
"style" :
{
"it" : "Regular"
},
"size" :
{
"width" : "-1",
"height" : "14",
"units" : "Pt"
}
},
"textColor" : "#54575B",
"backgroundColor" : "#FFFFFF",
"textAlignment" : "Near",
"verticalTextAlignment" : "Center",
"size" :
{
"width" : "-1",
"height" : "8000",
"units" : "Mkm"
},
"visible" : "1",
"htmlText" : "<span style="font-weight: normal;font-size: 14pt;color: #54575b;background-color: #ffffff;text-align: left;font-family: Roboto; "><span style="color: #54575b;background-color: #ffffff;font-size: 14pt;font-weight: normal;font-family: Roboto; ">Элемент управления 1</span></span>",
"htmlTitle" : "<span style="font-weight: normal;font-size: 14pt;color: #54575b;background-color: #ffffff;text-align: left;font-family: Roboto; "><span style="color: #54575b;background-color: #ffffff;font-size: 14pt;font-weight: normal;font-family: Roboto; ">Элемент управления 1</span></span>",
"isControl" : "1",
"autoHeight" : "0",
"customFormat" :
{
"@F" : "",
"@FT" : "0"
}
},
"visualizerKey" : "4294967295",
"fieldKey" : "4294967295",
"binding" : "",
"slideKeys" :
{
"u" :
[
"1",
"2"
]
},
"reciveKeys" : "",
"font" :
{
"family" : "Roboto",
"style" :
{
"it" : "Regular"
},
"size" :
{
"width" : "-1",
"height" : "14",
"units" : "Pt"
}
},
"textColor" : "#54575B",
"backgroundColor" : "#FFFFFF"
}
}
public static DashboardControl DashboardControlsAdd(string moniker)
{
var somClient = new SomPortTypeClient(); // Прокси-объект для выполнения операций
// Параметры выполнения операции
var tAdd = new DashboardControlsAdd()
{
arg = new DashboardControl()
{
id = string.Empty,
k = uint.MaxValue
},
mon = moniker + "!Controls"
};
// Создание элемента управления в информационной панели
var result = somClient.DashboardControlsAdd(tAdd);
return result;
}

См. также:

Работа с информационными панелями