Pop Search and Select V2

OVERVIEW:

• The 'Pop Search and Select' activity allows you to show the results grid in a custom popup inside Oracle Service Cloud and perform search & select operations. In the PopFlow Studio, you can configure the 'Pop Search and Select' activity.

• After opening 'Pop Search and select' activity, you will get the below configuration panel.

Default Configuration Parameters:

• Title: The title to be shown in the popup window.
• Allow Multi Selection: Select multiple rows in the popup window./ User Double Click on Grid: Select the single data and closes the popup.
• Data Source: The data to be displayed in the popup search results grid.
• Save Results In: Selected row will be stored in this.

Add Button allows you to add buttons to the popup. When the button is clicked, the activities defined in the button definition will be executed.

Add Searches allows you to add searches to the popup. When the search type is selected, and the search button is clicked the activities defined in the search selection definition will be executed.

HOW IT WORKS:

A Simple Example to configure the 'Pop Search and Select V2' activity in PopFlow Studio.

• Select the 'Pop Search and select' activity from 'Activity Sidebar'.
• Click on 'Pop Search and select' activity to open and configure the 'Set Interaction Data' activity.
• Once the Activity is opened now fill the Defaults required fields i.e. 'Title', 'Data Source' and 'Save Results In'.

• To select the 'Data Source' value we need to have either 'HTTPS' or 'GET DATA' activity result.
• In this example, we will be using 'HTTPS' activity to fetch the data from the API and show the result in 'Pop Search and Select'. To configure the 'HTTPS' activity please refer to the 'HTTPS' activity documents.
• After configuration of 'HTTPS' activity adds a 'Pop Search and Select' activity on the 'SUCCESS' button of 'HTTPS' activity as shown below.

• Now configure the Default fields 'Pop Search and Select' activity as shown below.

Data Sources:

• You can add the multiple 'Data Source' to view the different data lists or make a search on the different data lists and also you can select which column you want to show for selected 'Data Source'.
• After selecting the 'Data Source'. You can add multiple 'Search' by clicking on the 'Searches' button.

• After clicking on the 'Searches' you will get a search panel to configure the search. Enter the search name inside the 'Search Name' field.
• Select the search option "Filter in data Data Source" if you want the search result faster. This will search in selected 'Data Source'. 
• Select the search option "Search in new Data Source".This will make a search in the 'Database' if some new value is updated then it will also get the updated value. To achieve this search you need to add the same activity with the same configuration on the Search Button whose 'Data Source' you are using for the search. 

     - For example, suppose you are using the 'HTTPS' activity 'Save Result In' variable inside the 'Pop Search and Select' activity as a Data Source. 

      Steps to configure the "Search in new data Source":-

          Step 1: - Select the 'HTTPS' activity 'Save Result In' variable from the options as Data Source inside the 'Pop Search and Select' as shown below.

          Step 2:- Now create the search for the selected Data Source by clicking on the 'Searches' button. Select the "Search in new data Source" option to achieve the server-side searching.

          Step 3: - Enter the 'Search Name' and the 'Property' values (search property) inside the 'Enter Property' fields.

         step 4: After creating the search you will notice there is a button created with the same name as 'Search Name' (For this example 'Customer Search' is the 'Search Name') on the designer page under the 'Pop Search and Select' activity.

        Step 5:-- Now add the 'HTTPS' activity on the 'CUSTOMER SEARCH' button to achieve the server-side searching. The 'HTTPS' activity should have the same configuration as whose 'Save Result In' variable is selected as a 'Data Source' for the 'CUSTOMER SEARCH' Search inside the 'Pop Search and Select'.

       Steps 6:- 'Save Results In' variable name of 'HTTPS' activity should be the same as Parent HTTP activity.

          Steps 7:-  Click on the 'ADD QUERY CONDITION' to add the query parameters. After creating the query parameter you will get the two fields 'Property' and 'Enter Value'.In the Property field provide the correct 'column name' on which you want to apply the search and in 'Enter Value' press ' Opening curly bracket' (" { ") to open the autocomplete list. Once the list is opened select the 'Search' option as shown below.

Note: You can add the values manually if search option is not showing. ex- {search.customer_search.name}

          Steps 8:- After selecting the search now press the dot button (" . ") to open the searches created in the Pop Search and Select activity as shown below.

          Steps 9:-Select the correct search name from the list and again press the dot button (" . ") to open the search fields options created inside the search name as shown below.

          Steps 10:- Select the correct search field name for the 'Property' values. After selecting the search field press the 'Closing curly bracket' (" } ") button. You can add multiple query options according to your searches.

• You can add multiple search fields by clicking on the 'Add Search Fields' text as shown below. After clicking on it, It will add a panel with 'Search by' and 'Display Name (Optional)' fields.

• Enter the column name inside the 'Search by' fields on which you want to make a search. The 'Display Name' field is used to show the search name if this field is empty then it will take 'Search by' field value as a display name. 

Columns To Show

• You can display all the columns of the Data Source or You can define the columns that will be displayed in the search grid. To define the columns click on the 'Columns To Show' button to create the fields. After clicking on button it will create a panel with 'Column Path' and 'Column Name' fields. In the 'Column Path' field enter the column path value and inside the 'Column Name' you can enter any friendly name for the title, 'Column Name' field is optional you can either enter the value or left it blank. If the 'Column Name' field is empty it will show the 'Column Path' Value as a Column Name.

Adding Buttons: 

• To add the Custom button you need to click on the 'Button' icon to create the buttons. After clicking on the button, you will see a field name as 'Name' and a checkbox name as 'Close Popup'. Enter the Button name inside the field and click on the checkbox if you want to close the pop-up after clicking on the button in the Oracle service cloud. You can create multiple buttons. Once the buttons are created you will notice on the designer page has changed under the 'Pop Search and Select'  same button is created which you created inside the 'Pop Search and Select' activity. You can add multiple activities on that button to perform the several tasks on a button click.

After executing the workflow below pop-up will be shown in the Oracle service cloud.

• After executing the workflow it will pop up a 'Pop Search and Select' screen with the result, Searches and Custom buttons as shown below.

1. The title of the popup.
2. The Data Sources which we selected while configuring the 'Pop Search and Select'.
3. The search field: Enter the correct value and make a search.
4. The search button:
    a. The activities in the definition (i.e. HTTPS in this example) will be executed when the search button is clicked.
5. Multiple buttons can be configured. When the button is clicked then the activities define for that button will be executed.
6. The Searches which we created while configuring the 'Pop Search and Select'.
7. You can select multiple rows by clicking on the checkbox.
8. The Column Name of the Popup.

• Result After the Search.

• You can either search by only 'name' or both 'name' and 'address.street'.