Systems documentation techniques - Chapter 3

 

Documentation encompasses the narratives, flowcharts, diagrams, and other written materials that explain how the system works. This information covers the who, what, when, where, why, and how of data entry, processing, storage, information output, and system controls. Popular means of documenting a system include diagrams, flowcharts, tables, and other graphical representation of information. These are supplemented by a narrative description of the system, a written step by step explanation of the system components and interactions. In this chapter, we explain two common systems documentation tools: data flow diagrams and flowcharts.

Documentation tools are important on the following levels:

  1. At a minimum, you must be able to read documentation to determine how the system works.

  2. You may need to evaluate internal control systems documentation to identify strengths and weaknesses and recommend improvements.

  3. More skill is needed to prepare internal control documentation or documentation that shows how an existing or proposed system operates.

This chapter discusses the following documentation tools:

  • Data flow diagram (DFD). This is a graphical description of data sources, flows, processes, storage and destinations.

  • Document flowchart. This is a graphical description of the flow of documents and information between departments or areas of responsibility.

  • System flowchart. This is a graphical description of the relationship among the input, processing, and output in an information system.

  • Program flowchart. This is a graphical description of the sequence of logical operations a computer performs as it executes a program.

Accountants use documentation techniques extensively. Auditing standards require that independent auditors understand the automated and manual internal control procedures an entity uses. One good way to gain this understanding is to use flowcharts to documents the internal control system, because such graphic portrayals more readily reveal weaknesses and strengths.

Documentation tools are also used extensively in the system development process. In addition, the team members who develop information systems applications often change, and documentation tools help the new team members get up to speed quickly.

The documentation tools in this chapter are used throughout the book. They are also tested on professional examinations, and learning about them better prepares you for these examinations.

A data flow diagram (DFD) graphically describes the flow of data within an organization. It uses the symbols to represent the four basic elements: data sources, data flows, transformation process, and data stores.

A data source and data destination are entities that send or receive data that the system uses or produces. An entity can be both a source and a destination. Data sources and destinations are represented by square boxes. Data destinations are also referred to as data sinks.

A data flow is the movement of data among the processes, stores, and destinations. It is the flow of the data into or out of a process represented by curved or straight lines with arrows. Data that pass between data stores and a source or destination must go through a data transformation process. Data flows are labelled to show what information is flowing the only exception is data flow between a process and a data store. If two or more data flows move together, a single line is used.

Processes represent the transformation of data. An transformation process is the process that transform data from inputs to outputs are represented by circles. They are often referred to as bubbles.

A data store is a repository of data. Data flow diagrams do not show the physical storage medium used to store the data. The storage of data is represented by two horizontal lines, with the name of the file written inside the lines.

DFD’s are subdivided into successively lower levels to provide ever-increasing amounts of detail, because few systems can be fully diagrammed on one sheet of paper. The highest level DFD is referred to as a context diagram, because it provides the reader with a summary-level view of a system. It depicts a data processing system and the entities that are the sources and destinations of system inputs and outputs.

Example.

There are a few activities and data flows in a payroll process.

Activities

Data inputs

Data outputs

Update employee/ payroll file

New employee form

Employee change form

Updated employee/ payroll file

Pay employees

Time cards

Employee/ payroll file

Tax rates table

Employee checks

Payroll register

Updated employee/ payroll file

Payroll check

Payroll cash disbursements voucher

Prepare reports

Employee/ payroll file

Payroll report

Pay taxes

Employee/ payroll file

Tax report

Tax payment

Payroll tax cash disbursements voucher

Updated employee/ payroll file

Update general ledger

Payroll tax cash disbursements voucher

Payroll cash disbursements voucher

Updated general ledger

A flowchart is an analytical technique used to describe some aspect of an information system in a clear, concise, and logical manner. Flowcharts use a standard set of symbols to describe pictorially the transaction processing procedures a company uses and the flow of data through a system.

Flowcharting was introduced by industrial engineers in the 1950s as a way of recording how business processes are performed and documents flow and analysing how to improve processes and document flows.

Flowcharts have significant advantages. A pictorial representation is much easier to understand than a narrative description. Both the auditor and the business owner can use the flowchart as a working tool during discussions. For an experienced flowcharter using a computerized drawing tool, flowcharts provide an easy wat to capture and record data during interviews, and they can be easily and quickly revised.

