# Llama a una acción desde tu propio código

> Usa ACTION() para ejecutar una acción desde un temporizador, un trabajo u otra acción, con su propio payload, query y usuario.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: es
Content-SHA256: 4aa70bcc5f56bf300eb5970963c680af244502334ecaa99103b974d21a528133
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

`ACTION(name, payload)` devuelve un llamador que ejecuta la acción con toda su validación, exactamente como si viniera de una ruta. El segundo argumento es el payload (la entrada). Encadena `.query()` y `.user()` para darle más datos y termina con `.callback(function(err, response) {})` o `.promise()` (úsalo con `await`). Cuando los datos son inválidos, `err` es un error builder en lugar de una excepción.

```js definitions/math.js
NEWACTION('Math/add', {
	name: 'Add two numbers',
	input: '*a:Number, *b:Number',
	action: function($, model) {
		$.callback({ sum: model.a + model.b });
	}
});
```

```js controllers/math.js
exports.install = function() {
	ROUTE('GET /sum/', sum);
	ROUTE('GET /sum-promise/', sum_promise);
};

function sum($) {
	ACTION('Math/add', { a: '2', b: '3' }).callback(function(err, response) {
		if (err)
			$.invalid(err);
		else
			$.json(response);
	});
}

async function sum_promise($) {
	try {
		var response = await ACTION('Math/add', { a: 10, b: 5 }).promise();
		$.json(response);
	} catch (err) {
		$.invalid(400);
	}
}
```