Reinitialise taskFlow in dynamic region and set focus to default activity

Hello All

We all use bounded task flows in ADF application development and to switch between multiple task flows we use concept of dynamic region

Recently I came across a problem about dynamic region and bounded task flows, Scenario is like this

I have dropped a BTF in dynamic region and there is a link on page to open that task flow and those who have used dynamic region would be familiar with this piece of code

ADF Basics: Creating Bounded Task Flow Train using af:train component

This post is about using bounded task flow as train
A train presents a whole cycle and it's every stop presents a particular step of cycle
From the docs -

The train component presents a user with a series of stops, each stop representing a step in a multi-step process. The train walks the user through these steps, in a suggested order (the order being dictated by the underlying model). Each step is rendered as a train stop consisting of an image and a textual link indicating if they are in visited, current, unvisited and disabled states. Train can also be rendered in a vertical layout - the default being a horizontal layout. Trains are not rendered on printable pages. 

ADF Basics: Using setActionListener in ADF, Set pageFlowScope parameter without writing code

This post is about using setActionListener tag in ADF, this tag provides a simpler way to set values of other objects and makes use of EL
See What docs says-

The setActionListener tag is a declarative way to allow an action source (<commandButton>, <commandLink>, etc.) to set a value before navigation. It is perhaps most useful in conjunction with the "pageFlowScope" EL scope provided by ADF Faces, as it makes it possible to pass details from one page to another without writing any Java code. This tag can be used both with ADF Faces commands and JSF standard tags. More generally, it can be used with any component at all that implements the standard ActionSource interface.

Create taskFlow and region binding at run-time , show n numbers of regions using multiTaskFlow- Oracle ADF

This is very specific development requirement to create taskFlow and region binding at run-time to show n numbers of region in page
In this case initially you don't know how much regions required in page as it depends on user activity .

you can see in http://irctc.co.in/ (Indian Railways) site
when user search for a train and check berth availability then a tab is generated at run-time with berth and fare details and it continues for each action , every time a new tab with new information is generated (n- number of tab and taskFlow)

A very good article is published in Oracle Magazine (July – August 2014) by Frank Nimphius on this requirement , article contains very good description of each and every step and a sample application with whole functionality
I found it very interesting and good so giving a quick overview of TaskFlow on Fly

this functionality is implemented using multiTaskFlow element that uses taskFlow binding from managed bean , taskFlow bindings in managed bean created using TaskFlowBindingAttributes
this class is used to set all properties of taskFlow binding at runtime



See Oracle docs (TaskFlowBindingAttributes)-
Set of attributes that define a TaskFlowBinding object. The taskFlowList attribute of the multiTaskFlow element of the page definition uses a list of object of this type to describe each taskflowBinding that the multiTaskflow binding contains. The order of this list defines the order of the region objects in the multiTaskflow binding. 

So in this post i am using Departments and Employees table of HR Schema(Oracle) to create business components for Model part

Create viewCriteria in both viewObjects (Departments and Employees) to filter data using DepartmentId

Applied viewCriteria to viewObject at AM level (Edit Vo instance and shuttle viewCriteria to selected side)
After this created methods in AMImpl class to set value in both viewCriteria's bind variables

    /**Method to filter Department ViewObject
     * @param deptId
     */
    public void filterDepartmentData(Integer deptId) {
        this.getDepartments1().setNamedWhereClauseParam("BindDeptId", deptId);
        this.getDepartments1().executeQuery();

    }

    /**Method to filter Employees Data
     * @param deptId
     */
    public void filterEmployeesData(Integer deptId) {
        this.getEmployees1().setNamedWhereClauseParam("BindDeptId", deptId);
        this.getEmployees1().executeQuery();

    }

Expose both methods to use in clientInterface

Now viewController part-

Created two bounded taskFlow with one input parameter for DepartmentId (this id will be used to filter Departments and Employess viewObject)
One for Departments and Second for Employees-

First taskFlow has a .jsff (facelets) page that has Departments viewObject as a form , just to show date with navigation buttons

