Compartir vía

Functoids de base de datos

  • Artículo

Los functoids de base de datos extraen datos de una base de datos para su uso en un mensaje de instancia de salida.

Información general

A continuación se muestra una lista de los functoids de base de datos y cómo se pueden usar:

  • Búsqueda en base de datos. Use el functoid Búsqueda de base de datos para extraer información de una base de datos y almacenarla como un conjunto de registros de .NET (ADO.NET) de Microsoft ActiveX Data Objects. Este functoid requiere cuatro parámetros de entrada en el orden siguiente:

    • Un valor de búsqueda

    • Una cadena de conexión de base de datos

    • Un nombre de tabla

    • Un nombre de columna para el valor de búsqueda.

  • Devolución de error. Use el functoid Error Return para capturar información de error, como errores de conexión de base de datos, que se producen durante el tiempo de ejecución. Este functoid requiere un parámetro de entrada: un vínculo del functoid Búsqueda de base de datos .

  • Formatear mensaje. Devuelve una cadena formateada y localizada utilizando sustitución de argumentos y, potencialmente, referencias cruzadas a valores e Id.

  • Obtener el identificador de la aplicación. Recupera un identificador de un objeto de aplicación.

  • Obtener valor de aplicación. Recupera un valor de aplicación.

  • Obtener Id. común. Recupera un identificador de un objeto común.

  • Obtener valor común. Recupera un valor común.

  • Quite el identificador de aplicación. Quita un valor de aplicación.

  • Establezca id. común. Establece y devuelve un identificador para un objeto común.

  • Extractor de valor. Use el functoid Extractor de valores para extraer datos de la columna especificada en un conjunto de registros devuelto por el functoid Búsqueda de base de datos. Este functoid requiere dos parámetros de entrada: un vínculo al functoid Búsqueda de base de datos y un nombre de columna.

    Siete de los functoids de base de datos ( Mensaje de formato, Obtener id. de aplicación, Obtener valor de aplicación, Obtener identificador común, Obtener valor común, Quitar id. de aplicación y Establecer identificador común) son functoids crossReferencing . Estos functoids trasladan los Id. y valores de un mensaje de entrada a los Id. y valores que se necesitan en el mensaje de salida. Para obtener más información, consulte Referencia de functoids de base de datos en la guía de interfaz de usuario y referencia del espacio de nombres de api para desarrolladores.

Ejemplo

En el ejemplo siguiente se usan algunos de los functoids de base de datos . Imagine un gran fabricante de comercios al por menor, con tiendas distribuidas por una extensa área geográfica. Para realizar un seguimiento de las tiendas, la sede asigna a cada tienda un código único denominado StoreID. Además, la sede central asocia la siguiente información a cada StoreID:

  • StoreName

  • StoreAddress

  • Ciudad

  • Código postal

  • StorePhoneNumber

  • StoreManager

    Esta información se almacena en una base de datos y se distribuye a los socios comerciales periódicamente. Para el fabricante, todas las compras las realiza la oficina central, no las tiendas. Cuando la oficina central envía un pedido a los socios comerciales, es habitual que varias tiendas reciban mercancía encargada mediante el pedido único. En lugar de enviar información de nombre y dirección para cada tienda que es recibir mercancías, la sede simplemente envía el StoreID. Para insertar la información de nombre y dirección en el aviso de envío avanzado, el socio comercial usa los functoids de base de datos para insertar automáticamente esta información en el mensaje de instancia de salida. En la siguiente ilustración se muestra cómo puede implementar un socio comercial la sustitución del StoreID en una asignación.

    Mapa que muestra distintos functoids de base de datos.

    En la ilustración, el esquema de origen representa un pedido entrante; el esquema de destino representa una notificación previa de envío. El functoid Búsqueda de base de datos busca el registro adecuado de la tabla de base de datos adecuada. Los functoids extractor de valores extraen la columna adecuada del registro de búsqueda. El functoid Error Return genera una cadena que contiene información de error si hay errores (como errores de conexión) en tiempo de ejecución.

    En el ejemplo anterior, el primer parámetro de entrada se toma del campo StoreID del pedido de compra entrante y los tres parámetros de entrada restantes son constantes configuradas en el cuadro de diálogo Configurar <functoid Functoid> para el functoid Búsqueda de base de datos functoid. Es posible crear vínculos desde el esquema de origen para suministrar valores a los cuatro parámetros de entrada.

Nota

  • No puede usar algunos tipos de datos de Microsoft SQL Server, como texto, ntext e imagen, como valores de búsqueda para el functoid Búsqueda de base de datos. El functoid requiere tipos de datos que puedan representarse como una cadena de texto.

  • Si hay más de un registro que coincide con los parámetros de entrada del functoid Búsqueda de base de datos, el functoid Extractor de valores extrae datos solo del primer registro.

  • Utilice autenticación de NT en las cadenas de conexión para proteger las contraseñas mediante cifrado.

Functoids disponibles

Los functoids de base de datos son:

  • Búsqueda en base de datos
  • Devolución de error
  • Formatear mensaje
  • Obtener Id. de aplicación
  • Obtener valor de aplicación
  • Obtener Id. común
  • Obtener valor común
  • Quitar Id. de aplicación
  • Establecer Id. común
  • Extractor de valor

Para obtener más información sobre estos functiods, consulte La referencia de Functoid en la guía de la interfaz de usuario y la referencia del espacio de nombres de api de desarrolladores.

Consulte también