Functoid de índice

El functoid Index permite seleccionar información de un registro específico en una serie de registros. Cada functoid Index recopila información de un único campo.

Algunos registros suelen producirse muchas veces en un archivo de entrada. Por ejemplo, en un informe meteorológico, el elemento DailySummary puede producirse muchas veces. El elemento DailySummary puede incluir atributos para la temperatura, la presión barométrica y la velocidad del viento. El código siguiente es un ejemplo de un informe meteorológico.

<ns0:WeatherReport xmlns:ns0="http://IndexFunctoid.WeatherReport">  
    <DailySummary Pressure="80" Windspeed="10" Temperature="20" />  
    <DailySummary Pressure="78" Windspeed="20" Temperature="23" />  
    <DailySummary Pressure="77" Windspeed="16" Temperature="24" />  
</ns0:WeatherReport>  

En el esquema subyacente, la propiedad Max Occurs del registro DailySummary se establecería en sin enlazar para indicar un registro periódico o en bucle. El asignador de BizTalk compila este registro como un bucle.

Supongamos que desea recopilar información meteorológica para los dos primeros registros DailySummary del informe meteorológico. En el asignador de BizTalk, cada atributo del registro DailySummary del esquema de origen entrante se puede conectar a un functoid Index . A su vez, cada functoid Index puede especificar el registro DailySummary del que se va a dibujar la información: la primera o la segunda. Los functoids index pueden conectarse a los campos adecuados del esquema de destino.

En la ilustración siguiente se muestran functoids de índice usados de esta manera.

Ejemplo de functoid de índice

Para obtener la información de resumen diaria del primer día, el conjunto superior de tres functoids de índice tiene sus valores de índice establecidos en 1. Para obtener la información de resumen diaria del segundo día, el conjunto inferior de tres functoids de índice tiene sus valores de índice establecidos en 2.

Los functoids de índice usan el cuadro de diálogo Configurar <functoid functoid> para establecer sus parámetros de entrada. El primer parámetro de entrada identifica un campo dentro de un registro de bucle en el esquema de origen. Los parámetros de entrada segundo y correcto especifican el registro determinado. Puede especificar varios valores de índice para seleccionar un registro dentro de estructuras de repetición anidadas. El valor de índice de la estructura más interna es el segundo parámetro. El valor de índice de la siguiente estructura externa sería el tercer parámetro, etc. Por ejemplo, supongamos que los registros DailySummary anteriores estaban dentro de los registros WeeklyData . Para recuperar la presión del primer DailySummary en el segundo WeeklyData, el segundo parámetro sería 1 y el tercer parámetro sería 2.

Observe que en este ejemplo se supone que el campo Presión no se repite. Si el campo se repite, los índices estarían desactivados, el recuento comenzaría con el campo Presión , en lugar del Resumen diario.

Nota:

Aunque un parámetro de entrada de secuencia de índice suele ser una constante, es posible usar un vínculo desde un nodo del esquema de origen. Si este vínculo procede de un registro de bucle que no es un elemento primario del primer parámetro de entrada, el valor de entrada de la secuencia de índice procede de la primera instancia del nodo en el mensaje de instancia de entrada.

Nota:

El valor de la entrada de secuencia de índice siempre está en relación con el contexto actual en el documento de origen.

Importante

Un functoid Index debe tener tantos valores de índice como los nodos primarios del nivel de campo hasta el primer nivel por debajo del nodo raíz. Por ejemplo, en el mensaje de instancia de informe de varias condiciones meteorológicas, se requieren dos valores de índice. En el mensaje de instancia de informe meteorológico único, solo se requiere un valor de índice. Si no se establece el número necesario de valores de índice de un functoid index , se crea una salida basada en el primer nodo del mensaje de instancia de origen que coincide con el primer parámetro de entrada del functoid Index .

Véase también

Cómo agregar functoids de índice a un mapa
Functoids avanzados
Functoid de iteración
Functoid Recuento de registros