ForeExecWithState: Операция

ForeExecResult ForeExecWithState(ForeId tFore, ForeExecArg tArg, ForeExecStateArg tStateArg)

Параметры

tStateArg. Параметры сохранения объектов на сервере состояний.

Описание

Операция ForeExecWithState выполняет методы, реализованные в Fore-модулях, с последующим сохранением объектов на сервере состояний.

Комментарии

Сервер состояний должен быть предварительно установлен и настроен на работу с BI-сервером.

Для выполнения операции необходимо в поле tFore указать моникёр модуля/сборки, содержащего реализацию выполняемого метода. Моникёр может быть получен при выполнении операции GetObjects. В поле tArg.methodName укажите наименование выполняемого метода, а в поле tArg.args значения входных параметров метода. В поле tArg.tStateArg задайте параметры сохранения объектов на сервере состояний.

На операцию распространяются все требования, особенности и рекомендации, которые имеются у операции ForeExec.

Пример

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

SOAP JSON C#

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

<id>CJHOLKCMALALFOAEKGINPHCCMHHOLIHEBJLCOLDNKEKMKCKG!M!7360</id>

</tFore>

<methodName>WorkWithObject</methodName>

<args>

<it>

<value>CJHOLKCMALALFOAEKGINPHCCMHHOLIHEBJLCOLDNKEKMKCKG!M</value>

</it>

<it>

<value>CJHOLKCMALALFOAEKGINPHCCMHHOLIHEBJLCOLDNKEKMKCKG!M!S!ENPDFCNCMALALFOAEBIAIIOLLHIEDGGIEAKNLNKCFNJJDEKLP</value>

</it>

</args>

</tArg>

<s>CJHOLKCMALALFOAEKGINPHCCMHHOLIHEBJLCOLDNKEKMKCKG!M!S!ENPDFCNCMALALFOAEBIAIIOLLHIEDGGIEAKNLNKCFNJJDEKLP</s>

</objectsToSave>

</tStateArg>

</ForeExecWithState>

</s:Body>

</s:Envelope>

SOAP-ответ:

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

<soapenv:Body>

</ForeExecWithStateResult>

</soapenv:Body>

</soapenv:Envelope>

JSON-запрос:

{
 "ForeExecWithState" : 
  {
   "tFore" : 
    {
     "id" : "CJHOLKCMALALFOAEKGINPHCCMHHOLIHEBJLCOLDNKEKMKCKG!M!7360"
    },
   "tArg" : 
    {
     "methodName" : "WorkWithObject",
     "args" : 
      {
       "it" : 
        [
          {
           "k" : "1",
           "value" : "CJHOLKCMALALFOAEKGINPHCCMHHOLIHEBJLCOLDNKEKMKCKG!M"
          },
          {
           "k" : "2",
           "value" : "CJHOLKCMALALFOAEKGINPHCCMHHOLIHEBJLCOLDNKEKMKCKG!M!S!ENPDFCNCMALALFOAEBIAIIOLLHIEDGGIEAKNLNKCFNJJDEKLP"
          }
        ]
      }
    },
   "tStateArg" : 
    {
     "saveState" : "true",
     "objectsToSave" : 
      {
       "s" : "CJHOLKCMALALFOAEKGINPHCCMHHOLIHEBJLCOLDNKEKMKCKG!M!S!ENPDFCNCMALALFOAEBIAIIOLLHIEDGGIEAKNLNKCFNJJDEKLP"
      }
    }
  }
}

JSON-ответ:

{
 "ForeExecWithStateResult" : 
  {
   "result" : ""
  }
}

public static ForeExecResult ExecMethodWithState(MbId mb, string assmId, string methodName, string objMoniker)
{
    var somClient = new SomPortTypeClient(); //Прокси-объект для выполнения операций
    //Параметры выполнения операции
    var tExec = new ForeExecWithState()
    {
        tArg = new ForeExecArg()
        {
            methodName = methodName,
            //Моникёры в качестве значений параметров
            args = new OdArg[2]
            {
                new OdArg(){ k = 1, value = mb.id },
                new OdArg(){ k = 2, value = objMoniker }
            }
        },
        //Моникёр объекта среды разработки с реализацией метода
        tFore = new ForeId()
        {
            id = mb.id + "!" + FindObjectById(mb, assmId).k
        },
        tStateArg = new ForeExecStateArg()
        {
            saveState = true,
            objectsToSave = new string[] { objMoniker }
        }
    };
    //Выполнение метода и сохранение состояния объекта
    var result = somClient.ForeExecWithState(tExec);
    return result;
}

ForeExecWithState

Синтаксис