Documentacion: Personal_Assistants_in_the_PC

Descripcion: Organization description. It includes the groups and agents which compose the organization and the applications they own. It also shows the workflows the organization carries out to satisfy its goals and these goals.

This system is composed by just one organization, PCManagers. This has two global goals: Manage PC and Manage Mental Entities. The organization is composed by three groups: Administration, EmailManager and HDDocumentsManager. Its activities are organized in several workflows. The root one is Manage PC.

The Manage PC goal is related with the system purpose about helping the user's work with the computer. It includes the tasks related with the documents in the hard disk and e-mail and the classification of documents. The Manage Mental Entities goal has an administrative purpose. It covers the updates needed over agents mental states to run properly the system.

The system is decomposed in three groups according to their different goals and tasks. The Administration group is related with the tasks which are global to the system, that is, those shared between different document types and information sources. This group includes the agents Classifier and UserSpeaker. The first one manages the classification tool, the Categorizer, and the second one manages the communications with the user through an interface, the UserInterface. Administration owns also the AgentsManagerApplication. This program is used by agents in the system to add more of them or to removed themselves from the system. The EmailManagers group includes EmailOrganizer agents. These agents are connected with an EmailWrapper to carry out the tasks about the new e-mail. The last group is HDDocumentManagers. This group has HDDocumentOrganizer agents which use the HardDisk in order to manage the documents in the internal storage devices.

System activities are specified in five main workflows. The worflow which acts like a frame for the global activity is Manage PC. It is decomposed in Manage HD Documents, Manage Email, Manage Agents and Manage Categories. Manage Categories includes the tasks involved in the manual changes to the taxonomy. Manage Agents includes those activities which add and remove agents in the system. Manage Email and Manage HD Documents are very similar workflows. The first one deals with e-mail and the second one with documents in the hard disk. Both of them perceive the creation of a new document, classify it, move it to a folder according its category and make the corresponding notifications. These workflows covers the expected system functionality.

Instancias de entidades de meta-modelo

Entidad	Entidad del meta-modelo	Documentacion
Classifier	Agente	It represents the agent which manages the Classifier and makes the operations over the categories.
EmailOrganizer	Agente	It represents the agent which manages the email in the system. It is related with an EmailWrapper.
HDDocumentOrganizer	Agente	It represents the agent which manages the HD documents in the system. It is related with an HardDisk.
UserSpeaker	Agente	It represents the agent which manages the communications with the user through an interface. It is related with an UserDevice.
HardDisk	AplicacionEntorno	Hard Disk. It has operations to get the HD folders and the files in them and to move files between folders. It also has an event which notifies there is a new file.
AgentsManagerApplication	AplicacionInterna	It is an agent factory employed in the agent management. It provides operations to create, remove and list agents in the community.
Categorizer	AplicacionInterna	It is a wrapper to a text mining tool. It manages a category taxonomy. It provides operations to create new categories, add documents to these categories, obtain a category list and to get the category of a document.
EmailWrapper	AplicacionInterna	Wrapper for a mailing tool. It has operations to get the mail folders and the mails in them and to move mails between folders. It also has an event which notifies there is new email.
UserDevice	AplicacionInterna	It represents every device used to communicate with users. It provides operations to send and receive general notifications from or to the interface and to receive requests about adding or removing agents.
Manage Agents	FlujoDeTrabajo	This workflow includes the tasks to control and survey the agent population in the MAS. These tasks are adding new agents, removing agents in the system and listing the agents in the system. The later has not been specified.
Manage Categories	FlujoDeTrabajo	This workflow includes the tasks to add new categories, remove existing categories and lists the categories. It allows also to add, remove and list documents in categories.
Manage Email	FlujoDeTrabajo	This workflow includes the tasks to perceive a new incoming email, classify it, move it to the category folder and make the relevant notifications.
Manage HD Documents	FlujoDeTrabajo	This workflow includes the tasks to perceive a new document in the hard disk, classify it, move it to the category folder and make the relevant notifications.
Manage PC	FlujoDeTrabajo	The main workflow which covers all the activities.
Administration	Grupo
EmailManagers	Grupo
HDDocumentManagers	Grupo
Manage Mental Entities	Objetivo	The mental entities (goals, facts and events) have to be managed in order to allow the system works properly in an ongoing activity.
Manage PC	Objetivo	The main system goal is helping user in the management of his documents.
Organizacion	Organizacion

Classifier (Agente)

Propiedades:

ID	Classifier
Descripcion	It represents the agent which manages the Classifier and makes the operations over the categories.

Classifier relaciones:

En el rol	En la relacion	Con los objetos	En el rol
OTieneAgente_destino	OTieneAgente	Administration	OTieneAgente_origen

RGrupo	OTieneRecurso	Categorizer	RRecurso

EmailOrganizer (Agente)

Propiedades:

ID	EmailOrganizer
Descripcion	It represents the agent which manages the email in the system. It is related with an EmailWrapper.

EmailOrganizer relaciones:

En el rol	En la relacion	Con los objetos	En el rol
OTieneAgente_destino	OTieneAgente	EmailManagers	OTieneAgente_origen

HDDocumentOrganizer (Agente)

Propiedades:

ID	HDDocumentOrganizer
Descripcion	It represents the agent which manages the HD documents in the system. It is related with an HardDisk.

HDDocumentOrganizer relaciones:

En el rol	En la relacion	Con los objetos	En el rol
OTieneAgente_destino	OTieneAgente	HDDocumentManagers	OTieneAgente_origen

UserSpeaker (Agente)

Propiedades:

ID	UserSpeaker
Descripcion	It represents the agent which manages the communications with the user through an interface. It is related with an UserDevice.

UserSpeaker relaciones:

En el rol	En la relacion	Con los objetos	En el rol
OTieneAgente_destino	OTieneAgente	Administration	OTieneAgente_origen

RGrupo	OTieneRecurso	UserDevice	RRecurso

HardDisk (AplicacionEntorno)

Propiedades:

ID	HardDisk
Descripcion	Hard Disk. It has operations to get the HD folders and the files in them and to move files between folders. It also has an event which notifies there is a new file.
Operaciones	getFolders getFilesInFolder moveFile newFileCreated

HardDisk relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RRecurso	OTieneRecurso	HDDocumentManagers	RGrupo

AgentsManagerApplication (AplicacionInterna)

Propiedades:

ID	AgentsManagerApplication
Descripcion	It is an agent factory employed in the agent management. It provides operations to create, remove and list agents in the community.
Operaciones	addAgent removeAgent listAgents

AgentsManagerApplication relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RRecurso	OTieneRecurso	Administration	RGrupo

Categorizer (AplicacionInterna)

Propiedades:

ID	Categorizer
Descripcion	It is a wrapper to a text mining tool. It manages a category taxonomy. It provides operations to create new categories, add documents to these categories, obtain a category list and to get the category of a document.
Operaciones	createCategory addDocumentsToCategory enableCategorizer disableCategorizer getDocumentCategory getCategoryList

Categorizer relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RRecurso	OTieneRecurso	Classifier	RGrupo

EmailWrapper (AplicacionInterna)

Propiedades:

ID	EmailWrapper
Descripcion	Wrapper for a mailing tool. It has operations to get the mail folders and the mails in them and to move mails between folders. It also has an event which notifies there is new email.
Operaciones	getMailFolders getEmailsInFolder moveEmailToFolder newEmailReceived

EmailWrapper relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RRecurso	OTieneRecurso	EmailManagers	RGrupo

UserDevice (AplicacionInterna)

Propiedades:

ID	UserDevice
Descripcion	It represents every device used to communicate with users. It provides operations to send and receive general notifications from or to the interface and to receive requests about adding or removing agents.
Operaciones	sentMesage receiveMessage addNewAgent removeAgent

UserDevice relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RRecurso	OTieneRecurso	UserSpeaker	RGrupo

Manage Agents (FlujoDeTrabajo)

Propiedades:

ID	Manage Agents
Descripcion	This workflow includes the tasks to control and survey the agent population in the MAS. These tasks are adding new agents, removing agents in the system and listing the agents in the system. The later has not been specified.

Manage Agents relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RFlujoTrabajo	OTieneFlujosTrabajo	Manage PC	RFlujoTrabajo
		Manage HD Documents	RFlujoTrabajo
		Manage Email	RFlujoTrabajo
		Manage Categories	RFlujoTrabajo

Diagramas relacionados
ManageAgents_Workflow

Manage Categories (FlujoDeTrabajo)

Propiedades:

ID	Manage Categories
Descripcion	This workflow includes the tasks to add new categories, remove existing categories and lists the categories. It allows also to add, remove and list documents in categories.

Manage Categories relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RFlujoTrabajo	OTieneFlujosTrabajo	Manage PC	RFlujoTrabajo
		Manage HD Documents	RFlujoTrabajo
		Manage Email	RFlujoTrabajo
		Manage Agents	RFlujoTrabajo

Diagramas relacionados
ManageCategories_Workflow

Manage Email (FlujoDeTrabajo)

