# Chamar uma ação a partir do seu próprio código

> Use ACTION() para executar uma ação a partir de um temporizador, de uma tarefa ou de outra ação, com o seu próprio payload, query e utilizador.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: pt
Content-SHA256: 7b9811bb8830919d563b1947d3326948562b6e28a87502e979635259fb0ca8b0
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

`ACTION(name, payload)` devolve um chamador que executa a ação com toda a sua validação, exatamente como se viesse de uma rota. O segundo argumento é o payload (a entrada). Encadeie `.query()` e `.user()` para lhe dar mais dados e termine com `.callback(function(err, response) {})` ou `.promise()` (use com `await`). Quando os dados são inválidos, `err` é um error builder em vez de uma exceção.

```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);
	}
}
```