Universe Documenter – Some Best Practices

Beside the straightforward use of the Universe Documenter for documenting list of objects, tables etc, it can help developer to speedup some verification tasks.

1. Some guys do not believe in automatic context detection and create contexts manually. In my experience if the database schema is designed properly and join cardinalities are set properly, automatic context detection works perfect. However when you are creating the first draft of the universe, cardinalities of some joins might be not set. In this case automatic context detection will prompt a warning “All Cardinalities are not set. The detection can be wrong or incomplete because of the unknown cardinalities “.

If the schema is complex, it might be difficult to see the join, and a solution is to go through all joins in List Mode and check that all join cardinalities are set. The other option is to run Universe Documenter, and check the column “Outer Join” on the worksheet “Joins” for value “Unknown”. This will indicate the wrong join.

2. You can define a custom tables for an object to force a join. This might be useful for example for performance optimization. The problem with this feature is that the tables are reset if you change anything in the object expression (even if this is just a space). If you have a lot of such objects it might be really difficult task to verify all them. Verification of each object requires several mouse clicks. It is too easy to miss an object. An option is to build a list of objects and check column “Tables” on the worksheet “Objects”.

3. TBW

4 thoughts on “Universe Documenter – Some Best Practices

  1. Tim's avatarTim

    I get this dialogue box when checking context. I checked all my joins in list mode and they all have cardinalites set. Any ideas why this dialogue would be thrown when all cardinalities ARE set?

    Like

    Reply
  2. Mark's avatarMark

    Hi,

    long time ago, I used the unv documenter to manipulate an unv universe. After extraction to excel I were able to change things e.g. description and export it to the universe. Is this feature still in place?

    cheers

    Like

    Reply
    1. dmytro's avatardmytro Post author

      Hi,

      If you’re ready to pay $10 per month for this feature, I’ll be happy to add it – just send me an email at dmytro@biclever.com.

      Read-only features are relatively risk-free: if something goes wrong, at least it doesn’t break anything. But I can’t commit to any modification features unless I know there’s someone willing to support it financially.

      (Also, I didn’t even know this blog was still alive!:))

      /dmytro

      Like

      Reply

Leave a comment