01 ERP Based Monitoring
01 ERP Based Monitoring
Keywords: ERP with GIS, GIS in Maritime Cargo Terminals, Port Facilities Maintenance, SVG for Interactive Maps.
Abstract:     The civil facilities in maritime cargo terminals must be maintained to prevent uninterrupted services in
              handling cargo as well as to defer the stoppage of the whole port supply chain. These facilities include
              wharves, yards, warehouse and piping, and all the components attached to these which are needed to support
              the port operations. Given the vast area of the maritime cargo terminals (a terminal may consist of several
              berths of which the area is 10-100 ha each), identifying the exact location of each facility with its current
              condition information is important for the decision makers to design proper repair actions for the damaged
              parts of the facilities. Hence, GIS is needed. ERP frameworks offer advantages that can be adopted in facilities
              maintenance system. However, GIS is not yet supported by the frameworks. This paper presents the design
              of the proposed ERP system with GIS module and its implementation. To facilitate interactive maps and to
              display high quality of maps on web browsers, Scalable Vector Graphics (SVG) format is adopted. The system
              has passed the user acceptance test and is used by the largest maritime cargo terminals in Indonesia.
bollard
warehouse fender
(c) The consequences associated with port                          The computerized information system (IS) is an
infrastructure failures due to insufficient maintenance        integrated set of people, processes, and mechanisms
can be enormous, not only causing a disruption at              for collecting, storing, and processing data using the
ports, but also a possible stoppage of the whole port          IT infrastructure to deliver an information toward a
supply chain. In other words, the condition of                 particular goal (Stair R. and Reynolds, 2014). Any
infrastructural performance affects the efficiency of          specific IS aims to support the operations,
port operations and associated sectors.                        management, and decision-making. ERP system is an
    The port infrastructures as well as the equipment          IS, and vice versa. However, GIS, which is a system
components attached to or existed on those                     designed to capture, store, manipulate, analyze,
infrastructures, which are significant in supporting           manage, and present spatial or geographic data, is
the port operations, must be maintained.                       usually not a part of the ERP systems.
                                                                   To provide an easy and fast development of ERP
2.2    ERP, Information Systems and                            systems, many vendors offer ERP frameworks. Each
       ERP Frameworks                                          framework comes with a lot of modules (Accounting,
                                                               CRM, HR, Marketing, MRP, Sale, etc.) that can be
The Enterprise Resource Planning (ERP) system is a             used as is or customized by developers to meet
set of software that is used to organize, define, and          organizations’ requirements. One of the available
standardize the business processes that are necessary          frameworks is ODOO.
to effectively plan and control an organization.                   ODOO is an ERP framework built upon a Model-
Essentially, ERP applications are a computer model             View-Controller (MVC) architecture (ODOO, 2017).
of organization business, embodying the products and           One of the primary goals of this architecture is to
processes, information flow, procedures, and                   separate the visual display of the information from the
relationships between functions and activities. Data           business rules and management of the underlying
analysis and reporting tools are also an essential part        data. With this architecture, the Model notifies the
of the system, allowing full exploitation of the broad         Controller of any data changes, and in turn, the
range of information that the system will manage.              Controller updates the data in the Views. The View
Another essential technology characteristic is the             can then notify the Controller of actions the user
Internet connectivity. Modern systems employ thin-             performed and the Controller will either update the
client, highly graphical and tailorable role-based user        Model if necessary or retrieve any requested data (see
interface (APTEAN, 2017).                                      Figure 2).
                                                                      user
                                          update                     action
(b)
                                                                 Wharf W6
                                                                 * Length : 300 m
                         W1                     Sea              * Construction:
                              W2
                                   W3                            Concrete
                                         W4                      .....
                    Y1                            W5
                               Y4                         W6
                         Y3
                    Y2                             Y5
                                        WH1
