Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 16 Current »

The Lighting Component Campaign Items Related List has a couple of default settings defined which a technical administrator can change according to the following documentation. 

Navigate to the App Launcher - Feature Setting.

Default Sorting

In version 2.148 a new feature setting was added to the sort order feature setting. As of now you are able to define the sort direction (ascending or descending) to customize the sorting of the list to fit you and your users needs.

Replace "Name" with any field API you like to default the sorting to. 

Feature Name

Feature Setting Name

default value

CampaignItemRelatedList

SortByField

{"Field":["ADvendio__SortOrder__c"],"Order":"asc"}

Default Columns

Additionally, you can define individual columns for the component. Create new feature setting records in the following way:

Feature Name

Feature Setting Name

default value

CampaignItemRelatedList

TableFields

{
   "TableFields":[
      "Name",
      "ADvendio__Period__c",
      "ADvendio__Quantity__c",
      "ADvendio__Sales_Price__c",
      "ADvendio__Billing_category__c",
      "ADvendio__Amount_net3__c",
      "ADvendio__Available__c",
      "ADvendio__PositionNumber__c",
      "ADvendio__PositionNumberAppendix__c"
   ]
}

This entry in JSON format as an array is used to define what fields from the CampaignItem object can be shown into the ResultTable. List API names of Campaign Item fields only. 

Create and manage Custom Buttons

To add a custom button which can filter your line items or to manage the ADvendio Custom Buttons

  • Don't Show Cancelled Items

  • Don't Show Optimized Items

on your visual force page please create a feature setting with the following values:

Feature Name

Feature Setting Name

Default Filter Value

CampaignItemRelatedList

FilterButtons

{
   "Buttons":[
      {
         "title":"Don't Show Cancelled Item",
         "label":"Don't Show Cancelled Item",
         "filter":"ADvendio__ConnectedItem__c = null",
         "variant":"neutral",
         "isActive":"false"
      },
      {
         "title":"Don't Show Optimized Item",
         "label":"Don't Show Optimized Item",
         "filter":"ADvendio__OptimizationExclusion__c = null",
         "variant":"neutral",
         "isActive":"true"
      }
   ]
}

This entry in JSON format as an array of map objects is used to define the custom filter buttons, where we can define the

  • title: sets the text for the mouse over

  • label: is shown on the button and

  • define the filter values. You can add multiple using brackets. 

By default the values are as above. They can be set as follows;

  • 'isActive' set to false, if the user should see the button disabled when opening the component. When 'is Active' is set to false, variant will be set to neutral, meaning the button appears as not selected 

  • 'isActive' set to true, if the user should see the button enabled when opening the component. When 'is Active' is set to true, variant will be set to brand, meaning the button appears blue/as selected by default

Create and manage Action Buttons

To modify the action buttons on the component create or edit the following feature setting: 

Feature Name

Feature Setting Name

Feature Setting Name

CampaignItemRelatedList

ActionButtons

