Documentación de integraciones

Servicio de gestión de intercambio de datos por lote (BDES)

Este servicio se utiliza para iniciar procesamientos de Integración del SIS por volumen y generar informes sobre ello.

Operaciones implementadas

announceBulkDataExchangeasynchronously.
announceFailureBulkDataExchange

Operaciones invocadas

ignoreBulkDataExchange
cancelBulkDataExchange
reportBulkDataExchange
requestBulkDataExchange

Acerca de la operación announceBulkDataExchange

Un sistema de información de estudiantes invoca la operación announceBulkDataExchange cuando desea iniciar el proceso de Integración por volumen. Esta convocatoria produce una respuesta inmediata del sistema para indicar si la solicitud se recibió correctamente o no, y el proceso en masa continúa de forma asincrónica.

Flujo de proceso: announceBulkDataExchange

Cuando se recibe una solicitud announceBulkDataExchange del LIS, D2L traduce la solicitud con los traductores del LIS configurados para ITranslateAnnounceBulkDataExchange a fin de transformar la solicitud en un formato que la plataforma del IPSIS pueda comprender.
Una vez que la solicitud se ha traducido, los controladores de la Plataforma del IPSIS configurados para IBulkFileReadyRequestHandler se utilizan para registrar la solicitud por volumen con el IPSIS.
La respuesta del LIS se genera desde la respuesta del controlador. La respuesta incluye una lista de los servicios de implementación admitidos utilizando el traductor ITranslateSupportedServices configurado.
El Procesamiento por volumen se produce asincrónicamente después de haber recibido y respondido la solicitud de anuncio. Los servicios en segundo plano del trabajo por volumen del IPSIS procesa el trabajo por volumen a través de los siguientes pasos: los archivos se recuperan mediante IBulkFileRetriever, luego se procesan con IBulkFileProcessor y se genera una respuesta utilizando IBulkSendReportHandler, que usa reportBulkDataExchange para notificar los resultados al SIS.

Solicitud announceBulkDataExchange de muestra

<SOAP-ENV:Envelope xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"

   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

   <SOAP-ENV:Header>

      <imsx_syncRequestHeaderInfo xmlns="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

         <imsx_version>V1.0></imsx_version>

         <imsx_messageIdentifier>1234></imsx_messageIdentifier>

      </imsx_syncRequestHeaderInfo>

   <ims:imsx_epaRequestHeaderInfo xmlns:ims="http://www.imsglobal.org/xsd/gws/gwsv1p0/imsepa_v1p0"/></SOAP-ENV:Header>

   <SOAP-ENV:Body>

      <bdems:announceBulkDataExchangeRequest

         xmlns:bdems="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

         <bdems:transactionId>Test-1234></bdems:transactionId>

         <bdems:bulkBlockManifest>

            <bdems:bulkBlockManifestId>Test-1234</bdems:bulkBlockManifestId>

            <bdems:expiryDate>3000-01-01T00:00:00</bdems:expiryDate>

            <bdems:bulkBlockDataFile>

               <bdems:url>http://localhost://1234-a.xml></bdems:url&gt;

               <bdems:checkSum>00</bdems:checkSum>

               <bdems:totalSize>0</bdems:totalSize>

               <bdems:savePoint>2011-11-28T10:59:35.000000Z></bdems:savePoint>

               <bdems:serviceSet>

                  <bdems:serviceRecord>

                     <bdems:serviceName>pmsv2p0</bdems:serviceName>

                     <bdems:interfaceName>personmanager</bdems:interfaceName>

                     <bdems:operationSet>

                        <bdems:operationName>replacePerson</bdems:operationName>

                        <bdems:operationName>deletePerson</bdems:operationName>

                     </bdems:operationSet>

                  </bdems:serviceRecord>

               </bdems:serviceSet>

            </bdems:bulkBlockDataFile>

            <bdems:bulkBlockDataFile>

               <bdems:url>http://localhost://1234-b.xml></bdems:url&gt;

               <bdems:checkSum>00></bdems:checkSum>

               <bdems:totalSize>0></bdems:totalSize>

               <bdems:savePoint>2011-11-28T10:59:35.000000Z></bdems:savePoint>

               <bdems:serviceSet>

                  <bdems:serviceRecord>

                     <bdems:serviceName>gmsv2p0</bdems:serviceName>

                     <bdems:interfaceName>groupmanager</bdems:interfaceName>

                     <bdems:operationSet>

                        <bdems:operationName>replaceGroup</bdems:operationName>

                     </bdems:operationSet>

                  </bdems:serviceRecord>

               </bdems:serviceSet>

            </bdems:bulkBlockDataFile>

         </bdems:bulkBlockManifest>

      </bdems:announceBulkDataExchangeRequest>

   </SOAP-ENV:Body>

