Documentacion: Use_Cases_for_Personal_Assistants

Descripcion: Use cases to describe the functionality the assistant system should provide. Some of them are related to interactions in which they are specified in more detail with agent paradigm concepts.

The use case which illustrates the relevant functionality is Email Management. It reflects the actions the system takes when new mail arrives. These are obtain the new e-mail, classify it and move it to the appropiate folder. HDDocumentManagement is similar to this scenario but using hard disk documents instead of e-mail. The same use case is not used because additional actions could be taken over specific document types in the future. Manage Categories is related with the tasks the user do directly over the ontology, such as add, remove or lists categories. Finally, Manage Community represents the administrative operations over the system. These includes add, remove or lists existing agents.

Instancias de entidades de meta-modelo

Entidad	Entidad del meta-modelo	Documentacion
AddAgent	CasoUso	Add an agent to the community. The user gives the essential data about the agent. This data are the agent id and the relevant information needed in its creation.
ClassifyDocument	CasoUso	Categorize documents in one of the existing categories. If the Categorizer could not categorize the Document, the user's help is asked. The user could assign the document one existing category or create a new one.
ClassifyEmail	CasoUso	Categorize mail in one of the existing categories. This use case involves the additional processes required to prepare the email to the Categorizer tool.
ClassifyHDDocument	CasoUso	Categorize documents in one of the existing categories. This use case involves the additional processes needed to prepare the HD document to the Categorizer.
EmailManagement	CasoUso	The management of documents contained in the user´s email.
HDDocumentManagement	CasoUso	The management of documents contained in the user´s HD.
ManageCategories	CasoUso	It tries about how the document taxonomy is controlled and managed. It involves adding, removing and listing categories in the system and documents in them under user's request.
ManageCommunity	CasoUso	It tries about how the agent population is controlled and managed. It involves adding, removing and listing agents in the MAS.
MoveEmails	CasoUso	The email already classified is moved to the folder which corresponds to its category.
MoveHDFiles	CasoUso	The HD document already classified is moved to the folder which corresponds to its category.
OrganizeEmails	CasoUso	The ingoming mail is classified and moved to one of the existing folders according its category.
OrganizeHDDocuments	CasoUso	The new document is classified and moved to one of the existing folders according its category.
PCManagement	CasoUso	It involves the use cases in which the MAS helps the user in the task of better using the information in his machine. It is related with the detection of new or modified documents, their classification and therefore, the generation of relationships with other documents relevant to their topic.
RemoveAgent	CasoUso	Remove an agent from the community. The user gives the essential data about the agent. In this case, this data are only the agent id.
AddAgent	Interaccion	Add an agent to the community.
ClassifyDocument	Interaccion	Describes the interaction to classify a document with the ClassifyManager and the user (only if it is necessary).
ClassifyEmail	Interaccion	Describes the interaction to classify an email.
ClassifyHDDocument	Interaccion	Describes the interaction to classify a HD document.
ManageEmail	Interaccion	The ingoming mail is moved to one of the existing folders according its category.
MoveEmail	Interaccion	Describes the interaction to move a classified email to its corresponding folder.
MoveFiles	Interaccion	Describes the interaction to move a classified HD file to its corresponding folder.
RemoveAgent	Interaccion	Remove an agent from the community.

AddAgent (CasoUso)

Properties:

ID	AddAgent
Descripcion	Add an agent to the community. The user gives the essential data about the agent. This data are the agent id and the relevant information needed in its creation.

AddAgent relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLEspecificaOR	UMLEspecifica	AddAgent	UMLEspecificaDR

UMLIncluirCasoUsoDR	UMLIncluirCasoUso	ManageCommunity	UMLIncluirCasoUsoOR

ClassifyDocument (CasoUso)

Properties:

ID	ClassifyDocument
Descripcion	Categorize documents in one of the existing categories. If the Categorizer could not categorize the Document, the user's help is asked. The user could assign the document one existing category or create a new one.

ClassifyDocument relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLEspecificaOR	UMLEspecifica	ClassifyDocument	UMLEspecificaDR

UMLIncluirCasoUsoDR	UMLIncluirCasoUso	ClassifyEmail	UMLIncluirCasoUsoOR

UMLIncluirCasoUsoDR	UMLIncluirCasoUso	ClassifyHDDocument	UMLIncluirCasoUsoOR

ClassifyEmail (CasoUso)

Properties:

ID	ClassifyEmail
Descripcion	Categorize mail in one of the existing categories. This use case involves the additional processes required to prepare the email to the Categorizer tool.

