a!urlForRecord( recordType, targetLocation, identifier, view )
Returns the URL for one or more records in a site page or Tempo. Can also return the URL for a record list in Tempo.
See also:
Keyword | Type | Description |
---|---|---|
|
RecordType |
A reference to a record type. Reference the record type using the recordType! domain or a constant that points to a record type. |
|
Any Type |
The location where the record should open, which can be either a site page or Tempo. To reference a site page, use the following structure: |
|
Text |
One or more record identifiers. This is typically the primary key field. If the target location is a site page, at least one identifier is required. If the target location is "TEMPO" and no identifier is provided, the URL for the record list will be returned. |
|
text |
The URL stub of the record view to open for the record. Default is "summary". |
Text Array
These examples are designed to illustrate how to use the a!urlForRecord()
function in the Expression Rule Interface.
Record type and site object references are specific to each environment. If you copy and paste these examples into the Expression Rule interface, they will not evaluate in your Test Rules interface. Use them as a reference only.
1
2
3
4
5
a!urlForRecord(
recordType: recordType!Cases,
identifier: 1,
targetLocation: site!caseManagemt.cases
)
Returns
1
"https://home.appiancloud.com/suite/sites/case-management/page/cases/records/item/lIBBmtkdu05df/view/summary"
If the page is in a page group, the url includes the page group.
1
"https://home.appiancloud.com/suite/sites/case-management/group/cases/page/openCases/records/item/lIBBmtkdu05df/view/summary"
1
2
3
4
5
a!urlForRecord(
recordType: recordType!Cases,
identifier: {1,2},
targetLocation: site!caseManagemt.openCases
)
Returns
1
2
3
4
{
"https://home.appiancloud.com/suite/sites/case-management/page/openCases/records/item/lIBBmtkdu05df/view/summary",
"https://home.appiancloud.com/suite/sites/case-management/page/openCases/records/item/lIBBmtkdu05df/view/summary"
}
1
2
3
4
5
a!urlForRecord(
recordType: recordType!Cases,
identifier: 1,
targetLocation: "TEMPO"
)
Returns
1
"https://home.appiancloud.com/suite/tempo/records/item/lIBBmtkdu05df/view/summary"
1
2
3
4
5
6
a!urlForRecord(
recordType: recordType!Cases,
identifier: null,
targetLocation: "TEMPO"
)
Returns
1
"https://home.appiancloud.com/suite/tempo/records/type/enV6dA/view/all"
Feature | Compatibility | Note |
---|---|---|
Portals | Partially compatible | Can be used with Appian Portals if it is connected using an integration and web API. |
Offline Mobile | Partially compatible | Can be used with offline mobile if it is loaded at the top of the form. |
Sync-Time Custom Record Fields | Incompatible | |
Real-Time Custom Record Fields | Incompatible | Custom record fields that evaluate in real time must be configured using one or more Custom Field functions. |
Process Reports | Incompatible | Cannot be used to configure a process report. |
Process Events | Incompatible | Cannot be used to configure a process event node, such as a start event or timer event. |
There are older versions of this function . You can identify older versions by looking at the name to see if there is a version suffix. If you are using an old version, be sure to refer to the corresponding documentation from the list below.
Old Versions | Reason for Update |
---|---|
urlForRecord_23r4 | You can now specify a site page to open your record when using both a!urlForRecord and a!recordLink. |
To use the latest version of the function, replace the function with a version suffix with a new function reference.
To learn more about how Appian handles this kind of versioning, see the Function and Component Versions page.
a!urlForRecord() Function