</SOAP-ENV:Envelope>

Encabezado de solicitud announceBulkDataExchange y campos del cuerpo

Campos del encabezado de la solicitud

Para obtener más información, consulte Encabezados de solicitud y respuesta.

Campos del cuerpo de la solicitud

La Configuración del traductor de plantillas procesa los siguientes campos de la solicitud:

Propiedad	Esquema de solicitud del LIS	Obligatorio
JobId	request.bulkBlockManifestId	Sí
Fecha y hora de vencimiento	request.expiryDate	Sí
URL de archivos remotos	request.bulkBlockDataFile[*].url	Sí
Tamaños de archivos	request.bulkBlockDataFile[*].totalSize	Sí
Sumas de control	request.bulkBlockDataFile[*].checkSum	Sí
Puntos de suspensión	request.bulkBlockDataFile[*].savePoint	Sí
Tipos de entidad	request.bulkBlockDataFile[].serviceSet.serviceRecord[].interfaceName	Sí

Respuesta annouceBulkDataExchange de muestra

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

   <s:Header>

      <h:imsx_syncResponseHeaderInfo

        xmlns:h="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0"

        xmlns="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0"

        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

        xmlns:xsd="http://www.w3.org/2001/XMLSchema">

         <imsx_version>V1.0></imsx_version>

         <imsx_messageIdentifier>BDEMS_announceBulkDataExchange_20120304T014745_2593446Z></imsx_messageIdentifier>

         <imsx_statusInfo>

            <imsx_codeMajor>success></imsx_codeMajor>

            <imsx_severity>status></imsx_severity>

            <imsx_description/>

            <imsx_codeMinor>

               <imsx_codeMinorField>

                  <imsx_codeMinorFieldName>TargetEndSystem></imsx_codeMinorFieldName>

                  <imsx_codeMinorFieldValue>fullsuccess></imsx_codeMinorFieldValue>

               </imsx_codeMinorField>

            </imsx_codeMinor>

         </imsx_statusInfo>

      </h:imsx_syncResponseHeaderInfo>

   </s:Header>

   <s:Body

       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

       xmlns:xsd="http://www.w3.org/2001/XMLSchema">

      <announceBulkDataExchangeResponse

          xmlns="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

         <supportedServices>

            <personInterface>

               <operationName>replacePerson</operationName>

               <operationName>deletePerson</operationName>

            </personInterface>

            <groupInterface>

               <operationName>replaceGroup</operationName>

               <operationName>deleteGroup</operationName>

            </groupInterface>

            <membershipInterface>

               <operationName>replaceMembership</operationName>

               <operationName>deleteMembership</operationName>

            </membershipInterface>

            <templateInterface>

               <operationName>replaceCourseTemplate</operationName>

               <operationName>deleteCourseTemplate</operationName>

            </templateInterface>

            <offeringInterface>

               <operationName>replaceCourseOffering</operationName>

               <operationName>deleteCourseOffering</operationName>

            </offeringInterface>

            <sectionInterface>

               <operationName>replaceCourseSection</operationName>

               <operationName>deleteCourseSection&</operationName>

            </sectionInterface>

            <associationInterface>

               <operationName>replaceSectionAssociation</operationName>

               <operationName>deleteSectionAssociation</operationName>

            </associationInterface>

         </supportedServices>

      </announceBulkDataExchangeResponse>

   </s:Body>

</s:Envelope>

Encabezado de respuesta de announceBulkDataExchange y campos del cuerpo

Campos del encabezado de respuesta

Para obtener más información, consulte Encabezados de solicitud y respuesta.

Campos del cuerpo de respuesta

La Configuración del traductor de plantillas procesa los siguientes campos de la solicitud:

Propiedad	Esquema de respuesta del LIS	Obligatorio
JobId	request.bulkBlockManifestId	Sí
Fecha y hora de vencimiento	request.expiryDate	Sí
URL de archivos remotos	request.bulkBlockDataFile[*].url	Sí
Tamaños de archivos	request.bulkBlockDataFile[*].totalSize	Sí
Sumas de control	request.bulkBlockDataFile[*].checkSum	Sí
Puntos de suspensión	request.bulkBlockDataFile[*].savePoint	Sí
Tipos de entidad	request.bulkBlockDataFile[].serviceSet.serviceRecord[].interfaceName	Sí

Acerca de la operación announceFailureBulkDataExchange

