OpenDbCommand: Операция

Операция OpenDbCommand открывает SQL-объект и возвращает контекст для работы с ним.

Комментарии

Для выполнения операции необходимо в поле tObject указать моникёр SQL-объекта репозитория, а в поле tArg указать параметры открытия. Под SQL-объектом понимается один из следующих типов объектов репозитория:

Моникёр объекта может быть получен при выполнении операции GetObjects. В поле tArg могут быть указаны режим открытия (просмотр или редактирование), значения параметров, которые будут переданы в запрос, и шаблон для извлечения метаданных. В шаблоне указывается та информация, которая должна быть получена при выполнении операции. Результатом работы операции будет моникёр открытого экземпляра SQL-объекта, а также метаданные, полученнные в соответствии с указанным в поле tArg.metaGet шаблоном. Дальнейшая работа с открытым объектом осуществляется с помощью операций GetDbCommand и SetDbCommand. Для закрытия открытого экземпляра SQL-объекта используйте операцию CloseDbCommand.

Пример

Пример открытия SQL-объекта на редактирование. В запросе передается моникёр SQL-объекта в репозитории. В ответе приходит моникёр открытого экземпляра SQL-объекта.

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

</tOb>

<args>

</args>

</tArg>

</OpenDbCommand>

</s:Body>

</s:Envelope>

SOAP-ответ:

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

<soapenv:Body>

</id>

</OpenDbCommandResult>

</soapenv:Body>

</soapenv:Envelope>

JSON-запрос:

{
 "OpenDbCommand" : 
  {
   "tOb" : 
    {
     "id" : "S2!M!9051"
    },
   "tArg" : 
    {
     "args" : 
      {
       "openForEdit" : "true"
      }
    }
  }
}

JSON-ответ:

{
 "OpenDbCommandResult" : 
  {
   "id" : 
    {
     "id" : "S2!M!S!M1"
    }
  }
}

Указанная ниже функция OpenDbCommand открывает SQL-объект репозитория на редактирование. Моникёр соединения с репозиторием и идентификатор SQL-объекта передаются в качестве входных параметров. В примере используется функция FindObjectById, код которой приведен в примере «Получение описания объекта по его идентификатору». Результат выполнения операции является результатом выполнения функции.

    public static OpenDbCommandResult OpenSQLObject(MbId mb, string id)
    {
        var somClient = new SomPortTypeClient(); //Прокси-объект для выполнения операций
        //Параметры выполнения операции
        var tOpen = new OpenDbCommand()
        {
            tArg = new OpenDbCommandArg()
            {
                args = new DbCommandOpenArgs() 
                {
                    openForEdit = true
                }
            },
            tOb = new OdId() { id = mb.id + "!" + FindObjectById(mb, id).k }
        };
        //Открытие справочника
        var tResult = somClient.OpenDbCommand(tOpen);
        return tResult;
    }

OpenDbCommand

Синтаксис