Partilhar via

Configuração Plug and Play XML (Documentação do POS para o SDK .NET v1.14)

Embora o ID de hardware Plug and Play deva geralmente ser especificado usando a HardwareId propriedade do código-fonte do Objeto de Serviço, podem existir ocasiões em que os fornecedores de Objetos de Serviço necessitem de mais flexibilidade. Por exemplo, o ID de hardware precisa de ser alterado sem redistribuir toda a montagem do Objeto de Serviço.

Para suportar estes casos, o Microsoft Point of Service for .NET (POS for .NET) especifica associações de hardware num ficheiro XML. Estes ficheiros XML são lidos a partir do diretório especificado na chave de registo HKEY_LOCAL_MACHINE/SOFTWARE/POSfor.NET/ControlConfigs. Ao construir a lista de Objetos de Serviço e dispositivos disponíveis, PosExplorer processa cada ficheiro nesse diretório e associa o dispositivo sempre que possível. Não é necessária nenhuma ação adicional nem do Objeto de Serviço nem da aplicação.

Schema

Um ficheiro de configuração Plug and Play deve começar com um nó de topo chamado PointOfServiceConfig e ter o atributo Version para indicar a versão XML do ficheiro.

Depois disso, pode haver qualquer número de subnós ServiceObject . Cada nó de objeto de serviço deve incluir os atributos Type e Name para indicar o tipo de dispositivo POS e o nome do Objeto de Serviço. Estes dois campos serão comparados com os Objetos de Serviço disponíveis para determinar quais, se houver, devem estar associados aos dispositivos especificados no subnó HardwareId. Existe também um atributo opcional no nó ServiceObject , Override. Se este atributo for definido, então as associações de dispositivo no ficheiro XML sobrepõem-se às contidas na assembleia.

O nó ServiceObject contém subnós com o nome HardwareId, que têm atributos From e To. O conteúdo destes atributos é o mesmo que seria encontrado no HardwareId atributo numa assembly de Objeto de Serviço e especificam o intervalo de IDs de hardware a associar ao Objeto de Serviço.

Example

O exemplo mostra um ficheiro de configuração XML Plug and Play típico.

<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>

Precedência de ID de Hardware

Se o atributo Override estiver definido no nó ServiceObject, então a associação de dispositivo especificada no XML tem precedência, e qualquer atributo HardwareId no Service Object será descartado.

Se o Override atributo não estiver definido, então nem o XML nem o HardwareId têm precedência. Em vez disso, o PosExplorer associa a união de todos os dispositivos especificados ao Objeto de Serviço.

Ver também

Tasks

Conceitos

  • Last updated on