[1.6.0] Walidacja formularzy

Transkrypt

1 [1.6.0] Walidacja formularzy Walidator (ang. validator) jest skryptem sprawdzajcym poprawno przekazywanych informacji w strukturze o okrelonej skadni (Json w przypadku metody POST lub jako parametr w przypadku metody GET ). W przypadku platformy ShipX przeprowadzamy kilka wariantów walidacji jednoczenie. Wraz z wysaniem dania, przekazywane s wartoci podlegajce walidacji, dziki której przekazywane dane zgodne s z zaoeniami platformy, przyjmujcej danie. Dane, które nie speniaj zaoe walidacji, nie s zapisywane przez platform. Uytkownik w takim przypadku informowany jest czytelnym komunikatem zwrotnym. Zasób posiada informacje dot. walidacji formularzy wykorzystywanych w ShipX Na tej stronie Custom Attributes Insurance Parcels Simple Dimensions Simple Weight Simple Receiver Sender Address Create Address Cod Shipment Select Offers Bulk Buy Shipments at Parameters Mapping Custom Attributes target_point Atrybut nie jest wymagany dropoff_point Atrybut nie jest wymagany, wymagalno przekazania atrybutu dropoff_pointwystpuje wraz z przekazaniem atrybutu sending_method Powysza wymagalno wystpuje wycznie dla nastpujcych wartoci atrybutu sending_method ( parcel_locker, pok, courier_pok) allegro_tran saction_id allegro_user _id sending_meth od Atrybut nie jest wymagany Z chwil przekazania wartoci, system weryfikuje czy przekazane dane s zgodne z oczekiwanymi, jeli przekazana warto jest nieprawidowa, uytkownik otrzyma stosowny komunikat. Parametr postbuyid powinien by pobierany metody dogetpostbuysdataforsellers dostpnej z poziomu Allegro, Atrybut nie jest wymagany Z chwil przekazania wartoci, system weryfikuje czy przekazane dane s zgodne z oczekiwanymi, jeli przekazana warto jest nieprawidowa, uytkownik otrzyma stosowny komunikat. Jeli przekazanym atrybutem jest allegro_user_id, system przeprowadzi weryfikacje po stronie Allegro, jeli Allegro zwróci wyjtek, uytkownik otrzyma stosowny komunikat. Parametr userid powinien by pobierany z metody dogetuserid dostpnej z poziomu Allegro, /documentation.php/show/id,102#method-output Atrybut allegro_user_id dotyczy sprzedajcego. Atrybut nie jest wymagany, dopuszczalne wartoci (parcel_locker, pok, pop, courier_pok, branch, dispatch_order), moliwo przekazania pustego atrybutu. Insurance insurance_amount Decimal Atrybut nie jest wymagany Minimum 1 mniej ni insurance_currency Atrybut nie jest wymagany, defoultowa warto PLN

2 Parcels Simple dimensions Dimensions Simple Atrybut nie jest wymagany, wymagalno pojawia si z chwil kiedy template nie zostanie przekazany. template Atrybut nie jest wymagany weight Weight Simple Atrybut nie jest wymagany, wymagalno pojawia si z chwil kiedy template nie zostanie przekazany. id Atrybut nie jest wymagany is_non_standard Boolean Atrybut nie jest wymagany, defoultowa warto null Dodatkowa walidacja: Przekazujc kolekcj, pojawia si wymagalno przekazania atrybutu id w obiekcie paczki, jeli atrybut id nie zostanie przekazany, uytkownik otrzyma stosowny komunikat. Przekazujc kolekcj, pojawia si wymagalno przekazania atrybutu id w obiekcie paczki, jeli atrybut id nie bdzie unikatowy w ramach dania, uytkownik otrzyma stosowny komunikat. Dimensions Simple height Float Atrybut jest wymagany, minimum 1 mniej ni , moliwo przekazania pustego atrybutu. length Float Atrybut jest wymagany, minimum 1 mniej ni , moliwo przekazania pustego atrybutu. width Float Atrybut jest wymagany, minimum 1 mniej ni , moliwo przekazania pustego atrybutu. unit Atrybut nie jest wymagany, defoultowa warto mm Weight Simple amount Float Atrybut jest wymagany, minimum 1 mniej ni , moliwo przekazania pustego atrybutu. unit Atrybut nie jest wymagany, defoultowa warto mm Receiver company_n ame Atrybut nie jest wymagany, wymagalno pojawia si w momencie kiedy nie zostanie przekazany atrybut first_name, last_name oraz address. Maksimum 255 znaków. Atrybut nie jest wymagany, moliwo przekazania pustego atrybutu, w przypadku przesyek paczkomatowych atrybut jest wymagany. phone Atrybut jest wymagany, Podajc adres , walidujemy domen zgodnie z list domen zawartych w ApacheCommonValidator w wersji 1.6 address Address Atrybut jest wymagany,

