Distribution Network practical example

This example shows how to generate two forms that are linked. There is a schedulable hydrant test form, with a button linking to another hydrant test form.

Prerequesites

You will need to log in as an Administrator or System Administrator.

The network must be a Distribution network.

Scheduling must be enabled for the current application.

The default Ask about marking the form as "In Development" option must be enabled in the Options dialog.

Hydrant Test Extended Form

  1. Select New from the Forms group of the Forms tab.
  2. Ensure that the Default tab is in focus.

    Tip: By default, you can make a Default form and an Android version of the Default form. As the Default Form toolbox on the Android tab is only populated with the InfoAsset Manager Collect/Asset/Distribution system toolbox items when they are added to the Default form, it may be more useful to create the Default version first.

  3. Expand the Distribution tree and scroll down to the Hydrant test extended item.
  4. Expand the Hydrant test extended item.
  5. Drag and drop the following controls onto the form layout:
  6. ClosedShow image

    Designing a Hydrant Test extended form

  7. Click the cursor outside of the object boxes on the form layout to display design options that apply to the entire form.
  8. Set the following options within the Property Box:
    1. Enter a Title of Form Hydrant Test Extended_DDMMYY -ClosedThis is the title given to the form and can be seen across the top of the current page.
    2. Enter a Saved Report Title of Report Hydrant Test Extended_.
    3. Click the ellipsis button to bring up the Label Editor.
    4. Place the cursor at the end of the Report Hydrant Test Extended_ text.
    5. Select <Current Short Date & Time> from the Available Controls dropdown list, then click the Insert button.

      The label becomes Report Hydrant Test Extended_{<Current Short Date & Time>}-Closed This is the title given to the reports that will use this form as a template.

    6. ClosedShow image

      Setting up a customised report title

    7. Click OK on the Label Editor.
  9. Select Save from the Form group of the Form tab.

    A message is displayed.

    ClosedShow image

    In Development flag warning message

  10. Click Yes.

    Refer to About marking forms as In Development for more information about this flag.

    The Property Box will now display the entered information for the form.

  11. ClosedShow image

    Form properties

    By default, the form you have created could be used on both a Windows and an Android device. However, it is possible to create an Android version of this form that is perhaps more suitable for display on an Android device.

  12. To create an Android version of the Default form:
    1. Click the Android tab. The blank form for the Android version is displayed in the layout pane.
    2. Click the Default Form Toolbox tree to expand the items contained in the Default version of the form. This will include the items selected in step 5 as well as any hidden items.

      ClosedShow image

      Blank Android Form

    3. Repeat step 5 to add the items to the Android form.
    4. Select Save from the Form group of the Form tab.
  13. On the quick access toolbar, select Publish Application (Publish application).

    InfoAsset Mobile checks the application for In Development forms. If any are found, a message is displayed offering you the option to clear the flags before publishing. 

  14. Click Yes.

    The Publish Application dialog is displayed:

  15. Select Publish and then OK to confirm -Closed This will allow other users out in the field to view the newly createdDefault or Android form (depending on which platform is being used) and use it to generate reports . Both the Default and Android forms will be published.

Hydrant Test Form - example of schedulable form

We are now going to illustrate how to create a schedulable form.

  1. Select New from the Forms group of the Forms tab.
  2. Set the Platform option (located on the Form section of the Property Box) to Windows.

    A message is displayed informing you that the Android version of the form will be deleted. As this example is only going to illustrate how to create the Windows version of the Default form, click the OK button. The Android tab is then removed from the Toolbox.

  3. Expand the Distribution tree and scroll down to the Hydrant test item.
  4. Expand the Hydrant test item.
  5. Drag and drop the following controls onto the form layout:
  6. Scroll up and right-click to expand the Toolbox tree item.
  7. Double-click the Button control in the list.

    A New Button object appears on the form.

  8. ClosedShow image

    Adding a button to a form

  9. Double-click the button to reveal the Button Editor and highlight the New Button label in the list.

    ClosedShow image

    Configuring the button - 1

    1. Enter a Label of Hydrant Test Extended Report-ClosedThis will display on the newly created button
    2. From the Action dropdown list, select New Report.
    3. From the Using dropdown list, select the form created in the pre-conditions: Form Hydrant Test Extended_DDMMYY .
    4. ClosedShow image

      Configuring the button - 2

    5. Select OK to save these changes.

    The Button now has our custom label.

  10. ClosedShow image

    Button with customised label

  11. Click the cursor outside of the object boxes on the form layout to display design options that apply to the entire form.
  12. ClosedShow the options in the Property Box

    Form properties

  13. In order to create a scheduled event, the following design options must be set:
    1. Scheduled Date Field -Closed The date field opted for here is the date field that will be used for scheduling.
    2. Select the adjacent ellipsis button to reveal the Date to Use dialog.
    3. ClosedShow image

    4. Select Date /Time Planned and click OK. The Date to Use dialog closes.

      This automatically changes Enable Scheduling to True.

    5. ClosedShow image

      It is also useful to set the following options within the Property Box:

    6. Scheduled Duration Default -ClosedThis illustrates the amount of time allocated for the Test/Survey or Incident and is defaulted to 4:00 (4hrs) however this can be increased or reduced as appropriate.

      Select the adjacent dropdown arrow adjacent to reveal the numeric field and enter 3hrs (03:00), for example.

    7. ClosedShow image

      Scheduled Duration Default property change

    8. Schedule Title -Closed The title that will appear in the scheduler view

      Select the adjacent ellipsis button to reveal the Label Editor.

      Either type the beginning of a title in the Label box and select a value from the Available Controls dropdown box or compose a title. For the purpose of this example type in the title Hydrant Test Schedule_ in the Label field. Place the cursor at the end of this text, select <Current Short Date & Time> in the Available Controls, then click the Insert button to add it to the typed text. Click OK.

    9. ClosedShow image

      Label for Hydrant Test Schedule

    10. Scheduled Resource Field -ClosedThe field to use for scheduling resource.

      Select the adjacent ellipsis button to reveal the Resource to Use dialog.

      Choose Team leader and select OK.

    11. ClosedShow image

      Scheduled Resource To Use dialog

  14. Enter a Title of Form Hydrant Test_DDMMYY -ClosedThis is the title given to the form and can be seen across the top of the current page.
  15. Enter a Saved Report Title of Report Hydrant Test_and then use the ellipsis button to add dynamic data to the title, such as <Current Short Date & Time>. Refer to here for details on how to achieve this.-ClosedThis is the title given to the report.
  16. Select Save from the Form group of the Form tab.

    A prompt message related to the In Development flag may be displayed.

  17. Click Yes.

    The Property Box will now show information for the form.

  18. ClosedShow image

    Properties

  19. On the quick access toolbar, select Publish Application (Publish application).

    A message relating to the In Development flag may be displayed.

  20. Select the option clearing the flag for the form. See About marking forms as In Development for more information.

    The Publish Application dialog is displayed:

  21. Select Publish and then OK to confirm -Closed This will allow other users out in the field to view the newly created form and use it to generate reports.

