Деректер форматтары
JSON, XML, CSV, TSV және мәтінмен, UTF-8 және Windows-1251 кодтарымен, соның ішінде 1С деректерімен жұмыс істеу.
Автоматты аударма
Автоматтандыру JSON, XML, CSV, TSV және қарапайым мәтінді оқи және жасай алады. Пішім әр дереккөз мен тағайындау үшін бөлек реттеледі.
Бір көздің жауабы 5 МБ-тан аспауы керек.
JSON
response:
format: json
encoding: utf-8
JSON кәдімгі JavaScript мәндеріне түрлендіріледі:
- нысан-нысанға;
- массив-массивке;
- жолдар, сандар, логикалық мәндер және
nullтүрін сақтаңыз.
Кіріс жауабының мысалы:
{
"items": [
{ "id": 17, "amount": 1250.5 }
]
}
Өңдеушіде деректер келесідей қол жетімді input.items.
JSON-ға жіберген кезде нәтиже transform автоматты түрде серияланады. Қоңырау шалудың қажеті жоқ JSON.stringify қайтару алдында.
XML
response:
format: xml
encoding: windows-1251
XML нысанға түрлендіріледі. Түбірлік элемент бірінші кілтке, еншілес элементтер объектінің өрістеріне айналады.
Түпнұсқа XML:
<?xml version="1.0" encoding="UTF-8"?>
<Employees>
<Employee active="true">
<Id>42</Id>
<Name>Анна Смирнова</Name>
</Employee>
<Employee active="false">
<Id>57</Id>
<Name>Павел Орлов</Name>
</Employee>
</Employees>
JavaScript ішіндегі нысан:
{
Employees: {
Employee: [
{
"@attributes": { active: "true" },
Id: "42",
Name: "Анна Смирнова"
},
{
"@attributes": { active: "false" },
Id: "57",
Name: "Павел Орлов"
}
]
}
}
Конверсия ережелері:
- атрибуттар орналасқан
@attributes; - элементтің мәтіні
#text. егер элементте бір уақытта мәтін мен еншілес элементтер болса; - бір бала объектіге немесе жолға айналады;
- бірдей атаумен бірнеше элементтер массивке айналады;
- XML-дегі сандар мен логикалық мәндер жолдармен келеді, сондықтан оларды нақты түрлендіру қажет;
- Сыртқы нысандарды қосуға қабілетті DTD және XML директиваларына тыйым салынады;
- XML ұя салудың максималды тереңдігі-100 деңгей.
1С XML
1С жүктеулері Windows-1251-ді жиі қолданады және жазу тек бір болған кезде массивтің орнына бір элементті қайтара алады. Қауіпсіз өңдеуші екі нұсқаны да қарастырады:
function transform(input, context) {
const raw = input.Employees?.Employee;
const employees = Array.isArray(raw) ? raw : raw ? [raw] : [];
return employees.map((employee) => ({
externalId: String(employee.Id || ""),
fullName: String(employee.Name || "").trim(),
active: employee["@attributes"]?.active === "true",
}));
}
XML жіберу
request:
format: xml
encoding: utf-8
options:
root: Employees
options.root түбір элементін орнатады. Егер өңдеушінің нәтижесі жалғыз жоғарғы кілті бар объект болса, онда бұл кілт автоматты түрде түбір ретінде қолданылады.
CSV
response:
format: csv
encoding: windows-1251
options:
delimiter: ";"
header: true
| Орнату | Әдепкі бойынша | Мақсаты |
|---|---|---|
delimiter |
; |
Бір бөлгіш таңба. |
header |
true |
Бірінші жолда баған атаулары бар. |
Тақырыбы бар CSV:
id;name;amount
1;Первый заказ;350
2;Второй заказ;420
Түрлендіріледі:
[
{ id: "1", name: "Первый заказ", amount: "350" },
{ id: "2", name: "Второй заказ", amount: "420" }
]
CSV мәндері әрқашан жолдар болып табылады. Есептеулер үшін мыналарды пайдаланыңыз Number(value).
Егер header: false. кіріс жолдар массиві болады:
[
["1", "Первый заказ", "350"],
["2", "Второй заказ", "420"]
]
CSV жіберу
CSV жіберу үшін өңдеуші Нысандар массивін қайтаруы керек:
function transform(input, context) {
return input.items.map((item) => ({
id: item.id,
name: item.name,
amount: item.amount,
}));
}
Бағандар бірінші нысанның кілттері бойынша жасалады. Сондықтан барлық жолдарда бірдей өрістер жиынтығын қайтарған дұрыс.
TSV
TSV CSV сияқты жұмыс істейді, бірақ бөлгіш ретінде қойынды таңбасын пайдаланады.
response:
format: tsv
encoding: utf-8
TSV мәні үшін options.delimiter қажет емес.
text
response:
format: text
encoding: utf-8
Өңдеуші жолды қосымша талдаусыз алады.
function transform(input, context) {
const lines = String(input)
.split("\n")
.map((line) => line.trim())
.filter(Boolean);
return { lines };
}
Форматта жіберген кезде text нәтиже жолға түрлендіріледі.
Форматты автоматты түрде анықтау
Егер response.format орнатылмаған, Synchra24 тақырыпты талдайды Content-Type:
- мағынасы
json— JSON; - мағынасы
xml— XML; - мағынасы
csv— CSV; - қалған жауаптар-мәтін.
Болжалды жұмыс интеграциясы үшін форматты нақты көрсеткен дұрыс, әсіресе сыртқы қызмет дұрыс емес немесе жалпы болып табылса Content-Type.
Кодтау
Қолдау көрсетіледі:
utf-8немесеutf8;windows-1251немесеcp1251.
Егер encoding көрсетілмеген, UTF-8 қолданылады.
Кодтау жауап алғаннан кейін және форматты талдаудан бұрын қолданылады. Жіберу кезінде Тапсырыс кері: алдымен JSON, XML, CSV, TSV немесе мәтін жасалады, содан кейін нәтиже кодталады.
Пішімді қалай таңдауға болады
- Заманауи API үшін JSON пайдаланыңыз.
- 1С және ескі тіркелгі жүйелері үшін XML, CSV және Windows-1251 жиі қажет.
- Күрделі тіркемесі жоқ кестелік жүктеу үшін CSV немесе TSV қолайлы.
- Стандартты емес жалпақ жауап үшін мәтінді қолданыңыз және өңдегіштегі жолды бөлшектеңіз.
Кіріс артефактілерінің түрлері
Артефакт әрқашан сыртқы жүйенің форматына қарамастан JSON сақтайды. Толық ауыстыру ${artifacts.alias.field} JSON денесінде мән түрі сақталады; жол ішіндегі ауыстыру оны мәтінге айналдырады. URL және тақырыптар үшін толық мән жол болуы керек. Массивтер үшін жолдың сандық сегментін пайдаланыңыз, мысалы ${artifacts.settings.items.0.id}. Артефактілерді қосу.