Съдържание на курса
Урок 14 — Един файл, няколко поръчки
От Dorian Chávez · съосновател и 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. Предвиди
Преди да отвориш маршрута, отговори на лист хартия:
- Партида 0001 носи пет пратки. Колко 856-ци очакваш на SFTP на партньора?
- В партида 0002 третата пратка се проваля. Какво става с четвъртата и петата? А с първата и втората, които вече са минали?
- Когато партида 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. Тук е обратното: всяка пратка е на различен клиент и това, че една се проваля, не е причина да не уведомиш останалите четирима. Кое е по-добре — всичко или нищо, или една по една, зависи от това дали частите зависят една от друга.
Упражнение: партидата с нейната грешка
С твоята завършена версия:
- Отвори
buzon/.error/lote-bodega-0002.json. Ако ти беше човекът, който обслужва склада, как щеше да разбереш коя от петте пратки да прегледаш? Стига ли ти файлът, или ти трябва логът? - Пусни
./verificaоще веднъж, без да променяш нищо. Дублира ли се някоя 856-ца или някой EMBARCADO? Защо не? (Подсказка: verifica почиства дестинациите преди всяка партида, а API-то разпознава ключа на всяка пратка.) - Представи си, че складът поправя 9999 и праща отново цялата партида 0002. Какво би станало с четирите поръчки, които вече бяха EMBARCADO? Запиши отговора си: темата „кога две съобщения са едно и също?“ е урок 18.
Защо е направено така
Какво решихме в този урок, заедно с това, което отхвърлихме, и какво би ни накарало да си променим мнението:
- Един файл от склада се разделя на пратките си и една лоша не спира останалите
Преговор
- Какво прави един Splitter и защо е нужен при партида от склада?
- Защо вътре в
splitпоръчката се чете с${body[orden]}, а не с$.orden? - За какво служи
marshalпреди извикването на рутера? - Какво прави
stopOnException: false? Защо се пише, щом вече е стойността по подразбиране? - Заключителният въпрос: партида 0002 завърши в
.error/, макар че четири пратки минаха. Проблем ли е това? Какво ти казва този файл и какво ти казва логът?
Следва: в урок 15 заключителният въпрос от урок 12 се връща: ако рутерът има реплики, къде живее информацията за всяка поръчка? Днес рутерът не помни нищо; утре записва всяка поръчка, всеки канал и всеки опит в собствена база.
Предпочитате имейл? Пишете ни на hola@habil.mx