CWA 16926-2:2022
(Main)Extensions for Financial Services (XFS) interface specification Release 3.50 - Part 2: Service Class Definition - Programmer's Reference
Extensions for Financial Services (XFS) interface specification Release 3.50 - Part 2: Service Class Definition - Programmer's Reference
The service classes are defined by their service-specific commands and the associated data structures, error codes, messages, etc. These commands are used to request functions that are specific to one or more classes of Service Providers, but not all of them, and therefore are not included in the common API for basic or administration functions.
When a service-specific command is common among two or more classes of Service Providers, the syntax of the command is as similar as possible across all services, since a major objective of XFS is to standardize function codes and structures for the broadest variety of services. For example, using the WFSExecute function, the commands to read data from various services are as similar as possible to each other in their syntax and data structures.
In general, the specific command set for a service class is defined as a superset of the specific capabilities likely to be provided by the developers of the services of that class; thus any particular device will normally support only a subset of the defined command set.
There are three cases in which a Service Provider may receive a service-specific command that it does not support:
The requested capability is defined for the class of Service Providers by the XFS specification, the particular vendor implementation of that service does not support it, and the unsupported capability is not considered to be fundamental to the service. In this case, the Service Provider returns a successful completion, but does no operation. An example would be a request from an application to turn on a control indicator on a passbook printer; the Service Provider recognizes the command, but since the passbook printer it is managing does not include that indicator, the Service Provider does no operation and returns a successful completion to the application.
The requested capability is defined for the class of Service Providers by the XFS specification, the particular vendor implementation of that service does not support it, and the unsupported capability is considered to be fundamental to the service. In this case, a WFS_ERR_UNSUPP_COMMAND error for Execute commands or WFS_ERR_UNSUPP_CATEGORY error for Info commands is returned to the calling application. An example would be a request from an application to a cash dispenser to retract items where the dispenser hardware does not have that capability; the Service Provider recognizes the command but, since the cash dispenser it is managing is unable to fulfil the request, returns this error.
The requested capability is not defined for the class of Service Providers by the XFS specification. In this case, a WFS_ERR_INVALID_COMMAND error for Execute commands or WFS_ERR_INVALID_CATEGORY error for Info commands is returned to the calling application.
This design allows implementation of applications that can be used with a range of services that provide differing subsets of the functionalities that are defined for their service class. Applications may use the WFSGetInfo and WFSAsyncGetInfo commands to inquire about the capabilities of the service they are about to use, and modify their behavior accordingly, or they may use functions and then deal with error returns to make decisions as to how to use the service.
Specifikacija vmesnika razširitev za finančne storitve (XFS), izdaja 3.50 - 2. del: Opredelitev razreda storitev - Referenca za programerje
Razredi storitev so opredeljeni z lastnimi ukazi, značilnimi za določeno storitev, in s povezanimi podatkovnimi strukturami, kodami napak, sporočili itd. Ti ukazi se uporabljajo pri zahtevanju funkcij, ki so specifične za enega ali več razredov ponudnikov storitev (toda ne za vse), zato niso vključeni v skupnem vmesniku za programiranje aplikacij (API) za osnovne ali skrbniške funkcije.
Kadar se ukaz, značilen za določeno storitev, pogosto uporablja v dveh ali več razredih ponudnikov storitev, je sintaksa ukaza čim bolj podobna v vseh storitvah, saj je glavni cilj razširitev za finančne storitve (XFS) standardizacija funkcijskih kod in struktur za najrazličnejše storitve. Pri uporabi funkcije WFSExecute sta na primer sintaksa in podatkovna struktura ukazov za branje podatkov iz različnih storitev čim bolj podobni.
Na splošno je določen nabor ukazov za razred storitve opredeljen kot nadnabor specifičnih zmožnosti, ki jih bodo verjetno zagotovili razvijalci storitev tega razreda; tako bo določena naprava običajno podpirala le podnabor opredeljenega nabora ukazov.
Obstajajo trije primeri, v katerih lahko ponudnik storitev prejme ukaz, značilen za določeno storitev, ki ga ne podpira:
Zahtevana zmožnost je določena za razred ponudnikov storitev s specifikacijo razširitev za finančne storitve, implementacija določenega dobavitelja te storitve je ne podpira, nepodprta zmožnost pa se ne obravnava kot bistvena za storitev. V tem primeru ponudnik storitve vrne uspešno dokončanje postopka, vendar ne izvede nobene operacije. V drugem primeru bi aplikacija zahtevala vklop kazalnika za upravljanje na tiskalniku hranilnih knjižic; ponudnik storitve prepozna ukaz, toda ker tiskalnik hranilnih knjižic, ki ga upravlja, ne vključuje kazalnika, ponudnik storitve ne izvede nobene operacije in aplikacija prejme uspešno dokončanje postopka.
Zahtevana zmožnost je določena za razred ponudnikov storitev s specifikacijo razširitev za finančne storitve, implementacija določenega dobavitelja te storitve je ne podpira, nepodprta zmožnost pa je obravnavana kot bistvena za storitev. V tem primeru kličoča aplikacija prejme napako WFS_ERR_UNSUPP_COMMAND za ukaze »Izvedi« ali napako WFS_ERR_UNSUPP_CATEGORY za ukaze »Informacije«. V tretjem primeru bi aplikacija od naprave za izdajanje gotovine zahtevala, da umakne elemente, pri katerih strojna oprema zadevne naprave nima te zmožnosti; ponudnik storitve prepozna ukaz, toda ker naprava za izdajanje gotovine, ki jo upravlja, te zahteve ne more izvesti, vrne to napako.
Zahtevana zmožnost ni določena za razred ponudnikov storitev s specifikacijo razširitev za finančne storitve. V tem primeru kličoča aplikacija prejme napako WFS_ERR_INVALID_COMMAND za ukaze »Izvedi« ali napako WFS_ERR_INVALID_CATEGORY za ukaze »Informacije«.
Ta zasnova omogoča izvajanje aplikacij, ki jih je mogoče uporabiti z različnimi storitvami, ki zagotavljajo raznolike nabore funkcionalnosti, določene za njihov razred storitve. Aplikacije lahko z ukazoma WFSGetInfo in WFSAsyncGetInfo poizvedujejo o zmožnostih storitve, ki jo bodo uporabljale, ter ustrezno spremenijo svoje vedenje ali pa uporabijo funkcije in nato obravnavajo vrnjene napake, da se odločijo, kako uporabljati storitev.
General Information
Standards Content (Sample)
SLOVENSKI STANDARD
SIST CWA 16926-2:2023
01-marec-2023
Specifikacija vmesnika razširitev za finančne storitve (XFS), izdaja 3.50 - 2. del:
Opredelitev razreda storitev - Referenca za programerje
Extensions for Financial Services (XFS) interface specification Release 3.50 - Part 2:
Service Class Definition - Programmer's Reference
Ta slovenski standard je istoveten z: CWA 16926-2:2022
ICS:
35.200 Vmesniška in povezovalna Interface and interconnection
oprema equipment
35.240.15 Identifikacijske kartice. Čipne Identification cards. Chip
kartice. Biometrija cards. Biometrics
35.240.40 Uporabniške rešitve IT v IT applications in banking
bančništvu
SIST CWA 16926-2:2023 en,fr,de
2003-01.Slovenski inštitut za standardizacijo. Razmnoževanje celote ali delov tega standarda ni dovoljeno.
---------------------- Page: 1 ----------------------
SIST CWA 16926-2:2023
---------------------- Page: 2 ----------------------
SIST CWA 16926-2:2023
CEN
CWA 16926-2
WORKSHOP
December 2022
AGREEMENT
ICS 35.200; 35.240.15; 35.240.40
English version
Extensions for Financial Services (XFS) interface
specification Release 3.50 - Part 2: Service Class Definition
- Programmer's Reference
This CEN Workshop Agreement has been drafted and approved by a Workshop of representatives of interested parties, the
constitution of which is indicated in the foreword of this Workshop Agreement.
The formal process followed by the Workshop in the development of this Workshop Agreement has been endorsed by the
National Members of CEN but neither the National Members of CEN nor the CEN-CENELEC Management Centre can be held
accountable for the technical content of this CEN Workshop Agreement or possible conflicts with standards or legislation.
This CEN Workshop Agreement can in no way be held as being an official standard developed by CEN and its Members.
This CEN Workshop Agreement is publicly available as a reference document from the CEN Members National Standard Bodies.
CEN members are the national standards bodies of Austria, Belgium, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Finland, France,
Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Norway, Poland, Portugal, Republic of North
Macedonia, Romania, Serbia, Slovakia, Slovenia, Spain, Sweden, Switzerland, Türkiye and United Kingdom.
EUROPEAN COMMITTEE FOR STANDARDIZATION
COMITÉ EUROPÉEN DE NORMALISATION
EUROPÄISCHES KOMITEE FÜR NORMUNG
CEN-CENELEC Management Centre: Rue de la Science 23, B-1040 Brussels
© 2022 CEN All rights of exploitation in any form and by any means reserved worldwide for CEN national Members.
Ref. No.:CWA 16926-2:2022 E
---------------------- Page: 3 ----------------------
SIST CWA 16926-2:2023
CWA 16926-2:2022 (E)
Table of Contents
European Foreword . 3
1. Introduction . 7
1.1 Background to Release 3.50 . 7
1.2 XFS Service-Specific Programming . 7
2. Service Classes . 9
2.1 Printers and Scanners (PTR) . 10
2.2 Identification Card Units (IDC) . 11
2.3 Cash Dispensers (CDM) . 12
2.4 Personal Identification Number Keypads (PIN) . 13
2.5 Check Readers and Scanners (CHK) . 15
2.6 Depository Units (DEP) . 16
2.7 Text Terminal Units (TTU) . 17
2.8 Sensors and Indicators Units (SIU) . 18
2.9 Vendor Dependent Mode (VDM) . 19
2.10 Cameras (CAM) . 20
2.11 Alarms (ALM) .
...
SLOVENSKI STANDARD
SIST-TP CWA 16926-2:2023
01-marec-2023
Specifikacija vmesnika razširitev za finančne storitve (XFS), izdaja 3.50 - 2. del:
Opredelitev razreda storitev - Referenca za programerje
Extensions for Financial Services (XFS) interface specification Release 3.50 - Part 2:
Service Class Definition - Programmer's Reference
Ta slovenski standard je istoveten z: CWA 16926-2:2022
ICS:
35.200 Vmesniška in povezovalna Interface and interconnection
oprema equipment
35.240.15 Identifikacijske kartice. Čipne Identification cards. Chip
kartice. Biometrija cards. Biometrics
35.240.40 Uporabniške rešitve IT v IT applications in banking
bančništvu
SIST-TP CWA 16926-2:2023 en,fr,de
2003-01.Slovenski inštitut za standardizacijo. Razmnoževanje celote ali delov tega standarda ni dovoljeno.
---------------------- Page: 1 ----------------------
SIST-TP CWA 16926-2:2023
---------------------- Page: 2 ----------------------
SIST-TP CWA 16926-2:2023
CEN
CWA 16926-2
WORKSHOP
December 2022
AGREEMENT
ICS 35.200; 35.240.15; 35.240.40
English version
Extensions for Financial Services (XFS) interface
specification Release 3.50 - Part 2: Service Class Definition
- Programmer's Reference
This CEN Workshop Agreement has been drafted and approved by a Workshop of representatives of interested parties, the
constitution of which is indicated in the foreword of this Workshop Agreement.
The formal process followed by the Workshop in the development of this Workshop Agreement has been endorsed by the
National Members of CEN but neither the National Members of CEN nor the CEN-CENELEC Management Centre can be held
accountable for the technical content of this CEN Workshop Agreement or possible conflicts with standards or legislation.
This CEN Workshop Agreement can in no way be held as being an official standard developed by CEN and its Members.
This CEN Workshop Agreement is publicly available as a reference document from the CEN Members National Standard Bodies.
CEN members are the national standards bodies of Austria, Belgium, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Finland, France,
Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Norway, Poland, Portugal, Republic of North
Macedonia, Romania, Serbia, Slovakia, Slovenia, Spain, Sweden, Switzerland, Türkiye and United Kingdom.
EUROPEAN COMMITTEE FOR STANDARDIZATION
COMITÉ EUROPÉEN DE NORMALISATION
EUROPÄISCHES KOMITEE FÜR NORMUNG
CEN-CENELEC Management Centre: Rue de la Science 23, B-1040 Brussels
© 2022 CEN All rights of exploitation in any form and by any means reserved worldwide for CEN national Members.
Ref. No.:CWA 16926-2:2022 E
---------------------- Page: 3 ----------------------
SIST-TP CWA 16926-2:2023
CWA 16926-2:2022 (E)
Table of Contents
European Foreword . 3
1. Introduction . 7
1.1 Background to Release 3.50 . 7
1.2 XFS Service-Specific Programming . 7
2. Service Classes . 9
2.1 Printers and Scanners (PTR) . 10
2.2 Identification Card Units (IDC) . 11
2.3 Cash Dispensers (CDM) . 12
2.4 Personal Identification Number Keypads (PIN) . 13
2.5 Check Readers and Scanners (CHK) . 15
2.6 Depository Units (DEP) . 16
2.7 Text Terminal Units (TTU) . 17
2.8 Sensors and Indicators Units (SIU) . 18
2.9 Vendor Dependent Mode (VDM) . 19
2.10 Cameras (CAM) . 20
2.11 Alarms (ALM) .
...
Questions, Comments and Discussion
Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.