SetCube: Операция

Данная операция позволяет изменить структуру куба:

Для выполнения операции в параметре tCube укажите моникёр открытого экземпляра куба и в параметре tArg укажите параметры, в соответствии с которыми будут произведены изменения. Моникёр может быть получен при выполнении операции OpenCube. В поле tArg.pattern указывается шаблон для изменения структуры куба, а в поле tArg.meta указываются обновленные метаданные.

Результатом работы операции будет моникёр измененного куба и запрошенные метаданные, которые могут быть указаны в шаблоне tArg.metaGet.

Для сохранения внесенных изменений после операции SetCube выполните операцию SaveObject или SaveObjectAs.

Примечание. В «Форсайт. Аналитическая платформа» изменение структуры доступно только для стандартных кубов.

Пример

Пример добавления измерения в структуру куба. В запросе передаются:

В ответе приходит обновленная информация об измерениях куба.

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">

</tCube>

</pattern>

<meta>

<dims>

<its>

<it>

<id />

<n />

<n />

</obDesc>

</it>

</its>

</dims>

</meta>

</metaGet>

</tArg>

</SetCube>

</s:Body>

</s:Envelope>

SOAP-ответ:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">

<soapenv:Body>

</id>

STD_CUBE

5845

</obDesc>

</obInst>

<dims>

<its>

<it>

<id>FACTS</id>

<n>Факты</n>

FACTS

<n>Факты</n>

5857

</obDesc>

</it>

<it>

<id>CALENDAR</id>

<n>Calendar</n>

CALENDAR

<n>Calendar</n>

103

</obDesc>

</it>

<it>

DIM_1

103

</obDesc>

</it>

<it>

DIM_2

10529

</obDesc>

</it>

<it>

<id>COUNTRIES</id>

<n>Страны</n>

COUNTRIES

<n>Страны</n>

159

</obDesc>

</it>

</its>

</dims>

</meta>

</SetCubeResult>

</soapenv:Body>

</soapenv:Envelope>

JSON-запрос:

{
 "SetCube" : 
  {
   "tCube" : 
    {
     "id" : "S1!M!S!C1"
    },
   "tArg" : 
    {
     "pattern" : 
      {
       "obInst" : "true",
       "dims" : "Add"
      },
     "meta" : 
      {
       "dims" : 
        {
         "its" : 
          {
           "it" : 
            [
              {
               "k" : "208",
               "id" : "",
               "n" : "",
               "obDesc" : 
                {
                 "i" : "",
                 "n" : "",
                 "k" : "208",
                 "c" : "4294967295"
                }
              }
            ]
          }
        }
      },
     "metaGet" : 
      {
       "obInst" : "true",
       "dims" : "Get"
      }
    }
  }
}

JSON-ответ:

{
 "SetCubeResult" : 
  {
   "id" : 
    {
     "id" : "S1!M!S!C1"
    },
   "meta" : 
    {
     "obInst" : 
      {
       "obDesc" : 
        {
         "@isShortcut" : "0",
         "@isLink" : "0",
         "@ver" : "1",
         "@hf" : "0",
         "i" : "STD_CUBE",
         "n" : "Куб",
         "k" : "5857",
         "c" : "1281",
         "p" : "5845",
         "h" : "0",
         "hasPrv" : "0",
         "ic" : "0",
         "isPermanent" : "1",
         "isTemp" : "0"
        }
      },
     "dirty" : "1",
     "dims" : 
      {
       "its" : 
        {
         "it" : 
          [
            {
             "k" : "5858",
             "id" : "FACTS",
             "n" : "Факты",
             "vis" : "1",
             "obDesc" : 
              {
               "@isShortcut" : "0",
               "@isLink" : "0",
               "@ver" : "1",
               "@hf" : "0",
               "i" : "FACTS",
               "n" : "Факты",
               "k" : "5858",
               "c" : "1028",
               "p" : "5857",
               "h" : "0",
               "hasPrv" : "0",
               "ic" : "0"
              }
            },
            {
             "k" : "112",
             "id" : "CALENDAR",
             "n" : "Calendar",
             "vis" : "1",
             "obDesc" : 
              {
               "@isShortcut" : "0",
               "@isLink" : "0",
               "@ver" : "1",
               "@hf" : "0",
               "i" : "CALENDAR",
               "n" : "Calendar",
               "k" : "112",
               "c" : "1026",
               "p" : "103",
               "h" : "0",
               "hasPrv" : "0",
               "ic" : "0"
              }
            },
            {
             "k" : "116",
             "id" : "DIM_1",
             "n" : "Dim_1",
             "vis" : "1",
             "obDesc" : 
              {
               "@isShortcut" : "0",
               "@isLink" : "0",
               "@ver" : "1",
               "@hf" : "0",
               "i" : "DIM_1",
               "n" : "Dim_1",
               "k" : "116",
               "c" : "1025",
               "p" : "103",
               "h" : "0",
               "hasPrv" : "0",
               "ic" : "0"
              }
            },
            {
             "k" : "991",
             "id" : "DIM_2",
             "n" : "Dim_2",
             "vis" : "1",
             "obDesc" : 
              {
               "@isShortcut" : "0",
               "@isLink" : "0",
               "@ver" : "0",
               "@hf" : "0",
               "i" : "DIM_2",
               "n" : "Dim_2",
               "k" : "991",
               "c" : "1025",
               "p" : "10529",
               "h" : "0",
               "hasPrv" : "0",
               "ic" : "0"
              }
            },
            {
             "k" : "208",
             "id" : "COUNTRIES",
             "n" : "Страны",
             "vis" : "1",
             "obDesc" : 
              {
               "@isShortcut" : "0",
               "@isLink" : "0",
               "@ver" : "5",
               "@hf" : "0",
               "i" : "COUNTRIES",
               "n" : "Страны",
               "k" : "208",
               "c" : "3076",
               "p" : "159",
               "h" : "0",
               "hasPrv" : "0",
               "ic" : "0"
              }
            }
          ]
        }
      },
     "supportsRub" : "0"
    }
  }
}

public static SetCubeResult ChangeCubeStructure(CubeId moniker, Od newDim)
{
    var somClient = new SomPortTypeClient(); //Прокси-объект для выполнения операций
    //Параметры выполнения операции
    var tSet = new SetCube()
    {
        tArg = new SetCubeArg()
        {
            //Шаблон, указывающий необходимость добавить измерение в куб
            pattern = new CubeMdPattern()
            {
                dims = ListOperation.Add,
            },
            //Обновленные метаданные, содержащие новое измерение
            meta = new CubeMd
            {
                dims = new CubeDims
                {
                    its = new CubeDim[]
                    {
                        new CubeDim
                        {
                            k = newDim.k,
                            id = string.Empty,
                            n = string.Empty,
                            obDesc = new Od
                            {
                                k = newDim.k,
                                n = string.Empty,
                                i = string.Empty,
                                c = uint.MaxValue
                            }
                        }
                    }
                }
            },
            metaGet = new CubeMdPattern()
            {
                dims = ListOperation.Get,
            }
        },
        tCube = moniker
    };
    //Изменение структуры куба
    var result = somClient.SetCube(tSet);
    return result;
}

SetCube

Синтаксис

Параметры

Описание

Комментарии

Пример

SOAP-запрос:

SOAP-ответ:

JSON-запрос:

JSON-ответ: