Imprimir      Abrir a versão em PDF da Ajuda on-line


Tópico anterior

Próximo tópico

JoinFieldValue

Um tipo de registro pode ser mencionado por outro tipo de registro em uma chave de previsão. Um campo conjunto é um campo em um tipo de registro que usa uma chave de previsão para mencionar um campo de outro tipo de registro. Por exemplo, na maioria dos tipos de registro, o campo OwnerId é uma chave de previsão que menciona o tipo de registro do Usuário. O campo Proprietário de muitos registros é um campo conjunto que usa a chave de previsão OwnerId para mencionar o campo Apelido no tipo de registro do Usuário.

A função JoinFieldValue do Expression Builder retorna o valor de um campo conjunto quando o tipo de registro mencionado e os campos da chave de previsão relacionados são especificados na função. A função JoinFieldValue também pode recuperar outros campos no tipo de registro mencionado, que não estão diretamente unidos ao objeto de referência, que permite pesquisar campos pelos tipos de registro dos tipos de registros relacionados.

Se o campo ID de um tipo de registro referenciado estiver presente como uma chave estrangeira no tipo de registro em que você configura uma regra de workflow, você poderá usar a função JoinFieldValue para recuperar valores de campo no tipo de registro referenciado.

Além disso, você pode usar os seguintes campos de chave estrangeira, que estão disponíveis em todos os tipos de registro, a fim de recuperar os valores de campo no tipo de registro Usuário:

  • CreatedById
  • ModifiedById

OBSERVAÇÃO: A função JoinFieldValue não pode retornar os valores dos seguintes campos no tipo de registro atividade: Contagem de Transações de Desembolso, Contagem Detalhada do Produto, Contagem de Itens Promocionais Entregues, Contagem de Amostras Entregues. Esta limitação é decorrente da forma como o Oracle CRM On Demand calcula os valores desses campos.

Sintaxe

JoinFieldValue (ref_record_type, foreign_key, field_name)

Tipo de resultado

String.

Se ocorrer um erro ou o valor do campo solicitado estiver vazio, é retornada uma string com comprimento zero.

Argumentos

A tabela a seguir descreve os argumentos da função.

Argumento

Descrição

ref_record_type

O nome independente de idioma do tipo de registro mencionado. (Um nome independente de idioma é um nome que não muda quando o idioma do usuário é alterado.)

O argumento deve ser delimitado por identificadores da string de campo. Por exemplo:

'<Account>'

foreign_key

Uma literal ou expressão que retorna um ID da linha válido no tipo de registro mencionado (especificado no argumento ref_record_type). Se o ID da linha for inválido, a função retorna uma string com comprimento zero. As referências de campo direto devem ser delimitadas por identificadores de campo. Por exemplo:

[<AccountId>]

field_name

O nome independente de idioma de um campo no tipo de registro mencionado (especificado pelo argumento ref_record_type). Se não existir o campo no tipo de registro mencionado, é retornado um erro. O nome do campo deve ser delimitado por identificadores da string de campo. Por exemplo:

'<Type>'

OBSERVAÇÃO: os nomes de campos independentes de idioma e a sintaxe de nome de campo usada em qualquer expressão de exemplo neste tópico são os nomes de campo e a sintaxe do nome de campo que foram usados no Expression Builder nas versões anteriores à Versão 29 do Service Pack 1. Esses exemplos ainda são válidos. No entanto, se você selecionar os campos correspondentes de uma expressão na lista de Campos no Expression Builder na Versão 29 do Service Pack 1 ou posterior, os nome de campos e a sintaxe dos nomes de campos serão diferentes daquelas mostradas nos exemplos. É recomendado que você sempre selecione os campos das suas expressões na lista de Campos no Expression Builder para que os nomes de campos e a sintaxe dos nomes de campos estejam sempre corretas. Para obter mais informações sobre os nomes de campos e a sintaxe nos nomes de campos nas expressões, consulte Sobre expressões.

Exemplos

Exemplo 1: um processo de negócios necessita que uma regra de workflow pesquise o nome do novo proprietário quando o proprietário de um registro é alterado. Quando o proprietário de um registro é alterado, apenas o campo da chave de previsão OwnerId do registro é atualizado. Como resultado, a condição a seguir em uma regra de workflow não pesquisa o novo proprietário do registro:

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

Em vez disso, você pode usar a condição a seguir no workflow para pesquisar o novo proprietário do registro:

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

Exemplo 2: para obter o endereço de e-mail do proprietário anterior de um registro, use a expressão a seguir:

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

Exemplo 3: para obter o endereço de e-mail do atual proprietário de um registro, use a expressão a seguir:

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

Exemplo 4: um processo de negócios necessita que um e-mail de solicitação de serviço seja enviado a um contato. Antes que o e-mail seja enviado, a regra de workflow verifica se o contato está de acordo com os e-mails recebidos. A regra de workflow (com base no tipo de registro da solicitação de serviço) tem a seguinte condição:

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

Exemplo 5: para obter o território da conta principal para uma solicitação de serviço, use a seguinte expressão:

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

Tópicos relacionados

Consulte os seguintes tópicos para obter informações relacionadas ao Expression Builder:


Publicado em Otubro de 2016 Copyright © 2005, 2016, Oracle. Todos os direitos reservados. Legal Notices.