Figure 3: (a) Map of port civil facilities with its performance color; (b) Inspector click on a component layer map to pop up
the form.
At first, the map of a branch is displayed. Users can                                 an inspector (who has the duty to input the monitoring
select whether they want to display all layers or just a                              and inspection data), once the map of a facility is
layer. The map branch will include “mouse-over-                                       shown, the user may select the component layer then
able” and “click-able” objects of facilities. When an                                 the user click on a location/item, a form to input the
object is mouse-hovered, the information of the                                       item condition, pictures, and comment will pop up
object will pop up. If a facility object is clicked, the                              (Figure 3(b)). The user can fill the form and save it.
map of the facility will appear and replace the map of                                    To facilitate the interactive maps, the system
the branch. Every facility object as well as the                                      database store and manage the maps (SVG) of
component of a facility will be displayed in color                                    branches, which relates to their map of facilities. Each
representing its performance (e.g., green: ok, red:                                   facility map must relate to its component layers, each
damaged, grey: has not been observed). The branch                                     component must relate to its check items layers
as well as the facility page will also include its                                    (Figure 4). As described in Section 2.3, the ID of the
summary reports and KPI (Figure 3(a)). If the user is                                 SVG is used to relate between database tables.
                                        map layers of a
                                                                             map layers of wharf
                                           branch
                                                                                                        slab component with
                                                                                                           its check items
                                        wharf                                 beam
                                    yard                                   slab
                              warehouse                              fender
                                                                 bollard
                                                               background
                                                                                           fender component
                                                                                           with its check items
                     Figure 4: Map layers of branch, a wharf facility and component with its check item.
                                   Facility Maintenance                       Web                    Mobile
                                      ERP Module                             Services                 App
                                                                                                                     Inspector
              Users
FM Database
3.3     System Architecture                                                   taking facility pictures and inputting the component
                                                                              conditions using tablets that they carry while working
The proposed Marine Terminal Civil Facility                                   in the remote fields.
Maintenance (MTCFM) is built using the ERP
framework to take its advantages. The architecture is                         3.4       Use-case
depicted on Figure 5. It comprises of two main
modules:                                                                      The use-case describing features for each group of
(1) Facility Maintenance ERP Module: used by                                  users and features is depicted on Figure 6(a). The
several groups of users (inspector, branch                                    color in the ellipsis indicate whether the features are
administrator, branch manager, corporate division                             provided by the module that are customized from
head and director). This module is rich with features                         built-in ERP framework, interactive maps as well as
that are customized from the libraries provided by the                        customized or mobile app. The users access the
ERP frameworks as well as the ones designed with                              system via the organization Wide Area Network
interactive map capability.                                                   (WAN) using Internet browsers (Figure 6(b)). The
(2) Mobile App: used by facilities inspectors to                              reports that can be accessed by admin, manages and
download uninspected facilities, input, and upload the                        director include summary and detailed facilities
results of monitoring and inspections results. By                             conditions in every branch as well as branch and
using this app, inspectors have the advantage of                              facility KPIs.
(a)
(b)
                                                                                                         Director
                      manage
                                                                                  Data
                                        input monitoring                                                             Division
                      branches            & inspection                           Center
                                                                                                                     Director
                                           acitivities
                                                                                                    Organization
                      manage                                     Inspector
                                                                                                       WAN
   Super              facilties
                                         check & correct                     Database App
   Admin                                                                                                             Super
                   manage
                                          monitoring &                        Server Server
                                         inspection data                                                             Admin
                    users
                                                                  Branch
                                              input               Admin
                                                                                                               Branch
                    view                  maintenance
                                        actions & finalize                                                     Manager
                   reports                                                              Inspector    Branch
  Director
                                                                 Branch                              Admin
                                                                 Manager
                        : Customized from built-in modules