ClassifyEmail relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLEspecificaOR	UMLEspecifica	ClassifyEmail	UMLEspecificaDR

UMLIncluirCasoUsoDR	UMLIncluirCasoUso	OrganizeEmails	UMLIncluirCasoUsoOR

UMLIncluirCasoUsoOR	UMLIncluirCasoUso	ClassifyDocument	UMLIncluirCasoUsoDR

ClassifyHDDocument (CasoUso)

Properties:

ID	ClassifyHDDocument
Descripcion	Categorize documents in one of the existing categories. This use case involves the additional processes needed to prepare the HD document to the Categorizer.

ClassifyHDDocument relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLEspecificaOR	UMLEspecifica	ClassifyHDDocument	UMLEspecificaDR

UMLIncluirCasoUsoDR	UMLIncluirCasoUso	OrganizeHDDocuments	UMLIncluirCasoUsoOR

UMLIncluirCasoUsoOR	UMLIncluirCasoUso	ClassifyDocument	UMLIncluirCasoUsoDR

EmailManagement (CasoUso)

Properties:

ID	EmailManagement
Descripcion	The management of documents contained in the user´s email.

EmailManagement relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLIncluirCasoUsoDR	UMLIncluirCasoUso	PCManagement	UMLIncluirCasoUsoOR

UMLIncluirCasoUsoOR	UMLIncluirCasoUso	OrganizeEmails	UMLIncluirCasoUsoDR

HDDocumentManagement (CasoUso)

Properties:

ID	HDDocumentManagement
Descripcion	The management of documents contained in the user´s HD.

HDDocumentManagement relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLIncluirCasoUsoDR	UMLIncluirCasoUso	PCManagement	UMLIncluirCasoUsoOR

UMLIncluirCasoUsoOR	UMLIncluirCasoUso	OrganizeHDDocuments	UMLIncluirCasoUsoDR

ManageCategories (CasoUso)

Properties:

ID	ManageCategories
Descripcion	It tries about how the document taxonomy is controlled and managed. It involves adding, removing and listing categories in the system and documents in them under user's request.

ManageCategories relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLIncluirCasoUsoDR	UMLIncluirCasoUso	PCManagement	UMLIncluirCasoUsoOR

ManageCommunity (CasoUso)

Properties:

ID	ManageCommunity
Descripcion	It tries about how the agent population is controlled and managed. It involves adding, removing and listing agents in the MAS.

ManageCommunity relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLIncluirCasoUsoDR	UMLIncluirCasoUso	PCManagement	UMLIncluirCasoUsoOR

UMLIncluirCasoUsoOR	UMLIncluirCasoUso	AddAgent	UMLIncluirCasoUsoDR

UMLIncluirCasoUsoOR	UMLIncluirCasoUso	RemoveAgent	UMLIncluirCasoUsoDR

MoveEmails (CasoUso)

Properties:

ID	MoveEmails
Descripcion	The email already classified is moved to the folder which corresponds to its category.

MoveEmails relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLEspecificaOR	UMLEspecifica	MoveEmail	UMLEspecificaDR

UMLIncluirCasoUsoDR	UMLIncluirCasoUso	OrganizeEmails	UMLIncluirCasoUsoOR

MoveHDFiles (CasoUso)

Properties:

ID	MoveHDFiles
Descripcion	The HD document already classified is moved to the folder which corresponds to its category.

MoveHDFiles relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLEspecificaOR	UMLEspecifica	MoveFiles	UMLEspecificaDR

UMLIncluirCasoUsoDR	UMLIncluirCasoUso	OrganizeHDDocuments	UMLIncluirCasoUsoOR

OrganizeEmails (CasoUso)

Properties:

ID	OrganizeEmails
Descripcion	The ingoming mail is classified and moved to one of the existing folders according its category.

OrganizeEmails relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLEspecificaOR	UMLEspecifica	ManageEmail	UMLEspecificaDR

UMLIncluirCasoUsoDR	UMLIncluirCasoUso	EmailManagement	UMLIncluirCasoUsoOR

UMLIncluirCasoUsoOR	UMLIncluirCasoUso	MoveEmails	UMLIncluirCasoUsoDR

UMLIncluirCasoUsoOR	UMLIncluirCasoUso	ClassifyEmail	UMLIncluirCasoUsoDR

OrganizeHDDocuments (CasoUso)

Properties:

ID	OrganizeHDDocuments
Descripcion	The new document is classified and moved to one of the existing folders according its category.

OrganizeHDDocuments relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLIncluirCasoUsoDR	UMLIncluirCasoUso	HDDocumentManagement	UMLIncluirCasoUsoOR