Flowcharts also do have some disadvantages. Some people do not like or understand them. Many are poorly drawn and therefore not as helpful as they should be. They are time-consuming to prepare if the flowcharter is not trained properly.

Flowcharting symbols are divided into four categories:

  1. Input/output symbols represented devices or media that provide input to or record output from processing operations.

  2. Processing symbols show what types of devices used to process data or indicate when processing is performed manually.

  3. Storage symbols represent the devices used to store data.

  4. Flow and miscellaneous symbols indicate the flow of data, where flowcharts begin or end, where decisions are made, and when to add explanatory notes to flowcharts.

See figure 3.8 page 76 and page 77 for an overview of the common flowcharting symbols.

A document flowchart illustrates the flow of documents and information among areas of responsibility within an organization. They trace a document from its cradle to its grave, showing where each document originates, its distribution, its purpose, its disposition, and everything that happens as it flows through the system.

A document flowchart is particularly useful in analysing internal control procedures.

Document flowcharts that describe and evaluate internal controls are often referred to as internal control flowcharts. They can reveal system weaknesses or inefficiencies.

System flowcharts depict the relationships among system input, processing and output. A system flowchart begins by identifying system inputs and their origins. The input is followed by the processing performed on the data. The resulting new information is the output component, which can be stored for later use, displayed on a screen, or printed on paper.

System flowcharts are an important systems analysis, design and evaluation tool. A system flowchart begins by identifying system inputs and their origins. The input is followed by the processing performed on the data. The resulting new information is the output component, which can be stored for later use, displayed on a screen, or printed on paper. In many instances, the output from one process is an input to another.

System flowcharts are an important system analysis, design, and evaluation tool. They are universally employed in systems work and provide an immediate form of communication among workers. The system flowchart is an excellent vehicle for describing information flows and procedures within an accounting information system.

Program flowcharts illustrate the sequence of logical operations performed by a computer in executing a program. A program flowchart describes the specific logic used to perform a process shown on a system flowchart. Program flowcharts employ a subset of the symbols shown in figure 3.8. once designed and approved, the program flowchart serves as the blueprint for coding the computer program.

Heb je niet de volledige tekst in beeld, log dan eerst in
 

Aansluiten bij JoHo als abonnee of donateur

