Referencia a functoids acumulativos

 

Use los functoids acumulativos para realizar varios tipos de operaciones de acumulación para los valores que aparecen varias veces en un mensaje de instancia. Por ejemplo, puede usar el functoid Suma acumulativa para proporcionar el total combinado de un valor que aparece en varios registros dentro de un ámbito concreto de un mensaje de instancia.

En Microsoft BizTalk Server, todos los functoids acumulativos admiten dos parámetros de entrada. El segundo de ellos es un parámetro de ámbito opcional que no se usó en los functoids acumulativos de las versiones anteriores de BizTalk Server. Los dos parámetros son:

• Parámetro 1: el valor que se va a acumular. Este valor debe ser numérico para todos los functoids acumulativos, excepto en el caso del functoid Concatenación acumulativa, donde se espera un valor de cadena. Para proporcionar este valor, se crea un vínculo entre un nodo Atributo de campo, Elemento de campo o Registro (con su propiedad Mixed establecida en True) que tenga el tipo de datos adecuado y el functoid acumulativo.

  Nota

  Si ninguno de los nodos antecesores Registro del árbol de esquema se repite, no tiene sentido usar un functoid acumulativo.

• Parámetro 2: el ámbito en el que se debe realizar la acumulación del valor especificado en el primer parámetro. Este valor numérico opcional indica el grado de relación que deben tener los valores especificados en un mensaje de instancia para participar en la acumulación. Los valores pueden ser los siguientes:

  • El valor predeterminado cero (0) indica que el valor de elemento o atributo, tal como indica el nombre de elemento o atributo correspondiente, se debe acumular en todo el mensaje de instancia.

  • Un valor de ámbito igual a uno (1) indica que solo se deben acumular los valores de elemento o atributo que tengan el mismo elemento primario.

  • Un valor de ámbito igual a dos (2) indica que solo se deben acumular los valores de elemento o atributo que tengan el mismo elemento primario de segundo nivel, etc.

Nota

Todos los functoids acumulativos proporcionan compatibilidad con versiones anteriores de Microsoft BizTalk Server 2000 y Microsoft BizTalk Server 2002; en dichas versiones se requería solo un parámetro de entrada. El parámetro predeterminado de ámbito era cero (0), es decir, el ámbito de todo el mensaje de instancia.

Para información conceptual sobre los functoid acumulativos, incluido el parámetro de ámbito, consulte Functoids acumulativos.

En la tabla siguiente se muestran los functoids de la categoría Acumulativos.

Functoids acumulativos	Descripción
Promedio acumulado	Calcula el promedio acumulado de un valor numérico que se repite en los mensajes de instancia correspondientes.
Concatenación acumulativa	Concatena varias instancias de un valor de cadena que se repite en los mensajes de instancia correspondientes.
Máximo acumulado	Determina el valor máximo de un valor numérico que se repite en los mensajes de instancia correspondientes.
Mínimo acumulado	Determina el valor mínimo de un valor numérico que se repite en los mensajes de instancia correspondientes.
Suma acumulativa	Calcula la suma acumulada de un valor numérico que se repite en los mensajes de instancia correspondientes.

Consulte también

Cómo agregar functoids básicos a una asignación