Synchra.24
menu_bookҚұжаттама
Практические материалы по запуску и развитию

Здесь собраны инструкции по запуску, разработке внутренних сценариев и встраиванию собственных инструментов в рабочий контур компании.

folderАвтоматтандыру

Деректер форматтары

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}. Артефактілерді қосу.