1. Copyright © 2015 Pearson Education, Inc. Systems Documentation Techniques Chapter 3 3-1

2. Copyright © 2015 Pearson Education, Inc. INTRODUCTION In this chapter, we discuss two of the most common documentation tools: ▫Data flow diagrams ▫Flowcharts Include three types: –Document flowcharts describe the flow of documents and data between departments or units. –System flowcharts describe the relationship between inputs, processing, and outputs for a system. –Program flowcharts describe the sequence of logical operations performed in a computer program.

3. Copyright © 2015 Pearson Education, Inc. FLOWCHARTS A flowchart is an analytical technique that describes some aspect of an information system in a clear, concise, and logical manner. Flowcharts use a set of standard symbols to depict processing procedures and the flow of data.

4. Copyright © 2015 Pearson Education, Inc. FLOWCHARTS Every shape on a flowchart depicts a unique operation, input, processing activity, or storage medium. Before PC’s were common, flowcharts were commonly drawn with templates. Now, it is more common to use a software program such as Visio. ▫Microsoft and Power Point are also used ▫The software uses pre-drawn shapes, and the developer drags the shapes into the drawing.

5. Copyright © 2015 Pearson Education, Inc. DOCUMENT FLOWCHARTS A document flowchart shows the flow of documents and information among areas of responsibility in an organization. These flowcharts trace a document from origin to disposition and show: ▫Where a document comes from ▫Where it’s distributed ▫How it’s used ▫It’s ultimate disposition ▫Everything that happens as it flows through the system

6. Copyright © 2015 Pearson Education, Inc. DOCUMENT FLOWCHARTS Internal control flowcharts are document flowcharts used to evaluate the adequacy of internal controls, such as segregation of duties or internal checks. They can reveal weaknesses or inefficiencies such as: ▫Inadequate communication flows ▫Unnecessarily complex document flows ▫Procedures that cause wasteful delays Document flowcharts are also prepared in the system design process.

7. Copyright © 2015 Pearson Education, Inc. Document Flowchart Symbols Document Off-line FileMultiple-part document Transmittal Tape Manual Process Journal/ Ledger Terminal Off-page Connector On-page Connector A Annotation

8. Copyright © 2015 Pearson Education, Inc.

10. GUIDELINES FOR PREPARING A DOCUMENT FLOWCHART Let’s step through some guidelines for preparing a document flowchart: ▫As with DFDs, you can’t effectively prepare a flowchart if you don’t understand the system, so:  Interview users, developers, auditors, and management.  Administer questionnaires.  Read through narratives.  Walk through systems transactions

11. Copyright © 2015 Pearson Education, Inc. ▫Identify:  All departments using the system (the parties who “do” things in the story)  All documents or information flows  All processes performed on the documents ▫As you read through a narrative, you may want to mark the preceding items with different shapes (e.g., drawing a rectangle around entities, circling documents, etc.). GUIDELINES FOR PREPARING A DOCUMENT FLOWCHART

12. Copyright © 2015 Pearson Education, Inc. ▫Use separate columns for the activity of each department.  Example: If there are three different departments or functions that “do” things in the narrative, there would be three columns on the flowchart. GUIDELINES FOR PREPARING A DOCUMENT FLOWCHART

13. Copyright © 2015 Pearson Education, Inc. ▫Flowchart the normal course of operations, and identify exceptions with annotations. ▫As much as possible, the flow should go from top to bottom and left to right. ▫Use standard flowcharting symbols, and draw with a template or computer. ▫Clearly label all symbols. Use annotations if necessary to provide adequate explanation. ▫Show where each document originated and its final disposition. GUIDELINES FOR PREPARING A DOCUMENT FLOWCHART

14. Copyright © 2015 Pearson Education, Inc. ▫Every manual process should have at least one input and at least one output. ▫If a document goes into a process it must come out ▫Do not show process symbols for:  Forwarding a document to another department  Filing a document GUIDELINES FOR PREPARING A DOCUMENT FLOWCHART

15. Copyright © 2015 Pearson Education, Inc. Forwarding a document

16. Copyright © 2015 Pearson Education, Inc. Filing a document

17. Copyright © 2015 Pearson Education, Inc. ▫Do not connect two documents except when forwarding to another column.  When a document is forwarded, show it in both locations. ▫When using multiple copies of a document, place document numbers in the upper, right-hand corner. ▫Show on-page connectors and label them clearly to avoid excess flow lines. ▫Use off-page connectors if the flow goes to another page. GUIDELINES FOR PREPARING A DOCUMENT FLOWCHART

