Issue 3301: Vault object references (pdm-rtf) Source: (, ) Nature: Uncategorized Issue Severity: Summary: Summary: The current PDM Enablers standard provides a mechanism for obtaining object references to Vaults. In order to obtain an object reference the client must perform a ‘find’ operation on PdmDocumentManagement::VaultFactory. The operation requires the client to submit a vault_id as an input parameter to the ‘find’ operation. This mechanism makes it difficult, if not impossible, to obtain references to vaults which ID’s are not known to the client. Also, it is cumbersome when references to several vaults are required. The PdmDocumentManagement::VaultFactory interface could be extended by an introduction of a new operation, say ‘get_vaults()’ that takes no input parameters and returns a sequence of PdmDocumentManagement::Vault object references. Resolution: Revised Text: Add the following IDL to section 2.7.3.12 Vaults and to section 2.7.3.4 Document Management IDL typedef sequence<PdmDocumentManagement::Vault> Vaults; In section 2.7.3.12 Vaults and in 2.7.3.4 Document Management IDL, change the definition of interface VaultFactory to: interface VaultFactory { Vault find(in string vault_id) raises(PdmFoundation::PdmError); Vaults get_vaults() raises(PdmFoundation::PdmError); }; Actions taken: February 7, 2000: received issue October 10, 2000: closed issue Discussion: It is agreed that a method for obtaining references to all of the vaults of a PDM system would be useful. It was suggested that the solution proposed in the Summary of this issue (i.e. to add get_vaults() operation to VaultFactory) is perhaps out of scope of the VaultFactory interface. The reasoning behind this suggestion was that Factories normally only support a create() operation - to create new objects. Although this is true in principle, it must also be noted that the VaultFactory interface is not a typical Factory, in that it does not support a create() operation at all. Instead it supports a find(in string vault_id) operation. Thus, the get_vaults() operation does fit in with the scope of VaultFactory, and would be a useful extension. End of Annotations:===== From: pete@caddetc.co.uk To: pdm-rtf@omg.org Date: Tue, 15 Feb 2000 10:00:02 -0000 MIME-Version: 1.0 Subject: Issue 3301 Vault object references proposed resolution. Priority: normal X-mailer: Pegasus Mail for Win32 (v3.11) Message-Id: <10005053200075@caddetc.co.uk> Content-Transfer-Encoding: 8bit X-MIME-Autoconverted: from Quoted-printable to 8bit by emerald.omg.org id FAA26573 Content-Type: text/plain; charset=ISO-8859-1 X-UIDL: U^>!!TSD!!,~f!!WpUd9 Issue: 3301 Proposed Resolution: This resolution follows the discussion at the teleconference held on 09-Feb-2000. It was agreed, at the teleconference, that a method for obtaining references to all of the vaults of a PDM system would be useful. It was suggested that the solution proposed in the Summary of this issue (i.e. to add get_vaults() operation to VaultFactory) is perhaps out of scope of the VaultFactory interface. The reasoning behind this suggestion was that Factories normally only support a create() operation - to create new objects. Although this is true in principle, it must also be noted that the VaultFactory interface is not a typical Factory, in that it does not support a create() operation at all. Instead it supports a find(in string vault_id) operation. It seems to me that the get_vaults() operation does fit in with the scope of VaultFactory, and would be a useful extension of it. I propose the following change to the IDL of the PdmDocumentManagement module. module PdmDocumentManagement { . . stuff . . typedef sequence Vaults; //proposed addition . . stuff . . interface VaultFactory { .Vault find(in string vault_id) raises(PdmFoundation::PdmError); Vaults get_vaults() raises(PdmFoundation::PdmError); //proposed addition }; }; _________________________________________________________ Peter Dziulka Consultant Software Engineer, Enabled Systems, 6 Blenheim Terrace, Leeds LS6 9HZ, UK. E-mail: pete@caddetc.co.uk Tel: +44 (0)113 245 2288; Fax: +44 (0)113 246 8492 URL: http://www.caddetc.co.uk/enabled-systems/ _________________________________________________________ From: pete@caddetc.co.uk To: pdm-rtf@omg.org Date: Fri, 3 Mar 2000 14:36:33 -0000 MIME-Version: 1.0 Subject: Issue: 3301 (Vault object references) - revised following recent teleconf. Priority: normal X-mailer: Pegasus Mail for Win32 (v3.11) Message-Id: <14374999300006@caddetc.co.uk> Content-Transfer-Encoding: 8bit X-MIME-Autoconverted: from Quoted-printable to 8bit by emerald.omg.org id JAA05675 Content-Type: text/plain; charset=ISO-8859-1 X-UIDL: 2~1e9lNh!!85k!!h"%"! Issue: 3301 (Vault object references) Updated, as agreed in at the teleconference held on 22 Feb. 2000 Proposed Resolution: This resolution follows the discussion at the teleconference held on 09-Feb-2000. It was agreed, at the teleconference, that a method for obtaining references to all of the vaults of a PDM system would be useful. It was suggested that the solution proposed in the Summary of this issue (i.e. to add get_vaults() operation to VaultFactory) is perhaps out of scope of the VaultFactory interface. The reasoning behind this suggestion was that Factories normally only support a create() operation - to create new objects. Although this is true in principle, it must also be noted that the VaultFactory interface is not a typical Factory, in that it does not support a create() operation at all. Instead it supports a find(in string vault_id) operation. It seems that the get_vaults() operation does fit in with the scope of VaultFactory, and would be a useful extension of it. It is proposed that the following change should be made to the IDL of the PdmDocumentManagement module. module PdmDocumentManagement { . . stuff . . typedef sequence Vaults; //proposed addition . . stuff . . interface VaultFactory { .Vault find(in string vault_id) raises(PdmFoundation::PdmError); Vaults get_vaults() raises(PdmFoundation::PdmError); //proposed addition }; }; _________________________________________________________ Peter Dziulka Consultant Software Engineer, Enabled Systems, 6 Blenheim Terrace, Leeds LS6 9HZ, UK. E-mail: pete@caddetc.co.uk Tel: +44 (0)113 245 2288; Fax: +44 (0)113 246 8492 URL: http://www.caddetc.co.uk/enabled-systems/ _________________________________________________________