Към съдържанието
Съдържание на курса

Урок 14 — Един файл, няколко поръчки

От · съосновател и Chief Executive Officer на Hábil ·

Какво ще постигнеш: да разделиш файла, който складът оставя с няколко пратки, така че всяка поръчка да получи собствена 856-ца и своя статус EMBARCADO и една лоша пратка да не спира останалите.

Преди да започнеш, ти трябват: завършен урок 13 и включена средата от урок 00.

Новото днес, в едно изречение

В урок 13 складът оставяше по един файл за пратка. В реалния живот почти никога не е така: складът събира това, което е излязло сутринта, и оставя един-единствен файл, партида, с пет пратки вътре. Днес го разделяш на частите му, по една за поръчка. Шаблонът се нарича Splitter.

Картината: кашонът, който пристига в офиса с кореспонденцията за целия етаж. Никой не предава целия кашон на първото бюро: отваря се, вади се всеки плик и се носи на получателя му. А ако някой плик носи име, което никой не познава, той се отделя настрана и се разнасят останалите.


1. Подготви папката си

cd lecciones/14-un-archivo-varias-ordenes
cp -R inicio mio

Отвори добрата партида, datos/embarques/lote-bodega-0001.json. Отгоре носи данните на партидата (номер, склад, кога е генерирана), а после списък, embarques, с пет елемента. Всеки елемент е пратка като тази от урок 13: поръчка, куриерска фирма, товарителница и редове.

Лошата партида е lote-bodega-0002.json: пет пратки, а третата е за поръчка 9999, която магазинът никога не е създавал. Рутерът няма да я приеме.

2. Предвиди

Преди да отвориш маршрута, отговори на лист хартия:

  1. Партида 0001 носи пет пратки. Колко 856-ци очакваш на SFTP на партньора?
  2. В партида 0002 третата пратка се проваля. Какво става с четвъртата и петата? А с първата и втората, които вече са минали?
  3. Когато партида 0002 приключи, къде трябва да отиде файлът: в .camel/, в .error/ или в нито едно от двете?

Виж какво е положението днес:

./verifica inicio

Днес polling услугата праща на рутера цялата партида, сякаш е една пратка. Рутерът търси една-единствена поръчка в тялото, не я намира и я отхвърля. Отметките за API-то, ERP и партньора излизат в червено.

3. Какво ще напишеш

Отвори mio/sondeo-bodega/sondeo-bodega.camel.yaml. from вече носи четирите предпазни мерки от урок 13; променен е само include, който сега взема файловете lote-bodega-<algo>.json. Твоята работа е в трите TODO на стъпките:

TODO Какво правиш За какво
1 Обвиваш стъпките в split с JSONPath израза $.embarques[*] По едно съобщение за всяка пратка от списъка
2 Пишеш stopOnException: false в split Една лоша пратка да не спира останалите
3 Местиш вътре в split стъпките, които запазват поръчката и викат рутера, и добавяш marshal към JSON преди извикването Всяка част да пътува сама до рутера

Вътре в split стъпките са в собствен steps:, с по-голям отстъп. Така изглежда скелетът; вътрешните стъпки са тези, които вече са във файла:

- split:
    jsonpath:
      expression: "$.embarques[*]"
    stopOnException: false
    steps:
      - setVariable: …   # la orden de esta parte
      - marshal:
          json: {}
      - …                # quitar encabezados, Content-Type, llamar al router, anotar

Две нови неща:

  • Всяка част пристига като данни, не като текст. JSONPath ти предава всяка пратка като map (ключове и стойности). Затова поръчката вече не се взема с $.orden, а с ${body[orden]}, и преди да я пратиш на рутера, трябва да я превърнеш в JSON текст с marshal. Без marshal рутерът получава нещо, което не е JSON.
  • stopOnException: false вече е стойността по подразбиране. Пишеш я въпреки това: който чете маршрута, вижда, че е обмислено, а не забравено.

4. Счупи едно нарочно

С твоя завършен split смени stopOnException на true и пусни ./verifica. Преди това предвиди: колко от четирите добри пратки на партида 0002 пристигат?

Излиза в червено отметката за партида 0002: пристигат само две, 4001 и 4002. split върви поред; когато третата (9999) се провали, той спира и 4004 и 4005 остават без известие, макар да са излезли от склада. Заради грешка в поръчка, която дори не съществува, двама клиенти не знаят къде е пратката им. Върни на false.

