Udostępnij przez


Konfiguracja XML typu Plug and Play (Dokumentacja SDK POS dla .NET w wersji 1.14)

Mimo że identyfikator sprzętu Plug and Play powinien być ogólnie określony przy użyciu HardwareId właściwości w kodzie źródłowym obiektu usługi, mogą wystąpić czasy, gdy dostawcy obiektów usługi wymagają większej elastyczności. Na przykład identyfikator sprzętu należy zmienić bez ponownego dystrybuowania całego zestawu obiektów usługi.

Aby obsłużyć te przypadki, Microsoft Point of Service for .NET (POS for .NET) określa skojarzenia sprzętu w pliku XML. Te pliki XML są odczytywane z katalogu określonego w kluczu rejestru HKEY_LOCAL_MACHINE/SOFTWARE/POSfor.NET/ControlConfigs. Podczas tworzenia listy dostępnych obiektów usług i urządzeń, PosExplorer przetwarza każdy plik w tym katalogu i kojarzy urządzenie, tam gdzie to możliwe. Obiekt usługi lub aplikacja nie wymaga żadnej dodatkowej akcji.

Schema

Plik konfiguracji Plug and Play musi rozpoczynać się od węzła najwyższego poziomu o nazwie PointOfServiceConfig i mieć atrybut Version, aby wskazać wersję XML pliku.

Następnie może istnieć dowolna liczba podwęźle ServiceObject . Każdy węzeł obiektu usługi musi zawierać atrybuty Type i Name w celu wskazania typu urządzenia POS i nazwy obiektu usługi. Te dwa pola zostaną dopasowane do dostępnych obiektów usługi, aby określić, które, jeśli istnieją, powinny być skojarzone z urządzeniami określonymi w podwęźle HardwareId. W węźle Override istnieje również opcjonalny atrybut . Jeśli ten atrybut jest ustawiony, skojarzenia urządzenia w pliku XML zastępują te zawarte w zestawie.

Węzeł ServiceObject zawiera podwęzły o nazwie HardwareId, które mają atrybuty From oraz To. Zawartość tych atrybutów jest taka sama jak w atrybucie HardwareId w zestawie obiektu usługi i określ zakres identyfikatorów sprzętu do skojarzenia z obiektem usługi.

Example

W przykładzie przedstawiono typowy plik konfiguracji plug and Play XML.

<PointOfServiceConfig Version="1.0">
    <ServiceObject Type="Msr" Name="ExampleMsr" Override="yes">
        <HardwareId From="HID\Vid_0801&Pid_0002&Rev_0100"
                    To="HID\Vid_0801&Pid_0002&Rev_9999" />
    </ServiceObject>
</PointOfServiceConfig>

Pierwszeństwo identyfikatora sprzętu

Override Jeśli atrybut w węźle ServiceObject jest ustawiony, skojarzenie urządzenia określone w xml ma pierwszeństwo, a dowolny HardwareId atrybut w obiekcie usługi zostanie odrzucony.

Override Jeśli atrybut nie jest ustawiony, ani XML, ani HardwareId nie ma pierwszeństwa. Zamiast tego posExplorer kojarzy związek wszystkich określonych urządzeń z obiektem usługi.

Zobacz też

Tasks

Koncepcje