Paquete

Package

Clase Pública

Un objeto Paquete corresponde a un elemento paquete en el Explorador de Proyectos de EA. Se accede a él a través de la colección de Modelos del Repositorio (un Modelo es una forma especial de Paquete) o a través de la colección Paquetes de Paquete. Tenga en cuenta que un Paquete tiene un objeto Elemento como atributo - esto corresponde a un elemento Paquete de EA en la tabla t_object y se usa para asociar información adicional (tal como escenarios y restricciones) con el paquete lógico. Para configurar información adicional para un paquete, haga una referencia al objeto Elemento directamente. Tenga en cuenta también que si agrega un Paquete a un Diagrama, debería agregar una instancia del Elemento - no el Paquete en si - a la colección DiagramObjects para un Diagrama.

Tabla asociada en el archivo .EAP: t_package

Atributos de Package

Atributo	Tipo	Notas
Name	String	El nombre del paquete
Packages	Collection	Una colección de paquetes contenidos que se pueden recorrer
Elements	Collection	Una colección de Elementos que pertenecen a este paquete
Diagrams	Collection	Una colección de Diagramas contenidos en este paquete
Notes	String	Notas acerca de este paquete
IsNamespace	Boolean	Es verdadero si el paquete es un nombre de espacio raíz. Use 0 y 1 para establecer Falso y Verdadero
PackageID	Long	El número de ID local del Paquete. Válido sólo en este archivo de modelo.
PackageGUID	Variant	El ID del Paquete global. Válido a través de los modelos
ParentID	Long	El ID del Paquete que es el Padre de éste. 0 indica que este paquete es un Modelo (ej. no tiene padre)
Created	Date	Fecha de creación del paquete
Modified	Date	Fecha de última modificación del paquete
IsControlled	Boolean	Indica si el paquete se marcó como 'Controlado'
IsProtected	Boolean	Indica si el paquete se marcó como "Protegido"
UseDTD	Boolean	Indica si se va a utilizar un DTD cuando se exporte a XMI
LogXML	Boolean	Indica si la información de exportación a XMI se va a almacenar en un log
XMLPath	String	El camino a donde se guardará el XML cuando se usen paquetes controlados
Version	String	La Versión del paquete
LastLoadDate	Date	Última fecha en la que se cargó el XML para el paquete
LastSaveDate	Date	Última fecha en la que se guardó el XML del paquete
Flags	String	Información extendida acerca del paquete
Owner	String	El dueño del paquete cuando se utilizan paquetes controlados
CodePath	String	Camino adonde se encuentra el código fuente asociado
UMLVersion	String	Versión de UML para propósitos de exportación en XMI
TreePos	Long	La posición relativa en el árbol comparada con otros paquetes (se usa para ordenar paquetes)
IsModel	Boolean	Indica si el paquete es un Modelo o un Paquete
Element	Object	El objeto Elemento asociado. Úselo para configurar la información del tipo de Elemento para un paquete... incluyendo Estereotipo, Complejidad, Alias, Autor, Restricciones, Escenarios... etc.
BatchSave	Long	Valor booleano para indicar si el paquete se incluirá en la lista de exportación XMI por lote o no.
BatchLoad	Long	Bandera para indicar que el paquete se cargará por lote durante la importación por lote desde paquetes controlados. No se implementó aún.
Connectors	Collection	Colección de conectores. Es de sólo lectura.
Alias	string	Solo lectura. Alias
IsVersionControlled	boolean	Lectura/Escritura. Si este paquete esta bajo el control de versiones o no.
ObjectType	ObjectType	Solo lectura. Distingue los objetos referenciados a través de despacho.

Métodos de Package

Método	Tipo	Notas
GetLastError ()	String	Devuelve un valor string describiendo el error más reciente que ocurrió con relación a este objeto. Esta función se utiliza raramente debido a que se emitirá una excepción cuando ocurra un error.
Update ()	Boolean	Modifica el objeto Paquete actual después de su modificación o adición de un nuevo ítem. Si se devuelve un Falso, controle la función GetLastError para más información. Tenga en cuenta que un objeto Paquete también tiene un componente 'Elemento' que se debe tener en cuenta. El objeto Paquete contiene información acerca de la jerarquía, contenidos, etc. El atributo Elemento contiene información acerca de Estereotipo, Restricciones, Archivos, etc. -todos los atributos de un Elemento típico-.
FindObject(String DottedID	LPDISPATCH	Param: DottedID [String in] Devuelve un Paquete, Elemento, Atributo u Operación correspondiente al parámetro DottedID. El string DottedID esta en al forma de object. object.object donde objeto se reemplaza por el nombre de un paquete, elemento, atributo u operación. Ejemplos de DottedIDs incluyen MyNamespace.Class1, CStudent.m_Name, MathClass.DoubleIt(int) Si el DottedID no se encuentra, un error se devuelve: "No puede encontrar un objeto correspondiente"

VersionControlAdd (String ConfigGuid, String XMLFile, String Comment, Bool KeepCheckedOut)	void	param: ConfigGuid [ String - in ] Nombre correspondiente al ID Único de la configuración del Control de Versiones a usar. param: XMLFile [ String - in ] Nombre del archivo XML a usar para este paquete. Este nombre de archivo es relativo a la Copia de Trabajo especificada por la configuración. param: KeepCheckedOut [ Boolean - in ] Especifica Verdadero para agregar al control de versiones y mantener la verificación del paquete. Ubica el paquete bajo el control de versiones, usando la configuración del Control de Versiones y el nombre del archivo XMI especificado. Arroja una excepción si la operación falla. Usa GetLastError( ) para recuperar la información de error.
VersionControlRemove ( )	void	Remueve el control de versiones desde el paquete. Arroja una excepción si la operación falla. Usa GetLastError( ) para recuperar la información de error.
VersionControlCheckout (String Comment)	void	param: Comment [ String - in ] Registra el mensaje que se agrega al historial del archivo controlado de la versión. (Donde sea aplicable). Realiza una verificación del paquete controlado de la versión. Arroja una excepción si la operación falla. Usa GetLastError( ) para recuperar la información de error.
VersionControlCheckin (String Comment)	void	param: Comment [ String - in ] Registra el mensaje que se agrega al historial del archivo controlado de la versión. (Donde sea aplicable). Realiza registro del paquete controlado de la versión. Arroja una excepción si la operación falla. Usa GetLastError( ) para recuperar la información de error.

VersionControlGetStatus ( )

long

Retorna el estado del control de versiones del paquete.

Retorna los mapas de valor al siguiente Tipo enumerado;

enum EnumCheckOutStatus

{

csUncontrolled,

csCheckedIn,

csCheckedOutToThisUser,

csReadOnlyVersion,

csCheckedOutToAnotherUser,

csOfflineCheckedOutToThisUser,

csOfflineNotCheckedOutToThisUser,

csDeleted

}

csUncontrolled - Incapaz de comunicarse con el proveedor del control de versiones asociado con el paquete o el archivo del paquete no es conocido por el proveedor.

csReadOnlyVersion - El paquete se marca como solo lectura. Una revisión anterior del paquete ha sido recuperada del Control de Versiones.

csOfflineCheckedOutToThisUser - Indica que el paquete fue "verificado" por este usuario mientras se desconecta del Control de Versiones.

csOfflineNotCheckedOutToThisUser - Indica que EA no se puede conectar actualmente a VC config y el paquete no fue previamente verificado a este usuario.

csDeleted - El archivo del paquete ha sido eliminado del control de versiones.

Arroja una excepción si la operación falla. Usa GetLastError( ) para recuperar información del error.