SetDmCalc

Синтаксис

DmCalcResult SetDmCalc(DmId tDim, SetDmCalcArg tArg)

Параметры

tDim. Моникёр экземпляра вычисляемого справочника.

tArg. Параметры выполнения операции.

Описание

Операция SetDmCalc изменяет метаданные вычисляемого справочника.

Комментарии

Данная операция позволяет изменить структуру вычисляемого справочника: атрибуты, блоки, индексы, уровни справочника, макрос для построения дерева элементов, а также другие настройки, влияющие на работу справочника. Вычисляемый справочник должен быть открыт на редактирование. Для выполнения операции укажите в поле tDim моникёр экземпляра вычисляемого справочника, а в поле tArg параметры изменения. Моникёр может быть получен при выполнении операции OpenDim. В поле tArg.pattern укажите шаблон, в соответствии с которым будут производиться изменения, а в поле tArg.args изменяемые метаданные. После внесения изменений для сохранения справочника используйте операцию SaveObject или SaveObjectAs. Результатом работы операции будут обновлённые метаданные, если был указан шаблон tArg.metaGet.

Пример

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

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">
<SetDmCalc xmlns="http://www.fsight.ru/PP.SOM.Som">
<tDim xmlns="">
  <id>S1!M!S!DM1</id>
  </tDim>
<tArg xmlns="">
<pattern>
  <obInst>true</obInst>
  <attributes>Add</attributes>
  </pattern>
<args>
<attributes>
<attributes>
<it>
  <k>18446744073709551615</k>
  <name>Дополнительное значение</name>
  <id>ADDITIONAL</id>
  <dataType>3</dataType>
  </it>
  </attributes>
  </attributes>
  </args>
<metaGet>
  <obInst>true</obInst>
  <attributes>Get</attributes>
  </metaGet>
  </tArg>
  </SetDmCalc>
  </s:Body>
  </s:Envelope>

SOAP-ответ:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<SetDmCalcResult 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">
<id xmlns="">
  <id>S1!M!S!DM1</id>
  </id>
<meta xmlns="">
<obInst>
<obDesc ds="" isShortcut="0" isLink="0" ver="6" hf="0">
  <i>DIM_CALC</i>
  <n>Справочник</n>
  <k>175067</k>
  <c>1027</c>
  <p>175063</p>
  <h>0</h>
  <hasPrv>0</hasPrv>
  <ic>0</ic>
  <isPermanent>1</isPermanent>
  <isTemp>0</isTemp>
  </obDesc>
  </obInst>
  <dirty>0</dirty>
<attributes>
<attributes>
<it>
  <k>1</k>
  <name>Наименование</name>
  <id>NAME</id>
  <dataType>1</dataType>
  <visible>1</visible>
  <nameDest>1</nameDest>
  <hasHierarchy>0</hasHierarchy>
<order>
  <pattern>None</pattern>
  </order>
  </it>
<it>
  <k>2</k>
  <name>Идентификатор</name>
  <id>ID</id>
  <dataType>2</dataType>
  <visible>1</visible>
  <idDest>1</idDest>
  <hasHierarchy>0</hasHierarchy>
<order>
  <pattern>None</pattern>
  </order>
  </it>
<it>
  <k>3</k>
  <name>Порядок</name>
  <id>ORDER</id>
  <dataType>2</dataType>
  <visible>1</visible>
  <hasHierarchy>0</hasHierarchy>
<order>
  <pattern>Get</pattern>
  <reverse>0</reverse>
  <index>0</index>
  </order>
  </it>
<it>
  <k>4</k>
  <name>Дополнительное значение</name>
  <id>ADDITIONAL</id>
  <dataType>3</dataType>
  <visible>1</visible>
  <hasHierarchy>0</hasHierarchy>
<order>
  <pattern>None</pattern>
  </order>
  </it>
  </attributes>
  <hideInaccessible>1</hideInaccessible>
  </attributes>
  </meta>
  </SetDmCalcResult>
  </soapenv:Body>
  </soapenv:Envelope>

JSON-запрос:

{
"SetDmCalc" :
{
"tDim" :
{
"id" : "S1!M!S!DM1"
},
"tArg" :
{
"pattern" :
{
"obInst" : "true",
"attributes" : "Add"
},
"args" :
{
"attributes" :
{
"attributes" :
{
"it" :
{
"k" : "18446744073709551615",
"name" : "Дополнительное значение",
"id" : "ADDITIONAL",
"dataType" : "3"
}
}
}
},
"metaGet" :
{
"obInst" : "true",
"attributes" : "Get"
}
}
}
}

JSON-ответ:

{
"SetDmCalcResult" :
{
"id" :
{
"id" : "S1!M!S!DM1"
},
"meta" :
{
"obInst" :
{
"obDesc" :
{
"@ds" : "",
"@isShortcut" : "0",
"@isLink" : "0",
"@ver" : "6",
"@hf" : "0",
"i" : "DIM_CALC",
"n" : "Справочник",
"k" : "175067",
"c" : "1027",
"p" : "175063",
"h" : "0",
"hasPrv" : "0",
"ic" : "0",
"isPermanent" : "1",
"isTemp" : "0"
}
},
"dirty" : "0",
"attributes" :
{
"attributes" :
{
"it" :
[
{
"k" : "1",
"name" : "Наименование",
"id" : "NAME",
"dataType" : "1",
"visible" : "1",
"nameDest" : "1",
"hasHierarchy" : "0",
"order" :
{
"pattern" : "None"
}
},
{
"k" : "2",
"name" : "Идентификатор",
"id" : "ID",
"dataType" : "2",
"visible" : "1",
"idDest" : "1",
"hasHierarchy" : "0",
"order" :
{
"pattern" : "None"
}
},
{
"k" : "3",
"name" : "Порядок",
"id" : "ORDER",
"dataType" : "2",
"visible" : "1",
"hasHierarchy" : "0",
"order" :
{
"pattern" : "Get",
"reverse" : "0",
"index" : "0"
}
},
{
"k" : "4",
"name" : "Дополнительное значение",
"id" : "ADDITIONAL",
"dataType" : "3",
"visible" : "1",
"hasHierarchy" : "0",
"order" :
{
"pattern" : "None"
}
}
]
},
"hideInaccessible" : "1"
}
}
}
}
public static DmCalcResult ChangeUserDimension(DmId moniker)
{
var somClient = new SomPortTypeClient(); //Прокси-объект для выполнения операций
//Параметры выполнения операции
var tSet = new SetDmCalc()
{
tArg = new SetDmCalcArg()
{
pattern = new DmCalcMdPattern()
{
attributes = ListOperation.Add
},
args = new DmCalcMd()
{
attributes= new DmCalcAttributes()
{
attributes = new DmCalcAttribute[]
{
new DmCalcAttribute()
{
id = "ADDITIONAL",
name = "Дополнительное значение",
dataType = 3, //DbDataType.Float
k = ulong.MaxValue
}
}
}
},
metaGet = new DmCalcMdPattern()
{
attributes = ListOperation.Get
}
},
tDim = moniker
};
//Изменение вычисляемого справочника
var result = somClient.SetDmCalc(tSet);
return result;
}

См. также:

Работа со справочниками