SetTabRangeComment

Синтаксис

bool SetTabRangeComment(string mon, TabRangeComment tArg)

Параметры

mon. Моникёр для работы с ячейкой таблицы.

tArg. Параметры установки примечания.

Описание

Операция SetTabRangeComment добавляет новое или изменяет существующее примечание для ячейки.

Комментарии

Для выполнения операции укажите в поле mon моникёр для работы с ячейкой в следующем формате: «Моникёр экземпляра рег.отчёта!Sheets!Ключ листа!абсолютный адрес». Если будет указан моникёр диапазона ячеек, то операция будет выполнена для верхней левой ячейки диапазона.

Результатом операции будет логическое значение true, если изменение примечания завершилось успешно.

Пример

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

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">
<SetTabRangeComment xmlns="http://www.fsight.ru/PP.SOM.Som">
  <mon xmlns="">HBNCFAKEFPMNFOAEGJLELNECHEGOAOHEKJALPKOGKEBPFMNE!M!S!PKHDIGFKEFPMNFOAEDGNBAHBMBHMJKBNENLGGOOJBLJAKBOAO!Sheets!1!A1</mon>
<tArg xmlns="">
  <trc>Область исходных данных</trc>
  </tArg>
  </SetTabRangeComment>
  </s:Body>
  </s:Envelope>

SOAP-ответ:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
  <SetTabRangeCommentResult 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">1</SetTabRangeCommentResult>
  </soapenv:Body>
  </soapenv:Envelope>

JSON-запрос:

{
 "SetTabRangeComment" : 
  {
   "mon" : "HBNCFAKEFPMNFOAEGJLELNECHEGOAOHEKJALPKOGKEBPFMNE!M!S!PKHDIGFKEFPMNFOAEDGNBAHBMBHMJKBNENLGGOOJBLJAKBOAO!Sheets!1!A1",
   "tArg" : 
    {
     "trc" : "Область исходных данных"
    }
  }
}

JSON-ответ:

{
 "SetTabRangeCommentResult" : "1"
}
public static bool SetTabRangeComment(string moniker, string sheetKey, string adress, string comment)
{
    var somClient = new SomPortTypeClient(); // Прокси-объект для выполнения операции
    // Параметры выполнения операции
    var tTab = new SetTabRangeComment()
    {
        mon = moniker + "!Sheets!" + sheetKey + '!' + adress,
        tArg = new TabRangeComment()
        {
            trc = comment
        }
    };
    // Изменение примечания ячейки
    var result = somClient.SetTabRangeComment(tTab);
    return result;
}

См. также:

Таблица: Операции