Documentacion: Goals_and_Roles

Descripcion: Roles which are responsible of the identified Goals. They are conceived having also in mind the tasks required to carry out those goals. There are five main groups about e-mail, document classification, communication with user, community management, mental states and category management.

The goal Manage Mental Entities includes those related with mental states. It is pursued by the role MentalManager. The task which satisfies it is HandleMentalStates. Both the task and the goal are internal to agents. Perhaps the MentalManager should not exist because it does not represent functionality externally offered to other roles.

All the goals related with providing service with the classification tool, both to administrate the taxonomy and to classify documents, are associated with the role ClassifyManager. Therefore, this role corresponds to the handler of the categorising tool and its related taxonomy.

The goals about the community management are engaged by the AgentManager role. This role is responsible of the tasks Add Requested Agent and Remove Requested Agent which satisfies the indicated goals.

The role UserInterface is created to run the communications with the user. So it attends the goals Attend User's Request and Manage Communication With User. It is the handler of the user's interface.

The e-mail goals are pursued by several roles. One main role, OrganizeEmailManager, coordinates the others which are related with specific goals. OrganizeEmailManager is concerned with the general goals like Manage Email and Increase Classified Emails. The other roles pursue very narrow goals. Examples of these are the goal Notify Incoming Email pursued by ClassifyEmailRequester and MakeEmailClassifiable by EmailProcessor.

Some of this roles have very little related functionality. They are mainly distinguished to elucidate the design. These roles are then grouped by heritage relationships and associating them to the same agent.


Instancias de entidades de meta-modelo

EntidadEntidad del meta-modeloDocumentacion
Add Requested Agents 
 Objetivo  Add to the Community the agents requested by the user. 
Attend User's Requests 
 Objetivo  Begin the actions requested by the user. This should be done avoiding as far as possible user's annoyance. 
Give Document Category 
 Objetivo  A category has to be provided to a document under request. The Categorizer assigns a category to the Document. The category could be obtained automatically or, if it is not possible, it will be asked to the user. 
Give Email Category 
 Objetivo  A category has to be provided to an e-mail under request. 
Increase Classified Emails 
 Objetivo  The MAS tries to increase the collection of classified emails. 
Maintain A Good Classification 
 Objetivo  Documents have to be related to the right category to avoid the user does not find them or wastes his time looking for them. 
Make Email Classifiable 
 Objetivo  There is an unique Categorizer to every document. Therefore the email has to be preprocessed before it could be categorised. 
Manage Categories 
 Objetivo  The system has to be able to add, remove and list categories and document in them under user's request. 
Manage Communication With User 
 Objetivo  Important information about the MAS activities should be notified to the user. This should be done avoiding disturb user. This could be done, for example, grouping the messages to him and giving the possibility of some management over them. 
Manage Email 
 Objetivo  It is the documents managent specialised in emails. 
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. 
Minimize Classification Questions To User 
 Objetivo  The MAS tries to save user's time. It should avoid asking to the user about the classification whenever it is possible. 
Notify Incoming Email 
 Objetivo  The MAS should process the incoming email. In order to accomplish this it should perceive the new email arrival and begins the corresponding process. 
Place Email In Folder 
 Objetivo  The e-mail should be moved to the assigned folder. 
Remove Requested Agents 
 Objetivo  Remove from the Community the agents requested by the user. 
Request Document Category 
 Objetivo   
Request Email Category 
 Objetivo   
Request Email Movement 
 Objetivo   
AgentManager 
 Rol  It manages the AgentsManagerApplication. This application is employed to add, remove and list agents in the system. 
ClassifyEmailManager 
 Rol  It manages the classifying process over an e-mail. 
ClassifyEmailRequester 
 Rol  It represents the requester of a classify action over an e-mail. 
ClassifyManager 
 Rol  It manages the Categorizer, both to classify documents and to administrate the categories and their related documents. 
ClassifyRequester 
 Rol  It represents the requester of a classify action over a document. 
EMailMoverManager 
 Rol  It manages the move action over an e-mail. It has knowledge about how to use the e-mail wrapper to move e-mail between locations. 
EmailMoverRequester 
 Rol  It represents the requester of a move action over an e-mail. 
EmailNotificationReceiver 
 Rol  It represents the event listener about new incoming email not already processed. 
