Documentacion: AddAgent_TasksAndGoals

Descripcion: Complete description of the tasks, interactions, facts and events involved in the workflow AddAgent. The workflow goal is to add a requested agent.

The workflow is specified without and with the FIPA-Request protocol. In the first diagram the possible communications in the workflow relies in its specific tasks. In the second diagram the communication is explicitly carried out by the tasks in the FIPA-Request protocol. The following descriptions do not consider communication matters.

The workflow begins with an user's action catched by InteractWithUser. This action is represented by the AddNewAgent event. InteractWithUser generates with this event the AgentToAdd fact. This fact is consumed by AddAgent, which actually carries out the required labour. This task uses the AgentManagerApplication. The AddAgent task could generate one of two facts: AgentCreated or AgentNotCreated. The first one occurs when the agent has been successfully created and the second one when adding has not been possible. The success (AgentCreated fact) or fail (AgentNotCreated fact) notification is communicated by the AgentManager to the UserInterface requester thanks to the combined action of AgentManager_InitResponse and UserInterface_ProcessResponse. This last task generates the AgentCreated or AgentNotCreated fact which is consumed by ProcessNotification. ProcessNotification uses the UserDevice to send the request results to the user.

Instancias de entidades de meta-modelo

Entidad	Entidad del meta-modelo	Documentacion
AgentsManagerApplication	AplicacionInterna	It is an agent factory employed in the agent management. It provides operations to create, remove and list agents in the community.
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.
AddNewAgent	EventoAplicacionSlots	The user's request to include a new agent in the MAS.
FIPA-Request	FlujoDeTrabajo	FIPA-Request protocol.
AgentCreated	Hecho	The requested agent has been successfully created. It has a default status OK.
AgentNotCreated	Hecho	The requested agent could not be created.
AgentNotification	Hecho	A general notification about community management, that is, add, remove or list agents.
AgentToAdd	Hecho	Agent to add.
FIPA-Request_failure	Hecho
FIPA-Request_failure_Origin	Hecho
FIPA-Request_inform-done	Hecho
FIPA-Request_inform-done_Origin	Hecho
FIPA-Request_request	Hecho
FIPA-Request_request_Origin	Hecho
AddAgent	Interaccion	Add an agent to the community.
Note	Nota	The AddAgent workflow is specified in two different ways. The first diagram corresponds to the specification without protocols while the second one corresponds to that using a predefined FIPA-Request protocol.
Request Note	Nota	This fact includes the data of the AgentToAdd fact.
AddAgent	Tarea	Add a new agent to the system.
AgentManager_InitResponse	Tarea	Makes the sending of the add/remove agent response.
InteractWithUser	Tarea	Interface to add, remove and list agents, categories and documents in categories. It receives the user's request and directs it to the appropriate task.
ProcessNotification	Tarea	This task sends a notification to the UserDevice.
UserInterface_ProcessResponse	Tarea	Makes the processing of the add/remove agent response to the request.

AgentsManagerApplication (AplicacionInterna)

Properties:

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

Relaciones:

En el rol

En la relacion

Otros extremos

WFUsaDR

WFUsa

Con los objetos	En el rol
AddAgent	WFUsaOR

UserDevice (AplicacionInterna)

Properties:

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

Relaciones:

En el rol

En la relacion

Otros extremos

WFUsaDR

WFUsa

Con los objetos	En el rol
ProcessNotification	WFUsaOR

AddNewAgent (EventoAplicacionSlots)

Properties:

ID	AddNewAgent
Descripcion	The user's request to include a new agent in the MAS.
aplicacion
slots	user agentID agentInformation

Relaciones:

En el rol

En la relacion

Otros extremos

WFConsumeDR

WFConsume

Con los objetos	En el rol
InteractWithUser	WFConsumeOR

WFConsumeDR

WFConsume

Con los objetos	En el rol
InteractWithUser	WFConsumeOR

FIPA-Request (FlujoDeTrabajo)

Properties:

ID	FIPA-Request
Descripcion	FIPA-Request protocol.

Relaciones:

En el rol

En la relacion

Otros extremos

WFConsumeOR

WFConsume

Con los objetos	En el rol
FIPA-Request_request_Origin	WFConsumeDR

WFConsumeOR

WFConsume

Con los objetos	En el rol
FIPA-Request_failure_Origin	WFConsumeDR

WFConsumeOR

WFConsume

Con los objetos	En el rol
FIPA-Request_inform-done_Origin	WFConsumeDR

WFProduceOR

WFProduce

