Información de referencia: definir e inicializar documentos lógi (Biblioteca SAP

Información de referencia: definir e inicializar documentos lógicos

Entorno de tiempo de ejecución

Para inicializar la comunicación entre el documento HTML y el Sistema R/3, se debe registrar el documento en el momento de la ejecución. Puede hacerlo incluyendo el siguiente JavaScript en la etiqueta de seguridad de cabecera del documento HTML:

El entorno de tiempo de ejecución reserva automáticamente los siguientes controladores de evento de JavaScript. No puede utilizar estos eventos para sus propias funciones.

Objeto	Evento
ventana	onload, onunload
ventana.documento	onhelp, oncontextmenu, onkeypress, onclick

Inicializar el documento lógico

Todas las instrucciones de producción y todos los cockpits pueden constar de una agrupación jerárquica de diversos documentos HTML. Además, las instrucciones de producción pueden llamar uno o varios cockpits, que a su vez pueden utilizar varios otros cockpits y consiguientemente varios otros documentos HTML. En el momento de la ejecución, el Sistema R/3 debe saber cuál de estos documentos HTML debe utilizar como documentos principales y con qué documento lógico se corresponden.

Un documento lógico se identifica mediante los atributos siguientes en la etiqueta de seguridad META del documento HTML:

NAME ="_bfw_document_"
CONTENT = "valor del atributo de 'ID' del documento XML"

El ID del documento de archivo es idéntico al número de instrucciones de producción o a la denominación de cockpit. El documento XML creado proporciona este ID del documento de archivo como atributo de la etiqueta de seguridad DOCUMENT. En el documento HTML, una etiqueta de seguridad META que se debe actualizar antes de que el JavaScript incluya SAPR3-WR-BFW_INC_TOP.JS debe declarar el ID del documento de archivo.

El usuario podría incluir la sentencia siguiente para una etiqueta de seguridad META en la etiqueta de seguridad DOCUMENT de la hoja modelo XSL, por ejemplo:

Ejemplo

Ejemplo de definición de XSL

Documento XML	Documento XSL	Documento HTML
... <DOCUMENT id="10000000000004711"> .... </DOCUMENT> ...	... <META NAME="_bfw_document_"> <xsl:attribute name="CONTENT"> <xsl:value-of select="/@id"/> </xsl:attribute></META> <SCRIPT LANGUAGE="JavaScript" SRC="SAPR3-WR-BFW_INC_TOP.JS"> </SCRIPT> ...	... <META NAME="_bfw_document_" CONTENT="100000000000004711">. <SCRIPT LANGUAGE="JavaScript" SRC="SAPR3-WR-BFW_INC_TOP.JS"> </SCRIPT> ...

Explicación de la definición de XSL:

El atributo NAME="_bfw_document_" en la etiqueta de seguridad META especifica que el documento con el ID del documento de archivo que se debe añadir se debe identificar como el documento lógico.
La etiqueta de seguridad <xsl:attribute name="CONTENT"> especifica que se debe añadir un atributo con la denominación "CONTENT" con la etiqueta de seguridad META del documento HTML.
La etiqueta de seguridad <xsl:value-of select="/id"/> determina que el valor del atributo "id" se debe marcar en el documento XML y se debe insertar palabra por palabra como valor del atributo "CONTENT" en el documento HTML

Los documentos HTML que no declaran un documento lógico se asignan al documento lógico superior. Para hacerlo, el sistema realiza una búsqueda ascendente de la jerarquía de marco del browser. Puede utilizar este mecanismo, por ejemplo, para enlazar más documentos HTML con iFrames que pueden contener hiperenlaces a ficheros en el Sistema R/3 o marcadores para funciones de menú (véase información de referencia: Definición de comandos). El entorno de tiempo de ejecución puede acceder únicamente a documentos HTML que se cargan desde el Sistema R/3.

En el momento de la ejecución, el ID del documento de archivo debe ser unívoco para todos los documentos cargados. El entorno de tiempo de ejecución garantiza que se cumple este requisito. Si tiene lugar un error, el sistema crea un mensaje en el log. Si el mismo ID del documento de archivo aparece más de una vez, se inicia sólo la primera instancia.