Clase de Proyecto [Guía de Usuario de Enterprise Architect]

Top Previous Next

Clase de Proyecto

button_main button_prev button_next

La interfaz de del Proyecto puede ser accedida desde el Repositorio utilizando GetMailInterface( ). La interfaz devuelta proporciona acceso a la Interfaz de Automatización de Enterprise Architect basada en XML. Utilice esta interfaz para obtener XML para los varios elementos internos y para ejecutar algunas funciones de utilidad para realizar tareas tales como cargar diagramas o ejecutar informes.

Atributos del Proyecto

Atributo

Tipo

Notas

ObjectType

ObjectType

Sólo lectura

Distingue objetos referidos a través de una interfaz de Envío.

 

Métodos del Proyecto

Método

Tipo

Notas

Ver También

CancelValidation ()

Void

Cancela un proceso de validación.

 

 

Validación de Modelo

CanValidate ()

Boolean

Devuelve un valor para indicar que el componente de Validación del Modelo está cargado.

 

CreateBaseline (

string PackageGUID,

string Version,

string Notes)

Boolean

Crea una Línea de Base para un determinado paquete.

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete a Línea de Base

Versión: String - la versión de la Línea de Base

Notas: String - cualquier nota con respecto a la Línea de Base

 

 

CreateBaselineEx (

string PackageGUID,

string Version,

string Notes,

EA.CreateBaselineFlag Flags)

Boolean

Crea una Línea de Base de un determinado paquete, con una bandera para excluir el contenido del paquete debajo del primer nivel.

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete para ser Línea de Base

Versión: String - la versión de la Línea de Base

Notas: String - cualquier nota con respecto a la Línea de Base

Banderas: EA.CreateBaselineFlag - si excluir o no el contenido del paquete por debajo del primer nivel

 

Crear Líneas Base

EA.CreateBaselineFlag