La operación AnnounceFailureBulkDataExchange utiliza una solicitud de error de noticia y la procesa. El resultado final consiste en que el sistema de origen correspondiente a la solicitud sale del modo por lote y el registro correspondiente en la base de datos que resume toda la información requerida para el trabajo por lote tiene el estado como cancelado.

Flujo de proceso: announceFailureBulkDataExchange

Cuando se recibe una solicitud AnnounceFailureBulkDataExchange del LIS, D2L obtiene el transactionId de la solicitud y registra el código y la descripción del error si se presentan. No se utiliza un traductor conectable por separado para esta operación.
Una vez que la solicitud se ha traducido, los controladores de la Plataforma del IPSIS configurados para IBulkAnnounceFailureRequestHandler se utilizan para procesar la solicitud.
La respuesta del LIS se genera desde la respuesta del controlador.

Solicitud announceFailureBulkDataExchange de muestra

<soapenv:Envelope

    xmlns:ims="http://www.imsglobal.org/xsd/gws/gwsv1p0/imsepa_v1p0"

    xmlns:ims1="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0"

    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">

   <soapenv:Header>

      <ims:imsx_epaRequestHeaderInfo>

      </ims:imsx_epaRequestHeaderInfo>

      <ims1:imsx_syncRequestHeaderInfo>

         <ims1:imsx_version>V1.0</ims1:imsx_version>

         <ims1:imsx_messageIdentifier>1234</ims1:imsx_messageIdentifier>

      </ims1:imsx_syncRequestHeaderInfo>

   </soapenv:Header>

   <soapenv:Body>

      <ims1:announceFailureBulkDataExchangeRequest>

         <ims1:transactionId>Samp-816</ims1:transactionId>

      </ims1:announceFailureBulkDataExchangeRequest>

   </soapenv:Body>

</soapenv:Envelope>

Encabezado de solicitud announceFailureBulkDataExhange y campos del cuerpo

Campos del encabezado de la solicitud

Para obtener más información, consulte Encabezados de solicitud y respuesta.

Campos del cuerpo de la solicitud

El adaptador acepta los siguientes campos en la solicitud:

Propiedad	Esquema de solicitud del LIS	Obligatorio
ID de transacción	request.transactionId	Sí
Código de error	request.FailureReportType.failureCode	No
Descripción del error	request.FailureReportType.failureDescription	No

Respuesta announceFailureBulkDataExchange de muestra

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

   <s:Header>

      <h:imsx_syncResponseHeaderInfo

          xmlns:h="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0"

          xmlns="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0"

          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

          xmlns:xsd="http://www.w3.org/2001/XMLSchema">

         <imsx_version>V1.0</imsx_version>

         <imsx_messageIdentifier>BDEMS_announceFailureBulkDataExchange_20120223T192808_3713232Z</imsx_messageIdentifier>

         <imsx_statusInfo>

            <imsx_codeMajor>success</imsx_codeMajor>

            &ltimsx_severity>status</imsx_severity>

            <imsx_messageRefIdentifier>1234</imsx_messageRefIdentifier>

            <imsx_description/>

            <imsx_codeMinor>

               <imsx_codeMinorField>

                  <imsx_codeMinorFieldName>TargetEndSystem</imsx_codeMinorFieldName>

                  <imsx_codeMinorFieldValue>fullsuccess</imsx_codeMinorFieldValue>

               </imsx_codeMinorField>

            </imsx_codeMinor>

         </imsx_statusInfo>

      </h:imsx_syncResponseHeaderInfo>

   </s:Header>

   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

       xmlns:xsd="http://www.w3.org/2001/XMLSchema"/>

</s:Envelope>

Encabezado de respuesta announceFailureBulkDataExchange y campos del cuerpo

Campos del encabezado de respuesta

Para obtener más información, consulte Encabezados de solicitud y respuesta.

Campos del cuerpo del objeto de respuesta

No se devuelven campos en el cuerpo de la respuesta.

Acerca de la operación ignoreBulkDataExchange

El adaptador IPSIS LIS invoca la operación IgnoreBulkDataExchange ejecutada por el SIS. La invocación se implementa dentro de un controlador que implementa IBulkCancelRequestHandler y se configura para ejecutarse cuando se inicia una solicitud de Omitir en alguna parte de la Plataforma del IPSIS.

Flujo de proceso: ignoreBulkDataExchange

Cuando se inicia una solicitud por lote de ignorar (normalmente a través de la Interfaz de administrador), el BulkManager invoca al controlador configurado para implementar IBulkCancelRequestHandler. Para los sistemas que utilizan LIS, el controlador registrado inicia una solicitud IgnoreBulkDataExchange al SIS.

Solicitud ignoreBulkDataExchange de muestra

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">

<s:Header>

