Obtenga información sobre las propiedades de enlace del adaptador de BizTalk para Oracle E-Business Suite.
El adaptador de Microsoft BizTalk para Oracle E-Business Suite muestra varias propiedades de enlace. Al establecer estas propiedades, puede controlar parte del comportamiento del adaptador. En esta sección se describen las propiedades de enlace del adaptador de E-Business de Oracle. También muestra cómo puede acceder a ellos mediante la programación de .NET o estableciendo propiedades en un enlace de puerto físico BizTalk Server.
Propiedades de enlace del adaptador
Oracle E-Business Suite es una capa de aplicación sobre la base de datos de Oracle subyacente. Algunas propiedades de enlace configuran el comportamiento del adaptador al interactuar con Oracle E-Business Suite, mientras que otras propiedades configuran el comportamiento al interactuar con la base de datos de Oracle. En la tabla siguiente se muestran todas las propiedades de enlace del adaptador de Oracle E-Business agrupadas por categoría. La categoría hace referencia al nodo en el que cada propiedad de enlace aparece en los cuadros de diálogo que presentan diferentes aplicaciones para configurar el adaptador (o enlace).
| Binding (propiedad) | Category | Descripción | Tipo de .NET |
|---|---|---|---|
| ClientCredentialType | General | Especifica qué conjunto de credenciales se especifican al establecer una conexión con Oracle E-Business Suite. Los valores posibles son Database y EBusiness. - Si se establece en Base de datos, los clientes del adaptador deben especificar las credenciales de la base de datos para establecer la conexión y las credenciales de E-Business Suite para las propiedades de enlace OracleUserName y OraclePassword . - Si se establece en EBusiness, los clientes de adaptador deben especificar las credenciales de E-Business Suite para establecer la conexión y las credenciales de base de datos para las propiedades de enlace OracleUserName y OraclePassword . Importante: Si la propiedad de enlace ClientCredentialType está establecida en EBusiness, es obligatorio especificar el nombre de usuario de la base de datos y la contraseña para las propiedades de enlace OracleUserName y OraclePassword . El valor predeterminado es Database. |
enum (ClientCredential) |
| CloseTimeout | General | Tiempo de espera de cierre de la conexión WCF. Especifica un valor de intervalo de tiempo que indica el intervalo de tiempo proporcionado para que se complete la operación interna de cierre del canal WCF. El valor predeterminado es 1 minuto. No compatible. | System.TimeSpan |
| EnableBizTalkCompatibilityMode | General | Especifica cómo el adaptador genera el esquema para un DataSet. Establézcalo en True para generar el esquema para DataSet correctamente. Al usar los adaptadores de BizTalk Server, siempre debe establecer la propiedad en True. Al usar los adaptadores de Visual Studio, siempre debe establecer la propiedad en False. |
bool (System.Boolean) |
| InboundOperationType | General | Especifica si desea realizar la operación de sondeo o de entrada de notificación . El valor predeterminado es Sondeo. Para obtener más información sobre el sondeo , consulte Compatibilidad con llamadas entrantes mediante sondeo. Para obtener más información sobre la notificación, vea Consideraciones para recibir notificaciones de cambio de base de datos mediante el adaptador de Oracle Database. |
enum |
| Nombre | General | Valor de solo lectura que devuelve el nombre del archivo generado por el complemento Agregar referencia de servicio de adaptador de Visual Studio para contener la clase de cliente WCF. El complemento Add Adapter Service Reference forma el nombre de archivo anexando "Client" al valor de la propiedad Name . El valor devuelto es "OracleEBSBinding"; para este valor, el archivo generado se denominará "OracleEBSBindingClient". | string |
| OpenTimeout | General | Tiempo de espera de apertura de la conexión WCF. Especifica un valor de intervalo de tiempo que indica el intervalo de tiempo proporcionado para que se complete la operación interna de apertura del canal. El valor predeterminado es 1 minuto. Importante: El adaptador de Oracle E-Business siempre usa OpenTimeout para establecer el tiempo de espera de apertura de la conexión cuando abre una conexión a la base de datos de Oracle. El adaptador omite los parámetros de tiempo de espera (System.TimeSpan) pasados al abrir un objeto de comunicación, como un canal. |
System.TimeSpan |
| ReceiveTimeout | General | Tiempo de espera de recepción del mensaje WCF. Especifica un valor de intervalo de tiempo que indica el intervalo máximo de tiempo para el que el adaptador espera un mensaje entrante. El valor predeterminado es 10 minutos. Importante: Para las operaciones entrantes, como el sondeo, se recomienda establecer el tiempo de espera en el valor máximo posible, que es 24.20:31:23.6470000 (24 días). Cuando se usa el adaptador con BizTalk Server, establecer el tiempo de espera en un valor grande no afecta a la funcionalidad del adaptador. |
System.TimeSpan |
| SendTimeout | General | Tiempo de espera de envío del mensaje WCF. Especifica un valor de intervalo de tiempo que indica el intervalo de tiempo proporcionado para que se complete la operación de envío del canal interno. El valor predeterminado es 5 minutos. | System.TimeSpan |
| UseAmbientTransaction | General | Especifica si el adaptador de Oracle E-Business realiza las operaciones mediante el contexto de transacción proporcionado por el autor de la llamada. El valor predeterminado es true, lo que significa que el adaptador siempre realiza las operaciones en un contexto de transacción, suponiendo que el cliente proporciona el contexto transaccional. Si hay otros recursos que participan en la transacción, las conexiones creadas se inscriben en System.Transaction y se elevan a una transacción MSDTC. Sin embargo, puede haber escenarios en los que no desee que el adaptador realice operaciones en un contexto transaccional. Por ejemplo: - Al realizar una operación SELECT simple en la base de datos de Oracle (en un puerto de envío) - Mientras especifica una instrucción de sondeo que realiza una operación SELECT y no implica ningún cambio en la tabla a través de una instrucción DELETE o invocando un procedimiento almacenado (en un puerto de recepción) Ambas operaciones no realizan ninguna actualización de la tabla de base de datos y, por tanto, elevar estas operaciones para usar una transacción MSDTC puede ser una sobrecarga de rendimiento. En estos escenarios, puede establecer la propiedad de enlace en false para que el adaptador de Oracle E-Business no realice las operaciones en un contexto de transacción. Nota: No realizar operaciones en un contexto transaccional solo es aconsejable para las operaciones que no realizan cambios en la base de datos. En el caso de las operaciones que actualizan los datos de la base de datos, se recomienda establecer la propiedad de enlace en true; de lo contrario, podría experimentar pérdida de mensajes o mensajes duplicados en función de si está realizando operaciones entrantes o salientes. |
bool (System.Boolean) |
| DataFetchSize | Administración de búfer | ODP.NET propiedad. Especifica la cantidad de datos en bytes que ODP.NET captura del conjunto de resultados en un recorrido de ida y vuelta de servidor. El valor predeterminado es 65536. Esta propiedad se usa para el ajuste del rendimiento. | long (System.Int64) |
| InsertBatchSize | Administración de búfer | Especifica el tamaño del lote para varias operaciones de inserción de registros. El valor predeterminado es 20. Para los valores de InsertBatchSize mayor que uno, el adaptador de Oracle E-Business agrupa por lotes el número especificado de registros en una sola llamada ODP.NET. Si el número de registros de la operación Insertar no es un múltiplo del tamaño del lote, el lote final contendrá menos registros que el valor del tamaño del lote. Por ejemplo, si el mensaje de inserción tiene 10 registros y InsertBatchSize se establece en 1, el adaptador lee registros individuales y los escribe en la base de datos de Oracle. Por lo tanto, el adaptador realiza 10 operaciones independientes en la base de datos de Oracle. De forma similar, si el mensaje de inserción tiene 10 registros y InsertBatchSize se establece en 5, el adaptador leerá y escribirá 5 registros cada vez en la base de datos de Oracle, por lo que solo realizará 2 operaciones de inserción. Un valor bien elegido para InsertBatchSize puede mejorar considerablemente el rendimiento del adaptador para varias operaciones de inserción de registros. |
int (System.Int32) |
| LongDatatypeColumnSize | Administración de búfer | Especifica el tamaño máximo en bytes de una columna de tipo de datos long de Oracle. El valor máximo de esta propiedad de enlace puede ser 32512. El valor predeterminado es 0. Debe usar el valor predeterminado si no está realizando la operación en un tipo de datos largo. Debe establecer explícitamente un valor adecuado para esta propiedad de enlace si es: - Ejecución de un procedimiento almacenado que contiene parámetros de tipo de datos largos. - Realizar una operación Select en una tabla que contiene columnas con tipo de datos long y la instrucción SELECT no incluye la columna de clave principal. Si desea establecer el valor máximo de esta propiedad de enlace, establezca el valor en -1. Nota: Esta propiedad de enlace está en desuso. |
int |
| MaxOutputAssociativeArrayElements | Administración de búfer | Especifica el tamaño de la matriz asociada que crea el adaptador al realizar operaciones que devuelven una matriz asociativa en la respuesta. El adaptador comunica el tamaño de la matriz para ODP.NET, que a su vez crea un búfer en función del tamaño de la matriz. El valor predeterminado es 32. Esta propiedad de enlace es útil al realizar operaciones que implican tipos de tabla PL/SQL. |
int (System.Int32) |
| MetadataPooling | Administración de búfer | ODP.NET propiedad. Especifica si ODP.NET almacena en caché la información de metadatos para las consultas ejecutadas. El valor predeterminado es true, lo que permite la agrupación de metadatos. El almacenamiento en caché de esta información mejora el rendimiento; Sin embargo, si se producen cambios en los artefactos de Oracle subyacentes en el sistema Oracle, estos metadatos agrupados no estarán sincronizados. Esto puede hacer que las operaciones realizadas en el sistema Oracle devuelvan excepciones inesperadas. Esta propiedad se usa para la optimización del rendimiento. | bool (System.Boolean) |
| StatementCachePurge | Administración de búfer | ODP.NET propiedad. Especifica si la memoria caché de instrucciones de ODP.NET asociada a una conexión se purga cuando se devuelve la conexión al grupo de conexiones. El valor predeterminado es false, lo que deshabilita la purga de la caché de instrucciones. Esta propiedad se usa para la optimización del rendimiento. | bool (System.Boolean) |
| StatementCacheSize | Administración de búfer | ODP.NET propiedad. Especifica el número máximo de instrucciones que cada ODP.NET conexión puede almacenar en caché. Al establecer esta propiedad en un valor distinto de cero, se habilita el almacenamiento en caché de instrucciones para las conexiones. El valor predeterminado es 10. Esta propiedad se usa para la optimización del rendimiento. | int (System.Int32) |
| OracleConnectionClientId | Depuración | Especifica un identificador de cliente (ID) para la conexión utilizada por el adaptador para conectarse a Oracle. Esto es útil si ha habilitado el seguimiento del lado servidor de Oracle y desea realizar un seguimiento selectivo de las operaciones de un identificador de cliente determinado. Esto también le permite filtrar y ver los seguimientos del servidor de Oracle en función de un identificador de cliente. | String |
| EnablePerformanceCounters | Diagnóstico | Especifica si se habilitan los contadores de rendimiento del SDK del adaptador de LOB de WCF y el contador de rendimiento de latencia de LOB del adaptador de E-Business de Oracle. El valor predeterminado es False; Los contadores de rendimiento están deshabilitados. El contador de rendimiento de latencia de LOB mide el tiempo total empleado por el adaptador de Oracle E-Business para realizar llamadas a Oracle E-Business Suite. | bool (System.Boolean) |
| EnableSafeTyping | Metadatos | Habilita o deshabilita la escritura segura. El valor predeterminado es false; la escritura segura está deshabilitada. Esta característica controla cómo el adaptador muestra determinados tipos de datos de Oracle. Para obtener más información sobre la escritura segura, consulte Tipos de datos básicos de Oracle. | bool (System.Boolean) |
| UseSchemaInNameSpace | Metadatos | Especifica si el nombre del esquema (SCOTT, HR, etc.) se incluye en el espacio de nombres xml para las operaciones y sus tipos asociados en los artefactos de base de datos subyacentes. El valor predeterminado es True; el nombre del esquema se incluye en el espacio de nombres . La ventaja de no tener el nombre de esquema incluido en el espacio de nombres es que si hay una tabla con el mismo nombre (por ejemplo, EMP) en dos esquemas diferentes, se puede usar el mismo XML para realizar las operaciones SQL simples (Insertar, Actualizar, Eliminar, Seleccionar) en ambas tablas. Por ejemplo, si la propiedad UseSchemaInNamespace es true, el espacio de nombres para estas operaciones en SCOTT. La tabla EMP es http://schemas.microsoft.com/OracleEBS/Tables/SCOTT/EMP; si es false, el espacio de nombres es http://schemas.microsoft.com/OracleEBS/Tables/EMP.Importante: La acción del mensaje no se ve afectada por la propiedad de enlace UseSchemaInNamesapce ; siempre incluye el nombre del esquema. Importante: Se recomienda encarecidamente establecer esta propiedad de enlace en True al generar metadatos. Si establece esta propiedad en false, los nombres de esquema de Oracle (por ejemplo, SCOTT) no estarán disponibles en el espacio de nombres XML del esquema generado. Por lo tanto, si hay dos tablas con el mismo nombre en dos esquemas de Oracle diferentes y se agregan al mismo proyecto de BizTalk, el proyecto de BizTalk no podrá compilar e implementar. Si desea incluir estos esquemas en el mismo proyecto de BizTalk, debe editarlos manualmente para incluir el nombre del esquema de Oracle en el espacio de nombres XML. |
bool (System.Boolean) |
| MlsSettings | Compatibilidad con varios idiomas | Una instancia de Oracle E-Business Suite puede tener varios paquetes de idioma instalados. Por lo tanto, si el adaptador recupera metadatos de una instancia de Oracle E-Business Suite que tiene compatibilidad con varios idiomas (MLS), el adaptador debe presentar información con la misma configuración de idioma que el usuario que ha iniciado sesión prefiere. La propiedad de enlace MlsSettings permite a los clientes de adaptador especificar las opciones específicas de MLS. Esta propiedad de enlace se puede especificar en tiempo de diseño y en tiempo de ejecución. La propiedad de enlace MlsSettings es una propiedad de enlace compleja que, a su vez, contiene más propiedades de enlace. Todas estas propiedades de enlace son opcionales. El adaptador usa las propiedades de enlace de la siguiente manera para establecer el contexto de MLS: - Para las propiedades de enlace que tienen valores especificados, el adaptador usa esos valores para establecer el contexto de MLS. - Para las propiedades de enlace que no tienen valores especificados, el adaptador usa la configuración de MLS para el cliente de ODP.NET en el mismo equipo donde está instalado el adaptador. En la tabla siguiente se enumeran las propiedades de enlace que forman parte de la propiedad de enlace MlsSettings . Todas estas propiedades son opcionales. Calendario: especifica el sistema de calendario. Esta propiedad de enlace se asigna al valor de NLS_CALENDAR en el cliente de ODP.NET. Comparación: especifica un método de comparación para las cláusulas WHERE y la comparación en bloques PL/SQL. Esta propiedad de enlace se asigna al valor de NLS_COMP en el cliente de ODP.NET. Moneda: especifica la cadena que se va a usar como símbolo de moneda local para el elemento de formato de número L. Para obtener información sobre los distintos elementos de formato numérico y modelos de formato en Oracle, vea https://go.microsoft.com/fwlink/?LinkId=135807. Esta propiedad de enlace se asigna a la configuración de NLS_CURRENCY en el cliente de ODP.NET. DateFormat:Especifica el formato en el que se presenta la fecha. Esta propiedad de enlace se asigna al valor de NLS_DATE_FORMAT en el cliente de ODP.NET. DateLanguage: especifica el idioma de los nombres de día y mes. Esta propiedad de enlace se asigna a la configuración de NLS_DATE_LANGUAGE en el cliente ODP.NET DualCurrency: especifica el símbolo de moneda dual, como Euro, para el elemento de formato de número U. Para obtener información sobre los distintos elementos de formato numérico y los modelos de formato en Oracle, vea https://go.microsoft.com/fwlink/?LinkId=135807. Esta propiedad de enlace se asigna al valor de NLS_DUAL_CURRENCY en el cliente ODP.NET. ISOCurrency:Especifica la cadena que se va a usar como símbolo de moneda internacional para el elemento de formato de número C. Para obtener información sobre los distintos elementos de formato numérico y los modelos de formato en Oracle, vea https://go.microsoft.com/fwlink/?LinkId=135807. Esta propiedad de enlace se asigna al valor de NLS_ISO_CURRENCY en el cliente ODP.NET. Idioma: especifica el idioma que se va a establecer como parte del contexto de MLS. Esta propiedad de enlace se asigna al valor de NLS_LANGUAGE en el cliente de ODP.NET. Importante: El valor de la propiedad de enlace OracleEBSResponsibilityName debe especificarse en el mismo idioma que se especificó para la propiedad de enlace Language . Por ejemplo, si establece la propiedad Enlace de idioma en español, el nombre de responsabilidad que especifique para la propiedad de enlace OracleEBSResponsibilityName también debe estar en español. LengthSemantics: habilita la creación de columnas CHAR y VARCHAR2 mediante la semántica de longitud de bytes o caracteres (valor predeterminado). Esta propiedad de enlace se asigna al valor de NLS_LENGTH_SEMANTICS en el cliente ODP.NET. NCharConversionException: especifica si la pérdida de datos durante una conversión implícita o explícita de tipos de caracteres notifica un error o no. El valor predeterminado es True. Esta propiedad de enlace se asigna al valor de NLS_NCHAR_CONV_EXCP en el cliente ODP.NET. NumericCharacters: especifica el carácter decimal y el separador de grupo. Esta propiedad de enlace se asigna al valor de NLS_NUMERIC_CHARACTERS del cliente ODP.NET. Ordenar: especifica el tipo de ordenación para los datos de caracteres. Esta propiedad de enlace se asigna al valor de NLS_SORT en el cliente ODP.NET. Territory: especifica las convenciones de fecha y formato numérico para un territorio. Esta propiedad de enlace se asigna al valor de NLS_TERRITORY en el cliente de ODP.NET. TimeStampFormat: especifica el formato de cadena para los tipos de datos TimeStamp. Esta propiedad de enlace se asigna al valor de NLS_TIMESTAMP_FORMAT en el cliente ODP.NET. TimeStampTZFormat: especifica el formato de cadena para los tipos de datos TimeStampTZ. Esta propiedad de enlace se asigna al valor de NLS_TIMESTAMP_TZ_FORMAT en el cliente ODP.NET. TimeZone: especifica el nombre de la región de zona horaria. Esta propiedad de enlace se asigna al valor de TIME_ZONE en el cliente ODP.NET. |
enum |
| NotificationPort | Notificación | Especifica el número de puerto que ODP.NET debe abrir para escuchar la notificación de cambio de base de datos de Oracle. El valor predeterminado es -1, lo que significa que ODP.NET usa un número de puerto válido, aleatorio y sin usar. Importante: Los clientes del adaptador no recibirán notificaciones de cambio de base de datos si firewall de Windows está activado. Además, no es aconsejable desactivar firewall de Windows para recibir notificaciones. Por lo tanto, para recibir notificaciones sin poner en peligro la seguridad de los equipos del lado cliente, se recomienda especificar un valor entero positivo como un número de puerto y, a continuación, agregar ese número de puerto a la lista de excepciones del Firewall de Windows. Si establece esta propiedad de enlace en el valor predeterminado de -1, ODP.NET usa un puerto aleatorio y los clientes del adaptador no sabrán qué puerto agregar a la lista de excepciones del Firewall de Windows. Para obtener instrucciones sobre cómo agregar puertos a la lista de excepciones del Firewall de Windows, consulte https://go.microsoft.com/fwlink/?LinkID=196959. Precaución: Si hay más de una aplicación en un dominio de aplicación que recibe notificaciones mediante el adaptador de Oracle E-Business, la propiedad de enlace NotificationPort para todas las aplicaciones debe establecerse en el mismo número de puerto. Esto se debe a que ODP.NET crea solo un agente de escucha que escucha en un puerto dentro de un dominio de aplicación. |
int (System.Int32) |
| NotificationStatement | Notificación | Especifica la instrucción SELECT que se usa para registrarse para obtener notificaciones de la base de datos de Oracle. Una instrucción SELECT de ejemplo podría ser similar a la siguiente.SELECT TID,ACCOUNT,PROCESSED FROM SCOTT.ACCOUNTACTIVITY WHERE PROCESSED = ‘n’Nota: Debe especificar el nombre del objeto de base de datos junto con el nombre del esquema. Por ejemplo, SCOTT.ACCOUNTACTIVITY.El adaptador obtiene un mensaje de notificación de la base de datos de Oracle solo cuando cambia el conjunto de resultados de la instrucción SELECT especificada. |
string |
| NotifyOnListenerStart | Notificación | Especifica si el adaptador envía un mensaje de notificación a los clientes del adaptador, informando de que la ubicación de recepción se está ejecutando cuando se inicia el agente de escucha. El valor predeterminado es true. | bool (System.Boolean) |
| ConnectionLifetime | Grupo de conexiones de Oracle | ODP.NET propiedad. Especifica la duración máxima en segundos de una conexión. El valor predeterminado es 0. Esta propiedad se usa para el ajuste del rendimiento. | int (System.Int32) |
| DecrPoolSize | Grupo de conexiones de Oracle | ODP.NET propiedad. Especifica el número de conexiones que se cierran cuando no se usa una cantidad excesiva de conexiones establecidas. El valor predeterminado es 1. Esto se usa para el ajuste del rendimiento. | int (System.Int32) |
| IncrPoolSize | Grupo de conexiones de Oracle | ODP.NET propiedad. Especifica el número de nuevas conexiones que se van a crear cuando se solicita una nueva conexión y no hay conexiones disponibles en el grupo de conexiones de ODP.NET. El valor predeterminado es 5. Esta propiedad se usa para el ajuste del rendimiento. | int (System.Int32) |
| MaxPoolSize | Grupo de conexiones de Oracle | ODP.NET propiedad. Especifica el número máximo de conexiones en un grupo de conexiones de ODP.NET. El valor predeterminado es 100. Esta propiedad se usa para el ajuste del rendimiento. Importante: Debe establecer MaxPoolSize con criterio. Es posible agotar el número de conexiones disponibles en ODP.NET, si este valor es demasiado grande. |
int (System.Int32) |
| MinPoolSize | Grupo de conexiones de Oracle | ODP.NET propiedad. Especifica el número mínimo de conexiones en un grupo de conexiones de ODP.NET. El valor predeterminado es 1. Esta propiedad se usa para el ajuste del rendimiento. | int (System.Int32) |
| UseOracleConnectionPool | Grupo de conexiones de Oracle | ODP.NET propiedad. Especifica si se va a usar el grupo de conexiones de ODP.NET. El valor predeterminado es true, lo que permite la agrupación de conexiones. El adaptador de Oracle E-Business implementa la agrupación de conexiones mediante el grupo de conexiones ODP.NET. | bool (System.Boolean) |
| ApplicationShortName | OracleEBS | Nombre corto de una aplicación de Oracle E-Business Suite. Debe proporcionar el nombre corto de la aplicación al establecer el contexto de la aplicación para determinadas API de PL/SQL y tablas o vistas de base de datos. Pero, ¿por qué es necesario establecer el contexto de la aplicación solo para determinadas API de PL/SQL y tablas o vistas de base de datos? - Las API de PL/SQL, tanto asociadas a la base de datos de Oracle como a las aplicaciones de Oracle E-Business Suite, también están disponibles en el nodo "Vista basada en artefactos" y la Schema-Based Vista" en tiempo de diseño mientras se usa el complemento de servicio Consumir adaptador o el complemento de referencia del servicio Agregar adaptador. Al ejecutar las API de PL/SQL asociadas a la base de datos de Oracle, no es necesario establecer esta propiedad de enlace. Sin embargo, al ejecutar una API de PL/SQL asociada a una aplicación oracle E-Business Suite, debe establecer el contexto de la aplicación especificando un valor válido para esta propiedad de enlace. - Para las aplicaciones personalizadas de Oracle E-Business Suite, los usuarios pueden o no registrar las tablas de base de datos como tablas de interfaz. Si una tabla de base de datos no está registrada como una tabla de interfaz, estará disponible en el nodo "Base de datos" en tiempo de diseño mientras se usa el complemento Consumir servicio adaptador o el complemento Agregar referencia del servicio adaptador. Sin embargo, dado que estas tablas están asociadas a una aplicación de Oracle E-Business, para cualquier operación de estas tablas, debe establecer el contexto de la aplicación. Por lo tanto, para realizar cualquier operación en una API PL/SQL, y tablas o vistas de base de datos que pertenezcan a Oracle E-Business Suite, siempre debe especificar el nombre corto de la aplicación. Importante: Al ejecutar una API de PL/SQL o realizar cualquier operación en tablas o vistas de base de datos asociadas a una aplicación de Oracle E-Business Suite, también debe: - Establezca la propiedad de enlace ClientCredentialType en EBusiness, - Establezca las propiedades de enlace OracleUserName, OraclePassword para especificar las credenciales para conectarse a Oracle E-Business Suite y - Establezca la propiedad de enlace OracleEBSResponsibilityName en el nombre de responsabilidad adecuado. Al establecer estas propiedades de enlace, se informa al adaptador de que la API PL/SQL, o la tabla o vista de base de datos, el funcionamiento está asociado a una aplicación de Oracle E-Business Suite y, por tanto, la propiedad de enlace ApplicationShortName pasa a ser obligatoria. Por el contrario, si está ejecutando una API PL/SQL, o cualquier operación en tablas o vistas de base de datos, asociada a una aplicación de Oracle E-Business Suite, y no establece las propiedades de enlace ClientCredentialType, OracleUserName, OraclePassword y OracleEBSResponsibilityName apropiadamente, el adaptador omite ApplicationShortName., incluso si se establece y supone que la API pl/SQL o la tabla de base de datos en la que está realizando operaciones pertenece a la base de datos de Oracle. |
string |
| OracleEBSOrganizationId | OracleEBS | Especifica el identificador de organización al que pertenece una aplicación de Oracle E-Business Suite. Esta propiedad es opcional y solo se considera cuando: - La propiedad de enlace ClientCredentialType se establece en EBusiness y - Las propiedades de enlace OracleUserName, OraclePassword y OracleEBSResponsibilityName se especifican correctamente. |
string |
| OracleEBSResponsibilityKey | OracleEBS | Clave de responsabilidad asociada al usuario de Oracle E-Business Suite. A diferencia del nombre de responsabilidad (propiedad de enlace OracleEBSResponsibilityName ), la clave de responsabilidad no depende del idioma especificado. Implica que no es necesario especificar claves de responsabilidad en distintos idiomas en función del valor especificado en la propiedad Enlace de idioma al establecer el contexto de MLS. Importante: : el valor especificado para la propiedad de enlace OracleEBSResponsibilityKey invalida el valor especificado para la propiedad de enlace OracleEBSResponsibilityName . - Si va a realizar operaciones en los datos en varios idiomas y no desea especificar un nombre de responsabilidad en cada idioma, debe especificar un valor para esta propiedad de enlace mientras realiza operaciones en tablas de interfaz, seleccionando valores de vistas de interfaz o ejecutando un programa o conjunto de solicitudes simultáneos. Por supuesto, siempre puede usar esta propiedad de enlace incluso si solo está trabajando con datos en el idioma inglés. |
string |
| OracleEBSResponsibilityName | OracleEBS | Nombre de la responsabilidad asociada al usuario de Oracle E-Business Suite. El nombre de responsabilidad depende del idioma especificado. Implica que si va a establecer el contexto de MLS especificando un valor para la propiedad de enlace Language , el valor de la propiedad de enlace OracleEBSResponsibilityName debe especificarse en el mismo idioma que se especificó para la propiedad de enlace Language . Por ejemplo, si establece la propiedad de enlace Language en español, el nombre de responsabilidad que especifique para la propiedad de enlace OracleEBSResponsibilityName también debe estar en español. Importante: Debe especificar un valor para esta propiedad de enlace mientras realiza operaciones en tablas de interfaz, seleccionando valores de vistas de interfaz o ejecutando un programa simultáneo. |
string |
| OraclePassword | OracleEBS | - Si la propiedad de enlace ClientCredentialType está establecida en Database, esta propiedad especifica la contraseña de un usuario de base de datos de Oracle. - Si la propiedad de enlace ClientCredentialType está establecida en EBusiness, esta propiedad especifica la contraseña de un usuario de Oracle E-Business Suite. El adaptador de Oracle E-Business no conserva el caso del valor especificado para la propiedad de enlace OraclePassword cuando se conecta a Oracle E-Business Suite. La contraseña se pasa a Oracle E-Business Suite mediante las reglas estándar de SQL*Plus. Sin embargo, si desea conservar el caso de la contraseña o si desea escribir una contraseña que contenga caracteres especiales, debe especificar el valor entre comillas dobles. Importante: - Al realizar operaciones en tablas de interfaz, seleccionar valores de vistas de interfaz, ejecutar un programa simultáneo o ejecutar una API PL/SQL asociada a una aplicación de Oracle E-Business Suite, debe establecer la propiedad de enlace ClientCredentialType en EBusiness y, a continuación, especificar una contraseña válida para conectarse a Oracle E-Business Suite. - La propiedad de enlace OraclePassword no está disponible en el archivo de enlace (archivo XML) ni en el archivo de app.config generado como resultado del uso del complemento de proyecto de BizTalk del servicio de adaptador de consumo o el complemento Agregar referencia del servicio adaptador de Visual Studio. |
string |
| OracleUserName | OracleEBS | - Si la propiedad de enlace ClientCredentialType está establecida en Database, esta propiedad especifica el nombre de usuario para la autenticación en la base de datos de Oracle. - Si la propiedad de enlace ClientCredentialType está establecida en EBusiness, esta propiedad especifica el nombre de usuario para la autenticación en Oracle E-Business Suite. El adaptador de Oracle E-Business no conserva el caso del valor especificado para la propiedad de enlace OracleUserName cuando se conecta a Oracle E-Business Suite. El nombre de usuario se pasa a Oracle E-Business Suite mediante las reglas estándar de SQL*Plus. Sin embargo, si desea conservar el caso del nombre de usuario o si desea escribir un nombre de usuario que contenga caracteres especiales, debe especificar el valor entre comillas dobles. Importante: Al realizar operaciones en tablas de interfaz, seleccionar valores de vistas de interfaz, ejecutar un programa simultáneo o ejecutar una API PL/SQL asociada a una aplicación oracle E-Business Suite, debe establecer la propiedad de enlace ClientCredentialType en EBusiness y, a continuación, especificar un nombre de usuario válido para conectarse a Oracle E-Business Suite. |
string |
| PolledDataAvailableStatement | Sondeo | Especifica la instrucción SELECT ejecutada para determinar si hay datos disponibles para el sondeo de una tabla específica. La instrucción especificada debe devolver un conjunto de resultados que consta de filas y columnas. El valor de la primera celda del conjunto de resultados indica si el adaptador ejecuta el valor especificado para la propiedad de enlace PollingInput . Si la primera celda del resultado contiene un valor positivo, el adaptador ejecuta la instrucción de sondeo. Por ejemplo, una instrucción válida para esta propiedad de enlace será:Select * from <table_name>Propina: Si desea que el adaptador siga sondeando independientemente de si la tabla que se sondea tiene datos, puede especificar el valor de esta propiedad de enlace como Select 1 FROM DUAL.Nota: No debe especificar procedimientos almacenados para esta propiedad de enlace. Además, esta instrucción no debe modificar la base de datos de Oracle subyacente. |
string |
| PollingAction | Sondeo | Especifica la acción de la operación de sondeo. Puede determinar la acción de sondeo de una operación específica a partir de los metadatos que genere para la operación mediante el complemento Consumir servicio de adaptador. | string |
| PollingInput | Sondeo | Especifica la instrucción de sondeo. Puede especificar una instrucción SELECT simple o un procedimiento almacenado para sondear. Si desea sondear una tabla o vista, debe especificar una instrucción SELECT para esta propiedad de enlace. Si desea sondear mediante un procedimiento almacenado, debe especificar todo el mensaje de solicitud para esta propiedad de enlace. El mensaje de solicitud debe ser el mismo que se envía al adaptador para invocar el procedimiento almacenado como una operación de salida. Nota: La instrucción SQL o el procedimiento almacenado especificado para esta propiedad de enlace solo se ejecuta si la instrucción ejecutada por la propiedad de enlace PolledDataAvailableStatement devuelve algunos datos. Importante: El adaptador de Oracle E-Business ejecuta la instrucción de sondeo y la instrucción posterior al sondeo (si se especifica) dentro de una transacción de Oracle. Si usa una instrucción SELECT en la propiedad de enlace PollingInput , se recomienda especificar una cláusula FOR UPDATE en la instrucción SELECT. Esto garantizará que los registros seleccionados estén bloqueados durante la transacción y que la instrucción posterior al sondeo pueda realizar las actualizaciones necesarias en los registros seleccionados. |
string |
| PollingInterval | Sondeo | Especifica el intervalo de sondeo transaccionado, es decir, el intervalo en segundos en el que el adaptador de Oracle E-Business ejecuta la instrucción especificada para la propiedad de enlace PollingInput en la base de datos de Oracle. El valor predeterminado es 30. El adaptador usa el intervalo de sondeo para lo siguiente: - Intervalo de tiempo entre sondeos sucesivos. Este intervalo se usa para ejecutar las consultas de sondeo y posteriores al sondeo. Si estas consultas se ejecutan dentro del intervalo especificado, el adaptador se suspende durante el tiempo restante en el intervalo. - Valor de tiempo de espera de la transacción de sondeo. Este valor debe establecerse lo suficientemente grande como para incluir el tiempo de ejecución de la instrucción de sondeo, el tiempo de ejecución de la instrucción posterior al sondeo (si se especifica) y el tiempo para recibir la respuesta de la aplicación cliente para confirmar la transacción. Si la aplicación cliente envía una respuesta antes de que expire el intervalo de sondeo, el adaptador confirma la transacción y espera hasta que se alcanza el intervalo de sondeo para ejecutar el siguiente sondeo. Si la aplicación cliente devuelve un error, el adaptador finaliza la transacción. Si el intervalo de sondeo expira antes de que la aplicación cliente envíe la respuesta, se agotará el tiempo de espera de la transacción. |
int (System.Int32) |
| PollWhileDataFound | Sondeo | Especifica si el adaptador de Oracle E-Business omite el intervalo de sondeo y sondea continuamente la base de datos de Oracle, si los datos están disponibles en la tabla que se está sondeando. Si no hay datos disponibles en la tabla, el adaptador revierte para ejecutar la instrucción SQL en el intervalo de sondeo especificado. El valor predeterminado es false. Considere un escenario en el que el intervalo de sondeo se establece en 60 segundos y la instrucción especificada para PolledDataAvailableStatement devuelve que los datos están disponibles para el sondeo. A continuación, el adaptador ejecuta la instrucción especificada para la propiedad de enlace PollingInput . Suponiendo que el adaptador tarda solo 10 segundos en ejecutar la instrucción, ahora tendrá que esperar 50 segundos antes de volver a ejecutar PolledDataAvailableStatement y, después, ejecutar la instrucción de sondeo. En su lugar, para optimizar el rendimiento, puede establecer la propiedad de enlace PollWhileDataFound en true para que el adaptador pueda empezar a ejecutar el siguiente ciclo de sondeo tan pronto como finalice el ciclo de sondeo anterior. Nota: Esta propiedad de enlace es aplicable tanto para el sondeo en tablas como en vistas y sondeo mediante el procedimiento almacenado. |
string |
| PostPollStatement | Sondeo | Especifica un bloque de instrucciones que se ejecuta después de que se ejecute la instrucción especificada por la propiedad de enlace PollingInput . El valor predeterminado es null; no se ejecuta ninguna instrucción posterior al sondeo. La instrucción posterior al sondeo se ejecuta dentro de la transacción de sondeo. Dos usos comunes para la instrucción posterior al sondeo son: - Actualice una columna de las filas devueltas en la instrucción de sondeo para indicar que se han procesado y deben excluirse de las consultas de sondeo posteriores. - Mover registros procesados a una tabla diferente. Importante: Si se especifica una instrucción posterior al sondeo, PollingInterval debe establecerse lo suficientemente grande como para que se complete la instrucción posterior al sondeo antes de que expire el intervalo. Para obtener más información sobre cómo usar las propiedades de enlace en un escenario de sondeo, consulte Información general sobre las notificaciones de cambio de datos basadas en sondeo. |
string |
| SkipNilNodes | Comportamiento en tiempo de ejecución | Especifica si el adaptador de Oracle E-Business omitirá la inserción o actualización de valores para los nodos marcados como "nulos" en el XML de solicitud. Esta propiedad de enlace es aplicable para insertar o actualizar registros en una tabla y para los parámetros de tipo RECORD en los procedimientos almacenados. El valor predeterminado es true, lo que significa que el adaptador omitirá el paso de valores para los nodos marcados como "nil". En este caso, el valor predeterminado de Oracle (si se especifica) se tiene en cuenta para los nodos marcados como "nil". Si se establece en false, el adaptador pasa explícitamente un valor NULL para estos nodos. Nota: - Para los nodos que no están presentes en el XML de solicitud, el adaptador siempre omite pasar valores, independientemente del valor de la propiedad de enlace SkipNilNodes . - Para las tablas PL/SQL de RECORDS, el adaptador siempre pasa un valor NULL para los nodos marcados como "nulos" o no presentes en el XML de solicitud, independientemente del valor de la propiedad de enlace SkipNilNodes . En el ejemplo siguiente se explica la diferencia en la configuración del adaptador en función del valor establecido para esta propiedad de enlace. Supongamos que un XML de solicitud es similar al siguiente: <EMPNO>1000</EMPNO> <ENAME>John</ENAME> <SAL nil=’true’></SAL>Si SkipNilNodes se establece en true, el adaptador ejecuta el siguiente comando: INSERT INTO EMP (EMPNO, ENAME) VALUES (1000, “John”);Si SkipNilNodes se establece en false, el adaptador ejecuta la consulta siguiente: INSERT INTO EMP (EMPNO, ENAME, SAL) VALUES (1000, “John”, null);Tenga en cuenta que, en la segunda instrucción, el adaptador inserta explícitamente un valor NULL para el parámetro "SAL". |
bool (System.Boolean) |
| GeneratedUserTypesAssemblyFilePath | Generación de tipos de .NET UDT: tiempo de diseño | Especifica el nombre y la ruta de acceso del archivo DLL que genera el adaptador, al generar metadatos, que contienen todos los UDT que se usan en los metadatos. Debe especificar un nombre DLL si está generando metadatos para paquetes, procedimientos almacenados o funciones que usan UDT. Especificar el nombre dll es opcional para las tablas y vistas que tienen UDT. El archivo DLL generado se guarda en la misma ubicación que el ejecutable. Esta propiedad de enlace solo es necesaria al generar metadatos. Nota: - Solo debe especificar un nombre de archivo. Para todos los UDT de los metadatos, el adaptador genera un único archivo con el nombre especificado. Si no especifica un nombre, el adaptador genera el archivo DLL con un nombre GUID. - Esta propiedad de enlace no está disponible en BizTalk Server al configurar un puerto de recepción o envío de WCF-OracleEBS. |
string |
| GeneratedUserTypesAssemblyKeyFilePath | Generación de tipos de .NET UDT: tiempo de diseño | Especifica el nombre y la ruta de acceso del archivo de clave que usa el adaptador para crear un ensamblado fuertemente tipado. Esta propiedad de enlace es opcional y solo es necesaria al generar metadatos. Nota: Esta propiedad de enlace no está disponible en BizTalk Server al configurar un puerto de recepción o envío de WCF-OracleEBS. |
string |
| UserAssembliesLoadPath | Generación de tipos de .NET UDT: tiempo de ejecución | Especifica el nombre de los archivos DLL, separados por un punto y coma, que el adaptador crea al generar metadatos. Estos archivos DLL se guardan en la ubicación especificada para la propiedad de enlace GeneratedUserTypesAssemblyFilePath al generar metadatos. Debe copiar manualmente estos archivos DLL en las siguientes ubicaciones: - Para proyectos de BizTalk: copie los archivos DLL en la misma ubicación que BTSNTSvc.exe. Para BizTalk Server, esto está disponible normalmente en <unidad> de instalación:\Archivos de programa\Microsoft BizTalk Server. - Para proyectos de .NET: copie los archivos DLL en la carpeta \bin\Development dentro de la carpeta del proyecto de .NET. Esta propiedad de enlace solo es necesaria al enviar y recibir mensajes para realizar operaciones en Oracle E-Business Suite. |
string |
| AcceptCredentialsInUri | No aparece en el complemento Consumir servicio de adaptador ni en el complemento Agregar referencia de servicio de adaptador. | Especifica si el URI de conexión de Oracle E-Business Suite puede contener credenciales de usuario. El valor predeterminado es false, que deshabilita las credenciales de usuario en el URI de conexión. Si AcceptCredentialsInUri es false y el URI de conexión de Oracle contiene credenciales de usuario, el adaptador de Oracle E-Business produce una excepción. Puede establecer AcceptCredentialsInUri en true si debe especificar las credenciales en el URI. Para más información, consulte Creación del URI de conexión de Oracle E-Business Suite. | bool (System.Boolean) |
¿Cómo se establecen las propiedades de enlace?
Puede establecer las propiedades de enlace al especificar una conexión a Oracle E-Business Suite. Para obtener información sobre cómo establecer propiedades de enlace cuando:
Use el complemento Consumir el servicio adaptador de BizTalk Project o el complemento Agregar referencia de servicio de adaptador de Visual Studio, vea escribir la descripción del vínculo aquí.
Configure un puerto de envío o un puerto de recepción (ubicación) en una solución de BizTalk Server, consulte Configuración manual de un enlace de puerto físico al adaptador de E-Business de Oracle.
Use el modelo de canal WCF en una solución de programación. Consulte Conexión a Oracle E-Business Suite en Visual Studio.
Use el modelo de servicio WCF en una solución de programación. Consulte Conexión a Oracle E-Business Suite en Visual Studio.
Importante
Al usar el Complemento de proyecto de BizTalk del servicio consumir adaptador o el complemento Agregar referencia del servicio adaptador de Visual Studio, si no especifica un valor para una propiedad de enlace de tipo cadena y cuyo valor predeterminado es NULL, esa propiedad de enlace no estará disponible en el archivo de enlace (un archivo XML) o el archivo app.config respectivamente. Debe agregar manualmente la propiedad de enlace y su valor en el archivo de enlace o en el archivo de app.config, si es necesario.
Sin embargo, la propiedad de enlace OraclePassword no está disponible en el archivo de enlace o en el archivo de app.config incluso si especifica un valor para esta propiedad de enlace mientras se usa el Complemento de proyecto consumir servicio adaptador de BizTalk o el complemento Agregar referencia de servicio de adaptador de Visual Studio Complemento de Visual Studio.