Figure 6: The use-case (a) and system accessed via WAN (b).
As discussed in Subsection 2.2, an ERP module                                 data, views definitions (e.g., how data from specific
consists of data models, together with some initial                           data models should be displayed to the user), wizards
(specialized screens to help the user for specific                  Facility(IdFac,        name,          facility_plan_svg,
interactions) and reports. The users interact with the                  IdBr(refering     to     Branch(IdBr),       …other
system via a client (e.g., web browser).                                atributes); //the file of facility_plan_svg also
                                                                        contains component type layers (in the case of
3.5      System Design                                                  wharves: slabs, beams, fenders, bollards, etc)
                                                                        along with its components or object check items
Based on the ODOO architecture, the proposed ERP                        (in the case of wharf slabs, they are the element of
system can be seen in Figure 7. The clients can be                      slab construction).
categorized into two modules:                                       FacMapLayer(Svg_Id, name);
(a) Customized from built-in client side ODOO                       FacComponent(IdFC,           name,         svg_layer_id,
module: it issues a request to the server and display                   IdBr(refering     to     Branch(IdBr),       …other
the result (e.g., a list of facilities) in different manners            atributes);
(as forms, lists, etc.). Upon user actions (on the menus            FacCheckItem(IdFCI,            name,           svg_code,
or forms), it will send modified data to the server.                    IdFC(refering to FacComponent (IdFC), …other
(b) “Wizards” module that provides interactive maps:                    atributes);
this client module is developed using CSS, Ajax, and                (Database tables and their attributes are conformed
JavaScript for HTML 5. Libraries for SVG map                            with the model classes, depicted on Figure 8.)
display are used as well. This wizard displays maps                     Other database tables for storing master data
with layers that can be selected and has objects that               (facility type, users, etc.), facility weights (for
can be mouse-hovered as well as clicked to get the                  computing KPI), many kinds of monitoring and
object information or to pop-up forms (used to input                inspection transactions, repair activities are also
data) if the user is the field inspector. This module               designed and implemented.
also computes the facilities condition summary and
KPIs, and displays the results in the dash-boards.                  The Classes in the Model Module: The design of the
                                                                    main classes representing the branch, facilities and
                                                                    their component is shown in Figure 8. There are other
                     Customized Built-in
                                                    Interactive     classes that are not presented in this figure, such as
                                                   Map Module:
                       ERP Module:                 Maps, Forms,     classes that manage users, handle various transactions
                      Forms, Client logics, -      Client logics,
    Client            Reports, Dashboards            Reports,       (inputting/updating data of facility monitoring and
 (Web Browser)                                     Dashboards       inspection activities, facility status, etc.).
                                                                             Branch            BranchMapLayer
                              Web Services, Base            FM
      Server                  Module, ORM and                         name: char []            name: char[]
                                                           Module     map_svg: binary          svg_id: char[]
                                   Engine                             kpi_condition: float
               FM Database
                                                                      kpi_checking: float
                                                                      .. ..
                                                                      create
                                                                      write                      FacMapLayer
       Figure 7: Facility maintenance (FM) modules.                   parse_branch_map_svg
                                                                      get_branch               name: char[]
                                                                      .. ..                    svg_id: char[]
   warehouses, and piping that existed in the branch                         Figure 8: Class diagram related to maps data.
   port/terminal area).
BranchMapLayer(Svg_Id, name, IdBr(refering to
   Branch(IdBr));                                                   Figure 8 shows that an object of branch has one or
                                                                    more objects of branch map layer, a branch map layer
has one or more objects of facility, a facility has one      write (update): Parse, check, clean the facility SVG
or more objects of facility map layer, a facility map        (if reuploaded), get the values as in create method
layer has one objects of facility component, an object       then overwrite if exists, insert if not exist, delete the
of Facility also have one or more facility component,        old objects (component types, components) that are
a facility component type consist of one or more             no longer existed in the new SVG.
components or objects of checkItems (as illustrated in       webservice_handle: Get records of a facility, its
Figure 4). The description of classes and their main         component types and components with all of their
methods are as follows:                                      status construct as a complex object and return. The
                                                             records can be filtered by list_Ids or user_Id.
class Branch: Handle branches and their map of                   The data files (see Subsection 2.2) containing
branch.                                                      XML files declaring metadata (views or workflows)
Methods:                                                     and configuration data (modules parameterization)
create: Parse, check, clean the branch SVG file and:         are declared accordingly such that they can be used
(1) Get/extract branch ID, branch_name; (2)                  by functions in accessing, computing and displaying
Get/extract identity <g id= ….> </g> that relates to         the database content.
branch_map_layer (background, wharf, yard,                       Folder static: contains CSS describing the style of
warehouse, pipe) and extract Id, name of every               the HTML documents, JavaScript source code for
facility type/group; (3) From group of svg code              client logic (computing report and dash-board
representing a layer of wharf, yard, warehouse, pipe         material) and handling interactive maps as well as the
(<g id= ….> </g> ), parse and extract: ID, name and          non-map pages (by using styles defined in CSS),
type (wharf, yard, warehouse, pipe), coordinates and         XML describing lots of HTML classes used in the
shape boundary            of every facility objects          CSS, and Lightbox JavaScript libraries (to manage
resided/existed on the background layer; (4) Save the        images display).
branch SVG along with all those extracted values the             The Navigation of Interactive Map: A menu
database tables Branch, BranchMapLayer and                   “Monitoring & Inspection” (in FM ERP Module) is
Facility accordingly.                                        specifically provided for moving or navigating to
write (update): Parse, check, clean the branch SVG           pages (of the wizard module) with map interactivity
file (if reuploaded) and extract branch ID,                  capability. When that menu is clicked, a page with
branch_name, branch_map_layer and ID, name and               visual reports of every branch is displayed. Then,
type (wharf, yard, warehouse, pipe), coordinates and         when a branch report is clicked, the branch map along
shape boundary            of every facility objects          with its filter widgets (to select month, year, facility
resided/existed on the background layer and update           type layer, condition, monitoring or inspection, report
the values in the database tables or insert the values       and dashboard for this branch) is displayed (Figure
(branch_map_layer and facility objects on the                9). Furthermore, if users hover on a facility object,
background layer) if they do not exist. Delete the           the information of this facility will be popped up.
layer and its facility objects that no longer exist in the   Then, by clicking an object (a wharf, a yard, a
updated branch SVG.                                          warehouse, or a pipe) on the branch map, the
                                                             corresponding facility with its filter widgets (to select
class Facility: Handle facilities and their maps.            the month, the year, the component type layer, the
Methods:                                                     condition, the monitoring or inspection, the report for
create: Parse, check, clean the facility SVG file and:       this facility) is displayed (Figure 10). When a user
(1) Get/extract facility_name; (2) Get/extract identity      clicks on a component: if the user is a field inspector,
<g id= ….> </g> that relates to fac_map_layer (for           a form for entering the monitoring/inspection results
wharf, i.e. slabs, bollard, fender, etc) and extract Id,     will be popped up; if other user, a report of
of every facility component. Extract ID of every             monitoring/inspection for the corresponding
layer; (4) From svg code group (<g id= ….> </g> )            component at the selected month-year, will be popped
representing a component type layer of facility (for         up.
wharf, they are slabs, bollard, fender, etc), parse and          Hence, there are two pages designed with
extract ID, coordinates and shape boundary of every          interactive map, which are branch and facility page.
item objects resided/existed on the component layer;         These wizard pages are designed with: (a) JavaScript
(5) Save the facility SVG along with all those               functions that display/render the map and all of the
extracted values in the database tables Facility,            widgets (for filtering and to be clicked), and lots of
FacMapLayer          and       FacComponent         and      on-hover, on-button/mouse-click, on-mouse-out, on-
FacCheckItem.                                                change of combo check-box, on-change of drop-
down list functions, drawing objects in dash-board                                    side and button filter (Monitoring and Inspection) at
(monitoring and inspection charts, monthly-time-                                      the top right, report dashboard, menu (at the left side)
series charts, etc. ; (b) CSS definitions: describing the                             and map with layer selection (top). Zooming the map
styles for those 2 pages; (c) XML definitions: many                                   will display a clearer map, and mouse-over on a
HTML classes used in the CSS.                                                         facility object displays its information (bottom).
                                                                                      (b) Figure 10: By clicking on a facility object on the
                                                                                      map branch, the facility map with its dashboards,
4    IMPLEMENTATION                                                                   filter (top), menu (left), dashboard (right) and
                                                                                      component-type layer selection (bottom) are
                                                                                      displayed (b); the results of monitoring/inspections of
The designed have been implemented and the results
are presented with sample of screenshots below:                                       a facility item component can be inputted by clicking
                                                                                      on a layer of facility or text-based (a.2); the detailed
(a) Figure 9: the window of a branch with its drop-
                                                                                      report of monitoring transaction report (including the
down filter (month-year and condition) at the top left
                                                                                      pictures of damaged facility component items).
Jimbara
                   Jimbara
                                                                Duk u Wha rf
       Figure 9: Map of a branch (top) and its zoom with its layers selection, dashboard and mouse over on a wharf.
                                                   (a.1)
                                                                                            (a.2)
                                                   Jimbara
Jimbara/Wharf 215
                                    Query filter
     Menu
(b)
Figure 10: (a.1) Text-based form; (a.2) Map-based form (form pop-ups by clicking a location on the background map); (b)
The slab layer map after bad condition (red) is saved by form (a.1) or (a.2).
ACKNOWLEDGEMENTS
We would like to thank PT Pelabuhan Indonesia II
for funding this project.
REFERENCES
Alderton, P. M., 2008. Port Management and Operations,
    Informa. London.
Eisenberg, J. D., 2002. SVG Essentials, O'Reilly Publ.,
    USA, 1st ed.
Food and Agriculture Organization (FAO) of The United
    Nations, 2013. Advances in Geographic Information
    Systems and Remote Sensing for Fisheries and
    Aquaculture. Rome, Italy.
International Navigation Association (INA), 1998. Life
    Cycle Management of Port Structures General
    Principles. Report of Working Group No. 31 of the
    Permanent Technical Committee II. PIANC General
    Secretariat, Brussels, Belgium.