Page Comparison

		<activity
            android:name=".view.activity.NativeECSmartRegisterActivity"
            android:screenOrientation="landscape"
            android:theme="@style/AppThemeNoTitle" />

Where style/AppThemeNoTitle is defined under styles.xml file as:

	<style name="AppThemeNoTitle" parent="Theme.AppCompat.Light.DarkActionBar">
        <!-- Customize your theme here. -->
        <item name="android:windowNoTitle">true</item>
        <item name="android:windowActionBar">false</item>
        <item name="android:windowFullscreen">false</item> <!-- this is useful to prevent the keyboard from covering up the input fields -->
        <item name="android:windowContentOverlay">@null</item>
	</style>

The logic that is contained in the initial activity that loads the form is then moved to a fragment, the base fragment, the fragment should be as self sufficient as possible i.e only the functions that are handled better by activity rather than fragment are left, the rest are moved to the fragment.

see org.ei.opensrp.mcare.fragment.HouseHoldSmartRegisterFragment; most of the the code moved over from the initial activity i.e org.ei.opensrp.mcare.household.HouseHoldSmartRegisterActivity.

The other modification required by the activity goes to manifest file i.e since we are switching the activity orientation during runtime depending on the fragment on display, we need to prevent the activity from starting a fresh each time (would otherwise cause an exception)

		<activity
            android:name=".household.HouseHoldSmartRegisterActivity"
            android:configChanges="keyboardHidden|orientation|screenSize"
            android:theme="@style/AppThemeNoActionBarAndTitle" />

The default form launch functionality is also overridden such that we show the FormFragment instead of launching a new activity whenever a form is requested, the new form launch functionality accepts three parameters:

meta data (fields overrides) - data structure that holds the fields we would like to override

//....
 
@Override
protected DefaultOptionsProvider getDefaultOptionsProvider() {return null;}

@Override
protected void setupViews() {}

@Override
protected void onResumption(){}

@Override
protected NavBarOptionsProvider getNavBarOptionsProvider() {return null;}

@Override
protected SmartRegisterClientsProvider clientsProvider() {return null;}

@Override
protected void onInitialization() {}

@Override
public void startRegistration() {
}
//...

All the methods listed above are moved to the fragment, please note its important to retain empty stubs as shown in the example to avoid run time bugs since the SecuredNativeSmartRegisterActivity will attempt to invoke them.

see org.ei.opensrp.mcare.fragment.HouseHoldSmartRegisterFragment; most of the the code moved over from the initial activity i.e org.ei.opensrp.mcare.household.HouseHoldSmartRegisterActivity.

The other modification required by the activity goes to manifest file i.e since we are switching the activity orientation during runtime depending on the fragment on display, we need to prevent the activity from starting a fresh each time (would otherwise cause an exception)

		<activity
            android:name=".household.HouseHoldSmartRegisterActivity"
            android:configChanges="keyboardHidden|orientation|screenSize"
            android:theme="@style/AppThemeNoActionBarAndTitle" />

The default form launch functionality is also overridden such that we show the FormFragment instead of launching a new activity whenever a form is requested, the new form launch functionality accepts three parameters:

• formName - the name of the form we want to launch

• entityId - the id of the record we want to load to the form e.g if we are editing

• meta data (fields overrides) - data structure that holds the fields we would like to override

  
  

@Override
public void startFormActivity(String formName, String entityId, String metaData) {
    Log.v("fieldoverride", metaData);
    try {
        int formIndex =    displayFormFragment.loadFormData();
     FormUtils.getIndexForFormName(formName, formNames) + 1; // add the offset
         if displayFormFragment.setRecordId(entityId); != null || metaData != null){
       }     String data = null;
}          mPager.setCurrentItem(1, false); //Don't animate the view on orientation change the view disapears
    }

org.ei.opensrp.util.FormUtils class contains the logic needed while saving/retrieving the form, while saving the form the class converts the xml input obtained from the form into a form submission which can be handled by ziggy. When retrieving the form, e.g if the form needs to be preloaded with existing data, the class has utility method that uses the supplied id parameter to build an xml input string to be supplied to the form.

Navigation to and from the FormDisplay is achieved by simply switching the viewpager index to show the desired fragment, e.g initially the register activity shows the base fragment (the fragment with the records list), when new form flow is triggered the view pager index is moved to point to the FomFragment, 1 if its single form flow, or n if we can load multiple forms from the same base fragment.

Example in code is:

mPager.setCurrentItem(1, false); //Don't animate the view on orientation change the view disappears

	private String formName;
   
    public String getFormName() {
        return formName;
    }

    public void setFormName(String formName) {
        this.formName = formName;
    }

	String formData;

    public void setFormData(String data){
        this.formData = data;
    }

    public void loadFormData(){
        formData = formData != null ?  formData.replaceAll("\"","\\\"") : "";
        webView.post(new Runnable() {
            @Override
            public void run() {
                webView.loadUrl("javascript:loadDraft('"+ formData + "')");
            }
        });
    }

The fragment also contains javascript interface for communicating to and fro between the fragment/activity and the enketo form, currently there are only two functions:

check if there is previously saved data for the form
            data = getPreviouslySavedDataForForm(formName, metaData, entityId);
            if (data == null){
                data = FormUtils.getInstance(getApplicationContext()).generateXMLInputForFormWithEntityId(entityId, formName, metaData);
            }

            DisplayFormFragment displayFormFragment = getDisplayFormFragmentAtIndex(formIndex);
            if (displayFormFragment != null) {
                displayFormFragment.setFormData(data);
                displayFormFragment.loadFormData();
                displayFormFragment.setRecordId(entityId);
                displayFormFragment.setFieldOverides(metaData);
            }
        }

        mPager.setCurrentItem(formIndex, false); //Don't animate the view on orientation change the view disapears

    }catch (Exception e){
        e.printStackTrace();
    }

}

mPager.setCurrentItem(1, false); //Don't animate the view on orientation change the view disappears

	private String formName;
   
    public String getFormName() {
        return formName;
    }

    public void setFormName(String formName) {
        this.formName = formName;
    }

	String formData;

    public void setFormData(String data){
        this.formData = data;
    }

    public void loadFormData(){
        formData = formData != null ?  formData.replaceAll("\"","\\\"") : "";
        webView.post(new Runnable() {
            @Override
            public void run() {
                webView.loadUrl("javascript:loadDraft('"+ formData + "')");
            }
        });
    }

	
public class MyJavaScriptInterface {
    Context mContext;

    MyJavaScriptInterface(Context c) {
        mContext = c;
    }

    @JavascriptInterface
    public void showFormErrorToast(){
        // code to show an error message if the user attempts to save a form that contains errors 
    }

    @JavascriptInterface
    public void processFormSubmission(String formSubmission){
        showTranslucentProgressDialog();
        }

 ((SecuredNativeSmartRegisterActivity)getActivity()).saveFormSubmission(formSubmission, recordId, formName, getFormFieldsOverrides());
    }

@JavascriptInterface    @JavascriptInterface
    public void showFormErrorToastjavascriptLoaded(){
            //Toast.makeText(mContext, "Javascript formInputErrorMessageloaded", Toast.LENGTH_LONG).show();
        javascriptLoaded = true;
    }

 }   @JavascriptInterface
    public void @JavascriptInterface
savePartialFormData(String partialData){
       public void processFormSubmission(String formSubmission){
    //Toast.makeText(mContext, "saving un-submitted form data", Toast.LENGTH_LONG).show();
        ((SecuredNativeSmartRegisterActivity)getActivity()).saveFormSubmissionsavePartialFormData(formSubmissionpartialData, recordId, formName, getFormFieldsOverrides());
  
     }
  

}

	/**
 	*  Generates a form submision from a given xml input string
	*
 	* @param entity_id - id specified then the record with the given is used to preload non specified values
 	* @param formData - the xml input received from the form
 	* @param formName - the name of the form, determines which form definition we should load 
 	* @param overrides - the field overrides 
 	* @return
 	* @throws Exception
 	*/
	public FormSubmission generateFormSubmisionFromXMLString(String entity_id, String formData, String formName, JSONObject overrides) throws Exception{
        JSONObject formSubmission = XML.toJSONObject(formData);
        System.out.println(formSubmission);
        // use the form_definition.json to iterate through fields
        String formDefinitionJson = readFileFromAssetsFolder("www/form/" + formName + "/form_definition.json");
        JSONObject formDefinition = new JSONObject(formDefinitionJson);
        // ...
    }

	// ...

	/**
 	* Builds an xml input string that can be passed to an enketo form
 	* 
 	* @param entityId - the id of the entity being generated, if not null the record with matching id is used to generate the xml string
 	* @param formName - the name of the form being edited/displayed
 	* @param overrides - overrides for default field values 
 	* @return
 	*/
	public String generateXMLInputForFormWithEntityId(String entityId, String formName, String overrides){
    	try{
     		//get the field overrides map
   			JSONObject fieldOverrides = new JSONObject();
       		if (overrides != null){
        		fieldOverrides = new JSONObject(overrides);
        		String overridesStr = fieldOverrides.getString("fieldOverrides");
        		fieldOverrides = new JSONObject(overridesStr);
       		}
       		// use the form_definition.json to get the form mappings
            //...
    }