filterDepartmentData method of AMImpl is used as Default Activity of this taskFlow

to filter data before entering in page

Second taskFlow has a .jsff (facelets) page that has Employees viewObject as a table

filterEmployeesData method of AMImpl is used as Default Activity of this taskFlow

to filter data before entering in page

Now basic configuration is complete, model is ready and bounded taskFlows are ready
then create a jsf page and manged bean (pageFlowScope) in adfc-config.xml, this page will make use of these two bounded taskFlows  and managed bean is responsible to generate taskFlow binding at runtime

Next Step is to prepare manged bean to hold taskFlowBinding-
Create a List of type TaskFlowBindingAttributes and it's accessors

import oracle.adf.controller.binding.TaskFlowBindingAttributes;    
private List<TaskFlowBindingAttributes> taskFlowBinding = new ArrayList<TaskFlowBindingAttributes>(5);

    public void setTaskFlowBinding(List<TaskFlowBindingAttributes> taskFlowBinding) {
        this.taskFlowBinding = taskFlowBinding;
    }

    public List<TaskFlowBindingAttributes> getTaskFlowBinding() {
        return taskFlowBinding;
    }

Create multiTaskFlow binding in executables of pgae-

• Open jsf page, click on bindings tab of page editor
• click on green plus icon of executables section
• Select ADF TaskFlow Bindings in category and select multiTaskFlow





• click on ok and provide an unique value for id attribute and reference of List created in managed bean as value for taskFlowList attribute





• Configuration of  multiTaskFlow for this page is complete and now time to design page to render multiple regions. For this purpose add af:ForEach and a region inside it, forEach is responsible to add regions at run-time. here a little change i am using panelTabbed  to create tab at runtime and inside tab there will be region 
• See this xml code- here nothing simple panelTabbed and forEach iterates over to list to identify number of items and varStatus of forEach is used to create id of showDetailItem at runtime as id must be unique. regionModel is referenced from var attributes of forEach as part of taskFlowBinding 



 <af:panelTabbed position="above" id="pt1" partialTriggers="b1">
            <af:forEach items="#{bindings.mtf1.taskFlowBindingList}" var="multiTF" varStatus="vs">
               <af:showDetailItem id="Tab#{vs.index+1}" text="#{multiTF.name}" partialTriggers="b1">
                  <af:region value="#{multiTF.regionModel}" id="r1#{vs.index}" partialTriggers="::b1"/>
               </af:showDetailItem>
            </af:forEach>
         </af:panelTabbed>



• Now page is ready to show unknown (n) number of regions, here i am using two list and a button on page First List is of all departments and second one is static list to select information type (if user want to see Only Departments or Departments Wise Employees) and button to execute and add taskFlow from managed bean as per selected Department and 
• Again a map is created in managed bean to store input parameters for taskFlow and it will used while setting and creating taskFlowBinding



    HashMap<String, Object> tfParam = new HashMap<String, Object>();
    public void setTfParam(HashMap<String, Object> tfParam) {
        this.tfParam = tfParam;
    }

    public HashMap<String, Object> getTfParam() {
        return tfParam;
    }



