Printix
Liest die Printix-Partner-API und zählt die aktiven Nutzer je Kunden-Tenant — die Zahl, die abgerechnet wird.
Zugangsdaten (Zahnrad)
| Feld | Bedeutung |
|---|---|
| Auth-URL | https://auth.printix.net |
| API-URL | https://api.printix.net |
| Client ID / Client Secret | API-Client des Partner-Kontos |
| Partner ID | UUID des Partner-Kontos |
Metriken
| Metrik | Zählung |
|---|---|
printingUsers | aktive Nutzer je Tenant in der letzten Abrechnungsperiode — jeder Nutzer, der im monatlichen Abrechnungszyklus mindestens einmal in Printix angemeldet war (Client, App oder Administrator), egal ob er gedruckt hat. Der Schlüssel behält seinen historischen Namen, damit Zuordnungen und Historie erhalten bleiben; bis 2026-11-06 zählte er die druckenden Nutzer. |
Einen Tenant auf mehrere Kunden aufteilen
Manche Kunden teilen sich einen Printix-Tenant mit ihren Schwesterunternehmen; die Nutzer unterscheiden sich nur über die Domain ihrer E-Mail-Adresse. Multiverse kann so einen Tenant nach Domain aufteilen:
- Lege im Printix Administrator des Tenants eine Anwendung vom Typ Cloud Print API an (Authentication → Applications → Create Application). Printix erlaubt eine solche Anwendung pro Tenant und zählt sie wie einen Nutzer. Notiere Client ID und Client Secret — das Secret wird nur einmal angezeigt.
- Klicke in Multiverse → Printix in der Zeile des Tenants auf Aufteilen… und hinterlege Client ID und Client Secret unter Cloud-Print-API-Zugang. Die Partner-API kennt keine Nutzer; über diese Anwendung liest Multiverse die Nutzerliste des Tenants. Verbindung testen zeigt, wie viele reguläre Nutzer der Tenant hat (Gastnutzer bleiben außen vor), wie viele eine E-Mail-Adresse tragen, die Nutzer je E-Mail-Domain — und die Felder eines Nutzerobjekts. Liefert die API keine Nutzer, zeigt der Dialog die Schlüssel und einen Auszug ihrer Antwort, damit sich die Form prüfen lässt.
- Lege je Domain, die zu einem anderen Kunden gehört, eine Domain-Regel an (Zuweisen… in der Domain-Tabelle füllt sie vor): Domain → Kunde. Domains ohne Regel und Nutzer ohne E-Mail-Adresse bleiben beim Kunden des Tenants. Mehrere Domains dürfen auf denselben Kunden zeigen (sie bilden einen Teil); eine Regel auf den Kunden des Tenants selbst ist dasselbe wie keine Regel.
Ab dem nächsten Snapshot erscheint der Tenant als mehrere Kunden: der Tenant selbst plus einer je Domain-Regel. Printix meldet die Abrechnungszahl — die aktiven Nutzer der letzten Abrechnungsperiode — nur je Tenant, deshalb wird sie im Verhältnis der Nutzerzahlen je Domain aufgeteilt, gerundet auf ganze Nutzer nach dem größten Rest; die Teile ergeben zusammen immer die Zahl des Tenants. Der Dialog zeigt diese Aufteilung unter Nächster Snapshot, sobald ein Verbindungstest gelaufen ist.
Ein Tenant mit Regeln, aber ohne hinterlegten Zugang, wird als Ganzes abgerechnet — der Snapshot sagt das, und die Rechnungsläufe wiederholen es. Eine fehlschlagende Nutzerliste — oder eine, die für einen Tenant mit abgerechneten Nutzern leer zurückkommt — lässt nicht mehr alles beim Tenant: Der Snapshot verteilt den heutigen Wert nach den Nutzern des letzten erfolgreichen Abrufs, die Kunden der Regeln behalten ihren Anteil (nur ein Tenant, dessen Nutzer noch nie gelesen wurden, bleibt ganz); der Snapshot trägt einen Hinweis mit dem Tag dieses Abrufs, den die Rechnungsläufe wiederholen. Die Liste markiert den Stand jedes Tenants: „N Domain-Regeln“ (wird aufgeteilt), „N Domain-Regeln · kein Zugang“ (wird als Ganzes abgerechnet), „Zugang hinterlegt“ (noch keine Regel).
Besonderheiten
- Tenant-IDs sind stabil → automatische Umbenennungs-Erkennung. Die Kunden eines aufgeteilten Tenants tragen die ID
Tenant-ID:Domain, die Umbenennungs-Erkennung greift also auch für sie. - Das Secret einer Cloud-Print-API-Anwendung kann nach dem Speichern nicht mehr ausgelesen werden — nur ersetzt oder gelöscht.