ICubeInstanceStorage.SaveMatrixCallback

Синтаксис

SaveMatrixCallback: ICubeSaveMatrixCallback;

SaveMatrixCallback: Prognoz.Platform.Interop.Cubes.ICubeSaveMatrixCallback;

Описание

Свойство SaveMatrixCallback определяет обработчик процесса сохранения матрицы с данными в куб.

Комментарии

В качестве значения свойства необходимо указать экземпляр объекта, который реализует методы интерфейса ICubeSaveMatrixCallback или наследуется и переопределяет класс CubeCallback. Обработчик позволяет отследить процесс сохранения данных, при необходимости внести какие-либо изменения в данные или полностью отменить транзакцию в СУБД.

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

Пример

Для выполнения примера предполагается наличие куба с идентификатором «STD_CUBE». В структуру куба включено измерение с идентификатором «COUNTRY». В самом кубе хранятся какие-либо данные по странам.

Добавьте ссылки на системные сборки: Cubes, Dimensions, MathFin, Matrix, Metabase, ForeSystem (для примера на Fore.NET).

Sub UserProc;
Var
    MB: IMetabase;
    CubInst: ICubeInstance;
    Des: ICubeInstanceDestination;
    Sels: IDimSelectionSet;
    Sel: IDimSelection;
    Matr: IMatrix;
    Coord: IMatrixCoord;
    Sto: ICubeInstanceStorage;
    i: Integer;
Begin
    MB := MetabaseClass.Active;
    CubInst := MB.ItemById("STD_CUBE").Open(Null) As ICubeInstance;
    Des := CubInst.Destinations.DefaultDestination;
    //Отметка куба
    Sels := Des.CreateDimSelectionSet;
    For Each Sel In Sels Do
        If Sel.Dimension.Ident = "COUNTRY" Then
            Sel.SelectAll;
        Else
            Sel.SelectElement(0, False);
        End If;
    End For;
    //Получение матрицы значений по указанной отметке
    Matr := Des.Execute(Sels);
    Matr.ValueFlag := 1;
    Coord := Matr.CreateCoord;
    For i := 0 To Matr.DimensionCount - 1 Do
        Coord.Item(i) := 0;
    End For;
    //Изменение значения по координате
    Matr.Item(Coord) := (Matr.Item(Coord) As Double) + Math.RandBetween(50, 150);
    //Объект для сохранения данных в куб
    Sto := Des.CreateStorage(CubeInstanceStorageOptions.None);
    //Обработчик процесса сохранения данных
    Sto.SaveMatrixCallback := New TCubeSaveCallback.Create;
    //Сохранение значений
    Sto.SaveMatrix(Matr, Matr.ValueFlag);
End Sub UserProc;

Class TCubeSaveCallback: CubeCallback
    Public Sub OnBeforeSave(Argument: ICubeCallbackBeforeSaveArgument);
    Var
        Matr: IMatrix;
        Iter: IMatrixIterator;
        needSkipSave: Boolean = False;
    Begin
        //Матрица с сохраняемыми данными
        Matr := Argument.OriginalMatrix;
        Iter := Matr.CreateIterator;
        Iter.Move(IteratorDirection.First);
        While Iter.Valid Do
            //Если изменённое значение больше 100, то отменяем сохранение
            If Iter.ValueFlag = 1 Then
                If (Iter.Value As Double) > 100 Then
                    needSkipSave := True;
                End If;
            End If;
            Iter.Move(IteratorDirection.Next);
        End While;
        Argument.ResultMatrix := Matr;
        Argument.SkipDefaultSave := needSkipSave;
    End Sub OnBeforeSave;

    Public Sub OnAfterSave(Argument: ICubeCallbackSaveArgument);
    Var
        Connection: ISecurityConnection;
        Matr: IMatrix;
        Iter: IMatrixIterator;
    Begin
        Debug.WriteLine("---Данные сохранены---");
        Connection := (Argument.SecurityConnections[0] As ISecurityConnection);
        Debug.WriteLine("Пользователь платформы: " + Connection.UserNameLo);
        Debug.WriteLine("Пользователь СУБД: " + Connection.UserNameDb);
        Debug.WriteLine("Вариант отображения куба: " + Argument.Destination.Id);
        Debug.WriteLine("Ключ записи в протоколе доступа: " + Argument.LogKey.ToString);
        Debug.WriteLine("Значения, полученные из куба:");
        Matr := Argument.ValueMatrix;
        Iter := Matr.CreateIterator;
        Iter.Move(IteratorDirection.First);
        While Iter.Valid Do
            Debug.Write(iter.Value + " ");
            Iter.Move(IteratorDirection.Next);
        End While;
        Debug.WriteLine("");
        Debug.WriteLine("Изменённые значения:");
        Matr := Argument.FilteredMatrix;
        Iter := Matr.CreateIterator;
        Iter.Move(IteratorDirection.First);
        While Iter.Valid Do
            Debug.Write(iter.Value + " ");
            Iter.Move(IteratorDirection.Next);
        End While;
        Debug.WriteLine("");
    End Sub OnAfterSave;
End Class TCubeSaveCallback;