<h:imsx_syncRequestHeaderInfo xmlns:h="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0" xmlns="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<imsx_version>V1.0</imsx_version>

<imsx_messageIdentifier>1234</imsx_messageIdentifier>

<imsx_sendingAgentIdentifier>LIS_Test_System</imsx_sendingAgentIdentifier>

</h:imsx_syncRequestHeaderInfo>

<h:imsx_epaRequestHeaderInfo xmlns:h="http://www.imsglobal.org/xsd/gws/gwsv1p0/imsepa_v1p0" xmlns="http://www.imsglobal.org/xsd/gws/gwsv1p0/imsepa_v1p0"/>

</s:Header>

<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<transactionId>testRequest1</transactionId>

</ignoreBulkDataExchangeRequest>

</s:Body>

</s:Envelope>

Encabezado de solicitud ignoreBulkDataExchange y campos del cuerpo

Campos del encabezado de la solicitud

Para obtener más información, consulte Encabezados de solicitud y respuesta.

Campos del cuerpo de la solicitud

Propiedad	Descripción
transactionId	El identificador único asignado a esta transacción por el consumidor del servicio anterior a la solicitud de intercambio de datos por volumen.

Respuesta ignoreBulkDataExchange de muestra

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ims="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

   <soapenv:Header>

      <ims:imsx_syncResponseHeaderInfo>

         <ims:imsx_version>V1.0</ims:imsx_version>

         <ims:imsx_statusInfo>

            <ims:imsx_codeMajor>success</ims:imsx_codeMajor>

            <ims:imsx_severity>status</ims:imsx_severity>

            <ims:imsx_codeMinor>

               <ims:imsx_codeMinorField>

                  <ims:imsx_codeMinorFieldName>TargetEndSystem</ims:imsx_codeMinorFieldName>

                  <ims:imsx_codeMinorFieldValue>fullsuccess</ims:imsx_codeMinorFieldValue>

               </ims:imsx_codeMinorField>

            </ims:imsx_codeMinor>

         </ims:imsx_statusInfo>

        </ims:imsx_syncResponseHeaderInfo>

   </soapenv:Header>

   <soapenv:Body>

      <ims:ignoreBulkDataExchangeResponse>?</ims:ignoreBulkDataExchangeResponse>

   </soapenv:Body>

</soapenv:Envelope>

Encabezado de respuesta ignoreBulkDataExchange y campos del cuerpo

Campos del encabezado de respuesta

El proveedor del servicio (por ejemplo, Oracle) origina la respuesta y, a continuación, la envía nuevamente a D2L según nuestro envío de la solicitud mencionada.

Campo	Regresar	Valor
imsx_syncResponseHeaderInfo.imsx_version	El proveedor del servicio devuelve "V1.0" independientemente del valor del Encabezado de la solicitud.
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMajor	El proveedor del servicio devuelve el Código de estado mayor definido por el IMS.	success: cuando el proveedor del servicio recibe correctamente la solicitud de ignorar. failure: cuando el proveedor del servicio no recibe correctamente la solicitud de ignorar.
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_severity	El proveedor del servicio devuelve la gravedad definida por el IMS.	status
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_messageRefIdentifier	El proveedor del servicio devuelve el valor de imsx_syncRequestHeaderInfo.imsx_messageIdentifier
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMinor.imsx_codeMinorField.imsx_codeMinorFieldValue	El proveedor del servicio devuelve el valor del campo Código de estado menor definido por el IMS.	full success: cuando el proveedor del servicio ha recibido correctamente la solicitud de ignorar. invalidtransactionid: cuando el ID de transacción que devuelve el consumidor del servicio es desconocido en el proveedor del servicio. Se registra una condición de error en el proveedor del servicio, pero no se efectúan otros procesos.

Campos del cuerpo de respuesta

Ninguna.

Acerca de la operación cancelBulkDataExhange

La operación CancelBulkDataExchange se utiliza para enviar una solicitud de cancelación al SIS.

Flujo de proceso: cancelBulkDataExchange

Genere y envíe una solicitud.
Cuando se cancela un trabajo por volumen, el Administrador por volumen se basa en el IBulkCancelRequestHandler configurado.
Para los sistemas que utilizan LIS, el controlador registrado inicia una solicitud CancelBulkDataExchange al SIS.

