# Actions in einem Schema gruppieren und Input-Definitionen wiederverwenden

> Nutze NEWSCHEMA(), um zusammengehörige Actions unter einem Namen zu deklarieren, und teile eine Input-Definition zwischen Actions mit einer Datei in jsonschemas/.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: de
Content-SHA256: 0979700a052f93c351f6a0667f7e81ffd236ed434314d34eec6ee85207073bee
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

`NEWSCHEMA(name, fn)` gruppiert die Actions einer Entität. Die Funktion erhält das Schema-Objekt, und `schema.action(name, meta)` registriert eine Action namens `Name/action` mit denselben Optionen wie `NEWACTION()` (`input`, `output`, `params`, `user`, `permissions`, `action`...). Überall sonst wird die Action unter ihrem vollständigen Namen verwendet, genau so, als wäre sie mit `NEWACTION('Users/insert', ...)` deklariert worden: `ROUTE('POST /users/ --> *Users/insert')` oder `ACTION('Users/insert', payload)`.

Ein Fragment einer Input-Definition, das mehrere Actions teilen, etwa eine Adresse, kommt in eine eigene Datei in `jsonschemas/`. Eine `.txt`-Datei enthält dieselbe `name:Type`-Liste wie `input`; der Dateiname ist der Name des Schemas. Verweise aus einem `input` mit `@Name` darauf, und seine Felder (und welche davon Pflicht sind) werden zu den eigenen Feldern der Action hinzugefügt.

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