{
   "Buttons":[
   {
         "title":"Add Items",
         "label":"Add Items",
         "action":"/apex/ADvendio__SelectSearch?Id=$mcId$",
         "type":"vf"
      },
      {
         "title":"Change Items",
         "label":"Change Items",
         "componentDefinition":{
            "componentDef":"ADvendio:campaignBuilderWrapper",
            "attributes":{
               "mode":"edititems",
               "recordId":"$mcId$",
               "campaignItemIds":"$recordIds$"
            }
         },
         "type":"lwc"
      },
      {
         "title":"Edit Items",
         "label":"Edit Items",
         "action":"/apex/ADvendio__MediaConfiguration?id=$mcId$&selected=$recordIds$",
         "type":"vf"
      },
      {
         "title":"Optimize Items",
         "label":"Optimize Items",
         "action":"/apex/ADvendio__NavigateToOptimizer?id=$mcId$&selected=$recordIds$",
         "type":"vf"
      },
      {
         "title":"Delete Items",
         "label":"Delete Items",
         "action":"/apex/ADvendio__DeleteCampaignItems?id=$mcId$&selectedIds=$recordIds$",
         "type":"vf"
      },
      {
         "title":"Sort Items",
         "label":"Sort Items",
         "action":"/apex/ADvendio__SortCampaignItems?Id=$mcId$",
         "type":"vf"
      },
      {
         "title":"Show Recommendations",
         "label":"Show Recommendations",
         "action":"/apex/ADvendio__ProductRecomm?id=$mcId$",
         "type":"vf"
      },
      {
         "title":"Check Availability",
         "label":"Check Availability",
         "action":"/apex/ADvendio__CheckAvailabilityCi?id=$mcId$&selectedIds=$recordIds$",
         "type":"vf"
      },
      {
         "title":"Submit to AdServer",
         "label":"Submit to AdServer",
         "action":"/apex/ADvendio__SubmitToAdServer?id=$mcId$&selectedIds=$recordIds$",
         "type":"vf"
      },
      {
         "title":"Creative Upload",
         "label":"Creative Upload",
         "action":"/apex/ADvendio__CreativeUploadCi?id=$mcId$&selectedIds=$recordIds$",
         "type":"vf"
      },
      {
         "title":"Update Ad-Status in AdServer",
         "label":"Update Ad-Status in AdServer",
         "action":"/apex/ADvendio__UpdateAdServerAdStatus?id=$mcId$&selectedIds=$recordIds$",
         "type":"vf"
      },
      {
         "title":"Get Delivered Clicks/Impressions",
         "label":"Get Delivered Clicks/Impressions",
         "action":"/apex/ADvendio__DeliveredClicksAndImpressionsImport?id=$mcId$&selectedIds=$recordIds$",
         "type":"vf"
     }
   ]
}

This entry in JSON format as an array of map objects is used to define the default action buttons, where we can define the

  • title,

  • label and

  • action values.

The parameters must be defined as $mcid$ for the Media Campaign Id value and $recordIds$ for the selected items to use according the button choice. Currently ADvendio offers 12 buttons the same as the Salesforce Campaign Item default feature.

Create Custom Button for a Visualforce Page or LWC

To add a button to a Visualforce page, follow these steps:

  1. For Visualforce Pages:

    1. Create your Visualforce Page with an Apex Controller and add it to the Feature Setting as described below. Replace “vfExamplePage“ with the name you applied for the page:

    2. Add Button to Campaign Items:

      1. Go to Feature Setting (ActionButtons → CampaignItemRelatedList) and edit it.

      2. Add the value below: (info) You can change “title” and “label” based on your needs:

        {
         "title": "Example Page",
         "label": "Example VF",
         "action": "/apex/vfExamplePage?hello=$recordIds$",
         "type": "vf"
        }
  2. Create your LWC and add it to the Feature Setting as described below. Replace “lwcExample“ with the name you applied for the page:

    1. Add Button to Campaign Items:

      • Go to Feature Setting (ActionButtons → CampaignItemRelatedList) and edit it.

      • Add the value below: (info) You can change “title” and “label” based on your needs:

        {
         "title": "Example LWC",
         "label": "Example LWC",
         "componentDefinition": {
                "componentDef": "C:lwcExample",
                "attributes": {
                  "name": "$recordIds$"
                }
              },
         "type": "lwc"
        }

For both versions you must add the parameters defined as $mcid$ for the Media Campaign Id value and $recordIds$ for the selected items to use according the button choice. Keep in mind that when $recordIds$ has multiple values, this values will be comma separated.

As for $smallView$ and $counter$, those are optional parameters.

  • $smallView$ is a boolean that returns true if the CIRL was in small view when clicking an action button, and false otherwise

  • $counter$ returns an integer with the amount of rows selected

Now, the button should appear on the Campaign Items related list.

Captura de pantalla 2023-06-20 a la(s) 08.48.06.png

  • No labels