Solicitud cancelBulkDataExchange de muestra

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"

            xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">

    <s:Header>

        <h:imsx_syncRequestHeaderInfo

                       xmlns:h="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0"

                       xmlns="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0"

                       xmlns:xsd="http://www.w3.org/2001/XMLSchema"

                        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

            <imsx_version>V1.0</imsx_version>

                        <imsx_messageIdentifier>1234</imsx_messageIdentifier>

                        <imsx_sendingAgentIdentifier>LIS_Test_System</imsx_sendingAgentIdentifier>

        </h:imsx_syncRequestHeaderInfo>

        <h:imsx_epaRequestHeaderInfo xmlns:h="http://www.imsglobal.org/xsd/gws/gwsv1p0/imsepa_v1p0"

                     xmlns="http://www.imsglobal.org/xsd/gws/gwsv1p0/imsepa_v1p0"/>

    </s:Header>

    <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

        <cancelBulkDataExchangeRequest xmlns="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

            <transactionId>testRequest1</transactionId>

        </cancelBulkDataExchangeRequest>

    </s:Body>

</s:Envelope>

Encabezado de solicitud cancelBulkDataExchange y campos del cuerpo

Campos del encabezado de la solicitud

Para obtener más información, consulte Encabezados de solicitud y respuesta.

Campos del cuerpo de la solicitud

Propiedad	Descripción
transactionId	El identificador único asignado a esta transacción por los consumidores del servicio antes de la solicitud de intercambio de datos en masa.

Respuesta cancelBulkDataExchange de muestra

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ims="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

   <soapenv:Header>

      <ims:imsx_syncResponseHeaderInfo>

         <ims:imsx_version>V1.0</ims:imsx_version>

         <ims:imsx_statusInfo>

            <ims:imsx_codeMajor>success</ims:imsx_codeMajor>

            <ims:imsx_severity>status</ims:imsx_severity>

            <ims:imsx_codeMinor>

               <ims:imsx_codeMinorField>

                  <ims:imsx_codeMinorFieldName>?</ims:imsx_codeMinorFieldName>

                  <ims:imsx_codeMinorFieldValue>fullsuccess</ims:imsx_codeMinorFieldValue>

               </ims:imsx_codeMinorField>

            </ims:imsx_codeMinor>

         </ims:imsx_statusInfo>

      </ims:imsx_syncResponseHeaderInfo>

   </soapenv:Header>

   <soapenv:Body>

      <ims:cancelBulkDataExchangeResponse>TargetEndSystem</ims:cancelBulkDataExchangeResponse>

   </soapenv:Body>

</soapenv:Envelope>

Encabezado de respuesta cancelBulkDataExchange y campos del cuerpo

Campos del encabezado de respuesta

El proveedor del servicio (por ejemplo, Oracle) origina la respuesta y, a continuación, la envía nuevamente a D2L según el envío de la solicitud.

Encabezado	Regresar	Valor
imsx_syncResponseHeaderInfo.imsx_version	El proveedor del servicio devuelve "V1.0" independientemente del valor del Encabezado de la solicitud.
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMajor	El proveedor del servicio devolverá el Código de estado mayor definido por el IMS.	success: cuando el proveedor del servicio recibe correctamente la solicitud de ignorar. failure: cuando el proveedor del servicio no recibe correctamente la solicitud de ignorar.
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_severity	El proveedor del servicio devuelve la gravedad definida por el IMS.	status
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_messageRefIdentifier	El proveedor del servicio devuelve el valor de imsx_syncRequestHeaderInfo.imsx_messageIdentifier
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMinor.imsx_codeMinorField.imsx_codeMinorFieldValue	El proveedor del servicio devuelve el valor del campo Código de estado menor definido por el IMS.	fullsuccess: cuando el proveedor del servicio recibe correctamente la solicitud de ignorar. invalidtransactionid: cuando el ID de transacción que devuelve el consumidor del servicio es desconocido en el proveedor del servicio. Se registra una condición de error en el proveedor del servicio, pero no se efectúan otros procesos.

Campos del cuerpo de respuesta

Ninguna.

Acerca de la operación reportBulkDataExchange

El Adaptador IPSIS LIS no es compatible con la operación ReportBulkDataExchange, sino que invoca esta operación en el SIS cuando se ha completado un proceso de Intercambio de datos por lote.

Flujo de proceso: reportBulkDataExchange

Procese y envíe la solicitud. Cuando se completa un trabajo por volumen, el Administrador por volumen se basa en los controladores IBulkSendReportHandler configurados. Para los sistemas que utilizan LIS, el controlador registrado inicia una solicitud ReportBulkDataExchange al SIS.