5. Провери

./verifica

verifica създава поръчки от 4001 до 4005, оставя партида 0001 в пощенската кутия и проверява; после почиства дестинациите и оставя партида 0002. Урокът е завършен, когато видиш седемте зелени отметки:

✅ Arrancaron el router, los tres canales y el sondeo de la bodega
✅ Lote 0001: las 5 órdenes quedaron EMBARCADO en la API y en el ERP
✅ Socio: 5 archivos 856, uno por orden, y los 5 pasan el lector X12
✅ Buzón: el lote 0001 se apartó a .camel/
✅ Lote 0002: los otros 4 embarques pasaron (4001, 4002, 4004 y 4005 EMBARCADO en la API y el ERP)
✅ Sondeo: anotó en su bitácora que el embarque de la 9999 no pasó
✅ Buzón: el lote 0002 se apartó a .error/ para que alguien vea el embarque malo

Обърни внимание на последните две: партида 0002 завърши в .error/, макар че четири от петте ѝ пратки минаха. split продължи с останалите, но накрая помни, че е имало грешка, и polling услугата третира файла като провален. Файлът в .error/ казва „прегледай този“; логът казва кой точно:

DONDE=mio docker compose -f compose.yaml logs sondeo-bodega | grep "no aceptó"

Не тръгва? ./verifica solucion тества нашето решение, а diff mio/sondeo-bodega solucion/sondeo-bodega ти казва по какво се различават.

Какво виждаш Какво правиш
solo 0 de 5 órdenes quedaron EMBARCADO Стъпките, които викат рутера, са останали извън split или split липсва. Провери отстъпа: трябва да са вътре в неговия steps:
Логът казва, че рутерът не е приел нито една пратка Липсва marshal към JSON: рутерът получава map, а не текст
el malo detuvo a los demás stopOnException е останало на true
Al ERP le falta la tabla embarque Пресъздай ERP, както казва урок 13

Какво учи това извън курса

Партидите са правилото, не изключението. Банки, складове и стари системи предават работата си в големи файлове, веднъж на ден или на всеки час. Да разделиш файла и да третираш всяка част така, сякаш е пристигнала сама, е първото, което прави една интеграция с тях.

Партидата не е транзакция. В урок 05 научи „всичко или нищо“ вътре в ERP. Тук е обратното: всяка пратка е на различен клиент и това, че една се проваля, не е причина да не уведомиш останалите четирима. Кое е по-добре — всичко или нищо, или една по една, зависи от това дали частите зависят една от друга.

Упражнение: партидата с нейната грешка

С твоята завършена версия:

  1. Отвори buzon/.error/lote-bodega-0002.json. Ако ти беше човекът, който обслужва склада, как щеше да разбереш коя от петте пратки да прегледаш? Стига ли ти файлът, или ти трябва логът?
  2. Пусни ./verifica още веднъж, без да променяш нищо. Дублира ли се някоя 856-ца или някой EMBARCADO? Защо не? (Подсказка: verifica почиства дестинациите преди всяка партида, а API-то разпознава ключа на всяка пратка.)
  3. Представи си, че складът поправя 9999 и праща отново цялата партида 0002. Какво би станало с четирите поръчки, които вече бяха EMBARCADO? Запиши отговора си: темата „кога две съобщения са едно и също?“ е урок 18.

Защо е направено така

Какво решихме в този урок, заедно с това, което отхвърлихме, и какво би ни накарало да си променим мнението:

  • Един файл от склада се разделя на пратките си и една лоша не спира останалите

Преговор

  1. Какво прави един Splitter и защо е нужен при партида от склада?
  2. Защо вътре в split поръчката се чете с ${body[orden]}, а не с $.orden?
  3. За какво служи marshal преди извикването на рутера?
  4. Какво прави stopOnException: false? Защо се пише, щом вече е стойността по подразбиране?
  5. Заключителният въпрос: партида 0002 завърши в .error/, макар че четири пратки минаха. Проблем ли е това? Какво ти казва този файл и какво ти казва логът?

Следва: в урок 15 заключителният въпрос от урок 12 се връща: ако рутерът има реплики, къде живее информацията за всяка поръчка? Днес рутерът не помни нищо; утре записва всяка поръчка, всеки канал и всеки опит в собствена база.

Да обсъдим вашия проект

Предпочитате имейл? Пишете ни на hola@habil.mx