3 first_name Atrybut nie jest wymagany, wymagalno pojawia si w momencie kiedy nie zostanie przekazany atrybut company_name, oraz phone last_name Atrybut nie jest wymagany, wymagalno pojawia si w momencie kiedy nie zostanie przekazany atrybut company_name, oraz phone Sender company_n ame Atrybut nie jest wymagany, wymagalno pojawia si w momencie kiedy nie zostanie przekazany atrybut first_name ora z last_name Atrybut nie jest wymagany, moliwo przekazania pustego atrybutu. phone Atrybut jest wymagany. address Address Atrybut jest wymagany. first_name Atrybut nie jest wymagany, wymagalno pojawia si w momencie kiedy nie zostanie przekazany atrybut company_name, first_name lub last_name last_name Atrybut nie jest wymagany, wymagalno pojawia si w momencie kiedy nie zostanie przekazany atrybut company_name, first_name lub last_name Address line1 Atrybut nie jest wymagany city Atrybut nie jest wymagany post_code Atrybut nie jest wymagany country_code Atrybut nie jest wymagany street Atrybut nie jest wymagany building_number Atrybut nie jest wymagany Create Address street Atrybut jest wymagany, maksymalna dugo 255 znaków, warunkiem walidacji atrybutu jest nieprzekazanie atrybutów line1 / line2 lub przekazanie atrybutu building_number building_n umber Atrybut jest wymagany, maksymalna dugo 255 znaków, warunkiem walidacji atrybutu jest nieprzekazanie atrybutów line1 / line2 lub przekazanie atrybutu street line1 Atrybut jest wymagany, maksymalna dugo 255 znaków, warunkiem walidacji atrybutu jest przekazanie atrybutu line2 line2 Atrybut nie jest wymagany, maksymalna dugo 255 znaków city Atrybut jest wymagany, maksymalna dugo 255 znaków post_code Atrybut jest wymagany, format adresu zgodnie z konwencj Polskiego adresu pocztowego np country_co de Atrybut nie jest wymagany, minimum 2 znaki, maksimum 3 znaki

4 Cod cod_amount Decimal Atrybut nie jest wymagany, Z chwil przekazania danych system oczekuje wartoci z przedziau od 1do cod_currency Atrybut nie jest wymagany, defoultowa warto PLN Shipment Select Offers id Atrybut nie jest wymagany shipment_id Integer Atrybut jest wymagany offer_id Integer Atrybut jest wymagany Bulk Buy Shipments id Atrybut nie jest wymagany shipment_id Integer Atrybut jest wymagany offer_id Integer Atrybut jest wymagany at Parameters field_separator Atrybut nie jest wymagany character_encoding Atrybut nie jest wymagany text_qualifier Atrybut nie jest wymagany sheets_index Array[Integer] Atrybut nie jest wymagany Mapping custom_attributes Atrybut nie jest wymagany, defaultowa warto nil insurance Atrybut nie jest wymagany, defaultowa warto nil cod Atrybut nie jest wymagany, defaultowa warto nil

5 additional_services Atrybut nie jest wymagany, defaultowa warto nil service Atrybut nie jest wymagany, defaultowa warto nil parcels Atrybut nie jest wymagany, defaultowa warto nil receiver Atrybut nie jest wymagany, defaultowa warto nil sender Atrybut nie jest wymagany, defaultowa warto nil