The world of JoHo footer met landenkaart

    Aansluiten bij JoHo met een JoHo abonnement

    JoHo abonnement (€20,- p/j)

    • Voor wie online volledig gebruik wil maken van alle JoHo's en boeksamenvattingen voor alle fases van een studie, met toegang tot alle online HBO & WO boeksamenvattingen en andere studiehulp
    • Voor wie gebruik wil maken van de gesponsorde boeksamenvattingen (en er met zijn pinpoints 10 gratis kan afhalen in een JoHo support center of bij een JoHo partner)
    • Voor wie gebruik wil maken van de vacatureservice en bijbehorende keuzehulp & advieswijzers
    • Voor wie gebruik wil maken van keuzehulp en advies bij werk in het buitenland, lange reizen, vrijwilligerswerk, stages en studie in het buitenland
    • Voor wie extra kortingen wil op (reis)artikelen en services (online + in de JoHo support centers)
    • Voor wie extra kortingen wil op de geprinte studiehulp (zoals tentamen tests en study notes) in de JoHo support centers

     of met een JoHo donateurschap

    JoHo donateurschap (€5,- per jaar)

    • Voor wie €10,- korting wil op zijn JoHo abonnement
    • Voor wie JoHo WorldSupporter en Smokey projecten wil steunen
    • Voor wie gebruik wil maken van alle gedeelde materialen op WorldSupporter
    • Voor wie op zoek is naar de organisatie bij een vacature

     

    Aanmelden & Aansluiten bij JoHo 

    Spotlight: partners met impact

    Partnerselectie: inspiratie & activiteiten in binnen- en buitenland

    Wereldstage & Wereldjob

    Wereldstage is actief op Curaçao en helpt je aan betaald werk, stages, vrijwilligerswerk en de invulling van een 'gap programma'. Ze organiseren voor alle leeftijden programma's van een paar weken of langer, waarbij je erachter komt welke toekomst bij jou past. Lokale initiatieven worden gesteund door vrijwilligers te plaatsen, en financieel bij te dragen aan de vele goede doelen op Curaçao.

    Dutchies Travel

    Dutchies Travel is dé plek om reisplannen, ideeën en dromen van alle Dutchies (en hun vrienden) ter wereld te ontwikkelen! Door hun passie & liefde voor reizen te delen met de Nederlandse community creëren ze unieke en volledig op maat gemaakte droomreizen.
    Ze geven gratis advies over reizen in Australië, Nieuw-Zeeland, Fiji, Canada en hun andere bestemmingen. Ze helpen je bij het maken van je reisplannen, en bij het kiezen en regelen van tours en activiteiten die het beste bij jou passen.

    Vrijwillig Wereldwijd

    Vrijwillig Wereldwijd is een kleinschalige organisatie die de mooiste lokale projecten in meer dan 10 landen ondersteunt op de continenten: Afrika, Zuid-Amerika, Azië en Europa. Ze zijn er van overtuigd dat vrijwilligerswerk in het buitenland kan leiden tot een geweldige win-win situatie. Door middel van een goede begeleiding en jarenlange ervaring doen ze er alles aan doen om deze belofte waar te maken. Dit omdat ze op deze manier de wereld een stukje mooier willen maken en mensen willen inspireren.

    Snowminds

    Bij Snowminds deelt het volledige team dezelfde passie: Sneeuw! Iedereen in het team heeft winterseizoenen gedaan, uiteenlopend van één winterseizoen tot meer dan negen. Snowminds begeleidt haar ski- en snowboardleraren van de reis tot skipas, van het hotel tot je contract. Bij Snowminds volgt iedereen basis- en vervolgopleidingen om uiteindelijk zo goed voorbereid mogelijk de verschillende skiculturen ter wereld te kunnen ervaren én de Snowboard gasten van dezelfde passie te laten genieten.

    Pakachere

    Pakachere is een backpackershostel en creatief centrum in Malawi, opgericht door twee Nederlanders. De plek doet dienst als een ontmoetingsplek, waar mensen samen kunnen komen voor workshops, activiteiten of om gewoon een drankje te doen.

    Oneworld

    OneWorld is de grootste Nederlandse website over mondiale verbondenheid en duurzaamheid. Naast de website OneWorld.nl geeft de organisatie ook een aantalk keer per jaar het tijdschrijft OneWorld uit!

      Chapters 

    Teksten & Informatie

    JoHo: paginawijzer

    Hoe werkt een JoHo Chapter?

     

    Wat vind je op een JoHo Chapter pagina

    •   JoHo Chapters zijn tekstblokken en hoofdstukken rond een specifieke vraag of een deelonderwerp

    Crossroad: volgen

    • Via een beperkt aantal geselecteerde webpagina's kan je verder reizen op de JoHo website

    Crossroad: kiezen

    • Via alle aan het chapter verbonden webpagina's kan je verder lezen in een volgend hoofdstuk of tekstonderdeel.

    Footprints: bewaren

    • Je kunt deze pagina bewaren in je persoonlijke lijsten zoals: je eigen paginabundel, je to-do-list, je checklist of bijvoorbeeld je meeneem(pack)lijst. Je vindt jouw persoonlijke  lijsten onderaan vrijwel elke webpagina of op je userpage
    • Dit is een service voor JoHo donateurs en abonnees.

    Abonnement: nemen

    • Hier kun je naar de pagina om je aan te sluiten bij JoHo, JoHo te steunen en zelf en volledig gebruik te kunnen maken van alle teksten en tools.

    Abonnement: checken

    • Hier vind je wat jouw status is als JoHo donateur of abonnee

    Aantekeningen: maken

    • Dit is een service voor wie bij JoHo is aangesloten. Je kunt zelf online aantekeningen maken en bewaren, je eigen antwoorden geven op tests, of bijvoorbeeld checklists samenstellen.
    • De aantekeningen verschijnen direct op de pagina en zijn alleen voor jou zichtbaar
    • De aantekeningen zijn zichtbaar op de betrokken webpagine en op je eigen userpage.

    Prints: maken

    • Dit is een service voor wie bij JoHo is aangesloten.  Wil je een tekst overzichtelijk printen, gebruik dan deze knop.
    JoHo: footprint achterlaten