• finally we will create taskFlow binding and set properties on button click (actionEvent of button), See this code-



    /**Method to create and set properties in TaskFlowBinding
     * @param actionEvent
     */
    public void displayDepartmentAction(ActionEvent actionEvent) {
        //Clear List to show newly created regions only
        taskFlowBinding.clear();
        System.out.println("List Cleared -Size>" + taskFlowBinding.size());
        //Check that user selects value in both List (Uses component binding to check)
        if (deptIdBindVal.getValue() != null && showTypeBind.getValue() != null) {
            //Put value in TaskFLow Parameter map, deptIdBindVal is binding of list of departments on page
            tfParam.put("DeptIdParam", deptIdBindVal.getValue());

            //Only Shows Departments taskFlow, if user selectes "Only Departments"
            if ("Only Departments".equalsIgnoreCase(showTypeBind.getValue().toString())) {
                //Setting taskFlow properties
                TaskFlowBindingAttributes tfAttr = new TaskFlowBindingAttributes();
                //Creating Unique Id
                tfAttr.setId("Department_" + deptIdBindVal.getValue());
                //See bounded taskFlow name in WEB-INF and use here
                tfAttr.setTaskFlowId(new TaskFlowId("/WEB-INF/DepartmentsBTF.xml", "DepartmentsBTF"));
                //This EL refers parameter map created in this managedBean
                tfAttr.setParametersMap("#{pageFlowScope.MultiTaskFlowBean.tfParam}");
                //Finally add taskFlow to List
                taskFlowBinding.add(tfAttr);
            } else { // Show both Departments and Employees
                //Creating Departments TaskFlow binding
                TaskFlowBindingAttributes tfAttr = new TaskFlowBindingAttributes();
                tfAttr.setId("Department_" + deptIdBindVal.getValue());
                tfAttr.setTaskFlowId(new TaskFlowId("/WEB-INF/DepartmentsBTF.xml", "DepartmentsBTF"));
                tfAttr.setParametersMap("#{pageFlowScope.MultiTaskFlowBean.tfParam}");
                taskFlowBinding.add(tfAttr);
                //Creating Employee TaskFlow biniding
                tfAttr = new TaskFlowBindingAttributes();
                tfAttr.setId("Employees_" + deptIdBindVal.getValue());
                tfAttr.setTaskFlowId(new TaskFlowId("/WEB-INF/EmployeesBTF.xml", "EmployeesBTF"));
                tfAttr.setParametersMap("#{pageFlowScope.MultiTaskFlowBean.tfParam}");
                taskFlowBinding.add(tfAttr);
            }
        }
    }



• So Application with multiTaskFlow is ready , in this post i have used these two bounded taskFlow to show in two tabs at run-time, in same way you can call multiple TFs or a single taskFlow multiple time. Now runt application and see how it works

Initial page with two lists

Select Department and show type -click on button

Select Department and show type -click on button

• Refer this post Region Extreme: Multi-Task-Flow Binding to learn more about multiTaskFlow binding. In this Frank also told about how to use dynamic viewObject instance to show different data at run-time, because if we use same instance of viewObject in multiple taskFlow at same time then it will not maintain state for each region to it is necessary to use dynamic instance and it's binding in pageDef
• Read more about regions and taskFlows- Using Task Flows as Regions

Thanks - Happy Learning :) Sample ADF Application

Adding Drag and Drop Functionality for collections in page fragments to create insert

Hello All,
This tutorial is based on using Drag & Drop functionality in collections as af:table to create a new row
i have googled about Drag & Drop but was not able to implement in page fragments(.jsff), all samples was based on JSPX page.

this tutorial is based on DEPARTMENTS table (Default HR Schema) and an other table with Same Structure DEPARTMENTS_DUPL to implement drag and drop.
my scenario is to add row in DEPARTMENTS_DUPL from Departments 
 See the steps to implement- 

•  First create Departments_dupl table in your HR schema, simply run this script



CREATE TABLE DEPARTMENTS_DUPL
  (
    DEPARTMENT_ID   NUMBER(4, 0) ,
    DEPARTMENT_NAME VARCHAR2(30 BYTE) ,
    MANAGER_ID      NUMBER(6, 0) ,
    LOCATION_ID     NUMBER(4, 0)
  )



• Now create Fusion Web Application and create business components

• Now create a bounded taskflow and a page fragment in it, and drop both tables on page
  
  
  
• Now drop af:dragSource as child of Departments table and set properties, here discriminant is to ensure compatibility between drag and drop components, and its value must match for Drag source and Drop Target

• now drop af:dropTarget as child of DepartmentsDupl table and set properties as Action etc and create a DropListener for it that handles drop event, set Flavor class to java.lang.Object

• Now select af:dropTarget and goto source and set value for discriminant same as drag source



  <af:dropTarget dropListener="#{pageFlowScope.DragDropSampleBean.deptDropListener}" actions="COPY">
          <af:dataFlavor discriminant="copyDept" flavorClass="java.lang.Object"/>
        </af:dropTarget>





