InvestigativeArchitecture Data Context Diagram...

26
Investigative Architecture Investigative Architecture The Data Context Diagram Th O G E t i A hit t P titi C f The Open Group Enterprise Architecture Practitioners Conference July 21 st 2010 Ben Sommer, Senior Consultant, Systems Flow, Inc Dan Hughes, Principal Consultant, Systems Flow, Inc Jim Hosey, Senior Consultant, Systems Flow, Inc Jim Hosey, Senior Consultant, Systems Flow, Inc

Transcript of InvestigativeArchitecture Data Context Diagram...

Page 1: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

Investigative ArchitectureInvestigative ArchitectureThe Data Context Diagram

Th O G E t i A hit t P titi C fThe Open Group Enterprise Architecture Practitioners ConferenceJuly 21st 2010

Ben Sommer, Senior Consultant, Systems Flow, IncDan Hughes, Principal Consultant, Systems Flow, IncJim Hosey, Senior Consultant, Systems Flow, IncJim Hosey, Senior Consultant, Systems Flow, Inc

Page 2: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

Systems Flow & Enterprise Architecture

• Systems Flow, Inc. S ll “b ti ” f i l i & t i i – Small “boutique” professional services & training company

– Visual Modeling approach for EA is core specialtyo g pp o o o p y

• Enterprise Architecture (EA)p ( )– Ensures technology is sound at macro level– Ensures technology aligns to business needsgy g

Page 3: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

Why Investigative Architecture?A foundational skill for an architect is the ability to rapidly assess and document "as is" and proposed solution architectures. The challenge lies in the typical state of enterprise knowledge regarding the systems - a myriad of internal and external information sources at all myriad of internal and external information sources at all levels of quality and completeness. Rapidly converting this sea of information into useable knowledge requires a repeatable structured approach for gathering repeatable, structured approach for gathering information from internal stakeholders and documents, as well as performing focused research for publicly-available product and industry information. This is the Investigative Architecture approach.

Page 4: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

The Challenge• Information is the lifeblood of business, driving

decision-making• Data in all its electronic forms comprise business

information• A clean, simple method is required to depict the

context of data in an enterprise composed of systems, people & processes

Page 5: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

The Solution• A formal approach to visualizing data with a

notation thatI i l f hit t t di d • Is simple for architects to diagram and stakeholders to understand

• Captures specific and appropriate data scopes Captures specific and appropriate data scopes, primarily the enterprise scope

• Identifies the nature and direction of data flows between key architecture components

• Supports additional detail as needed for clarity (sequencing fields)(sequencing, fields)

• Leverages industry standard notation

Page 6: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

Investigative Architecture Core DiagramsInvestigative Architecture Core Diagrams

Diagram Scope NotationDiagram Scope Notation

PowerPoint View Icon-based w/guidelines

System View UML Component Diagram

Data View UML Collaboration DiagramYou arehere g

See Leveraging UML as a Standard Notation for Enterprise Architecture and Investigative Architecture – Making Sense of your Enterprise for additional information.

Page 7: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

Investigative Architecture ProcessCU1

Page 8: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

Investigative Architecture Sources for Data Context Diagrams Data Context Diagrams (partial list)

Information Source What to Expect Target DiagramV d P d t D t ti D t C t t L i l Vendor Product Documentation Data Context, Logical

Deployment

ETL Engineer Mapping Documents, ETL Specs

Data ContextSpecs

DB Administrator Data Model Data Context, Logical Deployment

Business Line Requirements Artifacts Data Context, Conceptual Overview

Page 9: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

Data Context Diagram Quick Start

Apply descriptive names to components Apply descriptive names to components Name components the same on this diagram as they are on other diagrams (map

names to/from other diagrams, if scope of the two diagrams aligns) Focus on the important logical interactions and not messaging infrastructure I l d l d t il ( t d i t ti t ) th t hit t ll Include only details (e.g., components and interactions, etc.) that are architecturally

significant Indicate data being passed at a business level and identify the direction of the data flow Park important info in another artifact if it does not fit the scope of your data context

Page 10: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

Investigative Architecture Case StudyInvestigative Architecture Case Study

The Company Massive Insurer, Inc.The Vendor EzeDoesIT, Inc.The Product EzeWorkflowThe Project Doing better, but now system interfaces are a

concernconcernThe Task Complete our set of architecture views with a Data

Context Diagram of the target solution

Page 11: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

Source #1 – our Conceptual Diagram

ResourcesApplication ServicesUsers Delivery Mechanism

LEGENDOnline Connections Batch Transfers

al

To

In

su

rer

RightFaxFax MachineCustomers

Ex

tern

Ma

ss

ive

FileNet

ImageIngestion/Retrieval

Services

Claims Archive

`Web/Fat Clients

Misc. AudjustmentWorkflow Systems

Adjusters

M Claims Archive

Customer/policysystems

Web Browser

Web Browser

EzeWorkflow

Documentation

Claims Agents

Specialists

Case Study(continued)

Page 12: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

ResourcesApplication ServicesUsers Delivery Mechanism

LEGENDOnline Connections Batch Transfers

Stub the SystemsMechanism

FileNet

ImageIngestion/Retrieval

Services

Claims Archive

`Web/Fat Clients

RightFax

Customer/policysystems

Misc. AudjustmentWorkflow Systems

Fax Machine

Web Browser

Web Browser

EzeWorkflow

DocumentationSpecialists

Claims Agents

Adjusters

Customers Carry over systems from your Conceptual Diagram that have apparently critical roles in data flow

Misc. Audjustment

Customer/policysystems

FileNet

Workflow Systems

ImageIngestion/Retrieval

Services

Claims Archive

Case Study(continued)

Page 13: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

Input #2 – Vendor “Marketecture”

Case Study(continued)

Page 14: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

RightFaxFileNetResourcesApplication ServicesUsers Delivery

Mechanism

LEGENDOnline Connections Batch Transfers

Mechanism

FileNet

ImageIngestion/Retrieval

Services

Claims Archive

`Web/Fat Clients

RightFax

Customer/policysystems

Misc. AudjustmentWorkflow Systems

Fax Machine

Web Browser

Web Browser

EzeWorkflow

DocumentationSpecialists

Claims Agents

Adjusters

Customers

“Fax claim submission” •“submission” is conveyed by the system interaction•“Faxed” underlines that RightFax is a (duh!) fax system•“insurance claims” neatly summarizes the datainsurance claims neatly summarizes the data

Retain and amplify your assumptions about system integration – i.e. fact that RightFax & FileNet integrate in the first place, and direction of flow

“ingestion” further implies the direction

Case Study(continued)

Page 15: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

FileNetEzeWorkflowResourcesApplication ServicesUsers Delivery

Mechanism

LEGENDOnline Connections Batch Transfers

Mechanism

FileNet

ImageIngestion/Retrieval

Services

Claims Archive

`Web/Fat Clients

RightFax

Customer/policysystems

Misc. AudjustmentWorkflow Systems

Fax Machine

Web Browser

Web Browser

EzeWorkflow

DocumentationSpecialists

Claims Agents

Adjusters

Customers

RightFax FileNetFaxed insurance claims

imag

es

rance

claim

documen

t imEzeWorkflow

Replicate the interface

Insura

FileNet

ImageImageIngestion/Retrieval

Services

Claims Archive

Ingestion/RetrievalServices

If FileNet performed “ingestion” of faxes from RIghtFax, EzeWorkflow

must perform “retrieval”…

Case Study(continued)

Page 16: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

EzeWorkflowCust/Policy Systems??ResourcesApplication ServicesUsers Delivery

Mechanism

LEGENDOnline Connections Batch Transfers

RightFax FileNet

ent im

ages

Faxed insurance claimsMechanism

FileNet

ImageIngestion/Retrieval

Services

Claims Archive

`Web/Fat Clients

RightFax

Customer/policysystems

Misc. AudjustmentWorkflow Systems

Fax Machine

Web Browser

Web Browser

EzeWorkflow

DocumentationSpecialists

Claims Agents

Adjusters

Customers

Insuran

ce cl

aim docu

men

No idea yet what the data should be aside

No idea yet which way the data is moving

EzeWorkflow

In

EzeWorkflow Integrator…

data should be, aside from broad brush of “customer” & “policy”

gLegacy…systems

“Customer/Policy Systems” was initial best guess at desired legacy integration. Now we need requirements.

Integration type was a guess g yp galso: need to confirm whether

objective would be online/real-time or day-end integration

Page 17: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

Input #3 – Draft RequirementsResourcesApplication ServicesUsers Delivery

Mechanism

LEGENDOnline Connections Batch Transfers

Mechanism

FileNet

ImageIngestion/Retrieval

Services

Claims Archive

`Web/Fat Clients

