Blog

Cómo buscar y devolver un valor único de un campo en una tabla de base de datos de aplicación, el caso de uso de BRApi.Database.LookupRowFieldValue usando un objeto DBWhere

Hay casos en los que necesita buscar un valor en una tabla de la base de datos de la aplicación y devolver el valor a su regla comercial. Podrías crear una conexión de base de datos, escribir una consulta SQL, pasar la secuela. consulte a través de una regla de negocios, capture el valor devuelto en una tabla de datos, luego obtenga ese valor y páselo a una variable.

Sin embargo, hay otra forma, BRApi.Database.LookupRowFieldValue, que utiliza un objeto DBWhere. Hay argumentos a favor de ambos enfoques. Yo personalmente uso el enfoque BRApi.Database.LookupRowFieldValue cuando quiero buscar un valor único ya que tiene solo 4 líneas de código. Ésta es sólo una forma de hacer las cosas, no la única.

La función BRApi.Database.LookupRowFieldValue toma 6 parámetros, si como SessionInfo, dblocation como cadena, tableName como cadena, dbWheres como lista (de DbWhere), fieldToReturn como cadena, defaultValue como Cadena.

A continuación se muestra la tabla de la que recuperaré un valor. El ejemplo recuperará NewMemberName donde OldMemberName es igual a "69000".

• 1. Cree su objeto dbWheres, que es una lista de objetos DbWhere. Pienso en los objetos DbWhere como el equivalente de la declaración Where en una consulta SQL; tienen el mismo propósito.

En el siguiente ejemplo, primero creo mi DbWhere. Puede crear varios objetos DbWhere y agregarlos al objeto objDBWheres, que es una lista de objetos DbWhere. El DbWhere toma 3 parámetros, el campo nombre sobre el que actuará el dónde, el tipo de acción (en este caso IsEqualTo) y los criterios sobre los que actuar. Este ejemplo muestra una cláusula donde en el campo OldMemberName donde es igual a "69000".

El DbOperator tiene tantas acciones diferentes que puede seleccionar, algunas de las cuales puede ver en la siguiente captura de pantalla.

Ahora que tiene objDBWheres (que es una lista de objetos DbWhere), puede usarlo en la llamada a la API BRApi.Database.LookupRowFieldValue

• 2. Agregue su llamada de función BRApi.Database.LookupRowFieldValue.

LookUpRowFieldValue toma 6 parámetros, incluido su objeto DbWheres. Le pasa dbLocation, en este caso es la base de datos de la aplicación, el nombre de la tabla a buscar, su objDBWheres y el Campo del que devolver un valor. También puede especificar un valor predeterminado para devolver si no se encuentra nada.

Aquí está el código completo, incluida en este caso una escritura en el registro de errores con fines de demostración.

Para fines de demostración, tengo esto en una regla de extensibilidad a la que puedo llamar desde un paso de gestión de datos. Cuando lo ejecuto, muestra el valor devuelto en el registro de errores.