Imports Prognoz.Platform.Interop.Cubes;
Imports Prognoz.Platform.Interop.Dimensions;
Imports Prognoz.Platform.Interop.ForeSystem;
Imports Prognoz.Platform.Interop.MathFin;
Imports Prognoz.Platform.Interop.Matrix;
Imports Prognoz.Platform.Interop.Metabase;
…
Private Shared Sub Main(Params: StartParams);
Var
    MB: IMetabase;
    CubInst: ICubeInstance;
    Des: ICubeInstanceDestination;
    Sels: IDimSelectionSet;
    Sel: IDimSelection;
    Matr: IMatrix;
    Coord: IMatrixCoord;
    Sto: ICubeInstanceStorage;
    CMath: MathClass = New MathClass();
    i: Integer;
Begin
    MB := Params.Metabase;
    CubInst := MB.ItemById["STD_CUBE"].Open(Null) As ICubeInstance;
    Des := CubInst.Destinations.DefaultDestination;
    //Отметка куба
    Sels := Des.CreateDimSelectionSet();
    For Each Sel In Sels Do
        If Sel.Dimension.Ident = "COUNTRY" Then
            Sel.SelectAll();
        Else
            Sel.SelectElement(0, False);
        End If;
    End For;
    //Получение матрицы значений по указанной отметке
    Matr := Des.Execute(Sels, uinteger.MaxValue);
    Matr.ValueFlag := 1;
    Coord := Matr.CreateCoord();
    For i := 0 To Matr.DimensionCount - 1 Do
        Coord.Item[i] := 0;
    End For;
    //Изменение значения по координате
    Matr.Item[Coord] := (Matr.Item[Coord] As Double) + CMath.RandBetween(50, 150);
    //Объект для сохранения данных в куб
    Sto := Des.CreateStorage(CubeInstanceStorageOptions.cisoNone);
    //Обработчик процесса сохранения данных
    Sto.SaveMatrixCallback := New TCubeSaveCallback();
    //Сохранение значений
    Sto.SaveMatrix(Matr, Matr.ValueFlag);
End Sub;

Class TCubeSaveCallback: ICubeSaveMatrixCallback
    Public Sub OnBeforeSave(Argument: ICubeCallbackBeforeSaveArgument);
    Var
        Matr: IMatrix;
        Iter: IMatrixIterator;
        needSkipSave: Boolean = False;
    Begin
        //Матрица с сохраняемыми данными
        Matr := Argument.OriginalMatrix;
        Iter := Matr.CreateIterator();
        Iter.Move(IteratorDirection.itdFirst);
        While Iter.Valid Do
            //Если изменённое значение больше 100, то отменяем сохранение
            If Iter.ValueFlag = 1 Then
                If (Iter.Value As Double) > 100 Then
                    needSkipSave := True;
                End If;
            End If;
            Iter.Move(IteratorDirection.itdNext);
        End While;
        Argument.ResultMatrix := Matr;
        Argument.SkipDefaultSave := needSkipSave;
    End Sub;

    Public Sub OnAfterSave(Argument: ICubeCallbackSaveArgument);
    Var
        Connection: ISecurityConnection;
        Matr: IMatrix;
        Iter: IMatrixIterator;
    Begin
        System.Diagnostics.Debug.WriteLine("---Данные сохранены---");
        Connection := ((Argument.SecurityConnections As Array)[0] As ISecurityConnection);
        System.Diagnostics.Debug.WriteLine("Пользователь платформы: " + Connection.UserNameLo);
        System.Diagnostics.Debug.WriteLine("Пользователь СУБД: " + Connection.UserNameDb);
        System.Diagnostics.Debug.WriteLine("Вариант отображения куба: " + Argument.Destination.Id);
        System.Diagnostics.Debug.WriteLine("Ключ записи в протоколе доступа: " + Argument.LogKey.ToString());
        System.Diagnostics.Debug.WriteLine("Значения, полученные из куба:");
        Matr := Argument.ValueMatrix;
        Iter := Matr.CreateIterator();
        Iter.Move(IteratorDirection.itdFirst);
        While Iter.Valid Do
            System.Diagnostics.Debug.Write(iter.Value + " ");
            Iter.Move(IteratorDirection.itdNext);
        End While;
        System.Diagnostics.Debug.WriteLine("");
        System.Diagnostics.Debug.WriteLine("Изменённые значения:");
        Matr := Argument.FilteredMatrix;
        Iter := Matr.CreateIterator();
        Iter.Move(IteratorDirection.itdFirst);
        While Iter.Valid Do
            System.Diagnostics.Debug.Write(iter.Value + " ");
            Iter.Move(IteratorDirection.itdNext);
        End While;
        System.Diagnostics.Debug.WriteLine("");
    End Sub;
End Class;

При выполнении примера будет получена матрица с данными из куба. По некоторой координате будет изменено значение, после чего обновленная матрица сохраняется обратно в куб. Процесс сохранения данных обрабатывается в пользовательском классе «TCubeSaveCallback». Если изменённое значение больше 100, то сохранение данных будет отменено.

См. также:

ICubeInstanceStorage