RightFax

Customer/policysystems

Misc. AudjustmentWorkflow Systems

Fax Machine

Web Browser

Web Browser

EzeWorkflow

DocumentationSpecialists

Claims Agents

Adjusters

Customers

EzeWorkflow Implementation Business Requirements Document (BRD)q ( )

“amounts” – Mmm… a financial interface?

Settlement RequirementsThe system of record for claims should be the new workflow system, though all payout amounts should book to payout amountspayout amounts book tobook to

Aha! “PolicyCenter” is more specific

……

PolicyCenter in order to be reflected in the next business claims settlement report...PolicyCenterPolicyCenter

“next day’ – i.e. “not necessarily immediately” – a clue to online vs. batch?

next business day’snext business day’s

“…book to…” a ripe action verb –a clue to the data direction…

immediately a clue to online vs. batch?

Page 18: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

EzeWorkflowPolicyCenterResourcesApplication ServicesUsers Delivery

Mechanism

LEGENDOnline Connections Batch Transfers

RightFax FileNet

t imag

es

Faxed insurance claimsMechanism

FileNet

ImageIngestion/Retrieval

Services

Claims Archive

`Web/Fat Clients

RightFax

Customer/policysystems

Misc. AudjustmentWorkflow Systems

Fax Machine

Web Browser

Web Browser

EzeWorkflow

DocumentationSpecialists

Claims Agents

Adjusters

Customers

suran

ce cl

aim docu

ment

Data = “…payout amounts…”

EzeWorkflow

InsuEzeWorkflow Implementation

Business Requirements Document (BRD)EzeWorkflow Implementation

Business Requirements Document (BRD)

The system of record for claims should be the new workflow system, though all settled claims should book to PolicyCenter in order to be reflected in the next business day’s settlement report...………

Settlement RequirementsThe system of record for claims should be the new workflow system, though all settled claims should book to PolicyCenter in order to be reflected in the next business day’s settlement report...………

Settlement Requirements

Pay

For now just park a note denoting “batch” so the info isn’t lost

Data???

Payout amounts

Online/Batch = “…next business day…”

Direction of flow = “…book to…”

System = “…PolicyCenter…”

y

Note to Self: go back and correct Conceptual Diagram to show “batch” not online connection

PolicyCenterEzeWorkflow

Page 19: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

Input #4 – Follow-up Emailon “Misc Adjustment Systems”ResourcesApplication ServicesUsers Delivery

Mechanism

LEGENDOnline Connections Batch Transfers on Misc. Adjustment SystemsMechanism

FileNet

ImageIngestion/Retrieval

Services

Claims Archive

`Web/Fat Clients

RightFax

Customer/policysystems

Misc. AudjustmentWorkflow Systems

Fax Machine

Web Browser

Web Browser

EzeWorkflow

DocumentationSpecialists

Claims Agents

Adjusters

Customers

EzeWorkflow Implementation Business Requirements Document (BRD)

EzeWorkflow Implementation Business Requirements Document (BRD)

The system of record for claims should be the new workflow system, though all settled claims should book to PolicyCenter in order to be reflected in the next business day’s settlement report...………

Settlement RequirementsThe system of record for claims should be the new workflow system, though all settled claims should book to PolicyCenter in order to be reflected in the next business day’s settlement report...………

Settlement Requirements

Misc. AudjustmentWorkflow Systems

EzeWorkflow

Page 20: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

EzeWorkflowMisc. Adjustment SystemsResourcesApplication ServicesUsers Delivery

Mechanism

LEGENDOnline Connections Batch Transfers

ment im

ages

Mechanism

FileNet

ImageIngestion/Retrieval

Services

Claims Archive