DefineRule (

string CategoryID,

EA.EnumMVErrorType ErrorType,

string ErrorMessage

String

Define las reglas individuales que se pueden realizar durante la validación del modelo. Debe ser llamado una vez para cada regla de el manejador de transmisión EA_OnInitializeUserRules.

El valor de retorno es una Regla, la cual puede ser utilizada para fines de referencia cuando una regla individual es ejecutada por Enterprise Architect durante la validación del modelo.

Vea el Ejemplo de Validación del Modelo para un ejemplo detallado del uso de este método.

Parámetros:

CategoryId: String - se debe pasar el valor de retorno desde el método DefineRuleCategory

ErrorType: EA.EnumMVErrorType - dependiendo de la gravedad del error que se está validando, puede ser:

mvErrorCritical

mvError

mvWarning, o

mvInformation

 

ErrorMessage: String - puede contener una cadena de error por defecto, aunque probablemente esta sea anulada por la llamada PublishResult

 

EA_OnInitializeUserRules

Ejemplo de Validación de Modelos

DefineRuleCategory

PublishResult

DefineRuleCategory (

string CategoryName)

String

Define una categoría de reglas que pueden ser realizadas durante la validación del modelo (generalmente hay una categoría por Add-In). Debe ser llamado una vez para desde el manejador de transmisión EA_OnInitializeUserRules.

El valor de retorno es un CategoryId que debe ser pasado al método DefineRule.

Vea el Ejemplo de Validación del Modelo para un ejemplo detallado del uso de este método.

Parámetros:

CategoryName: String - una cadena de texto que es visible en la ventana de Configuración de Validación del Modelo

 

EA_OnInitializeUserRules

DefineRule

Ejemplo de Validación de Modelos

DeleteBaseline (string BaselineGUID)

Boolean

Elimina una Línea de Base, identificada por el BaselineGUID, desde el repositorio.

Parámetros:

BaselineGUID: String - el GUID (en formato XML) de Línea de Base a eliminar

 

 

DoBaselineCompare (

s

tring PackageGUID,

string Baseline,

string ConnectString)

String

Realiza una comparación Línea de Base utilizando el GUID del paquete proporcionado y el GUID de la Línea de Base (obtenido de la lista de resultados desde GetBaselines).

Opcionalmente puede incluir la cadena de conexión necesaria para encontrar la Línea de Base si existe en un archivo de modelo distinto.

Este método devuelve un archivo de registro del estado de todos los elementos encontrados y comparados en el procedimiento de diferencia. Puede utilizar esta información de registro como entrada a DoBaselineMerge - combinando automáticamente la información de la Línea de Base.

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete para ejecutar la comparación sobre

Línea de Base: String - el GUID (en formato XML) de la Línea de Base para ejecutar la comparación sobre

ConnectString: String - la ubicación del archivo .EAP externo o DBMS para extraer la Línea de Base

 

GetBaselines

DoBaselineMerge

DoBaselineMerge (

string PackageGUID,

string Baseline,

string MergeInstructions,

string ConnectString)

String

Realiza una combinación de lotes basados en instrucciones contenidas en un archivo XML (MergeInstructions). Puede proporcionar una cadena de conexión opcional si la Línea de Base está localizada en otro modelo.

En el archivo MergeInstructions, cada nodo MergeItem proporciona el GUID de un ítem diferenciado desde el registro de diferencia XML. Como la combinación es unidireccional y accionada de sólo una manera posible, no se requieren argumentos adicionales. Enterprise Architect elige el procedimiento correcto basado en los resultados de Diferencia.

 

<Merge>

<MergeItem guid="{XXXXXX}" />

<MergeItem guid="{XXXXXX}" />

</Merge>

 

Alternativamente, puede proporcionar un único Mergeitem con un GUID de RestoreAll. En este caso, Enterprise Architect procesa por lotes TODAS las diferencias.

 

<Merge>

<MergeItem guid="RestoreAll" changed="true" baselineOnly="true" modelOnly="true" moved="true" fullRestore="false" />

</Merge>

 

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete para fusionar la Línea de Base hacia

Línea de Base: String - el GUID de la Línea de Base (en formato XML) para fusionar en el paquete

MergeInstructions: String - el archivo que contiene el GUID de cada ítem diferenciado desde el registro de diferencia XML devuelto por DoBaselineCompare()

ConnectString: String - la ubicación del archivo .EAP o DBMS para obtener la Línea de Base, si no está en el mismo modelo que el paquete

 

DoBaselineCompare()

EnumDiagramElements (

string DiagramGUID)

protected abstract: String

Obtiene una lista XML de todos los elementos de un diagrama.

Parámetros:

DiagramGUID: String - el GUID (en formato XML) del diagrama para obtener elementos para

 

 

EnumDiagrams (

string PackageGUID)

protected abstract: String

Obtiene una lista XML de todos los diagramas de un paquete determinado.

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete para listar diagramas para

 

 

EnumElements (

string PackageGUID)

protected abstract: String

Obtiene una lista XML de todos los elementos de un paquete determinado.

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete para obtener una lista de elementos para

 

 

EnumLinks (

string ElementGUID)

protected abstract: String

Obtiene una lista XML de conectores para un elemento determinado.

Parámetros:

ElementGUID: String - el GUID (en formato XML) del elemento para obtener todos los conectores asociados para

 

 

EnumPackages (

string PackageGUID)

protected abstract: String

Obtiene una lista XML de paquetes hijos dentro de un paquete padre.

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete padre

 

 

EnumProjects ()

protected abstract: String

Obtiene una lista de proyectos en el archivo actual; corresponde a Modelos en el Repositorio.

 

Modelos

EnumViews ()

protected abstract: String

Enumera las Vistas de un proyecto. Devuelto como un documento XML.

 

 

EnumViewEx (

string ProjectGUID)

protected abstract: String

Obtiene una lista de Vistas en el proyecto actual.

Parámetros:

ProjectGUID: String - el GUID (en formato XML) del proyecto para obtener vistas para

 

 

Exit ()

protected abstract: String

Sale de la instancia actual de Enterprise Architect; esta función se mantiene por razones de compatibilidad con versiones anteriores y nunca debe ser llamado.

Enterprise Architect sale automáticamente cuando ya no está usando ninguno de los objetos proporcionados.

 

 

ExportPackageXMI (

string PackageGUID,

enumXMIType XMIType,

long DiagramXML,

long DiagramImage,

long FormatXML,

long UseDTD,

string FileName)

protected abstract: String

Exporta XMI para un paquete determinado.

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete para ser exportado

XMIType: EnumXMIType - especifica el tipo e información de versión de XMI; vea XMIType Enum para los valores aceptados

DiagramXML: Long - verdadero si se requiere XML para los diagramas; valores aceptados:

 

0 = No exportar diagramas

1 = Exportar Diagramas

2 = Exportar diagramas junto con imágenes alternativas

 

DiagramImage: Long - el formato para imágenes del diagrama que se crean al mismo tiempo; valores aceptados:

 

-1=NONE

0=EMF

1=BMP

2=GIF

3=PNG

4=JPG

 

FormatXML: Long - verdadero si la salida XML fuera formateada antes de guardar

UseDTD: Long - verdadero si se utilizara DTD

Nombre de Archivo: String - el nombre de archivo con el cual salir

 

XMIType Enum

ExportPackageXMIEx (

string PackageGUID,

enumXMIType XMIType,

long DiagramXML,

long DiagramImage,

long FormatXML,

long UseDTD,

string FileName,

ea.ExportPackageXMIFlag Flags)

protected abstract: String

Exporta XMI para un determinado paquete, con una bandera para determinar si la exportación incluye el contenido del paquete debajo del primer nivel.

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete para ser exportado

XMIType: EnumXMIType - especifica el tipo e información de versión de XMI; vea XMIType Enum para los valores aceptados

DiagramXML: Long - verdadero si se requiere XML para los diagramas; valores aceptados:

 

0 = No exportar diagramas

1 = Exportar Diagramas

2 = Exportar diagramas junto con imágenes alternativas

 

DiagramImage: Long - el formato para imágenes del diagrama que se crean al mismo tiempo; valores aceptados:

 

-1=NONE

0=EMF

1=BMP

2=GIF

3=PNG

4=JPG

 

FormatXML: Long - verdadero si la salida XML fuera formateada antes de guardar

UseDTD: Long - verdadero si se utilizara DTD.

Nombre de Archivo: String - el nombre de archivo con el cual salir

Banderas: ea.ExportPackageXMIFlag - si incluir o no el contenido del paquete por debajo del primer nivel (actualmente sólo está soportado para xmiEADefault)

 

Contenido de Paquete

XMIType Enum

Exportar Bandera XMI de Paquete

GenerateClass (

string ElementGUID,

string ExtraOptions)

Boolean

Genera el código para una única Clase.

Parámetros:

ElementGUID: String - el GUID (en formato XML) del elemento a generar

ExtraOptions: String - permite que se den opciones adicionales al comando; actualmente no se utiliza

 

 

GenerateDiagramFromScenario (

string ElementGUID,

EnumScenarioDiagramType DiagramType,

long OverwriteExistingDiagram)

Boolean

Genera varios diagramas de la Especificación Estructurada de un elemento.

Parámetros:

ElementGUID: String - el GUID (en formato XML) del elemento que contiene la Especificación Estructurada

DiagramType: EnumScenarioDiagramType - el tipo de diagrama a generar; vea ScenarioDiagramType Enum para los valores aceptados

OverwriteExistingDiagram: Long - determina si desea sobrescribir los diagramas existentes o sincronizar los elementos existentes con los pasos del escenario

 

0 = Eliminar el diagrama y elementos existentes, y crear un nuevo diagrama y elementos

1 = Sincronizar elementos existentes con los pasos del escenario y conservar el diseño del diagrama

2 = Sincronizar elementos existentes con los pasos del escenario y volver a convertir el diseño del diagrama

3 = No generar un diagrama si ya existe uno

 

ScenarioDiagramType Enum

GenerateElementDDL (

string ElementGUID,

string FileName,

string ExtraOptions)

Boolean

Genera DDL para un elemento

Por ejemplo:

 

owner=true;pkfkconstraints=true;commentlevel=3;

 

 

Parámetros:

ElementGUID: String - el GUID (en formato XML) del elemento para generar DDL para

Nombre de Archivo: String - la ruta del archivo de destino en la cual escribir el DDL generado

ExtraOptions: String - permite que se den opciones adicionales al comando; actualmente permite:

Generar Propietario (propietario)

Generar Restricciones Clave PK/FK (pkfkconstraints)

Generar Comentarios:

 

0=Ninguno

1=Tabla

2=Columna

3=Todos

 

 

GeneratePackage (

string PackageGUID,

string ExtraOptions)

Boolean

Genera el código para todas las Clases dentro de un paquete.

Por ejemplo:

 

recurse=1;overwrite=1;dir=C:\

 

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete para generar código para

ExtraOptions: String - permite que se den opciones adicionales al comando; actualmente permite:

La generación de todos los subpaquetes ( recursivo)

Forzar la sobrescritura de todos los archivos (sobrescribir) y

La especificación para generar automáticamente todas las rutas (dir)

 

 

GeneratePackageDDL (

string PackageGUID,

string FileName,

string ExtraOptions)

Boolean

Genera DDL para un paquete.

Por ejemplo:

 

owner=true;pkfkconstraints=true;commentlevel=3;

singlefile=true;includechild=true;

 

 

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete para generar DDL para

Nombre de Archivo: String - la ruta del archivo de destino en la cual escribir el DDL generado

ExtraOptions: String - permite que se den opciones adicionales al comando; actualmente permite:

Generar DDL para paquetes hijos (includechild)

Generar Propietario (propietario)

Generar Restricciones Clave PK/FK (pkfkconstraints)

Generar Comentarios:

 

0 - Ninguno

1 - Tabla

2 - Columna

3 - Todos

 

Generar en SingleFile (singlefile)

 

 

GenerateTestFromScenario (

string ElementGUID,

EnumScenarioTestType TestType)

Boolean

Genera una Prueba Interna o una Prueba Externa desde la Especificación Estructurada de un elemento.

Parámetros:

ElementGUID: String - el GUID (en formato XML) del elemento que contiene la Especificación Estructurada

TestType: EnumScenarioTestType - el tipo de prueba a generar; vea ScenarioTestType Enum para los valores aceptados

 

Generar Casos de Prueba

ScenarioTestType Enum

GenerateWSDL(

string WSDLComponentGUID,

string Filename,

string Encoding,

string ExtraOptions)

Boolean

Genera WSDL para el Componente estereotipado WSDL especificado.

Parámetros:

WSDLComponentGUID: String - el GUID (en formato XML) del Componente estereotipado WSDL

Nombre de Archivo: String - la ruta del archivo destino

Codificación: String - la codificación XML para la instrucción de la página de código

ExtraOptions: String - permite que se den opciones adicionales al comando; actualmente no se utiliza

 

Servicios Web - WSDL

GenerateXSD (

string PackageGUID,

string FileName,

string Encoding,

string Options)

Boolean

Crea un esquema XML para un paquete, especificado por su GUID. Devuelve verdadero si es exitoso.

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete

Nombre de Archivo: String - la ruta del archivo destino

Codificación: String - la codificación XML para la instrucción de la página de código

Opciones: String - permite que se den opciones adicionales al comando; actualmente permite:

GenGlobalElement Encender o Apagar la generación de elementos globales para todos los ComplexTypes globales; por ejemplo: - GenGlobalElement=1

 

 

GetBaselines (

string PackageGUID,

string ConnectString)

String

Devuelve una lista (en formato XML) de Líneas de Base asociadas con el GUID del paquete proporcionado. Opcionalmente, puede proporcionar una cadena de conexión para obtener Líneas de Base desde el mismo paquete, pero localizado en un archivo de modelo distinto (o DBMS).

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete para obtener Líneas de Base para

ConnectString: String - la ubicación del archivo .EAP o DBMS para obtener Líneas de Base, si no están en el mismo modelo que el paquete

 

 

GetDiagram (

string DiagramGUID)

protected abstract: String

Obtiene los detalles del diagrama, en formato XML.

Parámetros:

DiagramGUID: String - el GUID (en formato XML) del diagrama para obtener detalles para

 

 

GetElement (

string ElementGUID)

protected abstract: String

Obtiene XML para el elemento determinado.

Parámetros:

ElementGUID: String - el GUID (en formato XML) del elemento para recuperar XML para

 

 

GetElementConstraints (

string ElementGUID)

protected abstract: String

Obtiene restricciones para un elemento, en formato XML.

Parámetros:

ElementGUID: String - el GUID (en formato XML) del elemento

 

 

GetElementEffort (

string ElementGUID)

protected abstract: String

Obtiene esfuerzos para un elemento, en formato XML.

Parámetros:

ElementGUID: String - el GUID (en formato XML) del elemento

 

 

GetElementFiles (

string ElementGUID)

protected abstract: String

Obtiene métricas para un elemento, en formato XML.

Parámetros:

ElementGUID: String - el GUID (en formato XML) del elemento

 

 

GetElementMetrics (

string ElementGUID)

protected abstract: String

Obtiene archivos para un elemento, en formato XML.

Parámetros:

ElementGUID: String - el GUID (en formato XML) del elemento

 

 

GetElementProblems (

string ElementGUID)

protected abstract: String

Obtiene una lista de problemas asociados con un elemento, en formato XML.

Parámetros:

ElementGUID: String - el GUID (en formato XML) del elemento

 

 

GetElementProperties (

string ElementGUID)

protected abstract: String

Obtiene valores Etiquetados para un elemento, en formato XML.

Parámetros:

ElementGUID: String - el GUID (en formato XML) del elemento

 

 

GetElementRequirements (

string ElementGUID)

protected abstract: String

Obtiene una lista de requisitos para un elemento, en formato XML.

Parámetros:

ElementGUID: String - el GUID (en formato XML) del elemento

 

 

GetElementResources (

string ElementGUID)

protected abstract: String

Obtiene una lista de recursos para un elemento, en formato XML.

Parámetros:

ElementGUID: String - el GUID (en formato XML) del elemento

 

 

GetElementRisks (

string ElementGUID)

protected abstract: String

Obtiene una lista de riesgos asociados con un elemento, en formato XML.

Parámetros:

ElementGUID: String - el GUID (en formato XML) del elemento

 

 

GetElementScenarios (

string ElementGUID)

protected abstract: String

Obtiene una lista de escenarios para un elemento, en formato XML.

Parámetros:

ElementGUID: String - el GUID (en formato XML) del elemento

 

 

GetElementTests (

string ElementGUID)

protected abstract: String

Obtiene una lista de pruebas para un elemento, en formato XML.

Parámetros:

ElementGUID: String - el GUID (en formato XML) del elemento

 

 

GetFileNameDialog (

string Filename,

string FilterString,

long FilterIndex,

long Flags,

string InitialDirectory,

long OpenOrSave)

 

String

Abre una ventana estándar de Abrir Archivo o Guardar Como y devuelve una cadena que contiene la ruta completa del archivo seleccionado en caso de éxito. Devuelve una cadena vacía si la ventana fue cancelada.

Por ejemplo:

Filename = ""

FilterString = "CSV Files (*.csv)|*.csv|All Files (*.*)|*.*||"

Filterindex = 1

Flags = &H2 'OFN_OVERWRITEPROMPT

InitialDirectory = ""

OpenOrSave = 1

filepath = Project.GetFileNameDialog (Filename, FilterString, Filterindex, Flags, InitialDirectory, OpenOrSave)

 

En este ejemplo, la ventana Guardar Como le solicitará un archivo CSV.

Parámetros:

Nombre de Archivo: String - nombre de archivo predeterminado especificado en la ventana

FilterString: String - lista delimitada de los filtros de tipo de archivo disponible

Filterindex: Long - Un índice basado en el filtro que se utilizará por defecto

Banderas: Long - banderas de bits adicionales para inicializar la ventana del archivo. Ver la estructura OPENFILENAME en la documentación MSDN para valores aceptados.

InitialDirectory: String - ruta del directorio a abrir esta ventana

OpenOrSave: Long - Mostrar la ventana como una ventana de estilo "Abrir" o "Guardar Como". Valores Aceptados: 0 = Abierto, 1 = Guardar como

 

 

GetLastError ()

protected abstract: String

Devuelve un valor de string describiendo el error más reciente que ocurrió en relación con este objeto.

 

 

GetLink (

string LinkGUID)

protected abstract: String

Obtiene los detalles del conector, en formato XML.

Parámetros:

LinkGUID: String - el GUID (en formato XML) del conector para obtener detalles de

 

 

GUIDtoXML (

string GUID)

String

Cambia un GUID interno a la forma utilizada en XML.

Parámetros:

GUID: String - el GUID de estilo de Enterprise Architect para convertir a formato XML

 

 

ImportDirectory (

string PackageGUID,

string Language,

string DirectoryPath,

string ExtraOptions)

Boolean

Importa un directorio de código fuente al modelo.

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete para hacer ingeniería inversa del código hacia

Lenguaje: String - especifica el lenguaje del código a importar.

DirectoryPath: String - especifica la ruta de donde se encuentra el código en la computadora

ExtraOptions: String - permite que se den opciones adicionales al comando; actualmente permite la importación de la fuente de todos los directorios hijos (recursivo) - por ejemplo: recurse=1

 

 

ImportFile (

string PackageGUID,

string Language,

string FileName,

string ExtraOptions)

Boolean

Importa un archivo individual o un módulo binario al modelo, en un paquete por importación de estilo del espacio de nombres.

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete para hacer ingeniería inversa del código hacia; esto se espera que sea un paquete raíz de espacio de nombre.

Lenguaje: String - especifica el lenguaje del código a importar.

 

Utilice el valor "DNPE" para importar un módulo binario; esto importa un ensamblado de .Net o un archivo Java .class, pero no un archivo .jar.

Nombre de Archivo: String - especifica la ruta de donde se encuentra el código o módulo en la computadora

ExtraOptions: String - permite que se den opciones adicionales al comando; actualmente no se utiliza

 

 

ImportPackageXMI (

string PackageGUID,

string Filename,

long ImportDiagrams,

long StripGUID)

String

Importa un archivo XMI en un punto del árbol.

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete destino donde importar el archivo XMI (o sobrescribir con el archivo XMI)

Nombre de archivo o Texto XML: String - el nombre del archivo XMI

 

Si la cadena es de tipo nombre de archivo se interpreta como un archivo fuente; en caso contrario, la cadena se importa como texto XML.

ImportDiagrams: Long

StripGUID: Largo - valor booleano para indicar si se va a reemplazar el elemento UniqueIDs en la importación; si está despojado, luego un paquete podría ser importado dos veces en Enterprise Architect, como dos versiones diferentes

 

Devuelve una cadena vacía si fue exitoso, o devuelve un mensaje de error si hubo un fallo.

 

 

LayoutDiagram (

string DiagramGUID,

long LayoutStyle)

Boolean

Obsoleto. Es recomendable que sea utilizado LayoutDiagramEx en su lugar.

Llama a la función para diseñar automáticamente un diagrama de manera jerárquica. Sólo se recomienda para los diagramas de Clases y Objetos.

Parámetros:

DiagramGUID: String - el GUID (en formato XML) del diagrama a diseñar

LayoutStyle: Long - siempre ignorado

 

 

LayoutDiagramEx (

string DiagramGUID,

long LayoutStyle,

long Iterations,

long LayerSpacing,

long ColumnSpacing,

boolean SaveToDiagram)

Boolean

Llama a la función para diseñar automáticamente un diagrama de manera jerárquica. Sólo se recomienda para los diagramas de Clases y Objetos.

LayoutStyle acepta las siguientes opciones

Opciones Predeterminadas:

lsDiagramDefault

lsProgramDefault

 

Opciones de Eliminación de Ciclo:

lsCycleRemoveGreedy

lsCycleRemoveDFS

 

Opciones de Capas:

lsLayeringLongestPathSink

lsLayeringLongestPathSource

lsLayeringOptimalLinkLength

 

Opciones de Inicialización:

IsInitializeNaive

IsInitializeDFSOut

IsInitializeDFSIn

 

Opción de Reducción de Cruce:

lsCrossReduceAggressive

 

Opciones de diseño - Dirección

lsLayoutDirectionUp

lsLayoutDirectionDown

lsLayoutDirectionLeft

lsLayoutDirectionRight

 

Parámetros:

DiagramGUID: String - el GUID (en formato XML) del diagrama a diseñar

LayoutStyle: Long - el estilo de diseño

Iteraciones: Long - el número de iteraciones de diseño que debería tener el proceso de Diseño para realizar una reducción cruzada (Valor Predeterminado = 4).

LayerSpacing: Long - el espaciado de capas por elemento que debería utilizar el proceso de Diseño (Valor Predeterminado = 20).

ColumnSpacing: Long - el espaciado de columnas por elemento que debería utilizar el proceso de Diseño (Valor Predeterminado = 20)

SaveToDiagram: Booleano - especifica si Enterprise Architect debería o no guardar las opciones de diseño proporcionadas como predeterminado para el diagrama en cuestión

 

ConstLayoutStyles Enum

LoadControlledPackage (

string PackageGUID)

String

Carga un paquete que ha sido marcado y configurado como controlado. Los detalles del nombre de archivo se almacenan en los datos del control de paquetes.

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete a cargar

 

 

LoadDiagram (

string DiagramGUID)

protected abstract: Boolean

Carga un diagrama por su GUID.

Parámetro:

DiagramGUID: String - el GUID (en formato XML) del diagrama a cargar; si recupera el GUID utilizando la interfaz del Diagrama, utilice la función GUIDtoXML para convertirlo a formato XML

 

GUIDtoXML

LoadProject (

string FileName)

protected abstract: Boolean

Carga un archivo de proyecto de Enterprise Architect.

No utilice este método si ha accedido a la interfaz del Proyecto desde el Repositorio, que ya ha cargado un archivo.

Parámetros:

Nombre de Archivo: String - el nombre del archivo de proyecto a cargar

 

 

Migrate (

string GUID,

string SourceType,

string DestinationType)

Void

Migra un modelo (o de una parte de un modelo) desde un formato BPMN o SysML a un formato actualizado.

Parámetros:

GUID: String - el GUID del paquete o elemento para el cual los contenidos deben ser migrados

SourceType: String - el tipo de modelo que debe actualizarse; valores aceptados:

 

BPMN

BPMN1.1

SysML1.1

SysML1.2

 

DestinationType: String - el tipo de modelo a actualizar; valores aceptados:

 

BPMN1.1

BPMN1.1::BPEL

BPMN2.0

SysML1.2

SysML1.3

 

 

MigrateToBPMN11 (

string GUID,

string Type)

Void

Migra cada construcción BPMN 1.0 en un paquete o elemento (incluyendo elementos, atributos, diagramas y conectores) a BPMN 1.1.

Parámetros

GUID: String - el GUID del paquete o elemento para el cual los contenidos deben ser migrados a BPMN 1.1.

Tipo: String - el tipo de actualización, ya sea sólo a BPMN 1.1 o a BPMN 1.1 y BPEL. Los valores aceptados son:

 

BPMN = migrar a BPMN 1.1

BPEL = migrar a BPMN 1.1 y actualizar:

cualquier diagrama con el estereotipo de BPMN a BPEL

cualquier elemento con el estereotipo de BusinessProcess a BPELProcess

 

Migrar a BPEL es posible sólo en las ediciones Ultimate o de Ingeniería de Negocios y Software de Enterprise Architect.

 

 

ProjectTransfer (

string SourceFilePath,

string TargetFilePath,

string LogFilePath)

Boolean

Transfiere el proyecto de un archivo .EAP o DBMS a un archivo .EAP.

Parámetros:

SourceFilePath: String - la ruta del archivo fuente para transferir

TargetFilePath: String - la ruta del archivo de destino; Enterprise Architect crea un nuevo proyecto Base en esta ubicación

LogFilePath: String - la ruta del archivo de registro donde se actualiza el estado del proceso de transferencia

 

En automatización, el archivo de destino no tiene que existir; la ruta del archivo es suficiente. Enterprise Architect crea un nuevo, archivo fuente Base.EAP vacío y le transfiere la fuente.

 

 

PublishResult (

string CategoryID,

EA.EnumMVErrorType ErrorType,

string ErrorMessage)

String

Devuelve los resultados de cada regla que puede ser realizada durante la validación del modelo. Debe ser llamado una vez para cada regla de el manejador de transmisión EA_OnInitializeUserRules.

El valor de retorno es una Regla, la cual puede ser utilizada para fines de referencia cuando una regla individual es ejecutada por Enterprise Architect durante la validación del modelo.

Vea el Ejemplo de Validación del Modelo para un ejemplo detallado del uso de este método.

Parámetros:

CategoryId: String - se debe pasar el valor de retorno desde el método DefineRuleCategory

ErrorType: EA.EnumMVErrorType - dependiendo de la gravedad del error que se está validando, puede ser:

 

mvErrorCritical

mvError

mvWarning, o

mvInformation

 

ErrorMessage: String - contiene una cadena de error

 

EA_OnInitializeUserRules

Ejemplo de Validación de Modelos

DefineRuleCategory

PutDiagramImageOnClipboard (

string DiagramGUID,

long Type)

protected abstract: Boolean

Copia una imagen del diagrama especificado al portapapeles.

Parámetros:

DiagramGUID: String - el GUID (en formato XML) del paquete a copiar

Tipo: Long - el tipo de archivo

Si el Tipo = 0, entonces es un metarchivo

Si el Tipo = 1, entonces es un Bitmap Independiente del Dispositivo

 

 

PutDiagramImageToFile (

string Diagram GUID,

string FileName,

long Type)

protected abstract: Boolean

Guarda una imagen del diagrama especificado en el archivo.

Parámetros:

DiagramGUID: String - el GUID (en formato XML) del paquete a guardar

Nombre de Archivo: String - el nombre del archivo en el cual guardar el diagrama

Tipo: Long - el tipo de archivo

Si el tipo = 0, entonces es un metarchivo

Si el tipo = 1 entonces utiliza el tipo de archivo de la extensión del nombre (es decir, .bmp, .jpg, .gif, .png, .tga)

 

 

ReloadProject ()

protected abstract: Boolean

Volver a cargar el proyecto actual.

Este es un método conveniente para actualizar el actual proyecto cargado (en caso de cambios en el archivo .EAP).

 

 

RunModelSearch (

string Search,

string SearchTerm,

bool ShowInEA)

Void

Invoca el componente de la Búsqueda de Modelo.

Parámetros:

Búsqueda: String - el nombre de una búsqueda definida de Enterprise Architect

SearchTerm: Cadena - el término a buscar en el proyecto

ShowInEA: Booleano - ejecutar la búsqueda y la salida en la ventana de Búsqueda de Modelo

 

Búsqueda Modelo

Clase Repositorio (una llamada diferente para Ejecutar la Búsqueda de Modelo)

RunReport (

string PackageGUID,

string TemplateName,

string Filename)

protected abstract: Void

Ejecuta un informe de documento nombrado.

Parámetros:

PackageGUID: String - el GUID del paquete o documento maestro en el cual ejecutar el informe

TemplateName: String - la plantilla del informe de documento a utilizar; si el PackageGUID tiene un estereotipo de MasterDocument, la plantilla no es necesaria

Nombre de Archivo: String - el nombre y ruta del archivo con los cuales guardar el informe generado. La extensión del archivo especificado determinará el formato del documento generado. E.g. RTF, PDF.

 

Generar Documentación

Documentos Virtuales

RunHTMLReport (

string PackageGUID,

string ExportPath,

string ImageFormat,

string Style,

string Extension)

String

Ejecuta un informe HTML (como en el caso de Documentación | Documentación HTML cuando hace clic derecho en un paquete en el Explorador del Proyectos).

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete o documento maestro en el cual ejecutar el informe

ExportPath: String - la ruta del directorio en la cual guardar los archivos del informe generado.

ImageFormat: String - el formato de archivo en el cual almacenar imágenes - PNG o GIF.

Estilo: String - el nombre de la plantilla de estilo web para aplicar. Utilice <predeterminado> para la plantilla estándar proporcionada por el sistema

Extensión: String - la extensión del archivo para los archivos HTML generados (Ejemplo: .htm)

 

Crear un Informe HTML

Documentos Maestros y Documentos Modelo

SaveControlledPackage (

string PackageGUID)

String

Guarda un paquete que se ha configurado como un paquete controlado, de XMI. Sólo se requiere el GUID del paquete, Enterprise Architect recoge el resto de la información de control del paquete.

Parámetro:

PackageGUID: String - el GUID (en formato XML) del paquete a guardar

 

 

SaveDiagramImageToFile (

string Filename)

protected abstract: String

Guarda una imagen del diagrama del diagrama actual para en el archivo.

Parámetros:

Nombre de Archivo: Cadena - el nombre de archivo de la imagen a guardar.

 

 

ShowWindow (

long Show)

protected abstract: Void

Muestra u oculta la interfaz de Usuario de Enterprise Architect.

Parámetros:

Mostrar: Long

 

 

SynchronizeClass (

string ElementGUID,

string ExtraOptions)

Boolean

Sincroniza una Clase con el último código fuente.

Parámetros:

ElementGUID: String - el GUID (en formato XML) del elemento para actualizar desde el código

ExtraOptions: String - permite que se den opciones adicionales al comando; actualmente no se utiliza

 

 

SynchronizePackage (

string PackageGUID,

string ExtraOptions)

Boolean

Sincroniza cada Clase en un paquete con el último código fuente.

Parámetros:

PackageGUID: String - el GUID (en formato XML) del paquete que contiene los elementos para actualizar desde el código

ExtraOptions: String - permite que se den opciones adicionales al comando; actualmente permite la sincronización de todos los paquetes hijos - por ejemplo: children=1

 

 

TransformElement (

string TransformName,

string ElementGUID,

string TargetPackage,

string ExtraOptions)

Boolean

Transforma un elemento en un Paquete

Parámetros:

TransformName: String - especifica la transformación que debería ser ejecutada.

ElementGUID: String - el GUID (en formato XML) del elemento a transformar

TargetPackageGUID: String - el GUID (en formato XML) del paquete a transformar en

ExtraOptions: String - permite que se den opciones adicionales al comando:

GenCode=Verdadero/Falso - articular la generación de código a partir de los elementos transformados; esta opción sustituye a la configuración actual del modelo

 

 

TransformPackage (

string TransformName,

string SourcePackage,

string TargetPackage,

string ExtraOptions)

Boolean

Ejecuta una transformación en el contenido de un paquete.

Parámetros:

TransformName: String - especifica la transformación que debería ser ejecutada.

SourcePackageGUID: String - el GUID (en formato XML) del paquete a transformar

TargetPackageGUID: String - el GUID (en formato XML) del paquete a transformar en

ExtraOptions: String - permite que se den opciones adicionales al comando:

GenCode=verdadero/falso - articular la generación de código a partir de los elementos transformados; esta opción sustituye a la configuración actual del modelo

SubPackages=true/false - especifique si los paquetes hijos deben ser incluidos mientras transforma un paquete

 

 

ValidateDiagram (

string DiagramGUID)

Boolean

Invoca el componente de Validación del Modelo de Enterprise Architect, luego valida el diagrama y elementos (para corregir) y los elementos y conectores dentro del diagrama.

La Salida puede ser vista a través de Vista | Salida del Sistema > Validación del Modelo.

Devuelve un valor booleano para indicar el éxito o el fracaso del proceso, independientemente de los resultados de la validación.

Parámetros:

DiagramGUID: String - el GUID del objeto de Clase de Diagrama

 

 

 

 

 

 

 

 

 

 

 

 

 

Validación de Modelo

ValidateElement (

string ElementGUID)

Boolean

Invoca el componente de Validación del Modelo de Enterprise Architect, luego valida el elemento y todos los elementos, diagramas, conectores, atributos y operaciones hijos.

La Salida puede ser vista a través de Vista | Salida del Sistema > Validación del Modelo.

Devuelve un valor booleano para indicar el éxito o el fracaso del proceso, independientemente de los resultados de la validación.

Parámetros:

ElementGUID: String - el GUID del objeto de Clase del Elemento

 

ValidatePackage (

string PackageGUID)

Boolean

Invoca el componente de Validación del Modelo de Enterprise Architect, luego valida el paquete y todos los sub-paquetes, elementos, conectores y diagramas dentro de él.

La Salida puede ser vista a través de Vista | Salida del Sistema > Validación del Modelo.

Devuelve un valor booleano para indicar el éxito o el fracaso del proceso, independientemente de los resultados de la validación.

Parámetros:

PackageGUID: String - el GUID del objeto de Clase del Paquete

 

XMLtoGUID (

string GUID)

String

Cambia un GUID en formato XML para que sea la forma utilizada dentro de Enterprise Architect.

Parámetros:

GUID: String - el GUID de estilo XML para convertir al formato interno de Enterprise Architect

 

 

Notas

Todos estos métodos requieren GUIDs de entrada en formato XML; utilice GUIDtoXML para cambiar el GUID de Enterprise Architect a un GUID XML

Aprender más

GUIDtoXML