FS 311577 Additional Diagnosis Check Fields: Difference between revisions
From Calidus HUB
m (outline only) |
(v0.2 - Amended estimate) |
||
(3 intermediate revisions by the same user not shown) | |||
Line 4: | Line 4: | ||
{{#vardefine:System|''CALIDUS'' eSERV}} | {{#vardefine:System|''CALIDUS'' eSERV}} | ||
{{#vardefine:Doc_Title|Additional Diagnosis Check Fields}} | {{#vardefine:Doc_Title|Additional Diagnosis Check Fields}} | ||
{{#vardefine:Version|0. | {{#vardefine:Version|0.2}} | ||
{{#vardefine:Date| | {{#vardefine:Date|11th September 2013}} | ||
{{#vardefine:Reference| | {{#vardefine:Reference|311577 309371-11}} | ||
{{#vardefine:Year|2013}} | {{#vardefine:Year|2013}} | ||
</div> | </div> | ||
Line 27: | Line 27: | ||
== Solution Overview == | == Solution Overview == | ||
New fields will be added to the application to store some generic check-box information. These will be labelled in the product as required by the customer, and available on the "Diagnosis" tab. | |||
* "Revisit", | |||
* "Follow Up" | |||
* "Burner safe for use" | |||
== Scope == | == Scope == | ||
Line 46: | Line 50: | ||
= Functional Description = | = Functional Description = | ||
== Database and DAL == | == Database and DAL == | ||
The EPOD_SERVICE table will be modified to add the following new fields: | |||
* EPL_CHECKBOX_1, a single character text field. | |||
* EPL_CHECKBOX_2, a single character text field. | |||
* EPL_CHECKBOX_3, a single character text field. | |||
Existing packages will be modified to allow the creating, editing and selecting of the new fields, including but not limited to: | |||
* EPOD_SERVICE_INSERT | |||
* EPOD_SERVICE_JOB_SEARCH | |||
* EPOD_SERVICE_JOB_SELECT | |||
* EPOD_SERVICE_SELECT | |||
* EPOD_SERVICE_UPDATE | |||
The existing EPOD_SERVICE/SERVICE_JOB DAL object will be changed to: | |||
* Export the new fields in XML requests | |||
* Read the new fields | |||
{{Note}} It is not necessary to add this flag as a searchable item. However, if allowing this keeps the packages and DAL objects standard in design, then this can also be done, within the DAL and the packages. | |||
== Server == | == Server == | ||
EPOD_JOB_UPDATE Messages received (through the calidus_epod.asmx web service) must save the contents of the EPL_CHECKBOX_1/2/3 fields back to their respective fields on the database, through the modified DAL objects above. | |||
== Admin == | == Admin == | ||
The Job Group and Site screens (job_group.aspx and site_header.aspx respectively) will be modified to allow the system to be configured for: | |||
* Configuration of customer-specific Diagnosis entry: | |||
** Allow the values N - Disabled, Y - Enabled (SM Fleet), A - Enabled (ALS), L - Enabled (Lanemark). {{Note}} This can use the new LIST features in Admin for these values or can be hard-coded. | |||
The existing Add and Edit pop-ups will be modified to allow these new fields and values. The grid will be modified to show the new values allowed on the Service Report format. | |||
{{Note}} As part of other changes for this customer, the following changes will also be made: | |||
* Configuration of customer-specific Info entry: | |||
** Allow the values N - Disabled, Y - Enabled (SM Fleet), A - Enabled (ALS), L - Enabled (Lanemark). {{Note}} This can use the new LIST features in Admin for these values or can be hard-coded. | |||
The Service Details screen (service_detail.aspx) will be modified to: | |||
* Change labels and remove unwanted items from the Diagnosis section: | |||
** The Diagnosis field (EPL_DIAGNOSIS_NARRATIVE) is always displayed. However, the label should change to "Comments", SITE/JOB_GROUP EPL_SERVICE_DIAGNOSIS flag is set to L. | |||
** If the SITE/JOB_GROUP EPL_SERVICE_DIAGNOSIS flag is set to L, the three new check-boxes will be displayed with the labels as follows: | |||
*** EPL_CHECKBOX_1 - "Revisit", | |||
*** EPL_CHECKBOX_2 - "Follow Up" | |||
*** EPL_CHECKBOX_3 - "Burner safe for use" | |||
** If the SITE/JOB_GROUP EPL_SERVICE_DIAGNOSIS flag is set to L, no other fields will be displayed here. | |||
== Android Client == | == Android Client == | ||
The table EPOD_SERVICE will be modified as follows: | |||
* EPL_CHECKBOX_1, a single character text field. | |||
* EPL_CHECKBOX_2, a single character text field. | |||
* EPL_CHECKBOX_3, a single character text field. | |||
{{Note}} As the database structure is changing with this version, the default values must be carefully set and the database creation script modified to ensure that the standing data is re-downloaded from the server after the changes have been made. This is achieved by setting the "last version changed" variable (lngLastVersionDB) in DBConnection to the latest version number. | |||
The XML Export of service records will now look as follows: | |||
<SERVICE> | |||
<PREWORK> | |||
<EPL_PREWORK_INTERIOR></EPL_PREWORK_INTERIOR> | |||
<EPL_PREWORK_EXTERIOR></EPL_PREWORK_EXTERIOR> | |||
<EPL_PREWORK_ELECTRIC></EPL_PREWORK_ELECTRIC> | |||
</PREWORK> | |||
<POSTWORK> | |||
<EPL_POSTWORK_INTERIOR></EPL_POSTWORK_INTERIOR> | |||
<EPL_POSTWORK_EXTERIOR></EPL_POSTWORK_EXTERIOR> | |||
<EPL_POSTWORK_ELECTRIC></EPL_POSTWORK_ELECTRIC> | |||
</POSTWORK> | |||
<INFO> | |||
<EPL_UNIT_TYPE></EPL_UNIT_TYPE> | |||
<EPL_REG_NUMBER></EPL_REG_NUMBER> | |||
<EPL_VIN_NUMBER></EPL_VIN_NUMBER> | |||
<EPL_MILEAGE></EPL_MILEAGE> | |||
<EPL_SIM_NUMBER></EPL_SIM_NUMBER> | |||
<EPL_SPEC_REQUIRED></EPL_SPEC_REQUIRED> | |||
<EPL_SERVICE_GROUP></EPL_SERVICE_GROUP> | |||
<EPL_SYSTEM_TYPE></EPL_SYSTEM_TYPE> | |||
</INFO> | |||
<MC_REF> | |||
<EPL_MC_REF_1></EPL_MC_REF_1> | |||
<EPL_MC_REF_2></EPL_MC_REF_2> | |||
<EPL_MC_REF_3><EPL_MC_REF_3> | |||
<EPL_MC_REF_4></EPL_MC_REF_4> | |||
<EPL_MC_REF_NARRATIVE></EPL_MC_REF_NARRATIVE> | |||
</MC_REF> | |||
<DIAGNOSIS> | |||
<EPL_DIAGNOSIS_NARRATIVE></EPL_DIAGNOSIS_NARRATIVE> | |||
<EPL_CUSTOMER_DAMAGE></EPL_CUSTOMER_DAMAGE> | |||
<EPL_VNOS></EPL_VNOS> | |||
<EPL_CHECKBOX_1></EPL_CHECKBOX_1> | |||
<EPL_CHECKBOX_2></EPL_CHECKBOX_2> | |||
<EPL_CHECKBOX_3></EPL_CHECKBOX_3> | |||
</DIAGNOSIS> | |||
<PRODUCT> | |||
<EPL_PRODUCT_ID></EPL_PRODUCT_ID> | |||
<EPL_QUANTITY></EPL_QUANTITY> | |||
<EPL_DIRECTION></EPL_DIRECTION> | |||
<EPL_RETURN></EPL_RETURN> | |||
</PRODUCT> | |||
<ACTIVITY> | |||
<EPL_SITE_ID></EPL_SITE_ID> | |||
<EPL_SERVICE_ID></EPL_SERVICE_ID> | |||
<EPL_ACTIVITY_CODE></EPL_ACTIVITY_CODE> | |||
<EPL_QUANTITY></EPL_QUANTITY> | |||
</ACTIVITY> | |||
</SERVICE> | |||
New language tags should be added to any strings.xml files in the i18n (multi-lingual) folder, as follows: | |||
* <string name="Revisit">Revisit</string> | |||
* <string name="FollowUp">Follow Up</string> | |||
* <string name="BurnerSafe">Burner safe for use</string> | |||
These should be added to all languages' xml files found under the i18n folder. | |||
The Services screen, Diagnosis tab will be modified to add the three check-boxes as required for the customer. This will be done by adding them after checkboxes for SM Fleet (where vars.PDAJOBGROUP.EPL_SERVICE_DIAGNOSIS=="Y"), and in a similar fashion - they will be added only if vars.PDAJOBGROUP.EPL_SERVICE_DIAGNOSIS=="L". | |||
The checkboxes will be added in the same was as in the code now for CustDamCB. | |||
The labels for these items should be set as a generic text where the variable is created, for example, CheckBox1, Checkbox2, etc. They should also have a unique ID following the standard convention in the rest of the screen, for example "Service_CheckBox1LB". | |||
The style object should have the LANE section modified to set the text against the new checkboxes specifically for the customer, as follows: | |||
* Service_CheckBox1LB/Service_CheckBox1LB_land - property "text" should be set to Ti.App.style.getLabel("Revisit") | |||
* Service_CheckBox2LB/Service_CheckBox1LB_land - property "text" should be set to Ti.App.style.getLabel("FollowUp") | |||
* Service_CheckBox3LB/Service_CheckBox1LB_land - property "text" should be set to Ti.App.style.getLabel("BurnerSafe") | |||
{{Note}} This Style change should already have been made under change [[FS 311581 Diagnosis Narrative Extended Length]] - if this has not been completed, please check this specification for details. | |||
Additionally, further functions will be modified to check for the same condition (vars.PDAJOBGROUP.EPL_SERVICE_DIAGNOSIS=="L"), as follows: | |||
* saveService - modified to populate Lanemark-specific fields | |||
* validateService - modified to check for Lanemark-specific fields | |||
{{Note}} The existing code for vars.CustDamCB) must now be made conditional on vars.PDAJOBGROUP.EPL_SERVICE_DIAGNOSIS=="Y" or "A". | |||
<!-- MEDIA LANDSCAPE YES --> | <!-- MEDIA LANDSCAPE YES --> | ||
Line 62: | Line 181: | ||
|Title={{#var:Doc_Title}} | |Title={{#var:Doc_Title}} | ||
|Log={{#var:Reference}} | |Log={{#var:Reference}} | ||
|Description=To test | |Description=To test the entry and visibility of the additional check box fields in {{#var:System}} | ||
|MenuAccess=Services | |MenuAccess=Services | ||
|Prerequisites=None | |Prerequisites=None | ||
|Objective=To test that: | |Objective=To test that: Services configured for Lanemark allow entry of additional checkboxes, labelled as required; existing Services functionality remains unaffected. | ||
}} | }} | ||
{{TestPlan_CycleHeader | |||
|Cycle={{ #vardefineecho: Cycle | {{ #expr: {{ #var: Cycle }} + 1 }} }}{{ #vardefine: SubCycle | {{ #var: Cycle }} }} | |||
|Title=Admin | |||
|Notes= | |||
}} <!--INSERT TESTS HERE --> {{TestPlan_Test | |||
|Test={{ #vardefineecho: SubCycle | {{ #expr: {{ #var: SubCycle }} + 0.01 }} }} | |||
|Action=Check Site and Job Group screens, that the Lanemark option can be chosen against 'Diagnosis', saved and edited. | |||
|Result=The value can be selected, EPL_SERVICE_DIAGNOSIS is saved correctly and is editable. | |||
|Remarks= | |||
|PassFail= | |||
}} {{TestPlan_CycleFooter}} | |||
{{TestPlan_CycleHeader | {{TestPlan_CycleHeader | ||
|Cycle={{ #vardefineecho: Cycle | {{ #expr: {{ #var: Cycle }} + 1 }} }}{{ #vardefine: SubCycle | {{ #var: Cycle }} }} | |Cycle={{ #vardefineecho: Cycle | {{ #expr: {{ #var: Cycle }} + 1 }} }}{{ #vardefine: SubCycle | {{ #var: Cycle }} }} | ||
|Title=PDA Services | |Title=PDA Services | ||
|Notes=Ensure that the EPOD_JOB_GROUP flag EPL_SERVICE_DIAGNOSIS is set to "L". Create a service job and assign to a PDA user. | |||
}} <!--INSERT TESTS HERE --> {{TestPlan_Test | |||
|Test={{ #vardefineecho: SubCycle | {{ #expr: {{ #var: SubCycle }} + 0.01 }} }} | |||
|Action=Logon to the PDA start a service and move to the Diagnosis tab. | |||
|Result=The only fields available for entry are the three new fields and Diagnosis Narrative. The three new checkboxes are labelled as required. | |||
|Remarks= | |||
|PassFail= | |||
}} {{TestPlan_Test | |||
|Test={{ #vardefineecho: SubCycle | {{ #expr: {{ #var: SubCycle }} + 0.01 }} }} | |||
|Action=Set or unset the checkboxes and complete the service. | |||
|Result=The values are saved as Y or N in the EPOD database. | |||
|Remarks= | |||
|PassFail= | |||
}} {{TestPlan_CycleFooter}} | |||
{{TestPlan_CycleHeader | |||
|Cycle={{ #vardefineecho: Cycle | {{ #expr: {{ #var: Cycle }} + 1 }} }}{{ #vardefine: SubCycle | {{ #var: Cycle }} }} | |||
|Title=Admin (post) | |||
|Notes= | |Notes= | ||
}} <!--INSERT TESTS HERE --> {{TestPlan_Test | }} <!--INSERT TESTS HERE --> {{TestPlan_Test | ||
|Test={{ #vardefineecho: SubCycle | {{ #expr: {{ #var: SubCycle }} + 0.01 }} }} | |Test={{ #vardefineecho: SubCycle | {{ #expr: {{ #var: SubCycle }} + 0.01 }} }} | ||
|Action= | |Action=Check the Job in Admin Services and Jobs screen, showing the details. | ||
|Result= | |Result=The job should be completed. The details should show only the fields required by the set-up (i.e. the Diagnosis Narrative and the new Check Boxes). They should be labelled correctly. | ||
|Remarks= | |Remarks= | ||
|PassFail= | |PassFail= | ||
}} {{TestPlan_Test | }} {{TestPlan_CycleFooter}} | ||
{{TestPlan_CycleHeader | |||
|Cycle={{ #vardefineecho: Cycle | {{ #expr: {{ #var: Cycle }} + 1 }} }}{{ #vardefine: SubCycle | {{ #var: Cycle }} }} | |||
|Title=Regression tests | |||
|Notes= | |||
}} <!--INSERT TESTS HERE --> {{TestPlan_Test | |||
|Test={{ #vardefineecho: SubCycle | {{ #expr: {{ #var: SubCycle }} + 0.01 }} }} | |Test={{ #vardefineecho: SubCycle | {{ #expr: {{ #var: SubCycle }} + 0.01 }} }} | ||
|Action= | |Action=Set the value of the EPOD_JOB_GROUP flag EPL_SERVICE_DIAGNOSIS is set to other values ("A", "N", "Y"). Repeat the tests above to ensure that the system operated as it should under the other configurations. | ||
|Result= | |Result=As required by the other configurations. | ||
|Remarks= | |Remarks= | ||
|PassFail= | |PassFail= | ||
Line 103: | Line 258: | ||
|FS=0.25 | |FS=0.25 | ||
|TS=0 | |TS=0 | ||
|DEV= | |DEV=3.0 | ||
|ST=0.25 | |ST=0.25 | ||
|IMP=0 | |IMP=0 |