Propiedades:

ID	Manage Email
Descripcion	This workflow includes the tasks to perceive a new incoming email, classify it, move it to the category folder and make the relevant notifications.

Manage Email relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RFlujoTrabajo	OTieneFlujosTrabajo	Manage PC	RFlujoTrabajo
		Manage HD Documents	RFlujoTrabajo
		Manage Agents	RFlujoTrabajo
		Manage Categories	RFlujoTrabajo

Diagramas relacionados
Collaboration for document relationships
ManageEmail_Workflow

Manage HD Documents (FlujoDeTrabajo)

Propiedades:

ID	Manage HD Documents
Descripcion	This workflow includes the tasks to perceive a new document in the hard disk, classify it, move it to the category folder and make the relevant notifications.

Manage HD Documents relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RFlujoTrabajo	OTieneFlujosTrabajo	Manage PC	RFlujoTrabajo
		Manage Email	RFlujoTrabajo
		Manage Agents	RFlujoTrabajo
		Manage Categories	RFlujoTrabajo

Diagramas relacionados
ManageHDDocuments_Workflow

Manage PC (FlujoDeTrabajo)

Propiedades:

ID	Manage PC
Descripcion	The main workflow which covers all the activities.

Manage PC relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RFlujoTrabajo	OTieneFlujosTrabajo	Organizacion	RFlujoTrabajo

RFlujoTrabajo	OTieneFlujosTrabajo	Manage HD Documents	RFlujoTrabajo
		Manage Email	RFlujoTrabajo
		Manage Agents	RFlujoTrabajo
		Manage Categories	RFlujoTrabajo

Administration (Grupo)

Propiedades:

ID	Administration
Descripcion

Administration relaciones:

En el rol	En la relacion	Con los objetos	En el rol
ODescomposicionGrupos_destino	OTieneGrupo	Organizacion	OTiene_grupo_origen

OTieneAgente_origen	OTieneAgente	UserSpeaker	OTieneAgente_destino

OTieneAgente_origen	OTieneAgente	Classifier	OTieneAgente_destino

RGrupo	OTieneRecurso	AgentsManagerApplication	RRecurso

EmailManagers (Grupo)

Propiedades:

ID	EmailManagers
Descripcion

EmailManagers relaciones:

En el rol	En la relacion	Con los objetos	En el rol
ODescomposicionGrupos_destino	OTieneGrupo	Organizacion	OTiene_grupo_origen

OTieneAgente_origen	OTieneAgente	EmailOrganizer	OTieneAgente_destino

RGrupo	OTieneRecurso	EmailWrapper	RRecurso

HDDocumentManagers (Grupo)

Propiedades:

ID	HDDocumentManagers
Descripcion

HDDocumentManagers relaciones:

En el rol	En la relacion	Con los objetos	En el rol
ODescomposicionGrupos_destino	OTieneGrupo	Organizacion	OTiene_grupo_origen

OTieneAgente_origen	OTieneAgente	HDDocumentOrganizer	OTieneAgente_destino

RGrupo	OTieneRecurso	HardDisk	RRecurso

Manage Mental Entities (Objetivo)

Propiedades:

ID	Manage Mental Entities
Descripcion	The mental entities (goals, facts and events) have to be managed in order to allow the system works properly in an ongoing activity.
estado

Manage Mental Entities relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RObjetivo	EntidadAutonomaTieneObjetivos	Organizacion	REntidadAutonoma

Manage PC (Objetivo)

Propiedades:

ID	Manage PC
Descripcion	The main system goal is helping user in the management of his documents.
estado

Manage PC relaciones:

En el rol	En la relacion	Con los objetos	En el rol
RObjetivo	EntidadAutonomaTieneObjetivos	Organizacion	REntidadAutonoma

Organizacion (Organizacion)

Propiedades:

ID	PCManagers
Descripcion

Organizacion relaciones:

En el rol	En la relacion	Con los objetos	En el rol
OTiene_grupo_origen	OTieneGrupo	HDDocumentManagers	ODescomposicionGrupos_destino

OTiene_grupo_origen	OTieneGrupo	EmailManagers	ODescomposicionGrupos_destino

OTiene_grupo_origen	OTieneGrupo	Administration	ODescomposicionGrupos_destino

REntidadAutonoma	EntidadAutonomaTieneObjetivos	Manage PC	RObjetivo

REntidadAutonoma	EntidadAutonomaTieneObjetivos	Manage Mental Entities	RObjetivo

RFlujoTrabajo	OTieneFlujosTrabajo	Manage PC	RFlujoTrabajo