Actividades

org.eclipse.ui.activities

3.0

El punto de extensión org.eclipse.ui.activities se utiliza para declarar actividades y elementos asociados. La plataforma utiliza las actividades para filtrar determinadas contribuciones de conector de la vista de los usuarios hasta que éstos muestran interés en ellas. Esto permite a Eclipse crecer dinámicamente en función del patrón de utilización de los usuarios.

<!ELEMENT extension (activity , activityRequirementBinding , activityPatternBinding , category , categoryActivityBinding , defaultEnablement)*>

<!ATTLIST extension

id    CDATA #IMPLIED

name  CDATA #IMPLIED

point CDATA #REQUIRED>


<!ELEMENT activity EMPTY>

<!ATTLIST activity

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED>

Este elemento se utiliza para definir actividades. Si existe más de uno de estos elementos con el mismo atributo id, sólo se considera válido el último elemento declarado (por orden de lectura del registro).



<!ELEMENT activityRequirementBinding EMPTY>

<!ATTLIST activityRequirementBinding

requiredActivityId CDATA #REQUIRED

activityId         CDATA #REQUIRED>

Este elemento permite enlazar actividades con actividades. La relación se establece de modo que el activityId se habilita cuando también lo hace el requiredActivityId.



<!ELEMENT activityPatternBinding EMPTY>

<!ATTLIST activityPatternBinding

activityId CDATA #REQUIRED

pattern    CDATA #REQUIRED>

Este elemento permite enlazar actividades con patrones.



<!ELEMENT category EMPTY>

<!ATTLIST category

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED>

Este elemento se utiliza para definir categorías. Si existe más de uno de estos elementos con el mismo atributo id, sólo se considera válido el último elemento declarado (por orden de lectura del registro).



<!ELEMENT categoryActivityBinding EMPTY>

<!ATTLIST categoryActivityBinding

activityId CDATA #REQUIRED

categoryId CDATA #REQUIRED>

Este elemento permite enlazar categorías con actividades.



<!ELEMENT defaultEnablement EMPTY>

<!ATTLIST defaultEnablement

id CDATA #REQUIRED>

Este elemento permite especificar que una actividad determinada debe habilitarse por omisión.



A continuación figura un ejemplo de varias definiciones de actividades y categorías, así como los enlaces asociados.

 

<extension point=

"org.eclipse.ui.activities"

>

<activity id=

"com.xyz.Activity"

description=

"Filtra contribuciones de com.xyz"

name=

"Mi actividad"

/>

<activity id=

"com.xyz.OtherActivity"

description=

"Filtra otras contribuciones de com.xyz"

name=

"Mi otra actividad"

/>

<!-- otra actividad requiere actividad -->

<activityRequirementBinding activityId=

"com.xyz.OtherActivity"

requiredActivityId=

"com.xyz.Activity"

/>

<category id=

"com.xyz.Category"

description=

"com.xyz Activities"

name=

"Mi categoría"

/>

<!-- colocar la actividad en la categoría -->

<categoryActivityBinding activityId=

"com.xyz.Activity"

categoryId=

"com.xyz.Category"

/>

<!-- enlazar todas las contribuciones del conector com.xyz -->

<activityPatternBinding id=

"com.xyz.Activity"

pattern=

"com\.xyz/.*"

/>

<!-- enlazar my.contribution del conector com.xyz.other -->

<activityPatternBinding id=

"com.xyz.OtherActivity"

pattern=

"com\.xyz\.other/my.contribution"

/>

<!-- la actividad debe habilitarse por omisión -->

<defaultEnablement id=

"com.xyz.Activity"

/>

</extension>

Actualmente no existe ninguna API pública para declarar actividades o elementos asociados aparte de este punto de extensión. Puede accederse al estado de las actividades en el entorno de trabajo por medio de org.eclipse.ui.IWorkbench.getActivitySupport(). Desde aquí puede consultar el conjunto de actividades habilitadas actualmente.

El entorno de trabajo no suministra "actividades por omisión". Las actividades deben definirse a nivel de producto, como por ejemplo el SDK de Eclipse, a fin de integrar estrechamente todos los componentes (conocidos) que contiene el producto.