Con los objetos	En el rol
FIPA-Request_request	WFProduceDR

WFProduceOR

WFProduce

Con los objetos	En el rol
FIPA-Request_failure	WFProduceDR

WFProduceOR

WFProduce

Con los objetos	En el rol
FIPA-Request_inform-done	WFProduceDR

AgentCreated (Hecho)

Properties:

Nombre	AgentCreated
Descripcion	The requested agent has been successfully created. It has a default status OK.
Slots	Nombre slot:user Descripcion slot:Document owner. Nombre slot:agentID Descripcion slot:Agent identification in the system. Nombre slot:agentInformation Descripcion slot:Information needed to create an agent.

Relaciones:

En el rol

En la relacion

Otros extremos

GTCreaDR

GTCrea

CondicionMental:

Con los objetos	En el rol
AddAgent	GTCreaOR

GTHerenciaOR

GTHerenciaHecho

Con los objetos	En el rol
AgentNotification	GTHerenciaDR

GTHerenciaOR

GTHerenciaHecho

Con los objetos	En el rol
AgentNotification	GTHerenciaDR

WFConsumeDR

WFConsume

Con los objetos	En el rol
AgentManager_InitResponse	WFConsumeOR

WFConsumeDR

WFConsume

Con los objetos	En el rol
AgentManager_InitResponse	WFConsumeOR

WFProduceDR

WFProduce

Con los objetos	En el rol
UserInterface_ProcessResponse	WFProduceOR

WFProduceDR

WFProduce

Con los objetos	En el rol
AddAgent	WFProduceOR

WFProduceDR

WFProduce

Con los objetos	En el rol
UserInterface_ProcessResponse	WFProduceOR

AgentNotCreated (Hecho)

Properties:

Nombre	AgentNotCreated
Descripcion	The requested agent could not be created.
Slots	Nombre slot:user Descripcion slot:Document owner. Nombre slot:agentID Descripcion slot:Agent identification in the system. Nombre slot:agentInformation Descripcion slot:Information needed to create an agent. Nombre slot:status Descripcion slot:Action status. It can be a Classification status, an Agent Status or a Category Status. Classification Status shows the reason of the no document obtaining, classification or movement. Agent Status shows the reason of the no agent adding, removing or listing. Category Status shows the reason of the fail in an operation requested by the user over the categories or its documents.

Relaciones:

En el rol

En la relacion

Otros extremos

GTCreaDR

GTCrea

CondicionMental:

Con los objetos	En el rol
AddAgent	GTCreaOR

GTHerenciaOR

GTHerenciaHecho

Con los objetos	En el rol
AgentNotification	GTHerenciaDR

GTHerenciaOR

GTHerenciaHecho

Con los objetos	En el rol
AgentNotification	GTHerenciaDR

WFConsumeDR

WFConsume

Con los objetos	En el rol
AgentManager_InitResponse	WFConsumeOR

WFConsumeDR

WFConsume

Con los objetos	En el rol
AgentManager_InitResponse	WFConsumeOR

WFProduceDR

WFProduce

Con los objetos	En el rol
UserInterface_ProcessResponse	WFProduceOR

WFProduceDR

WFProduce

Con los objetos	En el rol
AddAgent	WFProduceOR

WFProduceDR

WFProduce

Con los objetos	En el rol
UserInterface_ProcessResponse	WFProduceOR

AgentNotification (Hecho)

Properties:

Nombre	AgentNotification
Descripcion	A general notification about community management, that is, add, remove or list agents.
Slots	Nombre slot:user Descripcion slot:Document owner. Nombre slot:agentID Descripcion slot:Agent identification in the system. Nombre slot:agentInformation Descripcion slot:Information needed to create an agent. Nombre slot:status Descripcion slot:Action status. It can be a Classification status, an Agent Status or a Category Status. Classification Status shows the reason of the no document obtaining, classification or movement. Agent Status shows the reason of the no agent adding, removing or listing. Category Status shows the reason of the fail in an operation requested by the user over the categories or its documents.

Relaciones:

En el rol

En la relacion

Otros extremos

GTHerenciaDR

GTHerenciaHecho

Con los objetos	En el rol
AgentCreated	GTHerenciaOR

GTHerenciaDR

GTHerenciaHecho

Con los objetos	En el rol
AgentNotCreated	GTHerenciaOR

GTHerenciaDR

GTHerenciaHecho

Con los objetos	En el rol
AgentNotCreated	GTHerenciaOR

GTHerenciaDR

GTHerenciaHecho

