DS CWA 16926-2:2022

Shtojca për specifikimet e ndërfaqes në shërbimet financiare (XFS), Versioni 3.50 – Pjesa 2: Përkufizimi i klasës së shërbimit – Referencë për programuesin

Extensions for Financial Services (XFS) interface specification Release 3.50 - Part 2: Service Class Definition - Programmer's Reference

Scope

Klasat e shërbimeve përcaktohen nga komandat e tyre specifike për shërbimin dhe nga strukturat përkatëse të të dhënave, kodet e gabimeve, mesazhet, etj. Këto komanda përdoren për të kërkuar funksione që janë specifike për një ose më shumë klasa të Ofruesve të Shërbimeve, por jo për të gjitha, dhe për këtë arsye nuk përfshihen në API-në e përbashkët për funksionet bazë ose të administrimit.
Kur një komandë specifike për shërbimin është e përbashkët për dy ose më shumë klasa të Ofruesve të Shërbimeve, sintaksa e komandës është sa më e ngjashme të jetë e mundur në të gjitha shërbimet, pasi një nga objektivat kryesore të XFS-së është standardizimi i kodeve të funksioneve dhe strukturave për gamën më të gjerë të shërbimeve. Për shembull, duke përdorur funksionin WFSExecute, komandat për leximin e të dhënave nga shërbime të ndryshme janë sa më të ngjashme të jetë e mundur në sintaksë dhe në strukturat e të dhënave.
Në përgjithësi, grupi i komandave specifike për një klasë shërbimi përcaktohet si një superset i aftësive specifike që ka të ngjarë të ofrohen nga zhvilluesit e shërbimeve të asaj klase; për rrjedhojë, çdo pajisje e veçantë zakonisht do të mbështesë vetëm një nënbashkësi të grupit të komandave të përcaktuara.
Ekzistojnë tre raste në të cilat një Ofrues Shërbimi mund të marrë një komandë specifike për shërbimin që nuk e mbështet:
Aftësia e kërkuar është e përcaktuar për klasën e Ofruesve të Shërbimeve nga specifikimi XFS, por zbatimi i veçantë i prodhuesit nuk e mbështet atë dhe kjo aftësi e pambështetur nuk konsiderohet thelbësore për shërbimin.
Në këtë rast, Ofruesi i Shërbimit kthen një përfundim të suksesshëm, por nuk kryen asnjë veprim. Një shembull do të ishte një kërkesë nga një aplikacion për të ndezur një tregues kontrolli në një printer libreze; Ofruesi i Shërbimit e njeh komandën, por meqë printeri i librezës që ai menaxhon nuk e përfshin këtë tregues, nuk kryhet asnjë veprim dhe aplikacionit i kthehet një përfundim i suksesshëm.
Aftësia e kërkuar është e përcaktuar për klasën e Ofruesve të Shërbimeve nga specifikimi XFS, por zbatimi i veçantë i prodhuesit nuk e mbështet atë dhe kjo aftësi e pambështetur konsiderohet thelbësore për shërbimin.
Në këtë rast, për komandat Execute kthehet gabimi WFS_ERR_UNSUPP_COMMAND, ndërsa për komandat Info kthehet gabimi WFS_ERR_UNSUPP_CATEGORY. Një shembull do të ishte një kërkesë nga një aplikacion drejtuar një shpërndarësi parash për tërheqjen e artikujve, kur pajisja nuk e ka këtë aftësi; Ofruesi i Shërbimit e njeh komandën, por meqë pajisja nuk është në gjendje ta përmbushë kërkesën, kthen këtë gabim.
Aftësia e kërkuar nuk është e përcaktuar për klasën e Ofruesve të Shërbimeve nga specifikimi XFS.
Në këtë rast, për komandat Execute kthehet gabimi WFS_ERR_INVALID_COMMAND, ndërsa për komandat Info kthehet gabimi WFS_ERR_INVALID_CATEGORY.
Ky projektim lejon zhvillimin e aplikacioneve që mund të përdoren me një gamë shërbimesh që ofrojnë nënbashkësi të ndryshme të funksionaliteteve të përcaktuara për klasën e tyre të shërbimit. Aplikacionet mund të përdorin komandat WFSGetInfo dhe WFSAsyncGetInfo për të pyetur mbi aftësitë e shërbimit që do të përdorin dhe të përshtatin sjelljen e tyre në përputhje me to, ose mund të thërrasin funksione dhe më pas të trajtojnë gabimet e kthyera për të marrë vendime mbi mënyrën e përdorimit të shërbimit.