`Web/Fat Clients

RightFax

Customer/policysystems

Misc. AudjustmentWorkflow Systems

Fax Machine

Web Browser

Web Browser

EzeWorkflow

DocumentationSpecialists

Claims Agents

Adjusters

Customers

“…reports they send back…”

Insuran

ce cl

aim docu

m

“…sending location of auto claims to outside adjusters ”

Payout amo

EzeWorkflow Implementation Business Requirements Document (BRD)

EzeWorkflow Implementation Business Requirements Document (BRD)

The system of record for claims should be the new workflow system, though all settled claims should book to PolicyCenter in order to be reflected in the next business day’s settlement report...………

Settlement RequirementsThe system of record for claims should be the new workflow system, though all settled claims should book to PolicyCenter in order to be reflected in the next business day’s settlement report...………

Settlement Requirements

claims to outside adjusters…

mounts

First thing: update Conceptual Diagram to reflect bi-directional interface

Page 21: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

Final Touches

ent im

ages

Insuran

ce cl

aim docu

men

Batch (daily) P

Let’s cleanly model rather than annotate the fact that we have two batch systems

In

Batch (daily) Payout amounts

Adjustm

ent r

epor

t

maged

auto

loca

tions

Batch/day-end

have two batch systems

Dama

Page 22: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

Final ProductF d i l i

RightFax FileNet

ument im

ages

Faxed insurance claims

Insuran

ce cl

aim docu

m

Batch (day-end)

EzeWorkflow

port

tions P

Adju

stm

ent r

epo

Dam

aged

auto

loca

ti Payout amounts

PolicyCenterMisc. Adjustment

Systems

Page 23: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

ReferencesReferences

• Systems Flow Whitepapers, including:Systems Flow Whitepapers, including:– Leveraging UML as a Standard Notation for

Enterprise Architecturep– Other Investigative Architecture Case Studies

• The Logical Deployment DiagramThe Logical Deployment Diagram• The Conceptual Diagram

Page 24: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

QUESTIONS?QUESTIONS?

Page 25: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

About Systems FlowAbout Systems Flow

Systems Flow, Inc. helps organizations dramatically improve their Systems Flow, Inc. helps organizations dramatically improve their competitive advantage through practical, effective application of best practices in enterprise architecture and software development.

Each of our consultants has strong client facing skills hands on business experience broad bestEach of our consultants has strong client-facing skills, hands-on business experience, broad best-practices experience, deep technical knowledge, and visual modeling expertise. Collectively, our team has decades of “know how” that we bring to bear on client engagements.

Our strategic approach, together with our “boots on the ground” application of tools and methods, offer our clients an organic practical approach to their specific challenges We are able to scale our offer our clients an organic, practical approach to their specific challenges. We are able to scale our techniques to fit the business need, at both the project and enterprise level, to create effective solutions that reflect the unique identity of an organization.

Our blend of strategic business thinking and practical application builds a climate of confidence d t t b i ti d j t i l t ti t lik Thi li t ll and trust among business executives and project implementation teams alike. This climate allows

us to foster alignment and achieve positive, value-driven results across the enterprise.

Page 26: InvestigativeArchitecture Data Context Diagram …sysflow.com/images/InvestigativeArchitecture_Data_Context_Diagram.pdfInvestigative Architecture The Data Context Diagram Th O G E

About the AuthorsAbout the AuthorsBen Sommer ([email protected]) is a senior consultant at Systems Flow, Inc. His career has spanned network engineering, systems administration, and software development – running the gamut from tools to automate network and systems tasks, to web-based CRM applications, to identity management and provisioning systems to real-time music synthesis applications His industry management and provisioning systems, to real time music synthesis applications. His industry experience includes education, education finance, interactive marketing and banking. Ben is a trained composer and musician.

Dan Hughes ([email protected]) is a principal consultant at Systems Flow, Inc., where he leads the technology services practice. He has 18 years of software engineering experience spanning a gy p y g g p p gbroad range of technologies and techniques. Startup to enterprise, he has launched, managed, and executed all aspects of both product and enterprise life cycle, delivering complex, enterprise-scale architectures for clients in the public and private sector, in industries ranging from banking and insurance to international development. Dan holds a Bachelor of Science in Computer and Systems Engineering from Rensselaer Polytechnic Institute.

James Hosey ([email protected]) is a senior consultant at Systems Flow, Inc. and is currently engaged at Citizens Bank as an enterprise architect providing strategic architectural guidance and project-specific support across the bank's technology portfolio. Over the course of his 18-year career, Jim has managed and executed all phases of the software life cycle and has delivered a wide variety of technology solutions for both commercial resale and internal use in domains that include banking, i h i & di ib i k i i i d i i & insurance, warehousing & distribution, marketing, communications, and management training & development. Having worked with organizations of all sizes, Jim can tailor his approach to the specific driving forces within each type of environment. His experience managing his own consulting practice for ten years has provided him with the entrepreneurial experience necessary to work with stakeholders at all levels to achieve results.