• Now write code to create a new row in DepartmentsDupl and insert data from Departments on Drop Listener




    public void dragDropAction() {
        ViewObject dept = this.getDepartments1();
        ViewObject deptDupl = this.getDepartmentsDupl1();
        Row curDept = dept.getCurrentRow();
     
        Row dupl = deptDupl.createRow();
        dupl.setAttribute("DepartmentId", curDept.getAttribute("DepartmentId"));
        dupl.setAttribute("DepartmentName", curDept.getAttribute("DepartmentName"));
        dupl.setAttribute("ManagerId", curDept.getAttribute("ManagerId"));
        dupl.setAttribute("LocationId", curDept.getAttribute("LocationId"));
        deptDupl.insertRow(dupl);
        deptDupl.executeQuery();
        this.getDBTransaction().commit();
    }



• Now Run your page and use this cool functionality :-)

 Download Sample App Cheers :-)

Using Java API for getting Weather information in Oracle ADF-wunderground-core

hello everyone, here is nice tutorial for all ADF techies-

i have developed an application in ADF that retrieves weather information of a country's weather stations.

as-temperature, humidity, dew, rain rate, wind speed etc using wunderground-core 

API . This API fetch weather data for a weater station by given month and year or data for all the stations of a country.

Feature of this wunderground-core-

1. Very simple to use
2. Date Listener support
3. Fetch weather data for all stations of country
4. can be used with desktop or web application
5. Ajax supported
6. Real Time weather values

Snap-

 Change Country-

Download wunderground-core API- https://code.google.com/p/wunderground-core/downloads/list

and download jar distribution with all dependencies

• Now start , create a fusion web application and add jar file to  classpath

