Discovering Proposed Enterprise Objects

Creating a Proposed Object Report

Creating a reusable report

If you are looking to create a report you want to regularly use to discover any outstanding proposed objects, we recommend a designated Report object in your repository.

To create a report object, follow the instructions in our Reporting Guide under Create a Report . Then use the below described proposed object properties to build your report. In most cases you will want to report on the Latest Version using the corresponding checkbox, as diagrams that have open proposals are commonly not yet approved.

Building an ad-hoc report

To create an ad-hoc report that will not be persist for an extended amount of time, open the main navigation by clicking the application icon in the top left. Then click on Reporting to open the Reports area. Now click Design Report in the footer to start your report creation.

Choose Generic List or Table for your report type. Then use the below described proposed object properties to build your report. In most cases you will want to report on the Latest Version using the corresponding checkbox, as diagrams that have open proposals are commonly not yet approved.

Proposed Object Report Properties

Filter

Common filter scenarios include a list of all objects that have proposed objects that have not yet been accepted. The below filter will find all diagrams that have diagram and shape level proposals outstanding for acceptance:

CODE

describesState in (ProposalState.PROPOSED_EXISTING, ProposalState.PROPOSED_NEW) or diagramElement.describesState in (ProposalState.PROPOSED_EXISTING, ProposalState.PROPOSED_NEW)

Properties

The properties definition determines which information you will be able to see in the report, to help you determine the details of the proposal.

When combining the below property list with our previously defined filter, the resulting report will contain the status of each proposal (either a proposal for a new enterprise object or a proposal to describe an existing object in your enterprise model), as well as which objects are proposed (for connections to already existing objects).

CODE

describesState proposedObject diagramElement.describesState diagramElement.proposedObject

A more detailed list of available properties can be viewed under IQL query properties

Example Report

To report on a diagram's or shape's proposal status, the corresponding diagram has to have been checked in after the proposal was added. To accept a proposal, a user with the appropriate license and permissions will need to check out the diagram and accept the proposals before the describes relationships are fully realized.