Solicitud reportBulkDataExchange de muestra

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"

       xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">

        <s:Header>

                <h:imsx_syncRequestHeaderInfo

                          xmlns:h="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0"

                          xmlns="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0"

                          xmlns:xsd="http://www.w3.org/2001/XMLSchema"

                          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

                        <imsx_version>V1.0</imsx_version>

                        <imsx_messageIdentifier>1234</imsx_messageIdentifier>

                        <imsx_sendingAgentIdentifier>LIS_Test_System</imsx_sendingAgentIdentifier>

                </h:imsx_syncRequestHeaderInfo>

                <h:imsx_epaRequestHeaderInfo xmlns:h="http://www.imsglobal.org/xsd/gws/gwsv1p0/imsepa_v1p0"

                      xmlns="http://www.imsglobal.org/xsd/gws/gwsv1p0/imsepa_v1p0"/>

        </s:Header>

        <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

                <reportBulkDataExchangeRequest xmlns="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

                        <transactionId>testRequest1</transactionId>

                        <bulkBlockReport>

                                <bulkBlockManifestIdRef>testRequest1</bulkBlockManifestIdRef>

                                <reportSummary>

                                <noofTotalFullSuccess>6</noofTotalFullSuccess>

                                        <noofTotalPartialSuccess>0</noofTotalPartialSuccess>

                                        <noofTotalFailure>1</noofTotalFailure>

                                        <interfaceSummaryReport>

                                                <interfaceName>groupmanager</interfaceName>

                                                <noofFullSuccess>2</noofFullSuccess>

                                                <noofPartialSuccess>0</noofPartialSuccess>

                                                <noofFailure>0</noofFailure>

                                        </interfaceSummaryReport>

                                        <interfaceSummaryReport>

                                                <interfaceName>personmanager</interfaceName>

                                                <noofFullSuccess>0</noofFullSuccess>

                                                <noofPartialSuccess>0</noofPartialSuccess>

                                                <noofFailure>1</noofFailure>

                                        </interfaceSummaryReport>

                                        <interfaceSummaryReport>

                                                <interfaceName>coursetemplatemanager</interfaceName>

                                                <noofFullSuccess>1</noofFullSuccess>

                                                <noofPartialSuccess>0</noofPartialSuccess>

                                                <noofFailure>0</noofFailure>

                                        </interfaceSummaryReport>

                                        <interfaceSummaryReport>

                                                <interfaceName>courseofferingmanager</interfaceName>

                                                <noofFullSuccess>1</noofFullSuccess>

                                                <noofPartialSuccess>0</noofPartialSuccess>

                                                <noofFailure>0</noofFailure>

                                        </interfaceSummaryReport>

                                        <interfaceSummaryReport>

                                                <interfaceName>coursesectionmanager</interfaceName>

                                                <noofFullSuccess>1</noofFullSuccess>

                                                <noofPartialSuccess>0</noofPartialSuccess>

                                                <noofFailure>0</noofFailure>

                                        </interfaceSummaryReport>

                                        <interfaceSummaryReport>

                                                <interfaceName>membershipmanager</interfaceName>

                                                <noofFullSuccess>1</noofFullSuccess>

                                                <noofPartialSuccess>0</noofPartialSuccess>

                                                <noofFailure>0</noofFailure>

                                        </interfaceSummaryReport>

                                </reportSummary>

                                <transactionReportList>

                                        <transactionReport>

                                                <transactionOpIdentifierRef>Copy3</transactionOpIdentifierRef>

                                                <serviceName>pmsv2p0</serviceName>

                                                <transactionFailStatusVocabulary>http://www.imsglobal.org/lis/bdemsv1p0/transactionfailstatusvocabularyv1p0</transactionFailStatusVocabulary&gt;

                                                <transactionFailStatus>unknownvocabulary</transactionFailStatus>

                                        </transactionReport>

                                </transactionReportList>

                        </bulkBlockReport>

                </reportBulkDataExchangeRequest>

        </s:Body>

</s:Envelope>

Encabezado de solicitud reportBulkDataExchange y campos del cuerpo

Campos del encabezado de la solicitud

Para obtener más información, consulte Encabezados de solicitud y respuesta.

Campos del cuerpo de la solicitud

Propiedad	Descripción
transactionId	El ID de transacción correspondiente a la solicitud de anuncio que se envió.
reportSummary	Muestra la cantidad total de transacciones incluidas en la solicitud de anuncio, y el estado de cada uno. Contiene los informes interfaceSummaryReports.
interfaceSummaryReport	El contenedor de la información de resumen sobre el procesamiento de los archivos de datos por volumen realizado por el consumidor del servicio para una determinada interfaz de servicio.
transactionReport	El contenedor de los informes de estado en todas las transacciones dentro del archivo de datos por volumen que el consumidor del servicio no logró completar de forma correcta. Si no hay informes, entonces la solicitud announceBulkDataExchange se completó de forma correcta.
reportFailureDetail	El contenedor del conjunto de informes que describen las transacciones que dieron lugar a la generación de los códigos de estado de error.

