OpenRds

Синтаксис

OpenRdsResult OpenRds(OdId tOb, OpenRdsArg tArg)

Параметры

tOb. Моникёр объекта репозитория, являющегося справочником НСИ.

tArg. Параметры открытия справочника.

Описание

Операция OpenRds открывает справочник НСИ и возвращает контекст для работы с данными и метаданными справочника.

Комментарии

Для выполнения операции необходимо в параметре tOb указать моникёр объекта, являющегося справочником НСИ, а в параметре tArg указать шаблоны для метаданных, которые необходимо извлечь при выполнении операции. Также в параметре tArg можно указать значения параметров для открытия справочника, если он является параметрическим. Если в параметре tArg не заданы шаблоны, то результатом работы операции будет только моникёр открытого экземпляра справочника. Если шаблоны указаны, то извлеченные метаданные можно получить в поле meta.

Дальнейшая работа с открытым экземпляром справочником производится с помощью операций GetRds, GetRdsElements. Для закрытия открытого экземпляра справочника используйте операцию CloseRds.

Пример

Пример открытия справочника НСИ. В запросе передается моникёр объекта, являющегося справочником НСИ. В ответе приходит моникёр открытого экземпляра справочника.

SOAP

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

<OpenRds xmlns="http://www.fsight.ru/PP.SOM.Som">

<tOb xmlns=" ">

  <id>S1!M!5613</id>

  </tOb>

<tArg xmlns=" ">

<args>

  <bind>true</bind>

  <openForEdit>true</openForEdit>

  </args>

  </tArg>

  </OpenRds>

  </s:Body>

  </s:Envelope>

SOAP-ответ:

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

<soapenv:Body>

<OpenRdsResult xmlns="http://www.fsight.ru/PP.SOM.Som" xmlns:q1="http://www.fsight.ru/PP.SOM.Som" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<id xmlns=" ">

  <id>S1!M!S!N1</id>

  </id>

  </OpenRdsResult>

  </soapenv:Body>

  </soapenv:Envelope>

JSON

{
 "OpenRds" : 
  {
   "tOb" : 
    {
     "id" : "S1!M!5613"
    },
   "tArg" : 
    {
     "args" : 
      {
       "bind" : "true",
       "openForEdit" : "true"
      }
    }
  }
}

{
 "OpenRdsResult" : 
  {
   "id" : 
    {
     "id" : "S1!M!S!N1"
    }
  }
}

C#

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

См. также:

Работа со справочниками НСИ