Generating reports from the forms

We are now going to mimic what users in the field would do (that is, create new reports from the forms that have been set up in the office). Typically, in the field, users would refresh the application so that any new or edited forms related to the application would get downloaded onto the systems.

  1. Choose the newly created schedulable form on the Forms tab and select New from the Reports group.
  2. Complete all of the fields; enter tomorrow’s date in the Date / Time Planned field.
  3. ClosedShow image

    Filling in the form and accessing the linked form

  4. Select the Hydrant Test Extended Report button -ClosedThis will launch the associated Hydrant Test Extended report created in the first section of this topic.
  5. Enter data into each of the fields.
  6. Click Complete.

    The user is taken back to the first report (Report Hydrant Test_DDMMYY).

  7. Click Complete.

    The report closes.

  8. Select the Schedule tab.

    The Hydrant Test Schedule report appears on the calendar for the selected resource (Team Leader 1) on tomorrow’s date, in green as the report has been completed.

  9. ClosedShow image

    Schedule appearing on the Schedule View for the specified resource

    Tip: If a report for a Test, Survey or Incident is saved at this stage and has a future date/time then it will display in white, if it is scheduled for a date/time that has already passed it will display in red.

    Several options are available directly from the Hydrant Test Schedule Report in the scheduler by right-clicking on the item to display the context menu:

    • View Report - the report will display in read-only format
    • Edit Report - the report will displayed in editable format. If you edit the report at this stage, you will be warned that the report has not been uploaded and that any changes you make will overwrite the existing data.
    • View report history... - useful to browse through the history of the selected report, with details of existing versions. Older versions can be downloaded using the Report History dialog.
    • View on map - This option is available if the application is map-enabled. Click this button to centre the map view on the exact location of the report.
    • Tooltip giving the report status ("To Upload").
  10. Select Upload from the Reports group of the Synchronize tab.
  11. Ensure the checkboxes are ticked against the reports that are to be uploaded and click Upload.
  12. ClosedShow image

    Upload reports

    This will upload the reports to the server and transfer the data to InfoAsset Manager.

  13. Click OK on the confirmation message telling you that the upload has been successful.

Checking that the changes have been uploaded to InfoAsset Manager

In InfoAsset Manager:

  1. Select the appropriate Distribution network.
  2. Right-click the network in the tree view and choose Update (get changes made by others).
  3. Select Windows | Grid windows | New survey window.
  4. Select the Hydrant Test tab.

    The Hydrant Test object created via InfoAsset Mobile should appear.

  5. Right-click the hydrant test in the grid and select Properties to view its properties.
  6. Check that the data entered in the InfoAsset Mobile report are displayed where appropriate. For example, for the Report Hydrant Test Extended _DDMMYY report, look in the User text, User num tabs or General properties section , and the Notes tab or User defined properties section.

    Notes:

    • The location of the property values in InfoAsset Manager depends on the option - selectable in InfoAsset Manager - for displaying Property Sheets (old-style property sheet or Object Properties Window).
    • You will notice that the Mobile identifier field is populated for the Hydrant Test object, indicating that this object has been imported into InfoAsset Manager from InfoAsset Mobile.

Form examples

Collection Network practical example