EmailProcessor 
 Rol  It carries out the task ProcessEmail which convert an email in a document processable by the Categorizer. 
MentalManager 
 Rol  It makes the necessay actions over the agent mental entities to allow the cleaning of mental states and the maintaining of cyclic goals. 
OrganizeEmailManager 
 Rol  It coordinates the email management: perception, classification and movement with e-mails. 
UserInterface 
 Rol  It manages the user's interface and therefore the communication with the user. 

Add Requested Agents (Objetivo)

Properties:
IDAdd Requested Agents 
DescripcionAdd to the Community the agents requested by the user. 
estado 

Relaciones:
En el rolEn la relacion Otros extremos
WFPersigueDR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    AgentManager  WFPersigueOR
     

    Attend User's Requests (Objetivo)

    Properties:
    IDAttend User's Requests 
    DescripcionBegin the actions requested by the user. This should be done avoiding as far as possible user's annoyance. 
    estado 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueDR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    UserInterface  WFPersigueOR
     

    Give Document Category (Objetivo)

    Properties:
    IDGive Document Category 
    DescripcionA category has to be provided to a document under request. The Categorizer assigns a category to the Document. The category could be obtained automatically or, if it is not possible, it will be asked to the user. 
    estado 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueDR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    ClassifyManager  WFPersigueOR
     

    Give Email Category (Objetivo)

    Properties:
    IDGive Email Category 
    DescripcionA category has to be provided to an e-mail under request. 
    estado 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueDR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    ClassifyEmailManager  WFPersigueOR
     

    Increase Classified Emails (Objetivo)

    Properties:
    IDIncrease Classified Emails 
    DescripcionThe MAS tries to increase the collection of classified emails. 
    estado 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueDR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    OrganizeEmailManager  WFPersigueOR
     

    Maintain A Good Classification (Objetivo)

    Properties:
    IDMaintain A Good Classification 
    DescripcionDocuments have to be related to the right category to avoid the user does not find them or wastes his time looking for them. 
    estado 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueDR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    ClassifyManager  WFPersigueOR
     

    Make Email Classifiable (Objetivo)

    Properties:
    IDMake Email Classifiable 
    DescripcionThere is an unique Categorizer to every document. Therefore the email has to be preprocessed before it could be categorised. 
    estado 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueDR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    EmailProcessor  WFPersigueOR
     

    Manage Categories (Objetivo)

    Properties:
    IDManage Categories 
    DescripcionThe system has to be able to add, remove and list categories and document in them under user's request. 
    estado 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueDR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    ClassifyManager  WFPersigueOR
     

    Manage Communication With User (Objetivo)

    Properties:
    IDManage Communication With User 
    DescripcionImportant information about the MAS activities should be notified to the user. This should be done avoiding disturb user. This could be done, for example, grouping the messages to him and giving the possibility of some management over them. 
    estado 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueDR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    UserInterface  WFPersigueOR
     

    Manage Email (Objetivo)

    Properties:
    IDManage Email 
    DescripcionIt is the documents managent specialised in emails. 
    estado 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueDR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    OrganizeEmailManager  WFPersigueOR
     

    Manage Mental Entities (Objetivo)

    Properties:
    IDManage Mental Entities 
    DescripcionThe mental entities (goals, facts and events) have to be managed in order to allow the system works properly in an ongoing activity. 
    estado 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueDR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    MentalManager  WFPersigueOR
     

    Minimize Classification Questions To User (Objetivo)

    Properties:
    IDMinimize Classification Questions To User 
    DescripcionThe MAS tries to save user's time. It should avoid asking to the user about the classification whenever it is possible. 
    estado 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueDR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    ClassifyManager  WFPersigueOR
     

    Notify Incoming Email (Objetivo)

    Properties:
    IDNotify Incoming Email 
    DescripcionThe MAS should process the incoming email. In order to accomplish this it should perceive the new email arrival and begins the corresponding process. 
    estado 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueDR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    EmailNotificationReceiver  WFPersigueOR
     

    Place Email In Folder (Objetivo)

    Properties:
    IDPlace Email In Folder 
    DescripcionThe e-mail should be moved to the assigned folder. 
    estado 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueDR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    EMailMoverManager  WFPersigueOR
     

    Remove Requested Agents (Objetivo)

    Properties:
    IDRemove Requested Agents 
    DescripcionRemove from the Community the agents requested by the user. 
    estado 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueDR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    AgentManager  WFPersigueOR
     

    Request Document Category (Objetivo)

    Properties:
    IDRequest Document Category 
    Descripcion 
    estado 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueDR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    ClassifyRequester  WFPersigueOR
     

    Request Email Category (Objetivo)

    Properties:
    IDRequest Email Category 
    Descripcion 
    estado 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueDR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    ClassifyEmailRequester  WFPersigueOR
     

    Request Email Movement (Objetivo)

    Properties:
    IDRequest Email Movement 
    Descripcion 
    estado 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueDR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    EmailMoverRequester  WFPersigueOR
     

    AgentManager (Rol)

    Properties:
    IDAgentManager 
    DescripcionIt manages the AgentsManagerApplication. This application is employed to add, remove and list agents in the system. 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueOR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    Add Requested Agents  WFPersigueDR
    WFPersigueOR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    Remove Requested Agents  WFPersigueDR
     

    ClassifyEmailManager (Rol)

    Properties:
    IDClassifyEmailManager 
    DescripcionIt manages the classifying process over an e-mail. 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueOR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    Give Email Category  WFPersigueDR
     

    ClassifyEmailRequester (Rol)

    Properties:
    IDClassifyEmailRequester 
    DescripcionIt represents the requester of a classify action over an e-mail. 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueOR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    Request Email Category  WFPersigueDR
     

    ClassifyManager (Rol)

    Properties:
    IDClassifyManager 
    DescripcionIt manages the Categorizer, both to classify documents and to administrate the categories and their related documents. 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueOR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    Minimize Classification Questions To User  WFPersigueDR
    WFPersigueOR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    Maintain A Good Classification  WFPersigueDR
    WFPersigueOR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    Give Document Category  WFPersigueDR
    WFPersigueOR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    Manage Categories  WFPersigueDR
     

    ClassifyRequester (Rol)

    Properties:
    IDClassifyRequester 
    DescripcionIt represents the requester of a classify action over a document. 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueOR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    Request Document Category  WFPersigueDR
     

    EMailMoverManager (Rol)

    Properties:
    IDEMailMoverManager 
    DescripcionIt manages the move action over an e-mail. It has knowledge about how to use the e-mail wrapper to move e-mail between locations. 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueOR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    Place Email In Folder  WFPersigueDR
     

    EmailMoverRequester (Rol)

    Properties:
    IDEmailMoverRequester 
    DescripcionIt represents the requester of a move action over an e-mail. 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueOR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    Request Email Movement  WFPersigueDR
     

    EmailNotificationReceiver (Rol)

    Properties:
    IDEmailNotificationReceiver 
    DescripcionIt represents the event listener about new incoming email not already processed. 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueOR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    Notify Incoming Email  WFPersigueDR
     

    EmailProcessor (Rol)

    Properties:
    IDEmailProcessor 
    DescripcionIt carries out the task ProcessEmail which convert an email in a document processable by the Categorizer. 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueOR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    Make Email Classifiable  WFPersigueDR
     

    MentalManager (Rol)

    Properties:
    IDMentalManager 
    DescripcionIt makes the necessay actions over the agent mental entities to allow the cleaning of mental states and the maintaining of cyclic goals. 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueOR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    Manage Mental Entities  WFPersigueDR
     

    OrganizeEmailManager (Rol)

    Properties:
    IDOrganizeEmailManager 
    DescripcionIt coordinates the email management: perception, classification and movement with e-mails. 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueOR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    Manage Email  WFPersigueDR
    WFPersigueOR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    Increase Classified Emails  WFPersigueDR
     

    UserInterface (Rol)

    Properties:
    IDUserInterface 
    DescripcionIt manages the user's interface and therefore the communication with the user. 

    Relaciones:
    En el rolEn la relacion Otros extremos
    WFPersigueOR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    Manage Communication With User  WFPersigueDR
    WFPersigueOR WFPersigue
  • ID: 
    •  
    Con los objetosEn el rol
    Attend User's Requests  WFPersigueDR