Afdrukken      PDF-versie openen van online-help


Vorig onderwerp

Volgend onderwerp

JoinFieldValue

Er kan via een externe sleutel naar een recordtype worden verwezen door een ander recordtype. Een samengevoegd veld is een veld van een recordtype waarin een externe sleutel wordt gebruikt om naar een veld van een ander recordtype te verwijzen. Bijvoorbeeld: in de meeste recordtypen is het veld 'Eigenaar-ID' een externe sleutel die verwijst naar het recordtype 'Gebruiker'. Het veld 'Eigenaar' van veel records is een samengevoegd veld waarin de externe sleutel 'Eigenaar-ID' wordt gebruikt om te verwijzen naar het veld 'Alias' van het recordtype 'Gebruiker'.

De functie 'JoinFieldValue' in Expression Builder retourneert de waarde van een samengevoegd veld wanneer het recordtype en de verwante externe sleutelvelden in de functie zijn opgegeven. De functie 'JoinFieldValue' kan ook andere velden van het recordtype ophalen die niet rechtstreeks zijn gekoppeld aan het object waarnaar wordt verwezen. Zo kunt u naar velden in recordtypen zoeken vanuit verwante recordtypen.

Als het veld 'ID' voor een type record met verwijzing beschikbaar is als een externe sleutel voor het type record waarvoor u een workflowregel configureert, kunt u de functie JoinFieldValue gebruiken om veldwaarden op te halen uit het type record waarnaar wordt verwezen.

U kunt ook de volgende velden met externe sleutels gebruiken (beschikbaar voor alle recordtypen) om veldwaarden op te halen uit het type record 'Gebruiker':

  • CreatedById
  • ModifiedById

OPMERKING: met de functie JoinFieldValue kunnen geen waarden worden geretourneerd voor de volgende velden in het type record 'Activiteit': 'Aantal uitbetalingstransacties', 'Gedetailleerde producttelling', 'Aantal afgeleverde promotie-artikelen' en 'Aantal afgeleverde monsters'. Deze beperking komt voort uit de manier waarop de waarden van deze velden in Oracle CRM On Demand worden berekend.

Syntaxis

JoinFieldValue (ref_record_type, foreign_key, field_name)

Resultaattype

Tekenreeks.

Als er zich een fout voordoet of als de aangevraagde veldwaarde leeg is, wordt er een tekenreeks met lengte nul geretourneerd.

Argumenten

In de volgende tabel vindt u een omschrijving van de argumenten voor de functie.

Argument

Omschrijving

ref_record_type

De taalonafhankelijk naam van het recordtype waarnaar wordt verwezen. (Een taalonafhankelijke naam is een naam die niet wijzigt wanneer de taal van de gebruiker wordt gewijzigd.)

Het argument moet tussen haakjes worden geplaatst. Bijvoorbeeld:

'<Account>'

foreign_key

Een letterlijke waarde of een expressie die een geldige rij-ID in het recordtype waarnaar wordt verwezen (opgegeven in het argument 'ref_record_type') retourneert. Als de rij-ID niet geldig is, retourneert de functie een tekenreeks met lengte nul. Rechtstreekse verwijzingen naar een veld moeten tussen haakjes worden geplaatst. Bijvoorbeeld:

[<AccountId>]

field_name

De taalonafhankelijke naam van een veld in het recordtype waarnaar wordt verwezen (opgegeven via het argument 'ref_record_type'). Als het veld niet bestaat in het recordtype waarnaar wordt verwezen, wordt er een fout geretourneerd. De veldnaam moet tussen haakjes worden geplaatst. Bijvoorbeeld:

'<Type>'

OPMERKING: de taalonafhankelijke veldnamen en de syntaxis van de veldnamen die worden gebruikt in voorbeeldexpressies in dit onderwerp, zijn veldnamen en syntaxis van veldnamen die werden gebruikt in Expression Builder in versies vóór Versie 29 Service Pack 1. Deze voorbeelden zijn nog steeds geldig. Als u echter de overeenkomende velden selecteert voor een expressie uit de lijst met velden in Expression Builder in Versie 29 Service Pack 1 of later, zijn de veldnamen en de syntaxis van de veldnamen anders dan die uit de voorbeelden. U wordt aangeraden altijd de velden te selecteren voor uw expressies uit de lijst met velden in Expression Builder zodat de veldnamen en de syntaxis van de veldnamen altijd correct zijn. Zie Expressies voor meer informatie over de veldnamen en de syntaxis van de veldnamen in expressies.

Voorbeelden

Voorbeeld 1: voor een bedrijfsproces is een workflowregel nodig om de naam van de nieuwe eigenaar op te zoeken wanneer de eigenaar van een record wijzigt. Wanneer de eigenaar van een record wordt gewijzigd, wordt alleen het externe sleutelveld 'Eigenaar-ID' bijgewerkt. Als gevolg hiervan zoekt de conditie van een workflowregel niet naar de nieuwe eigenaar van de record:

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

In plaats daarvan kunt u de volgende conditie in de workflow gebruiken om de nieuwe eigenaar van de record op te zoeken:

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

Voorbeeld 2: gebruik de volgende expressie om het e-mailadres van de vorige eigenaar van een record op te halen:

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

Voorbeeld 3: gebruik de volgende expressie om het e-mailadres van de huidige eigenaar van een record op te halen:

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

Voorbeeld 4: voor een bedrijfsproces wordt vereist dat er een e-mailbericht met een serviceaanvraag naar een relatie wordt verzonden. Voordat het e-mailbericht wordt verzonden, controleert de workflowregel of de relatie akkoord is gegaan met het ontvangen van e-mailberichten. De workflowregel (gebaseerd op het recordtype 'Serviceaanvraag') heeft de volgende voorwaarde:

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

Voorbeeld 5: gebruik de volgende expressie om het rayon van de primaire account voor een serviceaanvraag op te halen:

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

Verwante onderwerpen

Zie de volgende onderwerpen voor meer informatie over Expression Builder:


Gepubliceerd op oktober 2016 Copyright © 2005, 2016, Oracle. Alle rechten voorbehouden. Legal Notices.