18. Copyright © 2015 Pearson Education, Inc. ▫If a flowchart takes more than one page, label the pages as 1 of 5, 2 of 5, 3 of 5, etc. ▫Show documents or reports first in the column where they are created. ▫Start with a rough draft; then redesign to avoid clutter and crossed lines. ▫Verify the accuracy of your flowchart by reviewing it with users, etc. ▫Place the flowchart name, the date, and the preparer’s name on each page of the final copy. GUIDELINES FOR PREPARING A DOCUMENT FLOWCHART

19. Copyright © 2015 Pearson Education, Inc. SYSTEM FLOWCHARTS Now that we’ve looked at document flowcharts and guidelines for creating flowcharts, let’s take a brief look at system flowcharts.

20. Copyright © 2015 Pearson Education, Inc. SYSTEM FLOWCHARTS A system flowchart depicts the relationship among the inputs, processes, and outputs of an AIS. They are a pictorial representation of automated processes and files ▫The system flowchart begins by identifying the inputs to the system. ▫Each input is followed by a process, i.e., the steps performed on the data. ▫The process is followed by outputs—the resulting new information.

21. Copyright © 2015 Pearson Education, Inc. Additional Flowcharting Symbols for System Flowcharts Automated Process Auxiliary Operation Video Display On-line Keyboard Keying Operation Magnetic Tape Magnetic Disk On-Line Storage Diskette

22. Copyright © 2015 Pearson Education, Inc. System Flowchart

23. Copyright © 2015 Pearson Education, Inc. PROGRAM FLOWCHARTS Program flowcharts illustrate the sequence of logical operations performed by a computer in executing a program. They also follow an input – process – output pattern.

24. Copyright © 2015 Pearson Education, Inc. The program flowchart from Figure 11 in your textbook is shown on the right.

25. Copyright © 2015 Pearson Education, Inc. FLOWCHARTS VS. DFDs Now that we’ve examined both flowcharts and DFDs, it may be useful to discuss the differences again. DFDs place a heavy emphasis on the logical aspects of a system. Flowcharts place more emphasis on the physical characteristics of the system.

26. Copyright © 2015 Pearson Education, Inc. FLOWCHARTS VS. DFDs EXAMPLE: The registrar’s office of a small college receives paper enrollment forms from students. They sort these records alphabetically and then update the student record file to show the new classes. They also prepare class lists from the same data. The sorted enrollment forms are forwarded to the bursar’s office for billing purposes. Class lists are mailed to faculty members.

27. Copyright © 2015 Pearson Education, Inc. Students 1.0 Update Student Records 2.0 Prepare Class Lists Student Records Faculty Bursar Enrollment Forms Enrollment Forms Enrollment Forms Class Lists Here’s a DFD that goes with the story.

28. Copyright © 2015 Pearson Education, Inc. Students 1.0 Update Student Records 2.0 Prepare Class Lists Student Records Faculty Bursar Enrollment Forms Enrollment Forms Enrollment Forms Class Lists Students Registrar’s Office Enrollment Forms Sort Forms Sorted Enrollment Forms Update Student Records A Prepare Class Lists Sorted Enrollment Forms Class Lists Sorted Enrollment Forms BursarFaculty Here’s a flowchart that goes with the story

29. Copyright © 2015 Pearson Education, Inc. FLOWCHARTS VS. DFDs Now let’s change the story so that students enter enrollment data online. The registrar’s office sends a tape file of the enrollment data to the bursar’s office and continues to send paper class lists to faculty.

30. Copyright © 2015 Pearson Education, Inc. Students 1.0 Update Student Records 2.0 Prepare Class Lists Student Records Faculty Bursar Enrollment Data Enrollment Data Enrollment Data Class Lists Original DFD Students 1.0 Update Student Records 2.0 Prepare Class Lists Student Records Faculty Bursar Enrollment Forms Enrollment Forms Enrollment Forms Class Lists Here’s the revised DFD.

31. Copyright © 2015 Pearson Education, Inc. Here’s the revised flowchart. Registrar’s Office Students Class Lists Bursar Faculty Enrollment Data Update Student Records Student Records Enrollment Data Prepare Class Lists Student s Registrar’s Office Enrollment Forms Sort Forms Sorted Enrollment Forms Update Student Records A Prepare Class Lists Sorted Enrollment Forms Class Lists Sorted Enrollment Forms BursarFaculty Original Flowchart

32. Copyright © 2015 Pearson Education, Inc. FLOWCHARTS VS. DFDs Moral of the Story: Changes in the physical characteristics of the process do affect the flowchart but have little or no impact on the DFD. The DFD focuses more on the logic. When deciding which tool to employ, consider the information needs of those who will view it.