CustomWebLinkUpsert

Updates custom Web link data or inserts new custom Web link data for an object.

Usage

Use the CustomWebLinkUpsert method to insert custom Web link or update existing custom Web link data for an object.

The object is specified with the <ObjectName> child element of apData:WebLinkSet.

The apdata:WebLinkSet argument contains the following elements containing custom Web link data:

  • Name. The name of the custom Web link field. When performing an insert operation, this name is used as the display name, if a display name is not provided in the <WebLinkTranslation> element.

  • IntegrationTag. The field’s integration tag name.

  • DisplayText. The label for the hyperlink of the custom Web link.

  • WebLinkTarget. The behavior when a user clicks the hyperlink. Open in Current window, Open in Custom Tab, or Open in New window.

  • TargetCustomWebTab. The required custom Web tab, if Open in Custom Tab is specified for WebLinkTarget.

  • RefreshParentWindow. Whether the parent window is refreshed after a new window is opened. Only applicable if Open in New window is specified for WebLinkTarget.

  • DisplayOptions. A character indicating the pages where the custom Web link is displayed: D for Detail Page, E for Edit Page, or B for Both.

  • ActiveLinkCondition. The condition that controls whether the custom Web link is active on the Detail and Edit pages.

  • DisplayLinkCondition. The condition that controls whether the custom Web link is visible on the Detail and Edit pages.

  • Type. The type of custom Web link, which can be Dashboard, Report, or URL.

  • URL. The URL that is invoked when the user clicks the custom Web link.

  • ReportType. Settings for a Report Web link:

    • ReportPath. The path to the report, which must be located under Shared Folders (required).

    • ReportParameters. The filters that will be applied to the report at runtime. For example: <data:ReportParameters>P0=1&amp;P1=eq&amp;P2="Account"."Account ID"&amp;P3=%%%Row_Id%%%</data:ReportParameters>. The filter syntax is validated when you insert or update. For more information about specifying parameters, see Oracle CRM On Demand Online Help.

    • ReportPrompts. Whether any prompts that are configured for the report are displayed at runtime. Corresponds to the Display Report Prompts check box in the UI.

      Note: If the <ReportPrompts> element is set to true, then any filters that are specified in the <ReportParameters> element are ignored at runtime, even if no prompts are defined for the analysis.
    • RefreshLink. Whether the Refresh link that allows users to refresh the report is available at runtime.

    • PrintLink. Whether the Print link that allows users to print the report is available at runtime.

    • ExportLink. Whether the Export link that allows users to download the report is available at runtime.

  • DashboardType. Settings for a Dashboard Web link:

    • DashboardPath. The path to the dashboard (required). The dashboard must be located directly in the Dashboards folder under Shared Folders and not at a deeper level. This validation is enforced only in the UI and not via Web service Upsert calls.

    • DashboardParameters. The filters that will be applied to the dashboard at runtime. For example: <data:DashboardParameters>P0=1&amp;P1=eq&amp;P2="Account"."Account ID"&amp;P3=%%%Row_Id%%%</data:DashboardParameters>. The filter syntax is validated when you insert or update. For more information about specifying parameters, see Oracle CRM On Demand Online Help.

  • ListOfWebLinkTranslations. The display names in the languages activated for your company:

    • DisplayName. The display name of the custom Web link in the language identified by the language code.

    • DisplayText. The label for the hyperlink, in the language identified by the language code.

    • LangCode. The three-letter language code for the language.

See Oracle Migration Tool On Demand Guide for reference tables about the following:

  • Mappings of three-letter language codes to languages.

  • Mappings of object names to the display names for the objects in the Oracle CRM On Demand user interface.

For more information about custom Web links, see Oracle CRM On Demand Online Help.

Note: Internally, concatenated fields are custom Web links, however you cannot use the CustomWebLinkUpsert method to update or insert concatenated field data.

Arguments

The following table describes the arguments taken by the CustomWebLinkUpsert method.

Table Arguments Taken by the CustomWebLinkUpsert Method

Name Description Required Default I/O

apData:WebLinkSet

The custom Web link data to be inserted or updated.

Yes

Not applicable

Input

Status

The status of the call.

Not applicable

Not applicable

Output

Return Value of the Call

The status is returned.