Respuesta reportBulkDataExchangede muestra

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ims="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

   <soapenv:Header>

      <ims:imsx_syncResponseHeaderInfo>

         <ims:imsx_version>V1.0</ims:imsx_version>

         <ims:imsx_statusInfo>

            <ims:imsx_codeMajor>success</ims:imsx_codeMajor>

            <ims:imsx_severity>status</ims:imsx_severity>

            <ims:imsx_codeMinor>

               <ims:imsx_codeMinorField>

                  <ims:imsx_codeMinorFieldName>TargetEndSystem</ims:imsx_codeMinorFieldName>

                  <ims:imsx_codeMinorFieldValue>fullsuccess</ims:imsx_codeMinorFieldValue>

               </ims:imsx_codeMinorField>

            </ims:imsx_codeMinor>

         </ims:imsx_statusInfo>

      </ims:imsx_syncResponseHeaderInfo>

   </soapenv:Header>

   <soapenv:Body>

      <ims:reportBulkDataExchangeResponse>?</ims:reportBulkDataExchangeResponse>

   </soapenv:Body>

</soapenv:Envelope>

Encabezado de respuesta reportBulkDataExchange y campos del cuerpo

El proveedor del servicio (por ejemplo, Oracle) origina la respuesta y, a continuación, la envía nuevamente a D2L según el envío de la solicitud.

Campos del encabezado de respuesta

Encabezado	Regresar	Valor
imsx_syncResponseHeaderInfo.imsx_version	El proveedor del servicio devuelve "V1.0" independientemente del valor del Encabezado de la solicitud.
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMajor	El proveedor del servicio devuelve el Código de estado mayor definido por el IMS.	success: cuando el proveedor del servicio recibe correctamente la solicitud de ignorar. failure: cuando el proveedor del servicio no recibe correctamente la solicitud de ignorar.
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_severity	El proveedor del servicio devuelve la gravedad definida por el IMS.	status
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_messageRefIdentifier	El proveedor del servicio devuelve el valor de imsx_syncRequestHeaderInfo.imsx_messageIdentifier
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMinor.imsx_codeMinorField.imsx_codeMinorFieldValue	El proveedor del servicio devuelve el valor del campo Código de estado menor definido por el IMS.	fullsuccess: cuando el proveedor del servicio recibió el informe correctamente y los datos suministrados son válidos. invalidtransactionid: cuando el ID de transacción que devuelve el consumidor del servicio es desconocido en el proveedor del servicio. Se registra una condición de error en el proveedor del servicio, pero no se efectúan otros procesos. incompletedata: cuando el proveedor del servicio ha detectado que falta una parte obligatoria del objeto BulkBlockReport. invaliddata: cuando una parte del objeto BulkBlockReport no es válida. expireddata: cuando el archivo de datos en masa expiryDate muestra que la validez del archivo ha vencido.

Campos del cuerpo de respuesta

Ninguna.

Acerca de la operación requestBulkDataExchange

El adaptador IPSIS LIS invoca la operación RequestBulkDataExchange ejecutada por el SIS. La invocación se implementa dentro de un controlador que implementa IBulkRequestDataHandler y se configura para ejecutarse cuando se inicia una solicitud en alguna parte de la Plataforma del IPSIS.

Flujo de proceso: requestBulkDataExchange

Procese y envíe la solicitud. Cuando se inicia una solicitud de intercambio de datos por volumen (normalmente a través de la interfaz del Administrador), el BulkManager invoca al controlador configurado para implementar IBulkRequestDataHandler.

Solicitud requestBulkDataExchange de muestra

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ims="http://www.imsglobal.org/xsd/gws/gwsv1p0/imsepa_v1p0" xmlns:ims1="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

   <soapenv:Header>

      <ims1:imsx_syncRequestHeaderInfo>

         <ims1:imsx_version>V1.0</ims1:imsx_version>

         <ims1:imsx_messageIdentifier>1234</ims1:imsx_messageIdentifier>

         <ims1:imsx_sendingAgentIdentifier>LIS_TEST_SYSTEM</ims1:imsx_sendingAgentIdentifier>

      </ims1:imsx_syncRequestHeaderInfo>

   </soapenv:Header>

   <soapenv:Body>

      <ims1:requestBulkDataExchangeRequest>

         <ims1:transactionId>060d01bf-8c5a-4e87-85f5-92a8aca30ef8</ims1:transactionId>

         <ims1:filter>

            <!--1 or more repetitions:-->

            <ims1:filterRule>

               <ims1:filterTypeVocabulary>http://www.imsglobal.org/lis/bdemsv1p0/filtertypevocabularyv1p0</ims1:filterTypeVocabulary&gt;

               <ims1:filterType>object</ims1:filterType>

               <!--Optional:-->

               <ims1:filterValueVocabulary>http://www.imsglobal.org/lis/bdemsv1p0/filtervalueobjectvocabularyv1p0</ims1:filterValueVocabulary&gt;

               <ims1:filterValue>All</ims1:filterValue>

            </ims1:filterRule>

         </ims1:filter>

      </ims1:requestBulkDataExchangeRequest>

   </soapenv:Body<