Con los objetos	En el rol
AgentCreated	GTHerenciaOR

WFConsumeDR

WFConsume

Con los objetos	En el rol
ProcessNotification	WFConsumeOR

WFConsumeDR

WFConsume

Con los objetos	En el rol
ProcessNotification	WFConsumeOR

AgentToAdd (Hecho)

Properties:

Nombre	AgentToAdd
Descripcion	Agent to add.
Slots	Nombre slot:user Descripcion slot:Document owner. Nombre slot:agentID Descripcion slot:Agent identification in the system. Nombre slot:agentInformation Descripcion slot:Information needed to create an agent.

Relaciones:

En el rol

En la relacion

Otros extremos

WFConsumeDR

WFConsume

Con los objetos	En el rol
AddAgent	WFConsumeOR

WFProduceDR

WFProduce

Con los objetos	En el rol
InteractWithUser	WFProduceOR

FIPA-Request_failure (Hecho)

Properties:

Nombre	FIPA-Request_failure
Descripcion
Slots

Relaciones:

En el rol

En la relacion

Otros extremos

WFConsumeDR

WFConsume

Con los objetos	En el rol
UserInterface_ProcessResponse	WFConsumeOR

WFProduceDR

WFProduce

Con los objetos	En el rol
FIPA-Request	WFProduceOR

FIPA-Request_failure_Origin (Hecho)

Properties:

Nombre	FIPA-Request_failure_Origin
Descripcion
Slots

Relaciones:

En el rol

En la relacion

Otros extremos

WFConsumeDR

WFConsume

Con los objetos	En el rol
FIPA-Request	WFConsumeOR

WFProduceDR

WFProduce

Con los objetos	En el rol
AgentManager_InitResponse	WFProduceOR

FIPA-Request_inform-done (Hecho)

Properties:

Nombre	FIPA-Request_inform-done
Descripcion
Slots

Relaciones:

En el rol

En la relacion

Otros extremos

WFConsumeDR

WFConsume

Con los objetos	En el rol
UserInterface_ProcessResponse	WFConsumeOR

WFProduceDR

WFProduce

Con los objetos	En el rol
FIPA-Request	WFProduceOR

FIPA-Request_inform-done_Origin (Hecho)

Properties:

Nombre	FIPA-Request_inform-done_Origin
Descripcion
Slots

Relaciones:

En el rol

En la relacion

Otros extremos

WFConsumeDR

WFConsume

Con los objetos	En el rol
FIPA-Request	WFConsumeOR

WFProduceDR

WFProduce

Con los objetos	En el rol
AgentManager_InitResponse	WFProduceOR

FIPA-Request_request (Hecho)

Properties:

Nombre	FIPA-Request_request
Descripcion
Slots

Relaciones:

En el rol

En la relacion

Otros extremos

NComentaDR

NComenta

Con los objetos	En el rol
Request Note	NComentaOR

WFConsumeDR

WFConsume

Con los objetos	En el rol
AddAgent	WFConsumeOR

WFProduceDR

WFProduce

Con los objetos	En el rol
FIPA-Request	WFProduceOR

FIPA-Request_request_Origin (Hecho)

Properties:

Nombre	FIPA-Request_request_Origin
Descripcion
Slots

Relaciones:

En el rol

En la relacion

Otros extremos

WFConsumeDR

WFConsume

Con los objetos	En el rol
FIPA-Request	WFConsumeOR

WFProduceDR

WFProduce

Con los objetos	En el rol
InteractWithUser	WFProduceOR

AddAgent (Interaccion)

Properties:

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

Relaciones:

En el rol

En la relacion

Otros extremos

WFProduceDR

WFProduce

Con los objetos	En el rol
InteractWithUser	WFProduceOR

WFProduceDR

WFProduce

Con los objetos	En el rol
InteractWithUser	WFProduceOR

Note (Nota)

Properties:

ID	Note
Descripcion	The AddAgent workflow is specified in two different ways. The first diagram corresponds to the specification without protocols while the second one corresponds to that using a predefined FIPA-Request protocol.

Relaciones:

Request Note (Nota)

Properties:

ID	Request Note
Descripcion	This fact includes the data of the AgentToAdd fact.

Relaciones:

En el rol

En la relacion

Otros extremos

NComentaOR

NComenta

Con los objetos	En el rol
FIPA-Request_request	NComentaDR

AddAgent (Tarea)

Properties:

ID	AddAgent
Descripcion	Add a new agent to the system.

Relaciones:

En el rol

