Propiedades de contexto de EDI
Las propiedades de contexto del mensaje del esquema de propiedades global de EDI están expuestos públicamente, lo que permite a los usuarios utilizarlos en operaciones como el enrutamiento de mensajes. Estas propiedades de contexto están definidas en el archivo PropertySchema.xsd del ensamblado Microsoft.BizTalk.Edi.BaseArtifacts. El espacio de nombres de las propiedades es http://schemas.microsoft.com/ Edi/PropertySchema. Si se promueven, estas propiedades de contexto de mensaje están disponibles como Edi.<Nombre de> propiedad en la página Filtros del cuadro de diálogo Propiedades del puerto de envío en la guía de la interfaz de usuario y en la referencia del espacio de nombres de la API de desarrolladores.
Lista de propiedades de contexto
Las propiedades de contexto de EDI también están disponibles en una orquestación, siempre que la referencia al ensamblado Microsoft.BizTalk.Edi.BaseArtifacts se haya agregado al proyecto de la orquestación.
| Nombre | Tipo | Descripción |
|---|---|---|
| AK901 | string | Indica si el grupo funcional identificado en el segmento AK1 de la confirmación se ha aceptado o rechazado (sólo confirmación 997 de X12). |
| AttachmentId | String | El identificador de los datos adjuntos del mensaje. |
| AgreementID | Int | Escrito por la canalización de recepción de EDI. Especifica el identificador del contrato en el que se resuelve el mensaje entrante. Para un contrato de reserva, este valor es 0. |
| AgreementName | String | Escrito por la canalización de recepción de EDI. Especifica el nombre del contrato en el que se resuelve el mensaje entrante. Para un contrato de reserva, este valor es BTSGuestParty. |
| AgreementNameForSend | String | Lo usa la canalización de envío EDI para la resolución de contrato del documento de salida. |
| AgreementPartIDForSend | Int | Lo usa la canalización de envío EDI para la resolución de contrato del documento de salida. Este valor lo escribe la orquestación de procesamiento por lotes. |
| AgreementPartIDOnReceive | Int | Escrito por la canalización de recepción de EDI. Especifica el identificador de contrato unidireccional del contrato al que se ha resuelto el mensaje entrante. Para un contrato de reserva, este valor es 0. |
| BatchElementValidationFailure | boolean | Indicación de que el sistema de procesamiento por lotes ha promovido un error cuando un elemento por lotes no ha podido efectuar una validación. |
| BatchEncodingType | string | El tipo de codificación que BizTalk Server debe usar para codificar un intercambio por lotes saliente. |
| BatchId | Int | El identificador de lote de la configuración de lotes que se debe usar al procesar este documento, si este último únicamente coincide con un filtro de lote. |
| BatchIds | String | Una lista de identificadores de lotes de los conjuntos de filtros de lotes coincidentes, si el documento coincide con más de un filtro de lote. |
| BatchingError | string | Una descripción del error que el sistema de procesamiento por lotes ha promovido al suspender un elemento por lotes. |
| BatchName | String | El nombre de la configuración del lote que se usará al procesar este documento. |
| CodePage | string | Página de códigos que se va a usar para validar el intercambio. |
| CONTRL_UCI4 | string | El campo de código de acción de una confirmación CONTRL, que indica si el intercambio se ha aceptado (con el valor "8") o rechazado a causa de un error en el segmento UNA o UNB (con el valor "4") (sólo confirmación de CONTRL de EDIFACT). |
| DestinationPartyID (en desuso en BizTalk Server) | int | El Id. de la entidad de destino a la que debe enviarse el mensaje. |
| DestinationPartyName (en desuso en BizTalk Server) | string | El nombre de la entidad de destino a la que debe enviarse el mensaje. |
| DestinationPartyReceiver Identificador |
string | El identificador de la entidad de destino a la que debe enviarse el mensaje. Esta propiedad puede promocionarse en un componente personalizado para habilitar la resolución de entidades en la canalización de envío. |
| DestinationPartyReceiver Calificador: |
string | El calificador de la entidad de destino a la que debe enviarse el mensaje. Esta propiedad puede promocionarse en un componente personalizado para habilitar la resolución de entidades en la canalización de envío. |
| DestinationPartySender Identificador |
string | El identificador de la entidad que envía el mensaje a la entidad de destino. Esta propiedad puede promocionarse en un componente personalizado para habilitar la resolución de entidades en la canalización de envío. |
| DestinationPartySender Calificador: |
string | El calificador de la entidad que envía el mensaje a la entidad de destino. Esta propiedad puede promocionarse en un componente personalizado para habilitar la resolución de entidades en la canalización de envío. |
| EncodingType | short | El tipo de codificación que BizTalk Server debe usar para codificar un mensaje saliente. |
| Descripción del error | string | En un mensaje suspendido, contiene una copia del mensaje de error (similar al mensaje del Visor de eventos). |
| GS_Segment | string | El segmento GS completo (grupo funcional) (X12). La canalización de recepción EDI escribe esta propiedad en el contexto cuando se ha dividido el intercambio en conjuntos de transacciones, y no cuando se conserva el intercambio. |
| GS01 | string | El código de identificador funcional (X12). La canalización de recepción edi promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| GS02 | string | El código de remitente de la aplicación (X12). La canalización de recepción edi promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| GS03 | string | El código de receptor de la aplicación (X12). La canalización de recepción edi promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| GS07 | string | La agencia responsable (X12). La canalización de recepción edi promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| GS08 | string | El código de identificador de la versión, el lanzamiento o la industria (X12). La canalización de recepción edi promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| ISA_Segment | string | El segmento ISA completo (encabezado de control de intercambio) (X12). El servidor BizTalk Server escribe esta propiedad en el contexto cuando se ha dividido el intercambio en conjuntos de transacciones, y no cuando se conserva el intercambio. Esta propiedad contiene información de autorización o seguridad (ISA2, Información de autorización, e ISA4, Información de seguridad) que puede dar lugar a la divulgación de información. Puede usar la propiedad de información de seguridad, autorización y contraseña de máscara (en la página Validación y generación de ACK ) para reemplazar cada carácter de los campos ISA2 e ISA4 por un carácter "#". Se trata de un proceso unidireccional: los caracteres "#" no se pueden convertir en caracteres reales. La canalización de recepción EDI escribe esta propiedad en el contexto cuando se ha dividido el intercambio en conjuntos de transacciones, y no cuando se conserva el intercambio. |
| ISA05 | string | El calificador del remitente del intercambio (X12). La canalización de recepción edi promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| ISA06 | string | El identificador del remitente del intercambio (X12). La canalización de recepción edi promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| ISA07 | string | El calificador del receptor del intercambio (X12). La canalización de recepción edi promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| ISA08 | string | El identificador del receptor del intercambio (X12). La canalización de recepción edi promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| ISA15 | string | El indicador de uso (X12). La canalización de recepción EDI promociona esta propiedad en el contexto si el intercambio no es un intercambio por lotes que se conserva. |
| IsResendControlMessage | int | Lo usa el motor AS2 para indicar que se debe retransmitir el envío de un mensaje AS2, ya que no se ha recibido ninguna respuesta MDN dentro del tiempo configurado. |
| IsSystemGeneratedACK | boolean | Indica que el mensaje es una confirmación (TA1 o 997 de X12, o bien CONTRL de EDIFACT) generada por el sistema. Puede establecerse en True o False. Se trata de una propiedad de contexto de mensaje que está disponible como EDI. IsSystemGeneratedACK en la página Filtros del cuadro de diálogo Propiedades del puerto de envío. |
| ReceiverPartyName | String | Escrito por la canalización de recepción de EDI. Especifica el nombre del socio de destino proporcionado en el acuerdo en el que se resuelve el mensaje. Para un contrato de reserva, este valor es RECEIVE-PARTNER. |
| ReceiverPartyNameForSend | String | Lo usa la canalización de envío EDI para la resolución de contrato de documentos de salida. |
| ReuseEnvelope | boolean | Indica si un intercambio se conserva o se divide. Si el intercambio se conserva, BizTalk Server reutilizará el sobre al procesar el intercambio para su envío. |
| SenderPartyName | String | Escrito por la canalización de recepción de EDI. Especifica el nombre del socio de origen proporcionado en el acuerdo en el que se resuelve el mensaje entrante. Para un contrato de reserva, este valor sería BTS-SENDER. |
| SenderPartyNameForSend | String | Lo usa la canalización de envío EDI para la resolución de contrato de documentos de salida. |
| ST01 | string | El código de identificador del conjunto de transacciones (X12). La canalización de recepción edi promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| ST03 | string | El código de identificador de la versión, el lanzamiento o la industria (X12). Puede escribir y promocionar esta propiedad para el contexto y usarla para el enrutamiento de mensajes. |
| TA1_TA104 | string | El campo de comportamiento del motor de una confirmación TA104, que indica si el intercambio se ha aceptado (con el valor "A"), aceptado con errores (con el valor "E") o si se ha rechazado o suspendido (con el valor "R") (sólo confirmación TA1 de X12). |
| ToBeBatched | boolean | Indica si la orquestación de procesamiento por lotes debe procesar el mensaje por lotes con otros mensajes. Después de procesar por lotes un intercambio, la orquestación de procesamiento por lotes establece esta propiedad como "False". |
| ToBeRouted | boolean | Indica si la orquestación de enrutamiento debe elegir el mensaje para crear tantas copias del elemento por lotes como número de suscripciones posea dicho elemento y enrutar las copias al cuadro de mensajes. |
| UNA_Segment | string | El segmento UNA completo (aviso de cadena de servicio) (EDIFACT). La canalización de recepción EDI escribe esta propiedad en el contexto cuando se ha dividido el intercambio en conjuntos de transacciones, y no cuando se conserva el intercambio. |
| UNB_Segment | string | El segmento UNB completo (encabezado de control de intercambio) (EDIFACT). La canalización de recepción EDI escribe esta propiedad en el contexto cuando se ha dividido el intercambio en conjuntos de transacciones, y no cuando se conserva el intercambio. Esta propiedad contiene información de autorización o seguridad (UNB6.1 y UNB6.2) que puede dar lugar a la divulgación de información. Puede usar la propiedad Enmascarar información de seguridad, de autorización y de contraseña para reemplazar los campos UNB6.1 y UNB6.2 con un carácter “#”. Tenga en cuenta que el carácter “#” no puede convertirse en caracteres reales. |
| UNB11 | string | El indicador de uso (EDIFACT). La canalización de recepción EDI promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| UNB2_1 | string | El Id. del remitente del intercambio (EDIFACT). La canalización de recepción EDI promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| UNB2_2 | string | El calificador del código de remitente del intercambio (EDIFACT). La canalización de recepción EDI promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| UNB2_3 | string | La dirección para el enrutamiento invertido (EDIFACT) La canalización de recepción EDI promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| UNB3_1 | string | El Id. del destinatario del intercambio (EDIFACT). La canalización de recepción EDI promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| UNB3_2 | string | El calificador del código de destinatario del intercambio (EDIFACT). La canalización de recepción EDI promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| UNG_Segment | string | El segmento UNG completo (grupo funcional) (X12). La canalización de recepción EDI escribe esta propiedad en el contexto cuando se ha dividido el intercambio en conjuntos de transacciones, y no cuando se conserva el intercambio. |
| UNG1 | string | La identificación de grupo funcional (EDIFACT). La canalización de recepción EDI promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| UNG2_1 | string | La identificación del remitente de la aplicación (EDIFACT). La canalización de recepción EDI promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| UNG3_1 | string | La identificación del destinatario de la aplicación (EDIFACT). La canalización de recepción EDI promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| UNH2_1 | string | El tipo de mensaje (EDIFACT). La canalización de recepción EDI promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| UNH2_2 | string | El número de versión del mensaje (EDIFACT). La canalización de recepción EDI promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
| UNH2_3 | string | El número de versión de mensaje (EDIFACT). La canalización de recepción EDI promueve esta propiedad al contexto (si el intercambio no es un intercambio por lotes que se conserva). |
Extraer campos individuales de las propiedades de contexto de segmento
Las canalizaciones de recepción EDI no escriben ni promocionan algunas propiedades en el contexto de mensaje como propiedades individuales, sino únicamente como parte de la cadena del segmento. Esto se lleva a cabo por razones de rendimiento, ya que la promoción de propiedades afecta al rendimiento. Por ejemplo, las canalizaciones de recepción promocionan los campos ISA5, ISA6, ISA7, ISA8 e ISA15 del segmento ISA como propiedades individuales, mientras que el resto de campos ISA solo se escriben en el contexto como parte de la propiedad ISA_Segment. Estas propiedades se escriben o promueven solo cuando ReuseEnvelope no está establecido en True, lo que indica que no se conserva un intercambio por lotes recibido.
Si necesita que un campo individual de uno de los segmentos (ISA, GS, UNB, UNG o UNA) se escriba en el contexto del mensaje, pero la escritura no se lleva a cabo de forma predeterminada, tendrá que escribir un componente personalizado para escribirla en el contexto de mensaje. Este componente personalizado debe analizar los campos del segmento y escribir un campo individual en el contexto del mensaje.
El ejemplo Message Enrichment muestra cómo utilizar un analizador para extraer los campos individuales de los segmentos y escribirlos en el contexto. Este ejemplo se incluye en la <unidad>:\Archivos de programa\Microsoft BizTalk Server\SDK\Samples\EDI\MessageEnrichment. Para obtener más información, vea Ejemplo de enriquecimiento de mensajes (BizTalk Server ejemplo).
Consulte también
Desarrollo y configuración de soluciones EDI de BizTalk Server