</soapenv:Envelope>

Encabezado de solicitud requestBulkDataExchange y campos del cuerpo

Campos del encabezado de la solicitud

Para obtener más información, consulte Encabezados de solicitud y respuesta.

Campos del cuerpo de la solicitud

Propiedad	Descripción
transactionId	El identificador único asignado a esta transacción por el consumidor del servicio anterior a la solicitud de intercambio de datos por volumen.

Respuesta requestBulkDataExchange de muestra

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ims="http://www.imsglobal.org/services/lis/bdems1p0/wsdl11/sync/imsbdems_v1p0">

   <soapenv:Header>

      <ims:imsx_syncResponseHeaderInfo>

         <ims:imsx_version>V1.0</ims:imsx_version>

         <ims:imsx_statusInfo>

            <ims:imsx_codeMajor>success</ims:imsx_codeMajor>

            <ims:imsx_severity>status</ims:imsx_severity>

            <ims:imsx_codeMinor>

               <ims:imsx_codeMinorField>

                  <ims:imsx_codeMinorFieldName>TargetEndSystem</ims:imsx_codeMinorFieldName>

                  <ims:imsx_codeMinorFieldValue>fullsuccess</ims:imsx_codeMinorFieldValue>

               </ims:imsx_codeMinorField>

            </ims:imsx_codeMinor>

         </ims:imsx_statusInfo>

      </ims:imsx_syncResponseHeaderInfo>

   </soapenv:Header>

   <soapenv:Body>

      <ims:requestBulkDataExchangeResponse>?</ims:requestBulkDataExchangeResponse>

   </soapenv:Body>

</soapenv:Envelope>

Encabezado de respuesta requestBulkDataExchange y campos del cuerpo

Campos del encabezado de respuesta

El proveedor del servicio (por ejemplo, Oracle) genera la respuesta y la envía nuevamente a D2L, según el envío de la solicitud.

Encabezado	Regresar	Valor
imsx_syncResponseHeaderInfo.imsx_version	El proveedor del servicio devuelve "V1.0" independientemente del valor del Encabezado de la solicitud.
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMajor	El proveedor del servicio devuelve el Código de estado mayor definido por el IMS.	success: cuando el proveedor del servicio recibe correctamente la solicitud de ignorar. failure: cuando el proveedor del servicio no recibe correctamente la solicitud de ignorar.
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_severity	El proveedor del servicio devolverá la gravedad definida por el IMS.	status
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_messageRefIdentifier	El proveedor del servicio devuelve el valor de imsx_syncRequestHeaderInfo.imsx_messageIdentifier.
imsx_syncResponseHeaderInfo.imsx_statusInfo.imsx_codeMinor.imsx_codeMinorField.imsx_codeMinorFieldValue	El proveedor del servicio devuelve el valor del campo Código de estado menor definido por el IMS.	fullsuccess: cuando la solicitud se ha recibido correctamente y el objetivo podrá cumplir con la solicitud. invaliddata: cuando los tipos de datos de objetos identificado son desconocidos en el proveedor de servicios. savepointerror: cuando se ha producido un error en el procesamiento de la información del identificador de los puntos de suspensión, lo que imposibilita leer los objetos correctos desde la base de datos. savepointsyncerror: cuando el valor de referencia del punto de suspensión del origen fue posterior al del sistema de destino. Los datos de sincronización no estarán disponibles.

Campos del cuerpo de respuesta

El cuerpo de la respuesta incluye una lista de los servicios admitidos, que pueden incluir los mencionados a continuación:

personInterface.replacePerson
personInterface.deletePerson
groupInterface.replaceGroup
groupInterface.deleteGroup
membershipInterface.replaceMembership
membershipInterface.deleteMembership
templateInterface.replaceCourseTemplate
templateInterface.deleteCourseTemplate
offeringInterface.replaceCourseOffering
offeringInterface.deleteCourseOffering
sectionInterface.replaceCourseSection
sectionInterface.deleteCourseSection
associationInterface.replaceSectionAssocation
associationInterface.deleteSectionAssociation