• Now create a bounded taskflow and a .jsff page inside this , now see the simple code to get all weather station of acountry and their weather data



        /*  create an instance of WeatherStationService */
        WeatherStationService weatherStationService = new WeatherStationService();

        /*  find all weather stations */
        List<WeatherStation> stations = weatherStationService.findAllWeatherStationsByCountry("INDIA");

        
        for (WeatherStation weatherStation : stations) {
            System.out.println(weatherStation.getStationId() + "\t" + "\t" + weatherStation.getCity() + "\t" +
                               weatherStation.getCountry());

            HttpDataReaderService dataReader = new HttpDataReaderService();
            dataReader.setWeatherStation(weatherStation);
            DataSet current = dataReader.getCurrentData();

            System.out.println(current.getDateTime() + "Temperature- " + current.getTemperature() + "Humidity-" +
                               current.getHumidity());



• I have used this code on my af:commandButton for getting weather data, and a table on page to show this information on page using list (arrayList) , rest is same and simple like other ADF Application
• Download Sample Application and see it, you will also learn that how to show a table using List(Java) Sample ADF Application





• See source of .jsff page for tables'use and values-



<?xml version='1.0' encoding='UTF-8'?>
<jsp:root xmlns:jsp="http://java.sun.com/JSP/Page" version="2.1" xmlns:af="http://xmlns.oracle.com/adf/faces/rich"
          xmlns:f="http://java.sun.com/jsf/core">
    <af:panelBox text="Weather Report App-www.javadrive.co.in" id="pb1" showDisclosure="false">
        <f:facet name="toolbar"/>
        <af:panelFormLayout id="pfl1">
            <af:inputText label="Country Name" id="it1"
                          contentStyle="text-transform:upperCase;color:green;font-weight:bold;"
                          binding="#{WeatherReportBean.cntryNameBind}"/>
            <af:commandButton text="Get Report" id="cb1" actionListener="#{WeatherReportBean.getWeatherReportButton}"
                              inlineStyle="font-weight:bold;"/>
        </af:panelFormLayout>
        <af:popup childCreation="deferred" autoCancel="disabled" id="p1">
            <af:dialog id="d1" title="User-User4" type="none">
                <f:facet name="buttonBar"/>
                <af:message id="m1" message="You are not authorize to make an order of 25000, your limit is 20000 !!!"
                            messageType="error"/>
            </af:dialog>
        </af:popup>
        <af:panelGroupLayout id="pgl1" layout="horizontal">
            <af:table var="row" rowBandingInterval="1" id="t1" value="#{WeatherReportBean.stations}"
                      partialTriggers="::cb1" contentDelivery="immediate" width="500">
                <af:column sortable="false" headerText="Country" id="c3">
                    <af:spacer width="10" height="10" id="s2"/>
                    <af:outputText value="#{row.country}" id="ot3" inlineStyle="font-weight:bold;color:red;"/>
                    <af:spacer width="10" height="10" id="s1"/>
                </af:column>
                <af:column sortable="false" headerText="Locality" id="c4" width="150">
                    <af:outputText value="#{row.neighborhood}" id="ot4"/>
                </af:column>
                <af:column sortable="false" headerText="City" id="c2">
                    <af:outputText value="#{row.city}" id="ot2" inlineStyle="font-weight:bold;color:darkgreen;"/>
                </af:column>
                <af:column sortable="false" headerText="Station Id" id="c1">
                    <af:outputText value="#{row.stationId}" id="ot1" inlineStyle="font-weight:bold;color:darkblue;"/>
                </af:column>
            </af:table>
            <af:table value="#{WeatherReportBean.reportL}" var="row" rowBandingInterval="1" id="t2"
                      contentDelivery="immediate" partialTriggers="::t1 ::cb1" styleClass="AFStretchWidth" width="800">
                <af:column sortable="false" headerText="Date" align="start" id="c5">
                    <af:spacer width="10" height="10" id="s4"/>
                    <af:outputText value="#{row.currDate}" id="ot5" inlineStyle="font-weight:bold;">
                        <af:convertDateTime pattern="dd/MMM/yyyy"/>
                    </af:outputText>
                    <af:spacer width="10" height="10" id="s3"/>
                </af:column>
                <af:column sortable="false" headerText="Temperature" align="end" id="c6" width="70">
                    <af:outputText value="#{row.temp} C" id="ot6" inlineStyle="font-weight:bold;color:teal;"/>
                </af:column>
                <af:column id="c7" headerText="Humidity" align="right" width="70">
                    <af:outputText value="#{row.humid}" id="ot7" inlineStyle="font-weight:bold;color:orange;"/>
                </af:column>
                <af:column id="c8" headerText="Dew Point" align="right" width="70">
                    <af:outputText value="#{row.dewR}" id="ot8" inlineStyle="font-weight:bold;color:green;"/>
                </af:column>
                <af:column id="c9" headerText="Wind Direction" align="right" width="70">
                    <af:outputText value="#{row.windDirec}" id="ot9" inlineStyle="font-weight:bold; color:Olive;"/>
                </af:column>
                <af:column id="c10" headerText="Wind Speed (Km/H)" align="right">
                    <af:outputText value="#{row.windSpd}" id="ot10"
                                   inlineStyle="color:ActiveCaption;font-weight:bold;"/>
                </af:column>
                <af:column id="c11" headerText="Rain Rate" align="right" width="70">
                    <af:outputText value="#{row.rainRt}" id="ot11" inlineStyle="font-weight:bold;color:maroon;"/>
                </af:column>
                <af:column id="c12">
                    <af:image shortDesc="Weather" id="i1"
                              source="#{row.temp >35 ? resource['images:sun.png'] : resource['images:sun_slush.png']}"/>
                </af:column>
            </af:table>
        </af:panelGroupLayout>
    </af:panelBox>
</jsp:root>



• And see managed bean code to populate data in tables on page, other than manged bean i have used a java bean to populate value in list and then in table
• WeatherReportBean.java- 



package weather.view.bean;

import de.mbenning.weather.wunderground.api.domain.DataSet;
import de.mbenning.weather.wunderground.api.domain.WeatherStation;
import de.mbenning.weather.wunderground.impl.services.HttpDataReaderService;
import de.mbenning.weather.wunderground.impl.services.WeatherStationService;

import java.io.Serializable;

import java.sql.SQLException;

import java.util.ArrayList;
import java.util.List;

import javax.faces.event.ActionEvent;

import oracle.adf.view.rich.component.rich.input.RichInputText;

import oracle.jbo.domain.Date;

public class WeatherReportBean implements Serializable {
    private RichInputText cntryNameBind;

    public WeatherReportBean() {
    }
    WeatherStationService weatherStationService = new WeatherStationService();

    List<WeatherStation> stations;
    List<Report> reportL;


    public void getWeatherReportButton(ActionEvent actionEvent) throws SQLException {
        if (cntryNameBind.getValue() != null) {
            String cntryName = cntryNameBind.getValue().toString();

            stations = weatherStationService.findAllWeatherStationsByCountry(cntryName);
            reportL = new ArrayList<Report>(50);
            for (WeatherStation weatherStation : stations) {

                HttpDataReaderService dataReader = new HttpDataReaderService();
                dataReader.setWeatherStation(weatherStation);
                DataSet current = dataReader.getCurrentData();

                java.util.Date b = new java.util.Date();
                Double c = new Double(0);
                Integer humidity = 0;
                Double dew = new Double(0);
                String windDir = "";
                Double windSp = new Double(0);
                Double rainRate = new Double(0);

                if (current != null) {
                    if (current.getDateTime() != null) {
                        b = current.getDateTime();
                        c = current.getTemperature();
                        humidity = current.getHumidity();
                        dew = current.getDewPoint();
                        windDir = current.getWindDirection();
                        windSp = current.getWindSpeedKmh();
                        rainRate = current.getRainRateHourlyMm();
                        System.out.println("Humidity is-->" + current.getHumidity() + "dew point-->" +
                                           current.getDewPoint() + "wind -->" + current.getWindDirection() +
                                           "speed--" + current.getWindSpeedKmh());


                    }
                }

                reportL.add(new Report(b, c, humidity, dew, windDir, windSp, rainRate));

            }


        }

    }

    public void setStations(List<WeatherStation> stations) {
        this.stations = stations;
    }

    public List<WeatherStation> getStations() {
        return stations;
    }

    public void setReportL(List<Report> reportL) {
        this.reportL = reportL;
    }

    public List<Report> getReportL() {
        return reportL;
    }

    public void setCntryNameBind(RichInputText cntryNameBind) {
        this.cntryNameBind = cntryNameBind;
    }

    public RichInputText getCntryNameBind() {
        return cntryNameBind;
    }
}



• Report.java- bean class to populate list



package weather.view.bean;

import java.util.Date;

public class Report {

    private Date CurrDate;
    private double temp;
    Integer humid;
    Double dewR;
    String windDirec;
    Double windSpd;
    Double rainRt;

    public Report(Date date, Double double1, Integer hum, Double de, String windD, Double windS, Double Rain) {
        System.out.println("date is-->" + date + "and temp is-->" + double1);

        this.CurrDate = date;
        setTemp(double1);
        this.humid = hum;
        this.dewR = de;
        this.windDirec = windD;
        this.windSpd = windS;
        this.rainRt = Rain;


    }


    public void setCurrDate(Date CurrDate) {
        this.CurrDate = CurrDate;
    }

    public Date getCurrDate() {
        return CurrDate;
    }

    public void setTemp(double temp) {
        this.temp = temp;
    }

    public double getTemp() {
        return temp;
    }

    public void setHumid(Integer humid) {
        this.humid = humid;
    }

    public Integer getHumid() {
        return humid;
    }

    public void setDewR(Double dewR) {
        this.dewR = dewR;
    }

    public Double getDewR() {
        return dewR;
    }

    public void setWindDirec(String windDirec) {
        this.windDirec = windDirec;
    }

    public String getWindDirec() {
        return windDirec;
    }

    public void setWindSpd(Double windSpd) {
        this.windSpd = windSpd;
    }

    public Double getWindSpd() {
        return windSpd;
    }

    public void setRainRt(Double rainRt) {
        this.rainRt = rainRt;
    }

    public Double getRainRt() {
        return rainRt;
    }
}