CAD 1.0 NO IDEA Avatar
  1. OMG Issue

CAD — Incompletely specified operations - issue

  • Key: CAD-43
  • Legacy Issue Number: 4985
  • Status: closed  
  • Source: NASA ( Russ Claus)
  • Summary:

    Mikhail Kazakov mentioned that some of the Cad Services interfaces may be under-specified. Here is a list of operations needing additional documentation:
    1. CadMain:: open_model( …) - the question involves whether this operation loads the specified model into memory or are all the available models in memory and the open_model() operation merely returns an object reference to the model.

    Recommendation: the documentation should include the following: The open_model() operation loads the specified model into memory and can be unloaded by invoking close_model() on the Model object reference.

    2. CadMain:: top_level_entities (in CadUtility::TypeCodeSeq entity_types) - what happens when an empty TypeCodeSeq is passed? One could respond with all top level entities or none.
    Recommendation: Documentation shall state that an empty TypeCodesSeq will result in a system exception (BAD_PARAM).

    3. unsigned long unique_entities_count (in CadUtility::TypeCodeSeq entity_types) raises (NotValidCadType, CadUtility::CadError); - what happens when an empty TypeCodeSeq is passed? One could respond with all entites or none.
    Recommendation: Documentation shall state that an empty TypeCodesSeq will result in a system exception (BAD_PARAM).

    4. CadFoundation::EntitySeq unique_entities (in CadUtility::TypeCodeSeq entity_types) raises (NotValidCadType, CadUtility::CadError); – what happens when an empty TypeCodeSeq is passed? One could respond with all entites or none.
    Recommendation: Documentation shall state that an empty TypeCodesSeq will result in a system exception (BAD_PARAM).

  • Reported: CAD 1.0b1 — Mon, 18 Mar 2002 05:00 GMT
  • Disposition: Resolved — CAD 1.0
  • Disposition Summary:

    The identified recommendations were agreed.

  • Updated: Fri, 6 Mar 2015 20:58 GMT