---
title: Life Cycle Documentation for Cognos Analytics
description: Cognos life cycle documentation is a necessity to see how an object has changed over time and also shows a record of all changes and the detail behind them.
image: https://www.envisn.com/hubfs/cognos-documenation.jpg
---

[![envisn](https://www.envisn.com/hs-fs/file-15282154-gif/images/logo.gif?width=120&name=logo.gif "envisn")](https://www.envisn.com)

[![Request a Demo](https://hubspot-no-cache-na2-prod.s3.amazonaws.com/cta/default/70307/973f9256-ef61-4ab8-ab2d-a004a90a18be.png)](https://hubspot-cta-redirect-na2-prod.s3.amazonaws.com/cta/redirect/70307/973f9256-ef61-4ab8-ab2d-a004a90a18be)

[![see our new video the magic of netvisn](https://hubspot-no-cache-na2-prod.s3.amazonaws.com/cta/default/70307/1845b46e-0995-41bd-9970-5523914e0cdd.png)](https://hubspot-cta-redirect-na2-prod.s3.amazonaws.com/cta/redirect/70307/1845b46e-0995-41bd-9970-5523914e0cdd)

# Envisn's IBM Cognos Blog

## [Life Cycle Documentation for Cognos Analytics](https://www.envisn.com/envisn-cognos-blog/life-cycle-documentation-for-cognos-analytics)

Posted by [The Envisn Team](https://www.envisn.com/envisn-cognos-blog/author/the-envisn-team)

- [Tweet](https://twitter.com/share)

*![cognos documenation](https://www.envisn.com/hs-fs/hubfs/cognos-documenation.jpg?width=289&name=cognos-documenation.jpg)By Paul Hausser, [Envisn, Inc.](https://www.envisn.com/)*

Documentation in Cognos, where it exists at all, is generally thought of as something that is nice to have but is often only an afterthought. And if it’s being done manually it is likely not complete, accurate or up to date.

Yet in virtually every Cognos environment change is constant as objects are created, routinely modified over time until they are ultimately replaced, or simply retired or discarded. Changes can include any number of things including:

| - **Data items ** - **Data sources ** - **Calculations ** - **Security ** - **Schedules ** - **Jobs** | - **Package used ** - **Owner ** - **Active/Inactive ** - **Modified date ** - **Triggers ** - **Filters** |
| --- | --- |

Documentation is often thought of as something that’s captured at a given point in time. A static, somewhat detailed picture of a Content Store object, generally a report. And while that is often needed to validate data sources, calculations, etc., in many cases it does not go far enough since it only shows what it is now and not how it may have changed. This is important, especially in situations where something about the object is questioned or more detail is needed. Did the data source change? When was it changed, who changed it, and when? With static documentation those questions may never be answered.

Some organizations require a change control process to address those questions for every object in the Content Store, but the majority don’t. And trying to do this manually is both tedious and time consuming. Plus, it also assumes that every change is captured by someone, but without a change control process in place, there is no guarantee that it will be.

In reality what’s needed is ***life cycle documentation***. Not only is documentation for all objects a necessity, but also the ability to see how an object has changed over time that also shows a record of all changes and the detail behind them.

Done the right way, it’s possible to create a closed loop system that is fully automated in terms of creating documentation that contains every level detail including:

- Detailed listing of all changes from one version to the next and the ability to see a listing of those changes over time.
- The ability to look at all changes from any level of detail; change type, specification, security, schedule, configuration, date, job, etc.
- A record of who made the change and the date the change was made.
- The ability to analyze change history when needed.

Here we are looking at Cognos documentation examples from Envisn’s [NetVisn](https://www.envisn.com/netvisn) product. A key feature of this product is that as soon as the NetVisn software is installed the entire Cognos Content Store is automatically documented in detail. And as new objects are created, or existing objects are changed, this is automatically detected and a new version is created. This capability is tied in with the version control capability of the product that covers virtually all objects in the Content Store.

In **Figure 1** below we see the specification for a report showing all of the data items in a report and the details behind them.

![cognos documentation order summary](https://www.envisn.com/hs-fs/hubfs/cognos-documenation-1.jpg?width=861&name=cognos-documenation-1.jpg)

**Figure 2** below shows all the version of the same Order Summary report along with detail of when it was created along with who made the change.

![cognos documentation version list](https://www.envisn.com/hs-fs/hubfs/cognos-documenation-2.jpg?width=861&name=cognos-documenation-2.jpg)

If more information is needed about exactly what changed between versions is easy to simply compare the versions either by looking at the detail in XML or looking at a query view of the key changes. These options allow whatever detail is needed to be presented.

![cognos documentation compare versions](https://www.envisn.com/hs-fs/hubfs/cognos-documenation-3.jpg?width=861&name=cognos-documenation-3.jpg)

In **Figure 4** below we see exactly what the major changes were between two versions with different time periods.

![cognos documentation additions and deletions](https://www.envisn.com/hs-fs/hubfs/cognos-documenation-4.jpg?width=861&name=cognos-documenation-4.jpg)

Often what’s needed is a simple list of key changes that have occurred to the object by date. In **Figure 5** we see a summary of changes by date going back over time.

![cognos documenation recent changes](https://www.envisn.com/hs-fs/hubfs/cognos-documenation-5.jpg?width=861&name=cognos-documenation-5.jpg)

Because change is pervasive across Cognos there are often times when it’s necessary to be able to see what changed and when across the entire Cognos environment. The [Audit Monitor](https://www.envisn.com/audit-monitor) capability makes it possible to search across all of the documentation to find specific change types, action types, object types, object name, location, etc. This kind of flexibility is essential to be able to access all change types whenever needed.

![cognos documentation changes to security](https://www.envisn.com/hs-fs/hubfs/cognos-documenation-6.jpg?width=861&name=cognos-documenation-6.jpg)

## Summary

Life cycle documentation provides a much broader view of the dynamics of change in any Cognos environment. And when done automatically it guarantees that no changes are missed and requires no resources to manage it. It also provides complete answers to any questions that come up with 100 percent accuracy, more than enough to satisfy any audit requirements.

All of the examples shown here are using the exact same metadata captured from the Cognos Content Store. A different view may be simply displaying the same metadata in a different way.

* © 2021 Envisn, Inc.  –  All rights reserved. Learn more about [Cognos Documentation with NetVisn](https://www.envisn.com/cognos-bi-documentation)  
*

*[![learn more about netvisn](https://hubspot-no-cache-na2-prod.s3.amazonaws.com/cta/default/70307/63785aed-7a75-4f7b-8676-b2dbcaba6962.png)](https://hubspot-cta-redirect-na2-prod.s3.amazonaws.com/cta/redirect/70307/63785aed-7a75-4f7b-8676-b2dbcaba6962)*

 

 Topics: [Cognos Content Store](https://www.envisn.com/envisn-cognos-blog/topic/cognos-content-store), [Cognos Reporting](https://www.envisn.com/envisn-cognos-blog/topic/cognos-reporting), [Cognos Documentation](https://www.envisn.com/envisn-cognos-blog/topic/cognos-documentation)

*Your feedback is very important to us - we’d love to hear your comments!*

### Subscribe to Envisn's IBM Cognos Blog

[![free ebook: download the content store survival guide newly revised](https://hubspot-no-cache-na2-prod.s3.amazonaws.com/cta/default/70307/698ddaea-e5df-441f-a5dd-f80d155323b7.png)](https://hubspot-cta-redirect-na2-prod.s3.amazonaws.com/cta/redirect/70307/698ddaea-e5df-441f-a5dd-f80d155323b7)

### Posts by Category

- [Cognos Content Store (22)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-content-store)
- [Cognos BI Best Practices (21)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-bi-best-practices)
- [Cognos Analytics (19)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-analytics)
- [Cognos BI administration (19)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-bi-administration)
- [Cognos Security (18)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-security)
- [Cognos Tools (14)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-tools)
- [Cognos Audit Data (11)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-audit-data)
- [Cognos Reporting (9)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-reporting)
- [Cognos Auditing (8)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-auditing)
- [Cognos 10 (7)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-10)
- [Cognos Framework Manager (7)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-framework-manager)
- [Cognos Metadata (7)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-metadata)
- [BI Trends (6)](https://www.envisn.com/envisn-cognos-blog/topic/bi-trends)
- [IBM Information on Demand (6)](https://www.envisn.com/envisn-cognos-blog/topic/ibm-information-on-demand)
- [Cognos Audit Log (5)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-audit-log)
- [cognos impact analysis (4)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-impact-analysis)
- [Big Data (3)](https://www.envisn.com/envisn-cognos-blog/topic/big-data)
- [Cognos Data Sources (3)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-data-sources)
- [Cognos Documentation (3)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-documentation)
- [Cognos Scheduling (3)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-scheduling)
- [Product Information (3)](https://www.envisn.com/envisn-cognos-blog/topic/product-information)
- [cognos data lineage (3)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-data-lineage)
- [Archiving Cognos Content (2)](https://www.envisn.com/envisn-cognos-blog/topic/archiving-cognos-content)
- [Cognos FM Model (2)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-fm-model)
- [Cognos migration (2)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-migration)
- [Announcements (1)](https://www.envisn.com/envisn-cognos-blog/topic/announcements)
- [Cognos Change Management (1)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-change-management)
- [Cognos Data Provenance (1)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-data-provenance)
- [Cognos Hotfiles (1)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-hotfiles)
- [Cognos Powerplay (1)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-powerplay)
- [Cognos Triggers (1)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-triggers)
- [Consolidating Cognos Environments (1)](https://www.envisn.com/envisn-cognos-blog/topic/consolidating-cognos-environments)
- [Impromptu (1)](https://www.envisn.com/envisn-cognos-blog/topic/impromptu)
- [Merging Content Stores (1)](https://www.envisn.com/envisn-cognos-blog/topic/merging-content-stores)
- [Remote Cognos Management (1)](https://www.envisn.com/envisn-cognos-blog/topic/remote-cognos-management)
- [cognos deployments (1)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-deployments)
- [cognos fm model documentation (1)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-fm-model-documentation)
- [cognos workspace (1)](https://www.envisn.com/envisn-cognos-blog/topic/cognos-workspace)
- [netvisn (1)](https://www.envisn.com/envisn-cognos-blog/topic/netvisn)

[see all](https://www.envisn.com/envisn-cognos-blog/life-cycle-documentation-for-cognos-analytics#)

### Posts by Popularity

[![free download expert guide to cognos audit data](https://hubspot-no-cache-na2-prod.s3.amazonaws.com/cta/default/70307/6933ba0f-4664-4d5d-9413-edf64d7b2644.png)](https://hubspot-cta-redirect-na2-prod.s3.amazonaws.com/cta/redirect/70307/6933ba0f-4664-4d5d-9413-edf64d7b2644)

### [Cognos Tools from Envisn](https://www.envisn.com/envisn-products)

[NetVisn](https://www.envisn.com/netvisn)  
[AutoVisn](https://www.envisn.com/autovisn-cogos-scheduler)  
[UniVisn](https://www.envisn.com/univisn-cognos-performance-management)  
[DocuVisn](https://www.envisn.com/docuvisn-cognos-documentation)

### [Cognos Resources](https://www.envisn.com/resources)

[Envisn’s IBM Cognos Blog](https://www.envisn.com/envisn-cognos-blog)  
[Custom Query Library](https://www.envisn.com/custom-query-library)  
[Tutorial Videos](https://www.envisn.com/cognos-demo-videos)  
[Mastering Cognos Security](https://www.envisn.com/mastering-ibm-cognos-security)  
[Content Store Survival Guide](https://www.envisn.com/content-store-survival-guide)  
[Expert Guide to Cognos Audit Data](https://www.envisn.com/cognos-audit-data-expert-guide)

### [Contact Envisn](https://www.envisn.com/contact)

[Request a Demo](https://www.envisn.com/request-a-demo)  
[Support](https://www.envisn.com/support)

512-991-3999  
[info@envisn.com](mailto:info@envisn.com)

### Latest Cognos Posts

| [![youtube](https://www.envisn.com/hs-fs/hubfs/youtube.png?width=30&name=youtube.png)](https://www.youtube.com/user/envisn) | [![linkedin](https://www.envisn.com/hs-fs/hubfs/linkedin.png?width=30&name=linkedin.png)](https://www.linkedin.com/company/envisn-inc./) | [![twitter](https://www.envisn.com/hs-fs/hubfs/twitter.png?width=30&name=twitter.png)](https://twitter.com/Envisn) | [![facebook](https://www.envisn.com/hs-fs/hubfs/facebook.png?width=30&name=facebook.png)](https://www.facebook.com/envisn/) |
| --- | --- | --- | --- |

[![Real Time Analytics](https://static.getclicky.com/media/links/badge.gif)](http://clicky.com/101126274)

![Clicky](https://in.getclicky.com/101126274ns.gif)

3000 Polar Lane, Suite 901, Cedar Park, TX 78613 USA  
*Serving North America, Europe, and the UK with plans to expand to other areas in the near future. **[Privacy, Copyright & Liability](https://www.envisn.com/privacy-copyright-liability)*