SetCubeResult SetCube(CubeId tCube, SetCubeArg tArg)
tCube. Моникёр открытого экземпляра куба.
tArg. Параметры изменения метаданных.
Операция SetCube изменяет метаданные куба.
Данная операция позволяет изменить структуру куба:
набор измерений;
варианты отображения;
параметры управляющих измерений.
Для выполнения операции в параметре tCube укажите моникёр открытого экземпляра куба и в параметре tArg укажите параметры, в соответствии с которыми будут произведены изменения. Моникёр может быть получен при выполнении операции OpenCube. В поле tArg.pattern указывается шаблон для изменения структуры куба, а в поле tArg.meta указываются обновленные метаданные.
Результатом работы операции будет моникёр измененного куба и запрошенные метаданные, которые могут быть указаны в шаблоне tArg.metaGet.
Для сохранения внесенных изменений после операции SetCube выполните операцию SaveObject или SaveObjectAs.
Примечание. В «Форсайт. Аналитическая платформа» изменение структуры доступно только для стандартных кубов.
Пример добавления измерения в структуру куба. В запросе передаются:
моникёр куба, открытого на редактирование;
шаблон, указывающий необходимость добавить измерение;
обновленные метаданные, содержащие добавляемое измерение.
В ответе приходит обновленная информация об измерениях куба.
{
"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"
}
}
}
}
{
"SetCubeResult" :
{
"id" :
{
"id" : "S1!M!S!C1"
},
"meta" :
{
"obInst" :
{
"obDesc" :
{
"@isShortcut" : "0",
"@isLink" : "0",
"i" : "STD_CUBE",
"n" : "Куб",
"k" : "5857",
"c" : "1281",
"p" : "5845",
"h" : "0"
}
},
"dirty" : "1",
"dims" :
{
"its" :
{
"it" :
[
{
"k" : "5858",
"id" : "FACTS",
"n" : "Факты",
"vis" : "1",
"obDesc" :
{
"@isShortcut" : "0",
"@isLink" : "0",
"i" : "FACTS",
"n" : "Факты",
"k" : "5858",
"c" : "1028",
"p" : "5857",
"h" : "0"
}
},
{
"k" : "112",
"id" : "CALENDAR",
"n" : "Calendar",
"vis" : "1",
"obDesc" :
{
"@isShortcut" : "0",
"@isLink" : "0",
"i" : "CALENDAR",
"n" : "Calendar",
"k" : "112",
"c" : "1026",
"p" : "103",
"h" : "0"
}
},
{
"k" : "116",
"id" : "DIM_1",
"n" : "Dim_1",
"vis" : "1",
"obDesc" :
{
"@isShortcut" : "0", "@isLink" : "0", "i" : "DIM_1", "n" : "Dim_1", "k" : "116", "c" : "1025", "p" : "103", "h" : "0" } },
{
"k" : "991",
"id" : "DIM_2",
"n" : "Dim_2",
"vis" : "1",
"obDesc" :
{
"@isShortcut" : "0",
"@isLink" : "0",
"i" : "DIM_2",
"n" : "Dim_2",
"k" : "991",
"c" : "1025",
"p" : "989",
"h" : "0"
}
},
{
"k" : "208",
"id" : "COUNTRY",
"n" : "Country",
"vis" : "1",
"obDesc" :
{
"@isShortcut" : "0",
"@isLink" : "0",
"i" : "COUNTRY",
"n" : "Country",
"k" : "208",
"c" : "4354",
"p" : "159", "h" : "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;
}
См. также:
SOAP