UMLIncluirCasoUsoOR	UMLIncluirCasoUso	MoveHDFiles	UMLIncluirCasoUsoDR

UMLIncluirCasoUsoOR	UMLIncluirCasoUso	ClassifyHDDocument	UMLIncluirCasoUsoDR

PCManagement (CasoUso)

Properties:

ID	PCManagement
Descripcion	It involves the use cases in which the MAS helps the user in the task of better using the information in his machine. It is related with the detection of new or modified documents, their classification and therefore, the generation of relationships with other documents relevant to their topic.

PCManagement relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLIncluirCasoUsoOR	UMLIncluirCasoUso	EmailManagement	UMLIncluirCasoUsoDR

UMLIncluirCasoUsoOR	UMLIncluirCasoUso	HDDocumentManagement	UMLIncluirCasoUsoDR

UMLIncluirCasoUsoOR	UMLIncluirCasoUso	ManageCommunity	UMLIncluirCasoUsoDR

UMLIncluirCasoUsoOR	UMLIncluirCasoUso	ManageCategories	UMLIncluirCasoUsoDR

RemoveAgent (CasoUso)

Properties:

ID	RemoveAgent
Descripcion	Remove an agent from the community. The user gives the essential data about the agent. In this case, this data are only the agent id.

RemoveAgent relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLEspecificaOR	UMLEspecifica	RemoveAgent	UMLEspecificaDR

UMLIncluirCasoUsoDR	UMLIncluirCasoUso	ManageCommunity	UMLIncluirCasoUsoOR

AddAgent (Interaccion)

Properties:

Etiqueta	AddAgent
Descripcion	Add an agent to the community.
Naturaleza_Interaccion	cooperacion

AddAgent relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLEspecificaDR	UMLEspecifica	AddAgent	UMLEspecificaOR

Diagramas relacionados
AddAgent_Interaction

ClassifyDocument (Interaccion)

Properties:

Etiqueta	ClassifyDocument
Descripcion	Describes the interaction to classify a document with the ClassifyManager and the user (only if it is necessary).
Naturaleza_Interaccion	cooperacion

ClassifyDocument relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLEspecificaDR	UMLEspecifica	ClassifyDocument	UMLEspecificaOR

Diagramas relacionados
ClassifyDocument_Interaction

ClassifyEmail (Interaccion)

Properties:

Etiqueta	ClassifyEmail
Descripcion	Describes the interaction to classify an email.
Naturaleza_Interaccion	cooperacion

ClassifyEmail relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLEspecificaDR	UMLEspecifica	ClassifyEmail	UMLEspecificaOR

Diagramas relacionados
ClassifyEmail_Interaction

ClassifyHDDocument (Interaccion)

Properties:

Etiqueta	ClassifyHDDocument
Descripcion	Describes the interaction to classify a HD document.
Naturaleza_Interaccion	cooperacion

ClassifyHDDocument relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLEspecificaDR	UMLEspecifica	ClassifyHDDocument	UMLEspecificaOR

ManageEmail (Interaccion)

Properties:

Etiqueta	ManageEmail
Descripcion	The ingoming mail is moved to one of the existing folders according its category.
Naturaleza_Interaccion	cooperacion

ManageEmail relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLEspecificaDR	UMLEspecifica	OrganizeEmails	UMLEspecificaOR

Diagramas relacionados
ManageEmail_Interaction

MoveEmail (Interaccion)

Properties:

Etiqueta	MoveEmail
Descripcion	Describes the interaction to move a classified email to its corresponding folder.
Naturaleza_Interaccion	cooperacion

MoveEmail relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLEspecificaDR	UMLEspecifica	MoveEmails	UMLEspecificaOR

Diagramas relacionados
MoveEmail_Interaction

MoveFiles (Interaccion)

Properties:

Etiqueta	MoveFiles
Descripcion	Describes the interaction to move a classified HD file to its corresponding folder.
Naturaleza_Interaccion	cooperacion

MoveFiles relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLEspecificaDR	UMLEspecifica	MoveHDFiles	UMLEspecificaOR

RemoveAgent (Interaccion)

Properties:

Etiqueta	RemoveAgent
Descripcion	Remove an agent from the community.
Naturaleza_Interaccion	cooperacion

RemoveAgent relaciones:

En el rol	En la relacion	Con los objetos	En el rol
UMLEspecificaDR	UMLEspecifica	RemoveAgent	UMLEspecificaOR

Diagramas relacionados
RemoveAgent_Interaction