Lee un documento digital puntual de la base. Existe un método con dos parámetros que serán el nombre del campo clave y el valor de ese campo si el documento está definido con solo un campo clave. Si éste tiene más de un campo como clave se pasa un array de NombreClave1, Valor1, NombreClave2, Valor2, …, NombreClaveN, ValorN.
•El parámetro pDocumentName es el nombre del documento digital a leer, un String de 3 letras.
•El parámetro pKey es el criterio de búsqueda, en un array con pares ordenados de Nombre de atributo (Tipo String) - Valor.
Si alguno de los campos clave es null se lanza una excepción indicando que todos los campos clave deben estar especificados para una consulta puntual. Esto es por seguridad porque si uno de los campos claves es null se realiza una búsqueda sin tener en cuenta el valor de ese campo y se encontrará más de un elemento, retornando el primero que se encuentre.
Se retorna el documento digital leído, un objeto de la clase BODigitalDocument, o null si no existe un documento con esa clave.
Ejemplo de uso:
// Leer la factura número 23500001. //
BODigitalDocument xBODigitalDocument = xBTDigitalDocument.readDocument("FAC", "nuFactura", new Integer(23500001));