En la relacion

Otros extremos

GTCreaOR

GTCrea

CondicionMental:

Con los objetos	En el rol
AgentCreated	GTCreaDR

GTCreaOR

GTCrea

CondicionMental:

Con los objetos	En el rol
AgentNotCreated	GTCreaDR

WFConsumeOR

WFConsume

Con los objetos	En el rol
AgentToAdd	WFConsumeDR

WFConsumeOR

WFConsume

Con los objetos	En el rol
FIPA-Request_request	WFConsumeDR

WFProduceOR

WFProduce

Con los objetos	En el rol
AgentCreated	WFProduceDR

WFProduceOR

WFProduce

Con los objetos	En el rol
AgentNotCreated	WFProduceDR

WFUsaOR

WFUsa

Con los objetos	En el rol
AgentsManagerApplication	WFUsaDR

AgentManager_InitResponse (Tarea)

Properties:

ID	AgentManager_InitResponse
Descripcion	Makes the sending of the add/remove agent response.

Relaciones:

En el rol

En la relacion

Otros extremos

RTarea

WFConecta

Con los objetos	En el rol
UserInterface_ProcessResponse	RTareaDestino

RTarea

WFConecta

Con los objetos	En el rol
UserInterface_ProcessResponse	RTareaDestino

WFConsumeOR

WFConsume

Con los objetos	En el rol
AgentCreated	WFConsumeDR

WFConsumeOR

WFConsume

Con los objetos	En el rol
AgentNotCreated	WFConsumeDR

WFConsumeOR

WFConsume

Con los objetos	En el rol
AgentNotCreated	WFConsumeDR

WFConsumeOR

WFConsume

Con los objetos	En el rol
AgentCreated	WFConsumeDR

WFProduceOR

WFProduce

Con los objetos	En el rol
FIPA-Request_failure_Origin	WFProduceDR

WFProduceOR

WFProduce

Con los objetos	En el rol
FIPA-Request_inform-done_Origin	WFProduceDR

InteractWithUser (Tarea)

Properties:

ID	InteractWithUser
Descripcion	Interface to add, remove and list agents, categories and documents in categories. It receives the user's request and directs it to the appropriate task.

Relaciones:

En el rol

En la relacion

Otros extremos

WFConsumeOR

WFConsume

Con los objetos	En el rol
AddNewAgent	WFConsumeDR

WFConsumeOR

WFConsume

Con los objetos	En el rol
AddNewAgent	WFConsumeDR

WFProduceOR

WFProduce

Con los objetos	En el rol
AddAgent	WFProduceDR

WFProduceOR

WFProduce

Con los objetos	En el rol
AgentToAdd	WFProduceDR

WFProduceOR

WFProduce

Con los objetos	En el rol
AddAgent	WFProduceDR

WFProduceOR

WFProduce

Con los objetos	En el rol
FIPA-Request_request_Origin	WFProduceDR

ProcessNotification (Tarea)

Properties:

ID	ProcessNotification
Descripcion	This task sends a notification to the UserDevice.

Relaciones:

En el rol

En la relacion

Otros extremos

WFConsumeOR

WFConsume

Con los objetos	En el rol
AgentNotification	WFConsumeDR

WFConsumeOR

WFConsume

Con los objetos	En el rol
AgentNotification	WFConsumeDR

WFUsaOR

WFUsa

Con los objetos	En el rol
UserDevice	WFUsaDR

UserInterface_ProcessResponse (Tarea)

Properties:

ID	UserInterface_ProcessResponse
Descripcion	Makes the processing of the add/remove agent response to the request.

Relaciones:

En el rol

En la relacion

Otros extremos

RTareaDestino

WFConecta

Con los objetos	En el rol
AgentManager_InitResponse	RTarea

RTareaDestino

WFConecta

Con los objetos	En el rol
AgentManager_InitResponse	RTarea

WFConsumeOR

WFConsume

Con los objetos	En el rol
FIPA-Request_failure	WFConsumeDR

WFConsumeOR

WFConsume

Con los objetos	En el rol
FIPA-Request_inform-done	WFConsumeDR

WFProduceOR

WFProduce

Con los objetos	En el rol
AgentCreated	WFProduceDR

WFProduceOR

WFProduce

Con los objetos	En el rol
AgentNotCreated	WFProduceDR

WFProduceOR

WFProduce

Con los objetos	En el rol
AgentNotCreated	WFProduceDR

WFProduceOR

WFProduce

Con los objetos	En el rol
AgentCreated	WFProduceDR