# Raggruppare le azioni in uno schema e riutilizzare le definizioni di input

> Usa NEWSCHEMA() per dichiarare azioni correlate sotto un unico nome e condividi una definizione di input tra azioni con un file in jsonschemas/.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: it
Content-SHA256: 9ac44a25f065ce1985aeadcd50aa5fae8dc0afa85b7c7574cb9a02247bbfdaea
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

`NEWSCHEMA(name, fn)` raggruppa le azioni di un'entità. La funzione riceve l'oggetto schema e `schema.action(name, meta)` registra un'azione chiamata `Name/action`, con le stesse opzioni di `NEWACTION()` (`input`, `output`, `params`, `user`, `permissions`, `action`...). Altrove l'azione si usa con il suo nome completo, esattamente come se fosse stata dichiarata con `NEWACTION('Users/insert', ...)`: `ROUTE('POST /users/ --> *Users/insert')` oppure `ACTION('Users/insert', payload)`.

Un frammento di definizione di input condiviso da più azioni, come un indirizzo, va in un proprio file in `jsonschemas/`. Un file `.txt` contiene la stessa lista `name:Type` di `input`; il nome del file è il nome dello schema. Richiamalo da un `input` con `@Name` e i suoi campi (e quali sono obbligatori) vengono aggiunti ai campi propri dell'azione.

```text jsonschemas/Address.txt
*street:String, *city:String, zip:String
```

```js schemas/users.js
NEWSCHEMA('Users', function(schema) {

	schema.action('insert', {
		name: 'Create a user',
		input: '*name:String, @Address',
		output: 'id:UID, name:String, city:String',
		action: function($, model) {
			$.callback({ id: UID(), name: model.name, city: model.city });
		}
	});

	schema.action('count', {
		name: 'Count users',
		action: function($) {
			$.callback({ count: 2 });
		}
	});

});
```

```js controllers/users.js
exports.install = function() {
	ROUTE('POST /users/ --> *Users/insert');
	ROUTE('GET /users/count/ --> *Users/count');
};
```