CreateEtlUnpivot

Синтаксис

CreateEtlUnpivotResult CreateEtlUnpivot(EtlId tEtl, CreateEtlUnpivotArg tArg)

Параметры

tEtl. Моникёр открытого экземпляра задачи ETL.

tArg. Параметры выполнения операции.

Описание

Операция CreateEtlUnpivot создаёт настройки извлечения данных в режиме кросс-таблицы.

Комментарии

Для выполнения операции укажите в поле tEtl моникёр открытого экземпляра задачи ETL, а в поле tArg.id идентификатор источника Excel, для которого создаются настройки. Источник должен быть добавлен на рабочее пространство задачи. В настройках источника полю unpivotMode должно быть установлено значение true. Моникёр может быть получен при выполнении операции OpenEtl.

Результатом выполнения операции будут новые настройки, если для источника еще не производилась настройка, или уже заданные настройки, если источник настраивался на извлечение данных в режиме кросс-таблицы. Дальнейшая работа с настройками осуществляется с помощью операций GetEtlUnpivot/SetEtlUnpivot,

Для закрытия настроек и освобождения ресурсов используйте операцию CloseEtlUnpivot.

Пример

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

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">
<CreateEtlUnpivot xmlns="http://www.fsight.ru/PP.SOM.Som">
<tEtl xmlns="">
  <id>ENAIMHDOPOEIGOAEIKGJBOMLGNPEKPJEOIFKLAKCKCFCJHKN!M!S!LBCNODJDOPOEIGOAEAACBDDFIJKHDGKNEHKAKNNDFDEABINKC</id>
  </tEtl>
<tArg xmlns="">
  <id>PLAINDATAEXCELPROVIDEREX1</id>
  </tArg>
  </CreateEtlUnpivot>
  </s:Body>
  </s:Envelope>

SOAP-ответ:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<CreateEtlUnpivotResult 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>ENAIMHDOPOEIGOAEIKGJBOMLGNPEKPJEOIFKLAKCKCFCJHKN!M!S!LBCNODJDOPOEIGOAEAACBDDFIJKHDGKNEHKAKNNDFDEABINKC</id>
  </id>
<props xmlns="">
<stringDataFormat>
  <useSystem>1</useSystem>
  <dateFormat>ДД.ММ.ГГГГ</dateFormat>
  <decimalSeparator>,</decimalSeparator>
  <usePredefinedDateFormats>1</usePredefinedDateFormats>
  </stringDataFormat>
  <typeGuessRows>100</typeGuessRows>
  <autoFillMode>Strings</autoFillMode>
  <filterIf />
  <leftBegin>0</leftBegin>
  <leftEnd>0</leftEnd>
  <headTop>0</headTop>
  <headBottom>0</headBottom>
  <headColumn>-1</headColumn>
  <dataTop>1</dataTop>
  <dataWidth>1</dataWidth>
  <dataRight>-1</dataRight>
  <dataBottom>-1</dataBottom>
  <fixedCells />
  <fieldsNames>1</fieldsNames>
  <fieldNamesRow>-1</fieldNamesRow>
  <fieldNamesColumn>-1</fieldNamesColumn>
  </props>
  </CreateEtlUnpivotResult>
  </soapenv:Body>
  </soapenv:Envelope>

JSON-запрос:

{
"CreateEtlUnpivot" :
{
"tEtl" :
{
"id" : "ENAIMHDOPOEIGOAEIKGJBOMLGNPEKPJEOIFKLAKCKCFCJHKN!M!S!LBCNODJDOPOEIGOAEAACBDDFIJKHDGKNEHKAKNNDFDEABINKC"
},
"tArg" :
{
"id" : "PLAINDATAEXCELPROVIDEREX1"
}
}
}

JSON-ответ:

{
"CreateEtlUnpivotResult" :
{
"id" :
{
"id" : "ENAIMHDOPOEIGOAEIKGJBOMLGNPEKPJEOIFKLAKCKCFCJHKN!M!S!LBCNODJDOPOEIGOAEAACBDDFIJKHDGKNEHKAKNNDFDEABINKC"
},
"props" :
{
"stringDataFormat" :
{
"useSystem" : "1",
"dateFormat" : "ДД.ММ.ГГГГ",
"decimalSeparator" : ",",
"usePredefinedDateFormats" : "1"
},
"typeGuessRows" : "100",
"autoFillMode" : "Strings",
"filterIf" : "",
"leftBegin" : "0",
"leftEnd" : "0",
"headTop" : "0",
"headBottom" : "0",
"headColumn" : "-1",
"dataTop" : "1",
"dataWidth" : "1",
"dataRight" : "-1",
"dataBottom" : "-1",
"fixedCells" : "",
"fieldsNames" : "1",
"fieldNamesRow" : "-1",
"fieldNamesColumn" : "-1"
}
}
}
public static CreateEtlUnpivotResult CreateEtlUnpivot(string moniker, string sourceId)
{
var somClient = new SomPortTypeClient(); // Прокси-объект для выполнения операций
// Параметры выполнения операции
var tCreate = new CreateEtlUnpivot()
{
tArg = new CreateEtlUnpivotArg()
{
id = sourceId
},
tEtl = new EtlId() { id = moniker }
};
// Создание настроек извлечения данных в режиме кросс-таблицы
var result = somClient.CreateEtlUnpivot(tCreate);
return result;
}

См. также:

Работа с задачей ETL