Imprimir      Abrir versión PDF de ayuda en línea


Tema anterior

Tema siguiente

JoinFieldValue

Se puede hacer referencia a un tipo de registro mediante otro tipo de registro a través de una clave foránea. Un campo combinado es un campo en un tipo de registro que utiliza una clave foránea para hacer referencia a un campo de otro tipo de registro. Por ejemplo, en la mayoría de los tipos de registro, el campo OwnerId es una clave foránea que hace referencia al tipo de registro Usuario. El campo Propietario en muchos registros es un campo combinado que utiliza la clave foránea OwnerId para hacer referencia al campo Alias en el tipo de registro Usuario.

La función JoinFieldValue del Expression Builder devuelve el valor de un campo combinado cuando el tipo de registro al que se hace referencia y los campos de claves foráneas relacionados se especifican en la función. La función JoinFieldValue también puede recuperar otros campos en el tipo de registro al que se hace referencia que no están directamente unidos al objeto de referencia, lo que permite buscar campos en tipos de registro de tipos de registro relacionados.

Si el campo ID de un tipo de registro al que se hace referencia está presente como clave foránea en el tipo de registro en el que configura una regla de flujo de trabajo, puede utilizar la función JoinFieldValue para recuperar los valores de campo del tipo de registro al que se hace referencia.

También puede utilizar los siguientes campos de clave foránea, que están disponibles en todos los tipos de registros, para recuperar los valores de campo del tipo de registro de usuario:

  • CreatedById
  • ModifiedById

NOTA: La función JoinFieldValue no puede devolver los valores de los siguientes campos en el tipo de registro Actividad: Recuento de transacciones de desembolso, Recuento de productos detallados, Recuento de ítems promocionales distribuidos y Recuento de muestras distribuidas. Esta limitación se debe a la forma en que Oracle CRM On Demand calcula los valores de estos campos.

Sintaxis

JoinFieldValue (ref_record_type, foreign_key, field_name)

Tipo de resultado

Cadena.

Si se produce un error o el valor del campo solicitado está vacío, se devuelve una cadena de longitud cero.

Argumentos

En la tabla siguiente se describen los argumentos de esta función.

Argumento

Descripción

ref_record_type

Nombre independiente del idioma del tipo de registro al que se hace referencia. (Un nombre independiente del idioma es un nombre que no cambia aunque cambie el idioma del usuario).

El argumento debe aparecer entre identificadores de cadena de campo. Por ejemplo:

'<Account>'

foreign_key

Literal o expresión que devuelve un ID de fila en el tipo de registro al que se hace referencia (especificado en el argumento ref_record_type). Si el ID de fila no es válido, la función devuelve una cadena de longitud cero. Las referencias de campo directas deben aparecer entre identificadores de campo. Por ejemplo:

[<AccountId>]

field_name

Nombre independiente del idioma de un campo del tipo de registro al que hace referencia (especificado por el argumento ref_record_type). Si el campo no existe en el tipo de registro al que se hace referencia, se devuelve un error. El nombre de campo debe aparecer entre identificadores de cadena de campo. Por ejemplo:

'<Type>'

NOTA: Los nombres de campo independientes del idioma y la sintaxis de nombre de campo que se utilizan en las expresiones de ejemplo de este tema son los que se utilizaban en las versiones de Expression Builder anteriores a la versión 29 Service Pack 1. Estos ejemplos siguen siendo válidos. Sin embargo, si selecciona los campos correspondientes para una expresión en la lista Campos de Expression Builder, en la versión 29 Service Pack1 o posterior, los nombres de campo y la sintaxis de los nombres de campo serán diferentes de los indicados en los ejemplos. Se recomienda seleccionar siempre los campos para las expresiones de la lista Campos de Expression Builder para que los nombres de campo y la sintaxis de los nombres de campo sean siempre correctos. Para obtener más información sobre los nombres de campo y la sintaxis de nombre de campo en las expresiones, consulte Acerca de las expresiones.

Ejemplos

Ejemplo 1: Un proceso de negocio necesita una regla de flujo de trabajo para buscar el nombre del nuevo propietario cuando se cambia el propietario de un registro. Al cambiar el propietario de un registro, sólo se actualiza el campo de clave foránea OwnerId en el registro. Como consecuencia, la siguiente condición de una regla de flujo de trabajo no busca el nuevo propietario del registro:

PRE('<Owner>') <> [<Owner>]

En lugar de ésta, puede utilizar la siguiente condición en el flujo de trabajo para buscar el nuevo propietario del registro:

PRE('<Owner>') <> JoinFieldValue('<User>',[<OwnerId>],'<Alias>')

Ejemplo 2: Para obtener la dirección de correo electrónico del propietario anterior de un registro, utilice la siguiente expresión:

JoinFieldValue('<User>',PRE('<OwnerId>'),'<EMailAddr>')

Ejemplo 3: Para obtener la dirección de correo electrónico del propietario actual de un registro, utilice la siguiente expresión:

JoinFieldValue('<User>',[<OwnerId>],'<EMailAddr>')

Ejemplo 4: Un proceso de negocio necesita que se envíe un correo electrónico de solicitud de servicio a un contacto. Antes de que se envíe el correo electrónico, la regla de flujo de trabajo comprueba que el contacto ha aceptado recibir correos electrónicos. La regla de flujo de trabajo (basada en el tipo de registro de solicitud de servicio) tiene la siguiente condición:

JoinFieldValue('<Contact>',[<ContactId>],'<NeverEmail>')<> 'Y'

Ejemplo 5: Para obtener el territorio de la cuenta principal de una solicitud de servicio, utilice la siguiente expresión:

JoinFieldValue('<Territory>', JoinFieldValue('<Account>', [<AccountId>], '<TerritoryId>'),'<TerritoryName>')

Temas relacionados

Consulte los siguientes temas para obtener información relacionada con Expression Builder:


Publicado en septiembre 2017 Copyright © 2005, 2017, Oracle. Todos los derechos reservados. Legal Notices.