RICOH Account Administration

1 RICOH Account Administration

RICOH Account Administration ist die Verwaltungsschnittstelle für RICOH TotalFlow Cloud-Anwendungen wie RICOH Predictive Insight™.

Referenz: Informationen zu den RICOH TotalFlow Cloud-Sicherheitsrichtlinien finden Sie unter RICOH TotalFlow Cloud Security Overview.

1.1 Übersicht über RICOH Account Administration

Administratoren verwenden RICOH Account Administration, um RICOH TotalFlow Cloud-Benutzer und andere in Ihren Anwendungen verwendete Objekte zu verwalten.

Die verfügbaren Funktionen hängen von den von Ihrem Unternehmen erworbenen Anwendungslizenzen ab. Bei allen TotalFlow Cloud-Anwendungen haben Sie mit Account Administration folgende Möglichkeiten:

Fügen Sie Benutzer hinzu, ändern und löschen Sie sie.
Zeigen Sie Details zu Ihren Abonnements an.
Zeigen Sie Ihre Kontodetails an und ändern Sie sie.

Bei einigen Anwendungen werden andere Funktionen hinzugefügt, mit denen Sie folgende Möglichkeiten haben:

Laden Sie RICOH Cloud Connector herunter und installieren Sie es, um die Kommunikation mit Ricoh-Anwendungen, die in Ihrem Netzwerk installiert sind, zu unterstützen.

1.1.1 Was gibt es Neues?

Für RICOH Account Administration wird regelmäßig eine Aktualisierung der verfügbaren Funktionen und eine Korrektur von Fehlern durchgeführt.

RICOH Account Administration umfasst verschiedene Fehlerkorrekturen und Sicherheitsaktualisierungen in jeder Bereitstellung. Weitere Änderungen für jede Bereitstellung sind hier aufgeführt.

3. September 2026

Die Funktion „Datenexport-API“ von RICOH Predictive Insight ist nun verfügbar. Die Beta-Notation wurde hier aus der Dokumentation entfernt: Arbeiten mit der Datenexport-API

5. August 2026

Fehlerbehebungen und Sicherheitsupdates, darunter Korrekturen für CVE-2026-42198, CVE-2026-44431, CVE-2026-44432, CVE-2026-48522, CVE-2026-48524, CVE-2026-48525 und CVE-2026-48526.

21. Juli 2026

Fehlerbehebungen und Sicherheitsupdates für den RICOH Cloud Connector, einschließlich Korrekturen für CVE-2026-8723, CVE-2026-41907, CVE-2026-44486, CVE-2026-44487, CVE-2026-44488, CVE-2026-44489, CVE-2026-44490, CVE-2026-44492, CVE-2026-44494, CVE-2026-44496, CVE-2026-45736 und CVE-2026-48779.

1. Juli 2026

Fehlerbehebungen und Sicherheitsupdates, einschließlich Korrekturen für CVE-2024-47535, CVE-2025-24970, CVE-2025-25193, CVE-2025-55163, CVE-2025-58057, CVE-2025-68161, CVE-2026-33871, CVE-2026-34477, CVE-2026-34478, CVE-2026-34480, CVE-2026-42581, CVE-2026-42583, CVE-2026-42584, CVE-2026-42587, CVE-2026-44249, CVE-2026-45416 und CVE-2026-47244.

12. Juni 2026

Fehlerbehebungen und Sicherheitsupdates, darunter Korrekturen für CWE-117 und CWE-93.

11. Juni 2026

Das Hilfesystem wurde aktualisiert und enthält nun Inhalte zur Datenexport-API, einer Funktion, die derzeit im Beta-Test verfügbar ist: Arbeiten mit der Datenexport-API

1. Mai 2026

Aktualisierte Ricoh TotalFlow Cloud Security Overview.

7. April 2026

Fehlerbehebungen und Sicherheitsupdates, darunter Korrekturen für CVE-2025-45768 und CVE-2026-26007.

21. Januar 2026

Fehlerkorrekturen und Sicherheitsaktualisierungen, einschließlich Korrekturen für CVE-2025-66418 und CVE-2025-66471.

17. Dezember 2025

Fehlerkorrekturen und Sicherheitsaktualisierungen, einschließlich Korrekturen für CVE-2025-48976, CVE-2025-7962 und CVE-2025-12383.

30. Oktober 2025

Fehlerkorrekturen und Sicherheitsaktualisierungen, einschließlich Korrekturen für CVE-2025-9636 und CVE-2025-48924.

30. Juli 2025

Fehlerkorrekturen und Sicherheitsaktualisierungen, einschließlich Korrekturen für CVE-2024-37891 und CVE-2024-12797.

23. Juli 2025

Fehlerkorrekturen und Sicherheitsupdates, einschließlich Korrekturen für CVE-2025-50181 und CVE-2025-50182.

9. Juli 2025

Die Datenschutzbestimmungen für Japan wurden aktualisiert.
Zusätzliche Unterstützung für Kunden in Slowenien und Kroatien.
Fehlerkorrekturen und Sicherheitsaktualisierungen, einschließlich Korrekturen für CVE-2021-28168.

2. Juli 2025

Fehlerkorrekturen und Sicherheitsupdates, einschließlich Korrekturen für CVE-2023-52428 und CVE-2023-1370.

4. Juni 2025

Fehlerkorrekturen und Sicherheitsupdates, einschließlich Korrekturen für CVE-2024-47554 und XUC-XUC-MAVEN-100000.

23. April 2025

Fehlerkorrekturen und Sicherheitsaktualisierungen, einschließlich einer Korrektur für CVE-2024-37891.

8. April 2025

Das dokument RICOH TotalFlow Cloud Security wurde aktualisiert.

2. April 2025

Aktualisiert, um den Namen RICOH Supervisor in RICOH Predictive Insight in allen Referenzen zu ändern.
Sicherheitsaktualisierungen und Fehlerbehebungen.

12. März 2025

Leistungsverbesserungen.
Sicherheitsaktualisierungen und Fehlerbehebungen.

4. Februar 2025

Verschiedene Sicherheitsaktualisierungen, einschließlich Korrekturen für CVE-2024-45296, CVE-2024-45590, CVE-2017-20165 und CVE-2024-39338.
Redaktionelle Änderungen und Fehlerbehebungen.

29. Januar 2025

Verschiedene Sicherheitsaktualisierungen, einschließlich Korrekturen für CWE-798.
Redaktionelle Änderungen und Fehlerbehebungen.

5. Dezember 2024

Die Datenschutzrichtlinie von Ricoh Europe gilt nun auch für die Ukraine, Rumänien und Israel.
Redaktionelle Änderungen und Fehlerbehebungen.

30. Oktober 2024

Verschiedene Sicherheitsaktualisierungen, einschließlich Korrekturen für CVE-2024-37891
Redaktionelle Änderungen und Fehlerbehebungen.

2. Oktober 2024

Verschiedene Sicherheitsaktualisierungen, einschließlich Korrekturen für CVE-2023-2650, CVE-2023-3446, CVE-2023-49083, CVE-2023-50782, CVE-2024-0727, CVE-2024-26130 und CVE-2023-4807.
Redaktionelle Änderungen und Fehlerbehebungen.

17. Juli 2024

Die Unterstützung für RICOH TotalFlow Producer wurde entfernt.
Redaktionelle Änderungen und Fehlerbehebungen.

20. Juni 2024

Redaktionelle Änderungen und Fehlerbehebungen.

11. Juni 2024

Redaktionelle Änderungen und Fehlerbehebungen.

22. Mai 2024

Die Liste der unterstützten Drucker für RICOH TotalFlow Producer-Advanced-Lizenzen wurde aktualisiert und es wurde Unterstützung für Drucker mit dem internen Ricoh-Standardcontroller aufgenommen.
Redaktionelle Änderungen und Fehlerbehebungen.

30. April 2024

Redaktionelle Änderungen und Fehlerbehebungen.

15. April 2024

Redaktionelle Änderungen und Fehlerbehebungen.

9. April 2024

Redaktionelle Änderungen und Fehlerbehebungen.

14. März 2024

Redaktionelle Änderungen und Fehlerbehebungen.

7. März 2024

Redaktionelle Änderungen und Fehlerbehebungen.

27. Februar 2024

Für RICOH TotalFlow Producer-Advanced-Lizenzen wurde unter RICOH Account Administration die Unterstützung für die Konfiguration und Verwaltung von Druckern hinzugefügt.
Für die Kommunikation mit den Druckern in Ihrer Umgebung enthält RICOH Cloud Connector jetzt die Komponente RICOH Printer Connector. Die Komponente RICOH Printer Connector ist derzeit nur in der Windows-Version von RICOH Cloud Connector verfügbar.
Redaktionelle Änderungen und Fehlerbehebungen.

13. Februar 2024

Redaktionelle Änderungen und Fehlerbehebungen.

30. Januar 2024

Redaktionelle Änderungen und Fehlerbehebungen.

14. November 2023

Zur Unterstützung von RICOH TotalFlow Producer hat RICOH Account Administration Unterstützung für die Beta-Funktion Office-Umwandlung hinzugefügt.
Diese Funktion ist mit einer RICOH TotalFlow Producer-Advanced-Lizenz verfügbar.

2. August 2023

Zur Unterstützung von RICOH TotalFlow Producer hat RICOH Account Administration die Unterstützung für diese Systemobjekte hinzugefügt:
- Automatisierungen
- Konnektoren
- Kunden
- Ordner für Sofortdruck
Diese Objekte sind erst sichtbar, nachdem Sie eine Lizenz für RICOH TotalFlow Producer aktiviert haben. Eine Anleitung zur Verwaltung dieser Objekte ist jedoch im Hilfesystem enthalten.

21. Juni 2023

Aktualisierungen des Hilfesystems.

1. März 2023

Verschiedene Sicherheitsaktualisierungen, einschließlich Korrekturen für CVE-2022-41946 und CVE-2022-42003.

10. November 2022

Verschiedene Sicherheitsaktualisierungen, einschließlich Korrekturen für CVE-2022-42889.

24. August 2022

Verschiedene Sicherheitsaktualisierungen, einschließlich Korrekturen für CVE-2022-31197.

27. Juli 2022

Verschiedene Sicherheitsupdates.

24. Juni 2022

Unterstützung für die Konfiguration von RICOH Cloud Connector zur Verwendung von HTTPS wurde hinzugefügt.
Verschiedene Sicherheitsaktualisierungen, einschließlich Korrekturen für CVE-2022-21724.

17. Mai 2022

Die RICOH Cloud Connector-Installation über die Benutzeroberfläche ist jetzt verfügbar.

11. März 2022

Übersetzungen aktualisiert, um den Inhalt von RICOH Cloud Connector einzubeziehen.
Englische Dokumentation für RICOH Cloud Connector und Übersichtsthemen aktualisiert.

23. Februar 2022

Support für Kunden in Kanada ergänzt.

19. Januar 2022

Verschiedene Sicherheitsaktualisierungen, einschließlich Korrekturen für CVE-2021-44228.

27. Oktober 2021

RICOH Cloud Connector ist jetzt verfügbar.

1. September 2021

Support für Kunden in Frankreich ergänzt.

25. August 2021

Support für Kunden in Deutschland ergänzt.

28. Juli 2021

Support für Kunden in Vietnam ergänzt.

12. Mai 2021

Support für Kunden in Belgien und Luxemburg ergänzt.

7. Mai 2021

Die Cookie-Richtlinie für Kunden in Japan wurde aktualisiert.

17. März 2021

Support für Kunden in Portugal ergänzt.

17. Februar 2021

Support für Kunden in Spanien ergänzt.

16. Dezember 2020

Zusätzlicher Support für Kunden auf den Philippinen.

2. Dezember 2020

Zusätzlicher Support für Kunden in der Schweiz.

9. September 2020

Zusätzlicher Support für Kunden in Japan.

2. September 2020

Aktualisierung der Datenschutzrichtlinie für Kunden in den Vereinigten Staaten.

5. August 2020

Zusätzlicher Support für Kunden in Schweden.

20. Mai 2020

Es wurde Unterstützung für Kunden in Malaysia und Mexiko hinzugefügt.

1.1.2 Systemobjekte

Systemobjekte sind Elemente, die Sie in TotalFlow Cloud-Anwendungen definieren und verwenden, um Ihre Lösung genau nach Ihren Wünschen zu gestalten. In Account Administration sind einige Beispiele für Systemobjekte Benutzer und Konnektoren.

Die Systemobjekte, die Sie in Account Administration definieren, können in allen TotalFlow Cloud-Anwendungen verwendet werden.

1.1.2.1 API-Schlüssel

Ein API-Schlüssel ist eine Anmeldeinformation, die es einer Anwendung ermöglicht, im Namen Ihres Kontos Anfragen an eine RICOH TotalFlow Cloud-API zu senden. Sie definieren API-Schlüssel unter RICOH Account Administration.

Anwendungen, die anstelle der Benutzeroberfläche eine API verwenden, können sich nicht als Benutzer anmelden. Stattdessen enthält jede Anfrage den Wert eines API-Schlüssels, der das Konto identifiziert, zu dem die Anfrage gehört. Da der Schlüssel Ihre Kontoidentität enthält, müssen in Anfragen keine Parameter für das Konto oder den Mandanten angegeben werden.

Sie können bis zu zehn Schlüssel für Ihr Konto festlegen. Viele Organisationen erstellen für jede Anwendung, die Daten abruft, einen eigenen Schlüssel, sodass ein Schlüssel ersetzt oder gelöscht werden kann, ohne dass die anderen Anwendungen davon beeinträchtigt werden. Jeder Schlüssel verfügt über einen Namen, eine Beschreibung und ein Ablaufdatum.

Der Wert eines Schlüssels wird nur einmal angezeigt, und zwar in dem Moment, in dem Sie den Schlüssel erstellen oder rotieren. Account Administration speichert den Wert nicht in einer Form, die erneut angezeigt werden kann; daher müssen Sie ihn kopieren und sicher aufbewahren, sobald er angezeigt wird. Sollte ein Wert verloren gehen, drehen Sie den Schlüssel, um einen neuen zu generieren. Jeder, der über diesen Wert verfügt, kann in Ihrem Namen Anfragen stellen; schützen Sie Ihre Schlüssel daher genauso wie ein Kennwort. Schlüssel sind nicht auf bestimmte Drucker beschränkt.

Die Schlüssel werden auf der Registerkarte API-Schlüssel verwaltet. Sie können den Namen, die Beschreibung oder das Ablaufdatum eines Schlüssels ändern; einen Schlüssel rotieren, um dessen Wert zu ersetzen und dabei dessen Identität beizubehalten; oder einen Schlüssel löschen, um den Zugriff sofort zu widerrufen.

Unter RICOH TotalFlow Cloud werden API-Schlüssel in Verbindung mit der Datenexport-API verwendet, die Informationen zu Druckern, Jobs und dem Druckerstatus abruft, die von RICOH Predictive Insight erfasst wurden. Die Anzahl der API-Anfragen, die Ihr Konto über alle API-Schlüssel hinweg stellen kann, richtet sich nach Ihrem Abonnement. Für jedes Abonnement gilt eine Obergrenze für die Anzahl der API-Anfragen, die innerhalb eines rollierenden Zeitraums von 30 Tagen zulässig sind. Sollten Sie die in Ihrem Abonnement gewährte Anzahl an Aufrufen überschreiten, werden keine Anfragen mehr angenommen, bis die Gesamtzahl der Anfragen der letzten 30 Tage unter das Abonnementlimit fällt. Um zu erfahren, wie viele Anrufe Ihr Abonnement umfasst und wie viele Sie in den letzten 30 Tagen getätigt haben, besuchen Sie bitte die Seite API-Schlüssel. Sollten Sie feststellen, dass Sie mehr Kapazität für API-Anfragen benötigen, wenden Sie sich bitte an Ihren Ricoh-Ansprechpartner, um eine Erweiterung Ihres Abonnements zu besprechen.

1.1.2.2 Konnektoren

Konnektoren sind auf Ihren lokalen Systemen gespeicherte Anwendungen, die eine Verbindung zwischen Cloud-Anwendungen und vor Ort installierter Software oder Geräten herstellen. Diese Verbindung ermöglicht einen Kommunikationspfad zwischen den Systemen. Um eine Verbindung zu RICOH TotalFlow Cloud herzustellen, installieren Sie RICOH Cloud Connector auf einem Server in Ihrem Netzwerk.

Diese Anwendungen verwenden RICOH Cloud Connector zur Installation und Verwaltung von Abonnementlizenzen:

RICOH InfoPrint Manager für Windows und für Linux
RICOH Auto Color Adjuster

1.1.2.3 Benutzer

Jeder, der mit RICOH TotalFlow Cloud-Anwendungen arbeitet, muss als Benutzer definiert werden.

Bei der Ersteinrichtung Ihres Kontos durch Ricoh wird ein Administrator-Benutzer erstellt. Der Administrator erhält eine Willkommens-E-Mail von TotalFlow Cloud mit einem Link, über den er sich anmelden und sein ursprüngliches Kennwort ändern kann. Dieser Administrator ist für die Erstellung von Benutzern für den Rest Ihrer Organisation verantwortlich.

Benutzern werden für jede Anwendung, für die Sie ein Abonnement erworben haben, Rollen zugewiesen. Die Rollen basieren auf den Aufgaben des Benutzers und variieren von Anwendung zu Anwendung. Zum Beispiel gibt es in Account Administration zwei Rollen, die Sie Benutzern zuweisen können:

Administrator: Benutzer, die berechtigt sind, Details über Ihr Konto einzusehen, andere Benutzer anzulegen und zu verwalten und andere Objekte nach Bedarf zu verwalten.
Keine: Benutzer, zu deren Aufgaben es gehört, in Ihren abonnierten Anwendungen zu arbeiten, aber keine Benutzer oder andere Objekte zu verwalten.

Ein Benutzer kann ein Administrator in Account Administration sein, aber ein Betrachter in einer Anwendung wie RICOH Predictive Insight.

Benutzern wird auch eine Rolle innerhalb der TotalFlow Cloud-Plattform zugewiesen. Die meisten Benutzer sind der Plattformrolle Standard zugeordnet. Andere Anwendungen können jedoch spezielle Plattformrollen hinzufügen.

RICOH Predictive Insight fügt zum Beispiel die Plattformrolle Große Anzeige hinzu. Sie legen einen Benutzer mit der Plattformrolle Große Anzeige an, wenn Sie z. B. RICOH Predictive Insight-Dashboards auf einem Monitor in Ihrem Produktionsbereich anzeigen möchten, um den aktuellen Status darzustellen. Jemand in Ihrem Unternehmen meldet sich als Benutzer Große Anzeige an und maximiert das Browserfenster auf dem großen Bildschirm. Der Benutzer Große Anzeige hat nur Anzeigezugriff und kann für die maximal zulässige Zeit angemeldet bleiben.

1.1.3 Benutzeroberfläche

Benutzer mit Berechtigung für den Zugriff auf RICOH Account Administration können über jedes System, das Zugriff auf das Internet hat und auf dem ein unterstützter Browser installiert ist, die Benutzeroberfläche öffnen.

1.1.3.1 Banner

Das Banner ist der schwarze Balken oben in der Benutzeroberfläche. Sie können auf allen Seiten der Benutzeroberfläche darauf zugreifen.

Mit den Symbolen im Banner können Sie eine Vielzahl von Aufgaben erledigen:

Wechseln Sie zu einer anderen RICOH TotalFlow Cloud-Anwendung, auf die Sie Zugriff haben.
Klicken Sie auf , das Symbol App-Wechsler, und wählen Sie die zu öffnende Anwendung. Die Anwendung wird auf dem gleichen Reiter geöffnet.
Reichen Sie Ideen zur Verbesserung unserer Anwendungen ein.
Klicken Sie auf , das Symbol Ideen übermitteln, und dann auf Neue Idee hinzufügen, um zu beschreiben, was wir hinzufügen sollen. Sie können auch die von anderen Kunden eingereichten Ideen prüfen. Wenn Ihnen die Idee gefällt, stimmen Sie für sie. Ideen, die von mehr als einem Kunden unterstützt werden, erregen eher unsere Aufmerksamkeit und haben eine bessere Chance, umgesetzt zu werden!
Zeigen Sie Benachrichtigungen an, die von Systemadministratoren oder von den Anwendungen selbst gesendet wurden.
Klicken Sie auf , das Symbol Benachrichtigungen.
- Sie können einige Benachrichtigungen sehen, ohne die Liste Benachrichtigungen zu öffnen. Diese Benachrichtigungen erscheinen in einem Streifen oberhalb oder unterhalb des Banners oder am unteren Rand des Browserfensters.
Zeigen Sie Details zu Ihrer Benutzer-ID oder dem Konto Ihres Unternehmens an.
Klicken Sie auf , das Symbol Konto. Ihre Benutzer-ID und Ihr Kontoname stehen oben im Menü. Wählen Sie eine Option, um die zugehörigen Einstellungen oder Informationen anzuzeigen.
Holen Sie sich Unterstützung bei der Nutzung der Anwendung.
Klicken Sie auf , das Hilfe-Symbol, und wählen Sie Hilfe.
Lesen Sie die Nutzungsbedingungen für TotalFlow Cloud-Anwendungen.
Klicken Sie auf , das Hilfe-Symbol, und wählen Sie Nutzungsbedingungen.

1.1.3.2 Hauptseite

Wenn Sie sich bei RICOH Account Administration anmelden oder von einer anderen Anwendung dorthin zurückkehren, sehen Sie die Hauptseite mit einem geöffneten Reiter.

Die Anzahl der verfügbaren Reiter hängt von den Anwendungen ab, die Sie abonniert haben. Alle Anwendungen enthalten diese Reiter:

Lizenzen
Benutzer
Details

Andere Anwendungen fügen je nach Bedarf weitere Reiter hinzu. Bei einer RICOH Auto Color Adjuster-Lizenz ist zum Beispiel auch der Reiter Konnektoren verfügbar.

Die meisten Reiter zeigen eine Liste von Objekten in einer Tabelle. In allen Tabellen haben Sie folgende Möglichkeiten:

Sortieren Sie die Einträge.
Klicken Sie einmal auf die Tabellenkopfzeile, um sie in aufsteigender Reihenfolge zu sortieren, und ein zweites Mal, um sie in absteigender Reihenfolge zu sortieren.
Ändern Sie die angezeigten Tabellenspalten und ordnen Sie sie neu an.
Klicken Sie auf , das Zahnrad-Symbol, und wählen Sie Spalten verwalten.
Suchen Sie nach Text in der Tabelle.
Klicken Sie auf , das Suchsymbol, und geben Sie den zu suchenden Text ein.

1.1.3.2.1 API-Schlüssel-Reiter

Die für Ihr Konto definierten API-Schlüssel sind auf der Registerkarte API-Schlüssel unter RICOH Account Administration aufgeführt. Über diese Registerkarte können Sie die Schlüssel erstellen, die Anfragen an die Datenexport-API autorisieren, und diese während ihrer gesamten Lebensdauer verwalten.

API-Schlüssel-Tab

Die Registerkarte API-Schlüssel ist nur verfügbar, wenn für Ihr Konto ein Abonnement für RICOH Predictive Insight besteht. Um die Registerkarte anzuzeigen und mit Schlüsseln zu arbeiten, benötigen Sie einen Administrator-Zugriff auf Account Administration.

Über zwei Links oben auf der Registerkarte können Sie Referenzinformationen zur Datenexport-API aufrufen:

Erste Schritte mit API-Schlüsseln: Öffnet die Hilfe zur Datenexport-API, in der Sie nachlesen können, was Sie tun müssen, um API-Schlüssel zu verwenden, sowie Informationen zu den verfügbaren Endpunkten, den Feldern, die jeder Endpunkt zurückgibt, und den für Anfragen geltenden Beschränkungen.
API-Explorer öffnen: Öffnet die interaktive Dokumentationsseite für die API, auf der Sie die einzelnen Endpunkte einsehen, die jeweils akzeptierten Parameter anzeigen und Beispielanfragen direkt über Ihren Browser absenden können. Sie benötigen den Wert eines API-Schlüssels, um von dieser Seite aus eine Anfrage zu senden.

Die folgenden Aktionen können Sie auf diesem Reiter durchführen:

Zeigen Sie alle für Ihr Konto definierten Schlüssel und deren Eigenschaften an, wie beispielsweise: Name, Status und Ablaufdatum.
In der Tabelle wird der Wert eines Schlüssels nicht angezeigt.
Erstellen Sie einen Schlüssel.
Klicken Sie auf API-Schlüssel erstellen. Die Schlüssel sind in der Regel innerhalb von 30 Sekunden aktiv, es kann jedoch zu Verzögerungen kommen.
Überwachen Sie die API-Anfragen des Kontos im Hinblick auf die Grenzwerte der Lizenz.
Das Feld oberhalb der Tabelle mit den API-Schlüsseln zeigt den Nutzungsplan des Kontos sowie die maximal zulässige Anzahl an API-Aufrufen innerhalb eines Zeitraums von 30 Tagen an. Erfassen Sie, wie viele Anrufe in den letzten 30 Tagen getätigt wurden.
Bearbeiten Sie den Namen, die Beschreibung oder das Ablaufdatum eines bestehenden Schlüssels.
Klicken Sie mit der rechten Maustaste auf eine Zeile und wählen Sie API-Schlüssel bearbeiten. Das Bearbeiten eines Schlüssels hat keinen Einfluss auf dessen Wert, sodass Anwendungen, die diesen Schlüssel bereits verwenden, weiterhin einwandfrei funktionieren.
Drehen Sie einen Schlüssel, um dessen Wert zu ändern.
Klicken Sie mit der rechten Maustaste auf eine Zeile und wählen Sie API-Schlüssel rotieren. Legen Sie einen Überschneidungszeitraum fest, in dem sowohl der bisherige als auch der neue Wert für einige Tage gültig sind, damit Sie genügend Zeit haben, Ihre Anwendungen anzupassen. Der Schlüssel mit dem neuen Wert steht in der Regel innerhalb von 30 Sekunden zur Verfügung, es können jedoch Verzögerungen auftreten.
Einen Schlüssel löschen.
Klicken Sie mit der rechten Maustaste auf eine Zeile und wählen Sie Sofort löschen.
- Durch das Löschen eines Schlüssels wird dieser innerhalb einer Minute aus dem System entfernt, wobei es zu Verzögerungen kommen kann. Gelöschte Schlüssel werden endgültig entfernt. Wenn Sie versuchen, eine API-Anfrage mit einem Schlüssel zu senden, nachdem dieser gelöscht wurde, schlägt die Anfrage fehl.
- Durch das Löschen eines Schlüssels werden alle Versionen dieses Schlüssels gelöscht. Wenn Sie einen Schlüssel rotieren und anschließend löschen, werden beide Versionen des Schlüssels gelöscht, auch wenn der Überschneidungszeitraum noch aktiv ist.

Wichtig: Der Wert eines Schlüssels wird nur einmal angezeigt, und zwar beim Erstellen oder beim Rotieren des Schlüssels. Von dieser Registerkarte aus können Sie es nicht erneut anzeigen. Kopieren Sie den Wert und bewahren Sie ihn zu diesem Zeitpunkt sicher auf. Sollten Sie ihn verlieren, drehen Sie den Schlüssel, um einen neuen Wert zu generieren.

Schlüssel sind nicht auf einzelne Drucker beschränkt. Jeder, der über den Wert eines Schlüssels verfügt, kann Anfragen in Ihrem Namen stellen. Geben Sie die Schlüssel ausschließlich an die Personen weiter, die an der Entwicklung von Integrationen arbeiten, und ersetzen Sie diese regelmäßig gemäß Ihren Sicherheitsrichtlinien.

Wenn Sie auf , das Werkzeugsymbol, klicken, öffnet sich ein Menü, in dem Sie die Informationen in der Tabelle aktualisieren und die Tabellenspalten verwalten können.

1.1.3.2.2 Konnektoren-Reiter

Die registrierten Konnektoren sind in RICOH Account Administration auf dem Reiter Konnektoren aufgeführt.

Konnektoren-Tab

Die folgenden Aktionen können Sie auf diesem Reiter durchführen:

Zeigen Sie alle registrierten Konnektoren und ihre Eigenschaften an, wie z. B. Status, Version, Plattform oder wann sie zuletzt kontaktiert wurden.
Laden Sie die neueste Version von RICOH Cloud Connector für Ihr Betriebssystem herunter.
Klicken Sie auf Download und wählen Sie das Betriebssystem aus.
Generieren Sie einen einmaligen Code, um einen Cloud Connector zu registrieren.
Klicken Sie auf Einmaligen Code generieren.
Bearbeiten, löschen oder zeigen Sie die Verbindungen an, die einem Konnektor zugeordnet sind
Klicken Sie mit der rechten Maustaste auf einen Konnektor und wählen Sie eine Option aus dem Menü.
- Um einen Konnektor zu bearbeiten, muss der Server, auf dem der Konnektor definiert ist, laufen und Sie müssen eine funktionierende Netzwerkverbindung zu ihm haben.
- Wenn Sie einen Konnektor löschen, wird die Instanz von RICOH Cloud Connector nicht deinstalliert, sondern die Registrierung in der Cloud wird aufgehoben. Die zugeordneten Lizenzen können davon betroffen sein.

Wenn Sie auf , das Werkzeugsymbol, klicken, öffnet sich ein Menü, in dem Sie die Informationen in der Tabelle aktualisieren und die Tabellenspalten verwalten können.

1.1.3.2.3 Details-Reiter

Auf dem Reiter Details finden Sie Informationen zu Ihrem Unternehmenskonto.

Sie können oben rechts auf der Seite auf Details bearbeiten klicken, um Ihren Unternehmensnamen, Ihre Kontakt- und Rechnungsdaten, die Standardsprache und den Zeitablauf für alle Benutzer in Ihrem Unternehmen zu aktualisieren.

1.1.3.2.4 Lizenzen-Reiter

Auf dem Reiter Lizenzen können Sie alle mit Ihrem Konto verbundenen Lizenzen einsehen, auch solche, die bereits abgelaufen sind. Sie können auch RICOH Cloud Connector herunterladen, wenn Sie es brauchen.

Lizenzen-Tab

Jedes Abonnement, das Ihr Unternehmen erworben hat, wird als Karte auf dem Reiter Lizenzen angezeigt. Auf der Karte sind das Anfangs- und das Ablaufdatum des Abonnements angegeben. Wenn Sie auf Details klicken, wird ein Dialogfeld geöffnet, das weitere Informationen anzeigt, u. a:

Anzahl und Arten der einzelnen Lizenzen, die in der Anwendung enthalten sind
Details zur Lizenz, einschließlich aller damit erworbenen Add-ons

1.1.3.2.5 Benutzer-Reiter

Auf dem Reiter Benutzer können Sie die Benutzer erstellen und verwalten, die Zugriff auf Ihre Anwendungen haben.

Benutzer-Reiter

Auf dem Reiter Benutzer haben Sie folgende Möglichkeiten:

Erstellen Sie neue Benutzer.
Klicken Sie auf Benutzer hinzufügen.
Bearbeiten, kopieren und löschen Sie vorhandene Benutzer.
Klicken Sie mit der rechten Maustaste auf eine Zeile und wählen Sie die richtige Option.
Senden Sie erneut Einladungen an Benutzer, die auf ihre erste Einladung nicht geantwortet haben.
Klicken Sie mit der rechten Maustaste auf eine Zeile und wählen Sie Einladung erneut senden.

1.1.4 RICOH Cloud Connector

RICOH Cloud Connector ist eine Anwendung, die Sie in Ihrem Netzwerk installieren, um die Kommunikation mit RICOH TotalFlow Cloud zu verwalten.

Cloud Connector ist nur bei bestimmten Produkten und in bestimmten Konfigurationen erforderlich:

RICOH InfoPrint Manager Subscription
Wenn Sie RICOH InfoPrint Manager Subscription kaufen, wird Cloud Connector zusammen mit dem Produkt installiert. Es stellt eine Verbindung zu RICOH TotalFlow Cloud her, um zu überprüfen, ob Ihr Abonnement noch nicht abgelaufen ist.
RICOH Auto Color Adjuster
RICOH Auto Color Adjuster verwendet Cloud Connector zur Verwaltung von Abonnements.

1.1.5 Barrierefreiheit

Ricoh ist bestrebt, Produkte zu liefern, die für jeden nutzbar sind, unabhängig von Alter oder Können.

Weitere Informationen über unser Engagement für Barrierefreiheit finden Sie auf der Seite Barrierefreiheit auf der Ricoh-Website.

Barrierefreiheitfunktionen

Barrierefreiheitfunktionen helfen Nutzern mit Behinderungen, wie z. B. eingeschränkter Mobilität oder eingeschränktem Sehvermögen, Informationstechnologieprodukte erfolgreich zu nutzen.

Die wichtigsten Barrierefreiheitfunktionen in diesem Produkt bieten Ihnen folgende Möglichkeiten:

Verwenden Sie Bildschirmleser, Bildschirmlupen und andere unterstützende Technologien.
Verwenden Sie eine Tastatur statt einer Maus.
Ändern Sie Attribute wie Lautstärke, Farbe, Kontrast und Schriftgröße.
Unterscheiden Sie die Tasten durch Berührung, ohne sie zu aktivieren.
Schließen Sie alternativer Eingabe- und Ausgabegeräte wie spezielle Zeigegeräte und Braille-Darstellungsgeräten an.

Darüber hinaus sind das Informationszentrum und die Veröffentlichungen zu dem Produkt in einem barrierefreien Format verfügbar.

Tastatur-Navigation

Dieses Produkt verwendet die Standardnavigationstasten von Microsoft Windows.

1.1.6 Marken

RICOH InfoPrint Manager™ und RICOH Predictive Insight™ sind Marken von Ricoh Company, Ltd. in den vereinigten Staaten und/oder anderen Ländern.

Firefox ist eine eingetragene Marke der Mozilla Foundation.

Google und Chrome sind Marken von Google Inc.

Java und alle Java-basierten Marken und Logos sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochterfirmen.

Linux ist die eingetragene Marke von Linus Torvalds in den USA und anderen Ländern.

Microsoft, Windows, Windows Server, Windows Vista und Internet Explorer sind eingetragene Marken oder Marken von Microsoft Corporation in den USA und/oder anderen Ländern.

Die richtigen Namen der Betriebssysteme von Windows lauten folgendermaßen:

Windows Server 2019:
- Microsoft®Windows Server® 2019 Standard
- Microsoft®Windows Server® 2019 Essentials
Windows Server 2022:
- Microsoft®Windows Server® 2022 Standard
- Microsoft®Windows Server® 2022 Essentials
Windows 10:
- Microsoft® Windows 10 Pro
- Microsoft® Windows 10 Enterprise
Windows 11:
- Microsoft® Windows 11 Pro
- Microsoft® Windows 11 Enterprise

OpenJDK ist eine Marke von Oracle America, Inc. Java und Open JDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochterfirmen. Urheberrecht Oracle America, Inc.

Andere hier aufgeführte Produktnamen dienen nur Identifikationszwecken und können Marken ihrer jeweiligen Firmen sein. Wir verzichten auf alle Rechte an diesen Marken.

1.2 Erste Schritte mit RICOH TotalFlow™ Cloud

Machen Sie sich mit den TotalFlow Cloud-Anwendungen vertraut, damit Sie mit der Arbeit beginnen können.

1.2.1 Erste Anmeldung bei RICOH TotalFlow Cloud

Wenn Ihr Konto erstellt wurde, erhalten Sie eine E-Mail von RICOH TotalFlow Cloud. Verwenden Sie die Schaltfläche in dieser E-Mail, um sich zum ersten Mal anzumelden.

Gehen Sie folgendermaßen vor, um sich zum ersten Mal bei RICOH TotalFlow Cloud anzumelden:

Öffnen Sie die E-Mail, die Sie von RICOH TotalFlow Cloud erhalten haben.
Klicken Sie auf Bei Ihrem Konto anmelden.
Die Anmeldeseite wird in Ihrem Standard-Webbrowser geöffnet.
Geben Sie ein Passwort in die Felder Neues Kennwort und Kennwort wiederholen ein und klicken Sie dann auf Kennwort erstellen.
Die Passwörter müssen mehr als acht Zeichen lang sein und die auf der Seite aufgeführten Kriterien erfüllen.
- Die E-Mail-Einladung ist sieben Tage lang gültig. Wenn Sie auf den Link klicken, nachdem die Einladung abgelaufen ist, wird eine Fehlerseite geöffnet und automatisch eine neue E-Mail-Einladung an Sie gesendet.
  Wichtig: Klicken Sie nur auf den Link Einladung erneut senden auf dieser Seite, wenn Sie innerhalb von 15 Minuten keine neue E-Mail von RICOH TotalFlow Cloud erhalten.
- Wenn Sie weitere Probleme bei der Erstellung Ihres Kontos haben, wenden Sie sich an Ihren Administrator und bitten Sie ihn, Ihre Einladung erneut zu versenden.

1.2.2 Erste Schritte mit RICOH TotalFlow Cloud für Administratoren

Administratoren richten TotalFlow Cloud-Objekte und Anwendungen ein, um sie für die Nutzung durch andere vorzubereiten. Sie erstellen Benutzer-IDs für andere und sind bei geplanten Ausfallzeiten, Systemaktualisierungen und Abonnementinformationen auf dem Laufenden.

Administratoren erledigen die meisten ihrer Aufgaben in der RICOH Account Administration-Anwendung, können aber auch auf andere Anwendungen zugreifen und diese nutzen.

Ihr ersten Schritte mit RICOH TotalFlow Cloud als Administrator:

Melden Sie sich an und ändern Sie Ihr Kennwort.
Wenn Ihre Benutzer-ID erstellt wurde, erhalten Sie eine E-Mail, in der Sie aufgefordert werden, sich anzumelden und die RICOH TotalFlow Cloud-Anwendungen zu nutzen. Wenn Sie sich das erste Mal anmelden, müssen Sie Ihr Kennwort ändern.
- Ricoh erstellt nur einen Benutzer für Ihr Konto. Dieser Benutzer ist ein Administrator. Wenn Sie der erste Benutzer sind, sind Sie dafür verantwortlich, weitere Benutzer hinzuzufügen und ihnen Zugriff auf die richtigen Anwendungen zu geben. Sie können weitere Administratoren anlegen und ihnen Aufgaben übertragen.
Als Administrator werden Sie zur Anwendung Account Administration weitergeleitet.
Ergreifen Sie Maßnahmen zu den Cookie-Einstellungen.
TotalFlow Cloud-Anwendungen verwenden Cookies, von denen einige erforderlich sind. Unter Cookie-Einstellungen verwalten erfahren Sie mehr über Cookies und die Maßnahmen, die Sie ergreifen können.
Machen Sie sich mit der Benutzeroberfläche der Anwendung vertraut. Sehen Sie sich diese Themen an:
- Banner
- Hauptseite
Überprüfen Sie Ihre Kontoinformationen und Abonnements.
- Kontodetails verwalten
  Bei Bedarf können Sie Ihre Kontaktdaten aktualisieren.
- Lizenzen anzeigen
  Wenn Sie Fragen haben, wenden Sie sich an Ihren Ricoh-Vertreter.
Informieren Sie sich über die Komponenten Ihres Systems, damit Sie mit der Planung der zu erstellenden Objekte beginnen können.
- Systemobjekte
- RICOH Cloud Connector
Verwenden Sie die in diesem Abschnitt und im Abschnitt Konfiguration beschriebenen Verfahren, um die Benutzer-IDs und andere für Ihr Konto erforderliche Objekte zu erstellen.

1.2.2.1 Lizenzen anzeigen

Sie können Details zu Ihren Lizenzen in RICOH Account Administration anzeigen.

So zeigen Sie die Lizenzen an:

Melden Sie sich bei RICOH Account Administration an.
Klicken Sie im linken Bereich auf Lizenzen.

Die Seite Lizenzen enthält Ihre Lizenzkarten sowie deren aktuellen Status und die Ablaufdaten. Ein Abonnementstatus kann sein:

Aktiv

Die Lizenz kann derzeit genutzt werden.

Ausstehend

Das Startdatum des Abonnements ist noch nicht erreicht.

Ausgesetzt

Das Abonnement wurde aufgrund eines Ereignisses, z. B. einer Verletzung der Geschäftsbedingungen oder einer fehlenden Zahlung, deaktiviert. Es kann wiederhergestellt werden, nachdem das Problem behoben wurde.

Abgelaufen

Die Laufzeit der Lizenz ist abgelaufen.
Klicken Sie auf Details, um die Details der Lizenz zu erweitern.

Die Tabelle Lizenzen enthält Informationen über die Lizenzen für die verschiedenen Funktionen, die in der Lizenz enthalten sind, sowie über alle Add-ons und die Anzahl der einzelnen Lizenztypen, die Sie im Rahmen dieser Lizenz erworben haben.

Die Tabelle Lizenzdetails enthält eine Übersicht über das Produkt und alle in dieser Lizenz enthaltenen Add-ons.

Um eine Lizenz zu verlängern oder weitere Add-ons zu erwerben, wenden Sie sich an Ihren Ricoh-Vertreter.

1.2.2.2 Benutzer hinzufügen

Wenn Sie einen Benutzer hinzufügen, geben Sie die Kontaktinformationen des Benutzers und die jeweilige Funktion an, die der Benutzer für die einzelnen Anwendungen innehält.

Sie können einen neuen Benutzer anlegen oder einen bestehenden Benutzer kopieren. Durch das Kopieren von Benutzern können Sie Zeit sparen, insbesondere dann, wenn Sie mehrere Benutzer mit ähnlichen Merkmalen erstellen müssen.

So fügen Sie einen Benutzer hinzu:

Klicken Sie im linken Fensterbereich auf Benutzer.
Wählen Sie eine der folgenden Optionen:
- Um einen neuen Benutzer hinzuzufügen: Klicken Sie in der rechten oberen Ecke des Fensters auf Benutzer hinzufügen.
- Um einen bestehenden Benutzer zu kopieren: Klicken Sie mit der rechten Maustaste auf die Zeile eines bestehenden Benutzers und wählen Sie Duplizieren.
Geben Sie in dem sich öffnenden Dialogfeld die Details für den Benutzer ein.
Wählen Sie unter Benutzertyp die Option Intern, um ein Benutzerkonto für einen Ihrer Mitarbeiter anzulegen.
Wählen Sie unter Plattform-Rolle eine der folgenden Optionen:
- Standard − Der Benutzer kann sich bei der Anwendung mit Standardzeitüberschreitung und Standard-Zugriffsoptionen anmelden.
- Große Anzeige − Auf einem großen Display hat der Benutzer nur Lesezugriff auf die Anwendung; für die Anmeldung gilt keine Zeitüberschreitung.
Wählen Sie unter Zugriff und Rollen den Zugriff und die Rolle des Benutzers für jede Anwendung. Klicken Sie auf den Pfeil in der Spalte Zugriff und Rollen für die jeweilige Anwendung.
- Einige Abonnements umfassen Beschränkungen für die Anzahl der Benutzer, die jeder Rolle zugewiesen werden können.
Klicken Sie auf OK.

Der Benutzer erhält eine E-Mail, in der er aufgefordert wird, sich bei RICOH TotalFlow Cloud anzumelden, wo er seine Daten anpassen und sein Kennwort ändern kann. Die E-Mail-Einladung ist sieben Tage lang gültig.

Hinweis:

Wenn sich der Benutzer nicht anmeldet, bevor die E-Mail-Einladung abläuft, können Sie die Einladung erneut senden. Klicken Sie mit der rechten Maustaste auf den Benutzer und wählen Sie Einladung erneut senden.

1.2.3 Erste Schritte mit RICOH TotalFlow Cloud für Benutzer

Die Benutzer der RICOH TotalFlow Cloud-Anwendungen können eine Vielzahl von Rollen einnehmen, vom Analysten von Unternehmensinformationen bis zum Druckerei-Bediener.

Die meisten Benutzer haben Zugriff zu einer RICOH TotalFlow Cloud-Anwendung. Sie können auch die Angaben zu Ihrer Benutzer-ID und Ihrem Kennwort aktualisieren.

Ihre ersten Schritte mit RICOH TotalFlow Cloud-Anwendungen als Benutzer:

Melden Sie sich an und ändern Sie Ihr Kennwort.
Wenn Ihre Benutzer-ID erstellt wurde, erhalten Sie eine E-Mail, in der Sie aufgefordert werden, sich anzumelden und die RICOH TotalFlow Cloud-Anwendungen zu nutzen. Wenn Sie sich das erste Mal anmelden, müssen Sie Ihr Kennwort ändern.
Nachdem Sie Ihr Kennwort geändert haben, sehen Sie die Anwendung, die Sie benutzen können.
Ergreifen Sie Maßnahmen zu den Cookie-Einstellungen.
TotalFlow Cloud-Anwendungen verwenden Cookies, von denen einige erforderlich sind. Unter Cookie-Einstellungen verwalten erfahren Sie mehr über Cookies und die Maßnahmen, die Sie ergreifen können.
Machen Sie sich mit der Benutzeroberfläche der Anwendung vertraut. Sehen Sie sich diese Themen an, wenn sie für Sie relevant sind:
Informieren Sie sich über die Komponenten Ihres Systems.
- Systemobjekte

1.2.4 Cookie-Einstellungen verwalten

RICOH TotalFlow Cloud-Anwendungen verwenden Cookies, um Ihre Erfahrungen mit unserer Software zu verbessern. Sie können die Einstellungen für einige dieser Cookies steuern.

RICOH TotalFlow Cloud-Anwendungen können folgende Arten von Cookies verwenden:

Unbedingt erforderliche Cookies: Dies sind Cookies, die für das Funktionieren unserer Anwendungen unerlässlich sind. Wenn Sie sich entscheiden, diese Cookies nicht zuzulassen, können Sie sich möglicherweise nicht bei unseren Anwendungen anmelden oder andere wichtige Funktionen nutzen.
Leistungs-Cookies: Leistungs-Cookies, auch bekannt als Statistik-Cookies, sammeln Informationen darüber, wie gut unsere Anwendungen funktionieren. Diese Informationen werden zusammengefasst und anonymisiert, sodass sie nicht dazu verwendet werden können, Sie zu identifizieren.; Zu den gesammelten Leistungsdaten gehören auch die von Google Analytics erfassten Informationen. Um zu verhindern, dass Ihre Daten von Google Analytics erfasst werden, deaktivieren Sie Leistungs-Cookies.
Funktionalitäts-Cookies: Funktionalitäts-Cookies, auch als Einstellungs-Cookies bekannt, speichern Informationen wie die zuletzt besuchte Seite oder die von Ihnen bevorzugte Sprache.
Marketing-Cookies: Marketing-Cookies sammeln Informationen über Ihre Online-Aktivitäten, um Ihnen relevante Werbung zu bieten.

So verwalten Sie die Cookie-Einstellungen:

Melden Sie sich bei einer beliebigen TotalFlow Cloud-Anwendung an.
Klicken Sie im Banner auf , das Konto-Symbol, und wählen Sie Cookie-Einstellungen.
Klicken Sie im Dialogfeld Cookie-Einstellungen auf Erklärung zu Cookies anzeigen, um eine Liste der in TotalFlow Cloud-Anwendungen verwendeten Cookies und deren Beschreibungen anzuzeigen.
Benutzen Sie die Schalter, um die jeweilige Cookie-Art ein- oder auszuschalten.
In der Standardeinstellung sind alle Cookies aktiviert:
Klicken Sie auf OK.

1.3 Konfiguration

Verwenden Sie diese Verfahren, um Ihr System so einzurichten, dass andere Personen in Ihrem Unternehmen es nutzen können.

1.3.1 Benutzer hinzufügen

Wenn Sie einen Benutzer hinzufügen, geben Sie die Kontaktinformationen des Benutzers und die jeweilige Funktion an, die der Benutzer für die einzelnen Anwendungen innehält.

So fügen Sie einen Benutzer hinzu:

Klicken Sie im linken Fensterbereich auf Benutzer.
Wählen Sie eine der folgenden Optionen:
- Um einen neuen Benutzer hinzuzufügen: Klicken Sie in der rechten oberen Ecke des Fensters auf Benutzer hinzufügen.
- Um einen bestehenden Benutzer zu kopieren: Klicken Sie mit der rechten Maustaste auf die Zeile eines bestehenden Benutzers und wählen Sie Duplizieren.
Geben Sie in dem sich öffnenden Dialogfeld die Details für den Benutzer ein.
Wählen Sie unter Benutzertyp die Option Intern, um ein Benutzerkonto für einen Ihrer Mitarbeiter anzulegen.
Wählen Sie unter Plattform-Rolle eine der folgenden Optionen:
- Standard − Der Benutzer kann sich bei der Anwendung mit Standardzeitüberschreitung und Standard-Zugriffsoptionen anmelden.
- Große Anzeige − Auf einem großen Display hat der Benutzer nur Lesezugriff auf die Anwendung; für die Anmeldung gilt keine Zeitüberschreitung.
Wählen Sie unter Zugriff und Rollen den Zugriff und die Rolle des Benutzers für jede Anwendung. Klicken Sie auf den Pfeil in der Spalte Zugriff und Rollen für die jeweilige Anwendung.
- Einige Abonnements umfassen Beschränkungen für die Anzahl der Benutzer, die jeder Rolle zugewiesen werden können.
Klicken Sie auf OK.

Hinweis:

Wenn sich der Benutzer nicht anmeldet, bevor die E-Mail-Einladung abläuft, können Sie die Einladung erneut senden. Klicken Sie mit der rechten Maustaste auf den Benutzer und wählen Sie Einladung erneut senden.

1.4 Verwalten von Objekten

Nachdem Sie Benutzer erstellt und Ihre Kontodetails konfiguriert haben, können Sie sie bei Bedarf aktualisieren.

1.4.1 Kontodetails verwalten

Sie können Ihre Kontodetails, einschließlich Ihres Unternehmens und Ihrer Kontaktinformationen, ändern.

So verwalten Sie Kontodetails:

Klicken Sie im linken Fensterbereich auf Details.
Klicken Sie auf Details bearbeiten.
Ändern Sie die Informationen nach Bedarf, und klicken Sie auf OK.

1.4.2 Benutzerinformationen ändern

Sie können die Angaben zu einem Benutzer bei Bedarf ändern.

So ändern Sie Benutzerinformationen:

Klicken Sie im linken Bereich auf Benutzer.
Klicken Sie mit der rechten Maustaste auf die Informationen, die Sie ändern möchten, und klicken Sie auf Bearbeiten.
Ändern Sie die Benutzerinformationen nach Bedarf, und klicken Sie auf OK.

1.4.3 Ihr Kennwort ändern

Ändern Sie Ihr Kennwort, um die Sicherheit Ihres Kontos zu gewährleisten.

Hinweis:

Wenn Sie Ihr aktuelles Kennwort nicht kennen, öffnen Sie die Anmeldeseite für RICOH TotalFlow Cloud und klicken Sie auf Kennwort vergessen. Geben Sie Ihre E-Mail-Adresse ein und klicken Sie auf Weiter. Prüfen Sie Ihre E-Mails auf eine Nachricht von RICOH TotalFlow Cloud, die Anweisungen zum Zurücksetzen Ihres Kennworts enthält.

So ändern Sie Ihr Kennwort:

Melden Sie sich bei RICOH TotalFlow Cloud an.
Klicken Sie im Banner auf , das Kontosymbol, und wählen Sie Profileinstellungen.
Klicken Sie auf der linken Seite der Seite Ricoh Software Profil und Einstellungen auf Kennwort.
Geben Sie Ihr aktuelles Kennwort und Ihr neues Kennwort zweimal ein.
Klicken Sie auf Kennwort ändern.
Klicken Sie auf Schließen.

Wenn Sie sich das nächste Mal anmelden, müssen Sie das neue Kennwort verwenden.

1.5 Arbeiten mit der Datenexport-API

Mithilfe der Datenexport-API können Sie die von RICOH Predictive Insight erfassten Informationen extrahieren, um sie in anderen Prozessen und Tools Ihres Unternehmens zu nutzen.

Die Datenexport-API ermöglicht den programmgesteuerten Zugriff auf Druckerinformationen, die Jobs, Daten zum Druckerstatus sowie Ereignisse im Zusammenhang mit Eingriffen am Drucker. Sie können damit Berichtstools mit Daten versorgen, Dashboards befüllen, Betriebsdaten archivieren oder Daten aus RICOH Predictive Insight in andere Systeme Ihrer Umgebung integrieren.

1.5.1 Datenexport-API

Die Datenexport-API ist eine REST-API, die vier Endpunkte bereitstellt. Über diese Endpunkte können Sie Informationen zu Ihren Druckern und den von ihnen verarbeiteten Jobs sowie zu den Betriebszuständen dieser Drucker im Zeitverlauf und zu Ereignissen abrufen, die Warn- oder Fehlermeldungen am Drucker ausgelöst haben.

Mithilfe der Datenexport-API können Sie Daten aus RICOH Predictive Insight in Business-Intelligence-Tools, Data Warehouses, Dashboards und andere Anwendungen in Ihrem Unternehmen übertragen.

Authentifizierung

Sie erstellen und verwalten API-Schlüssel unter RICOH Account Administration. Sie können so viele Schlüssel erstellen, wie Sie benötigen: einen pro Anwendung, die Daten herunterlädt, oder einen Schlüssel, der unternehmensweit verwendet werden kann. Legen Sie das Ablaufdatum entsprechend Ihren Sicherheitsrichtlinien fest und wechseln Sie die Schlüssel bei Bedarf aus. Sie können den Überlappungszeitraum festlegen, sodass der alte und der neue Schlüssel noch einige Tage lang beide funktionieren. Bei Bedarf können Sie einen Schlüssel löschen, um ihn sofort zu deaktivieren.

Der API-Schlüssel enthält zudem Ihre Mandanten-ID, weshalb bei keiner Anfrage ein Mandanten- oder Kontoparameter erforderlich ist. Jeder, der über den Schlüsselwert verfügt, kann Anfragen in Ihrem Namen absenden; schützen Sie API-Schlüssel daher genauso, wie Sie ein Kennwort schützen würden.

Verfügbare Endpunkte

Die API umfasst die folgenden Endpunkte:

/printers

Gibt die Liste der Drucker in Ihrem Konto zurück, einschließlich Druckername, Modell, Hersteller, Seriennummer, Druckwerke und aktueller Status der Verbindung.

/jobs

Gibt Details auf Ebene der Jobs für einen oder mehrere Drucker zurück, darunter Zeitangaben, gedruckte Exemplare, Seiten, Drucke, Bögen, Rollenlänge sowie den Tinten- und Spülmittelverbrauch nach Farbkanal. Standardmäßig umfasst die Antwort die letzten 24 Stunden.

/printer-states

Gibt den Betriebsstatus jeder Drucker-Engine zurück, entweder als aggregierte Historie über einen bestimmten Zeitraum oder ausschließlich als aktueller Status. Sie können den aktuellen Status des Druckers abrufen, beispielsweise: Drucken, Vorbereiten, Wartung oder Ruhezustand, oder diese Status können in folgende Kategorien zusammengefasst werden: up, down, idle oder unkown.

Tipp: Der Endpunkt /printer-states liefert Statusinformationen pro Drucker-engine und nicht pro Drucker. Ein Drucker mit mehreren Modulen gibt pro Modul eine Zeile aus.

/printer-interventions

Gibt die Ereignisse zurück, die auf einem oder mehreren Druckern zu Warnungen oder Fehlern geführt haben, wie beispielsweise einen Papierstau oder eine leere Medienquelle. Jedes Ereignis wird für eine einzelne Drucker-Engine erfasst, einschließlich des Startzeitpunkts, des Endzeitpunkts, der Dauer, eines Codes zur Identifizierung der Bedingung sowie gegebenenfalls des Namens des Jobs, der gerade gedruckt wurde. Standardmäßig umfasst die Antwort die letzten 24 Stunden. Sie können Veranstaltungsbeschreibungen in jeder der unterstützten Sprachen anfordern.

Testen der API

Es steht eine interaktive Dokumentationsseite zur Verfügung, auf der Sie die einzelnen Endpunkte einsehen, die unterstützten Parameter überprüfen und Beispielanfragen direkt in Ihrem Browser ausprobieren können. Um die Seite zu öffnen, rufen Sie folgende Adresse auf:

USA und Japan: https://rpi-data-export.app-ricohsoftware.com/api/v1/api-docs
Europa: https://rpi-data-export.app-ricohsoftware.eu/api/v1/api-docs

Um Anfragen über die Dokumentationsseite oder aus Ihren eigenen Anwendungen zu senden, müssen Sie zunächst einen API-Schlüssel erstellen. Sie erstellen und verwalten API-Schlüssel unter Account Administration.

1.5.2 Erstellen und Verwalten von API-Schlüsseln

Ein API-Schlüssel autorisiert Anfragen an die Datenexport-API. Sie erstellen und verwalten API-Schlüssel unter Account Administration und geben den Schlüssel an, wenn Sie Anfragen über die Seite „API-Explorer“ oder aus Ihren eigenen Anwendungen absenden.

Jede Anfrage an die Datenexport-API muss einen gültigen API-Schlüssel in der Kopfzeile x-api-key enthalten. Der Schlüssel authentifiziert die Anfrage für Ihr Konto (Tenant).

Um API-Schlüssel zu erstellen, benötigen Sie Zugriff auf Administrator unter Account Administration.

Befolgen Sie die in diesem Abschnitt beschriebenen Vorgehensweisen, um:

Erstellen Sie einen neuen API-Schlüssel.
Bearbeiten Sie den Namen, das Ablaufdatum oder die Beschreibung eines vorhandenen Schlüssels.
Drehen Sie einen Schlüssel, um dessen geheimen Wert zu ersetzen, ohne die Identität des Schlüssels zu ändern.
Entfernen Sie einen Schlüssel aus dem System.

Hinweis: Wenn Sie einen API-Schlüssel erstellen oder aktualisieren, gibt es ein kurzes Zeitfenster, bevor der Schlüssel registriert und einsatzbereit ist. In der Regel beträgt dieses Zeitfenster weniger als eine Minute.

So erstellen Sie einen neuen API-Schlüssel:
1. Klicken Sie im linken Bereich von Account Administration auf API-Schlüssel.
2. Klicken Sie auf API-Schlüssel erstellen.
3. Geben Sie einen Namen und eine Beschreibung für diesen Schlüssel ein.
4. Wählen Sie für Ablaufdatum ein Datum aus, das bis zu 367 Tage in der Zukunft liegt.
5. Wählen Sie für Lizenzen den Nutzungsplan „RPI Data Export“ für API-Schlüssel aus.
6. Klicken Sie auf Weiter.
  Der Schlüssel wurde generiert und gespeichert.
7. Klicken Sie auf Kopieren, um den generierten Schlüssel in Ihre Zwischenablage zu kopieren. Bewahren Sie es sicher auf.
  
  Wichtig: Der vollständige Schlüsselwert wird erst bei der Erstellung des Schlüssels angezeigt. Sie können nicht erneut darauf zugreifen. Sollten Sie den Wert verlieren, müssen Sie den Schlüssel rotieren, um einen neuen zu generieren.
1. Klicken Sie auf Ich habe meinen Schlüssel gespeichert, um das Dialogfeld zu schließen.
So bearbeiten Sie einen bestehenden API-Schlüssel:
1. Klicken Sie im linken Bereich von Account Administration auf API-Schlüssel.
2. Suchen Sie den Schlüssel, den Sie ändern möchten. Klicken Sie mit der rechten Maustaste auf die Zeile des Schlüssels und wählen Sie API-Schlüssel bearbeiten aus.
3. Passen Sie den Namen, das Ablaufdatum oder die Beschreibung nach Bedarf an.
  Das Bearbeiten eines Schlüssels hat keine Auswirkungen auf den Schlüsselwert. Anwendungen, die den Schlüssel bereits verwenden, funktionieren weiterhin ohne Änderungen.
4. Klicken Sie auf OK.
So rotieren Sie einen API-Schlüssel:
1. Klicken Sie im linken Bereich von Account Administration auf API-Schlüssel.
2. Suchen Sie den Schlüssel, den Sie drehen möchten. Klicken Sie mit der rechten Maustaste auf die Zeile des Schlüssels und wählen Sie API-Schlüssel rotieren aus.
3. Stellen Sie den Parameter Überschneidungszeitraum in Tagen auf die Anzahl der Tage ein, an denen sowohl der bestehende Schlüssel als auch die rotierte Version gleichzeitig aktiv sein sollen.
4. Legen Sie für den Schlüssel einen neuen Wert Ablaufdatum fest.
5. Klicken Sie auf OK.
6. Klicken Sie auf Kopieren, um den generierten Schlüssel in Ihre Zwischenablage zu kopieren. Bewahren Sie es sicher auf.
  
  Wichtig: Der vollständige Schlüsselwert wird erst bei der Erstellung des Schlüssels angezeigt. Sie können nicht erneut darauf zugreifen. Sollten Sie den Wert verlieren, müssen Sie den Schlüssel rotieren, um einen neuen zu generieren.
7. Aktualisieren Sie alle Anwendungen, Skripte oder gespeicherten interaktiven Dokumentationssitzungen, die diesen Schlüssel verwenden, bevor der Überschneidungszeitraum abläuft.
So entfernen Sie einen Schlüssel aus dem System:
1. Klicken Sie im linken Bereich von Account Administration auf API-Schlüssel.
2. Suchen Sie den Schlüssel, den Sie drehen möchten. Klicken Sie mit der rechten Maustaste auf die Zeile des Schlüssels und wählen Sie Sofort löschen aus.
3. Wählen Sie im Dialogfeld Folgendes aus: Ja, diesen Schlüssel löschen.
  Dieser Schritt ist erforderlich, da das Löschen unwiderruflich ist. Sobald Sie den Schlüssel gelöscht haben, können Sie ihn nicht mehr wiederherstellen.
4. Klicken Sie auf OK.

Sie können den neuen oder aktualisierten API-Schlüssel auf der Seite mit der interaktiven Dokumentation verwenden, um die Datenexport-API zu testen, sowie in jeder Anwendung, die Anfragen an die API sendet.

1.5.3 Die Datenexport-API ausprobieren

Befolgen Sie diese Anleitung, um sich einen kurzen Überblick über die API zu verschaffen, und nutzen Sie dabei die interaktive Dokumentationsseite als Leitfaden.

Bevor Sie mit dieser Aufgabe beginnen, erstellen Sie bitte einen API-Schlüssel unter RICOH Account Administration.

Diese Anleitung führt Sie durch folgende Schritte:

Authentifizierung auf der Seite mit der interaktiven Dokumentation
Abrufen der Liste der Drucker-IDs für die Drucker in Ihrem Konto
Den Status eines oder mehrerer Drucker abrufen
Anforderung von Informationen zu Jobs, die mit einem oder mehreren dieser Drucker verbunden sind

So nutzen Sie die Datenexport-API:

Öffnen Sie hier die interaktive Dokumentation zur Datenexport-API:
- USA und Japan: https://rpi-data-export.app-ricohsoftware.com/api/v1/api-docs
- Europa: https://rpi-data-export.app-ricohsoftware.eu/api/v1/api-docs
Authentifizierung mithilfe eines API-Schlüssels:
1. Klicken Sie auf der rechten Seite auf Autorisieren.
2. Geben Sie im Dialogfeld Verfügbare Berechtigungen Ihren API-Schlüssel in das Feld Wert ein.
1. Klicken Sie auf Autorisieren, um sich zu authentifizieren.
2. Klicken Sie auf Close.
Sie können nun die verfügbaren API-Funktionen testen. Nutzen Sie diese Schnittstelle, um sich mit der Syntax vertraut zu machen, bevor Sie die API in Ihre Anwendungen integrieren.
Rufen Sie die Liste der Drucker-IDs für die in Ihrem Konto definierten Drucker ab.
Um Informationen zum Status der Jobs und des Druckers abzurufen, müssen Sie in Ihren API-Anfragen die Drucker-ID-Werte angeben. Drucker-IDs ändern sich nicht. Wenn Sie diese nun abrufen und die Werte speichern, können Sie die IDs in anderen API-Aufrufen verwenden.
1. Öffnen Sie den Abschnitt Drucker und anschließend den Endpunkt GET /printers.
  Sie sehen, dass für diesen Endpunkt keine Parameter erforderlich sind.
2. Klicken Sie auf Ausprobieren und anschließend auf Ausführen.
3. Überprüfen Sie den Antworttext. Sie sehen eine Liste mit Details zu den Druckern, die von RICOH Predictive Insight überwacht werden. Die Antwort sieht in etwa so aus:
```
[
  {
    "printerName": "VC80_2",
    "printerId": "0bc6b7b3-8df9-4293-cdd4-5ae3162c4d4c",
    "engines": 2,
    "manufacturer": "Ricoh",
    "model": "RICOH Pro VC80000",
    "printerMode": "duplex",
    "printerType": "continuous_feed",
    "serialNumber": "Printer 1: 10-11111 and Printer 2: 10-11112",
    "connectionStatus": "not_connected"
  },
  {
    "printerName": "IP 5000",
    "printerId": "0f8726da-8q37-9c3l-8710-065d7c265122",
    "engines": 1,
    "manufacturer": "InfoPrint",
    "model": "InfoPrint 5000 GP v3.17.129",
    "printerMode": "simplex",
    "printerType": "continuous_feed",
    "serialNumber": "10-1111111",
    "connectionStatus": "connected"
  }
]
```
  Notieren Sie sich die Werte der printerId-Parameter für jeden Ihrer Drucker.
Fordern Sie den Druckerstatusverlauf für einen oder mehrere Drucker in Ihrem System an.
1. Rufen Sie den Endpunkt GET /printer-states auf.
2. Klicken Sie auf Probieren Sie es aus.
3. Klicken Sie neben printerId auf Zeichenfolgenelement hinzufügen.
4. Ersetzen Sie den Text in dem Feld durch einen der Drucker-ID-Werte, die Sie in Schritt 3 abgerufen haben.
  Um den Statusverlauf für weitere Drucker abzurufen, klicken Sie erneut auf Zeichenfolgenelement hinzufügen und fügen Sie einen weiteren Drucker-ID-Wert hinzu.
5. Wählen Sie unter Zeitzone die Zeitzone aus, die für die Daten verwendet werden soll.
6. Geben Sie die Start- und Endzeit für den Zeitbereich an, für den der Bericht erstellt werden soll. Lassen Sie diese Felder leer, um Daten der letzten 24 Stunden abzurufen.
7. Lassen Sie die letzten drei Werte auf den Standardwerten stehen, damit Sie die vollständige Liste der Informationen sehen können, die die API zurückgeben kann.
8. Klicken Sie auf Ausführen.
9. Überprüfen Sie den Antworttext. Sie sehen eine Liste mit Daten zum Druckerstatus für jede Drucker-Engine, wobei jeder Statuswechsel durch einen eigenen Eintrag dargestellt wird.
10. Ändern Sie die Werte für die Parameter currentState, stateCategoryOnly und stateCategory und klicken Sie erneut auf Ausführen, um zu sehen, wie sich die Antwort ändert.
  - Wenn Sie diese Parameter auf den Standardwert (nicht gesetzt) belassen, hat dies denselben Effekt wie die Einstellung auf falsch.
  - Sie können diese einzeln oder in Kombination miteinander verwenden.
Fordern Sie Informationen zu den Jobs an, die mit einem oder mehreren dieser Drucker verbunden sind:
1. Rufen Sie den Bereich Jobs auf dieser Seite auf.
2. Rufen Sie den Endpunkt GET /jobs auf.
3. Klicken Sie auf Probieren Sie es aus.
4. Klicken Sie neben printerId auf Zeichenfolgenelement hinzufügen.
5. Ersetzen Sie den Text in dem Feld durch einen der Drucker-ID-Werte, die Sie in Schritt 3 abgerufen haben.
  Um Jobinformationen für weitere Drucker abzurufen, klicken Sie erneut auf Zeichenfolgenelement hinzufügen und fügen Sie einen weiteren Drucker-ID-Wert hinzu.
6. Wählen Sie unter Zeitzone die Zeitzone aus, die für die Daten verwendet werden soll.
7. Geben Sie die Start- und Endzeit für den Zeitbereich an, für den der Bericht erstellt werden soll. Lassen Sie diese Felder leer, um Daten der letzten 24 Stunden abzurufen.
8. Lassen Sie das Feld Jobstatus leer, um die gesamte Bandbreite der Antworten anzuzeigen, die die API zurückgeben kann.
9. Klicken Sie auf Ausführen.
10. Überprüfen Sie die Antwort, um die zurückgegebenen Jobinformationen anzuzeigen.
11. Ändern Sie den Wert für Jobstatus und klicken Sie erneut auf Ausführen, um zu sehen, wie sich die Antwort ändert.

1.5.4 Umgang mit Datum und Uhrzeit in der Datenexport-API

Die Datenexport-API verwendet ein einheitliches Modell für die Verarbeitung von Datums- und Zeitangaben: Jede Anfrage enthält eine IANA-Zeitzone, jeder Datums- und Zeitwert wird in dieser Zeitzone interpretiert, und jeder Datums- und Zeitwert in der Antwort wird in derselben Zeitzone formatiert. Nutzen Sie dieses Thema, um die Funktionsweise des Modells zu verstehen und häufige Fehler zu vermeiden.

Das Datum und Uhrzeitmodell

Drei Regeln beschreiben, wie die API mit Datum und Uhrzeitangaben umgeht:

Jede Anfrage an /Jobs, /printer-states und /printer-interventions muss einen timezone enthalten, der eine gültige IANA-Zeitzonenbezeichnung enthält, beispielsweise America/Denver oder Europe/Bucharest.
Jeder in der Anfrage angegebene Wert für startDateTime oder endDateTime wird als Ortszeit in der angegebenen Zeitzone interpretiert. Die Werte enthalten keinen UTC-Versatz.
Jeder Datum und Zeitwert in der Antwort wird als Ortszeit in derselben Zeitzone im Format JJJJ-MM-TTTHH:MM:SS.sss dargestellt.

Der Parameter timezone bestimmt die Bedeutung der Anfrage und die Formatierung der Antwort. Zwei Anfragen für dieselben zugrunde liegenden Daten, die mit unterschiedlichen Zeitzonen übermittelt wurden, führen zu Antworten mit unterschiedlichen Zeitstempel-Zeichenfolgen, obwohl sie dieselben Ereignisse beschreiben.

Datum und Uhrzeitformat

Die API verwendet sowohl in Anfragen als auch in Antworten ein einheitliches Format für alle Datums- und Zeitangaben:

YYYY-MM-DDTHH:MM:SS.sss

Beispielsweise entspricht 2026-03-15T14:30:00.000 dem 15. März 2026 um 14:30:00 Uhr, interpretiert in der mit der Anfrage angegebenen Zeitzone.

Wichtig: Das Format enthält weder einen UTC-Versatz (z. B. -06:00) noch das Suffix Z. Fügen Sie keine hinzu. Sowohl bei Anfragen als auch bei Antworten wird ausschließlich die Ortszeit verwendet, wobei die Zeitzone separat als Anfrageparameter übermittelt wird.

In Anfragen ist der Millisekunden-Teil (.sss) optional. In den Antworten ist es stets vorhanden.

Standardzeitbereich

Sie können startDateTime, endDateTime oder beides weglassen. Die beiden Standardwerte werden unabhängig voneinander angewendet:

Wenn Sie startDateTime weglassen, verwendet die API den Zeitpunkt 24 Stunden vor der aktuellen Uhrzeit als Beginn des Zeitraums.
Wenn Sie endDateTime weglassen, verwendet die API die aktuelle Uhrzeit als Endzeitpunkt des Zeitraums.

Die Standardeinstellungen werden so kombiniert, wie Sie es erwarten würden:

Wenn Sie beide Werte weglassen, gibt die API Daten für die letzten 24 Stunden zurück.
Wenn Sie für startDateTime den Wert „vor einer Stunde“ angeben und endDateTime weglassen, gibt die API Daten für die vergangene Stunde zurück.
Wenn Sie endDateTime angeben und startDateTime weglassen, gibt die API Daten für den Zeitraum zurück, der 24 Stunden vor der Anfrage beginnt und mit endDateTime endet.

Die Standardwerte werden in der mit der Anfrage angegebenen Zeitzone berechnet.

Aufbewahrungsfrist: die letzten sieben Tage

Die Datenexport-API stellt Betriebsdaten in Echtzeit bereit. Jobs, der Verlauf des Druckerstatus und Interventionsereignisse sind nur für die letzten sieben Tage verfügbar. Eine Anfrage nach Daten, die älter als sieben Tage sind, führt zu einer Fehlermeldung.

Planen Sie Ihre Integration so, dass geplante Datenextrakte häufig genug ausgeführt werden, um alle Daten zu erfassen, bevor diese veralten:

Für nächtliche Auszüge sollten Sie eine Sicherheitsmarge von mindestens ein bis zwei Tagen einplanen. Sollte ein geplanter Lauf fehlschlagen, haben Sie Zeit, die Ursache zu ermitteln und den Lauf erneut auszuführen, bevor die Daten nicht mehr verfügbar sind.
Bei Nachlieferungen oder einmaligen Datenextrakten fordern Sie bitte keine Daten an, die älter als sieben Tage sind.

Regeln für den angeforderten Bereich

startDateTime muss vor endDateTime liegen. Eine Anfrage, die gegen diese Regel verstößt, schlägt mit dem Fehler ERR_INVALID_DATE_RANGE fehl.
Beide Werte müssen das unter Datum und Uhrzeitformat beschriebene Format aufweisen. Eine Anfrage mit einem fehlerhaften Wert schlägt mit dem Fehler ERR_INVALID_DATE_FORMAT fehl.
Der Zeitraum zwischen startDateTime und endDateTime darf den maximal zulässigen Bereich nicht überschreiten. Eine Anfrage, die das Maximum überschreitet, schlägt mit dem Fehler ERR_DATE_RANGE_EXCEEDED fehl.

Angabe der Zeitzone

Der Parameter timezone akzeptiert IANA-Zeitzonenbezeichnungen wie beispielsweise America/Denver, America/New_York, Europe/Bucharest, Asia/Tokyo oder UTC. Auf der interaktiven Dokumentationsseite ist eine Liste aller Werte aufgeführt, die die API akzeptiert.

Ein ungültiger oder nicht erkannter Bezeichner führt zu einem Fehler mit dem Code ERR_INVALID_TIMEZONE. Dreibuchstabige Abkürzungen wie MST oder EST sind keine IANA-Kennungen und werden nicht akzeptiert; verwenden Sie stattdessen die entsprechende Bereichs-Kennung (beispielsweise America/Denver oder America/New_York).

Bereitstellung der Sprache

Der Parameter timezone ist nicht der einzige Parameter, der bestimmt, wie die API eine Antwort formatiert. Der Endpunkt /printer-interventions akzeptiert zudem einen optionalen language-Parameter, der die Sprache des description-Feldes in der Antwort festlegt.

Die zulässigen Werte sind en (Englisch), de (Deutsch), ja (Japanisch), it (Italienisch), fr (Französisch) und es (Spanisch). Ein Wert, der nicht in dieser Liste enthalten ist, führt zu einem Fehler mit dem Code ERR_INVALID_LANGUAGE.

Zwei Aspekte dieses Parameters sollten bei der Planung berücksichtigt werden:

Wenn Sie den Parameter weglassen oder wenn in der von Ihnen gewünschten Sprache keine Beschreibung verfügbar ist, wird die Beschreibung auf Englisch zurückgegeben. Die Anfrage ist in beiden Fällen erfolgreich; daher darf Ihre Integration nicht davon ausgehen, dass es zwischen der Sprache einer Beschreibung und der angeforderten Sprache eine Übereinstimmung gibt.
Der Parameter wirkt sich ausschließlich auf das description-feld aus. Das dazugehörige Feld interventionCode ist sprachunabhängig; verwenden Sie dieses Feld daher, wenn Sie Ereignisse unabhängig von der angeforderten Sprache einheitlich gruppieren, vergleichen oder speichern müssen.

Sommerzeit und mehrdeutige Zeitangaben

Da Anfragen und Antworten als Ortszeit ausgedrückt werden, ergeben sich durch den Wechsel zur Sommerzeit zwei Situationen, die Sie beachten sollten:

Übersprungene Ortszeiten beim Wechsel zur Sommerzeit: Wenn die Uhren vorgestellt werden, existiert eine Stunde der Ortszeit nicht. Beispielsweise ist in America/Denver am Tag der Zeitumstellung auf Sommerzeit 02:30:00 keine gültige Ortszeit. Vermeiden Sie es, Zeitangaben aus der übersprungenen Stunde als startDateTime oder endDateTime zu verwenden.
Wiederkehrende Ortszeiten im Herbstübergang: Wenn die Uhren zurückgestellt werden, tritt eine Stunde Ortszeit zweimal auf. Ein Wert wie 01:30:00 am Tag der Zeitumstellung ist mehrdeutig. Wählen Sie Zeitpunkte außerhalb der wiederkehrenden Stunde, um Unklarheiten darüber zu vermeiden, welche Instanz Sie anfordern.

Falls Ihre Integration unbeaufsichtigt läuft und möglicherweise eine Anfrage übermittelt, deren Start- oder Endzeit in einen Übergang fällt, planen Sie die Ausführung der Anfrage so, dass sie einige Stunden vor oder nach dem Übergang erfolgt, oder wählen Sie Zeitpunkte, die eindeutig außerhalb des Übergangs liegen.

Empfehlungen zur Speicherung und zum Vergleich von Antwortzeitstempeln

Die Zeitstempel der Antworten sind Ortszeiten ohne Versatz. Um Mehrdeutigkeiten in nachgelagerten Systemen zu vermeiden, sollten Sie einen der folgenden Ansätze in Betracht ziehen:

Speichern Sie den Zeitstempel der Antwort zusammen mit der Zeitzone, die Sie in der Anfrage angegeben haben. Zusammen genommen verdeutlicht dieses Paar einen einzigartigen Moment in der Zeit.
Konvertieren Sie in Ihrer Integration jeden Zeitstempel einer Antwort vor dem Speichern in UTC, wobei Sie die von Ihnen in der Anfrage angegebene Zeitzone verwenden. Die Speicherung von UTC-Werten vereinfacht Vergleiche zwischen Daten, die in unterschiedlichen Zeitzonen erfasst wurden.
Reichen Sie Anfragen stets in derselben Zeitzone ein, beispielsweise in UTC, damit alle gespeicherten Zeitstempel direkt miteinander vergleichbar sind.

Beispiele

Die folgenden Beispiele veranschaulichen, wie die Zeitzone, die Startzeit und die Endzeit zusammenwirken.

Standardfenster in der Mountain Time: Eine Anfrage, die am 15. März 2026 um 9:00 Uhr in der Zeitzone America/Denver, ohne Angabe einer Start- oder Endzeit, liefert Daten vom 2026-03-14T09:00:00 bis zum 2026-03-15T09:00:00, wobei beide Zeitangaben in Mountain Time interpretiert werden.
Bestimmter Zeitraum in osteuropäischer Zeit: Eine Anfrage mit den Parametern timezone=Europe/Bucharest, startDateTime=2026-03-15T08:00:00 sowie endDateTime=2026-03-15T16:00:00 enthält, liefert Daten für den achtstündigen Arbeitstag in Bukarester Ortszeit. Die Zeitstempel der Antworten werden ebenfalls in der Ortszeit von Bukarest angegeben.
Dasselbe Fenster in zwei Zeitzonen: Um dieselben zugrunde liegenden Daten zweimal abzurufen – jeweils für zwei Zielgruppen aufbereitet –, senden Sie zwei Anfragen mit unterschiedlichen timezone und passen Sie startDateTime und endDateTime so an, dass sie in jeder Zeitzone denselben Zeitpunkt beschreiben. Die Antwort-Nutzdaten beschreiben dieselben Ereignisse, verwenden jedoch unterschiedliche Zeitstempel-Zeichenfolgen.

1.5.5 Feldnamen der Antwort der Datenexport-API

Jeder Endpunkt der Datenexport-API gibt ein JSON-Array aus Objekten zurück. Verwenden Sie die Tabellen in diesem Abschnitt, um die Felder in den einzelnen Antworten zu interpretieren.

In dieser Referenz verwendete Konventionen

Alle Zeitangaben werden in Millisekunden angegeben.
Alle Datums- und Zeitangaben werden in der durch den timezone Anfrageparameter angegebenen Zeitzone nach dem Muster JJJJ-MM-DDTHH:MM:SS.sss formatiert.
Identifikationsfelder (printerId, jobId) bleiben über mehrere Anfragen hinweg unverändert und können von integrierten Anwendungen zwischengespeichert werden. Da sich die printerId niemals ändert, können die Werte gespeichert und über mehrere Sitzungen hinweg wiederverwendet werden.

GET /printers – Antwortfelder

Der Endpunkt /printers gibt pro Drucker, der im Konto identifiziert und von einem Data Collector erfasst wird, ein Objekt zurück.

Feld	Typ	Beschreibung
`printerName`	Zeichenfolge	Der Anzeigename, der dem Drucker unter RICOH Predictive Insight zugewiesen wurde.
`printerId`	Zeichenfolge (UUID)	Die eindeutige Kennung des Druckers. Verwenden Sie diesen Wert als `printerId`-Parameter, wenn Sie die Endpunkte `/Jobs`, `/printer-states` oder `/printer-interventions` aufrufen.
`engines`	ganze-zahl	Die Anzahl der Druckwerke im Drucker. Endlosdrucker können über eine oder mehrere Druckwerke verfügen; bei Einzelblattdruckern ist in der Regel ein einziges Druckwerk vorhanden. Jeder Motor wird in den Antworten auf die Anfragen `/printer-states` und `/printer-interventions` als eigene Zeile aufgeführt.
`manufacturer`	Zeichenfolge	Der Hersteller des Druckers, beispielsweise Ricoh oder InfoPrint.
`model`	Zeichenfolge	Das vom Gerät gemeldete Druckermodell, beispielsweise RICOH Pro VC80000.
`printerMode`	Zeichenfolge	Ob der Drucker im `simplex`- oder im `duplex`-Modus arbeitet. Dieses Feld ist bei Druckertypen, für die der Wert nicht zutrifft – wie beispielsweise bei Einzelblattdruckern –, abwesend.
`printerType`	Zeichenfolge	Ob der Drucker `continuous_feed` oder `cut_sheet` unterstützt.
`serialNumber`	Zeichenfolge	Die vom Drucker angezeigte Seriennummer. Bei Druckern mit mehreren Druckwerken können in diesem Feld die Seriennummern der einzelnen Druckwerke in einer einzigen Zeichenfolge angegeben werden, beispielsweise Printer 1: 10-11111 and Printer 2: 10-11112.
`connectionStatus`	Zeichenfolge	Gibt an, ob RICOH Predictive Insight derzeit eine Verbindung zum Drucker herstellen kann. Mögliche Werte sind `connected` und `not_connected`.

GET /Jobs – Antwortfelder

Der Endpunkt /jobs gibt pro Job, der von den angeforderten Druckern innerhalb des angegebenen Zeitraums verarbeitet wurde, ein Objekt zurück.

Feld	Typ	Beschreibung
`printerId`	Zeichenfolge (UUID)	Die Kennung des Druckers, der den Job verarbeitet hat. Ist mit einer `printerId` aus der Antwort unter `/printers` übereinstimmend.
`jobId`	Zeichenfolge	Die eindeutige Kennung des Jobs.
`jobName`	Zeichenfolge	Der Name des Jobs, wie er an den Drucker übermittelt wurde; in der Regel der Name der Quelldatei.
`jobPrintingSide`	Zeichenfolge	Die Seite(n), die für diesen Job bedruckt werden, beispielsweise `simplex` oder `duplex`.
`jobAction`	Zeichenfolge	Der Status der Jobs zum Zeitpunkt der Bearbeitung der Anfrage. Mögliche Werte: `printing`: Der Job wurde gerade gedruckt, als die Anfrage gestellt wurde. `printed`: Der Job wurde erfolgreich abgeschlossen. `aborted`: Der Job wurde beendet, bevor der Druckvorgang abgeschlossen war. `completed`: Der Job hat seinen Endzustand erreicht. Dieser Wert ist eine Obermenge, die sowohl `printed` Jobs als auch `aborted` Jobs umfasst. Verwenden Sie diese Funktion, wenn Sie alle Jobs abrufen möchten, die nicht mehr aktiv sind, unabhängig vom Ergebnis.
`jobStartTime`	Zeichenfolge (Datum/Uhrzeit)	Das lokale Datum und die Uhrzeit, zu denen der Job gestartet wurde, in der in der Anfrage angegebenen Zeitzone.
`jobEndTime`	Zeichenfolge (Datum/Uhrzeit)	Das lokale Datum und die lokale Uhrzeit, zu denen der Job beendet wurde, in der in der Anfrage angegebenen Zeitzone.
`jobDuration`	ganze-zahl	Die verstrichene Druckzeit für den Job in Millisekunden.
`printedCopies`	ganze-zahl	Die Anzahl der erstellten Exemplare der Jobs.
`printedPages`	ganze-zahl	Die Gesamtzahl der für den Job gedruckten logischen Seiten, einschließlich aller Kopien.
`printedImpressions`	ganze-zahl	Die Gesamtzahl der gedruckten Exemplare. Ein Druckbild entspricht einer Seite eines Blattes; bei einem Duplex-Job entstehen somit zwei Druckbilder pro Blatt.
`printedSheets`	ganze-zahl	Die Gesamtzahl der für die Jobs verwendeten physischen Blätter.
`printedRollFeet`	number	Bei Endlosdruckern die Länge des für den Job verbrauchten Druckmediums in Fuß.
`printedRollMeters`	number	Bei Endlosdruckern die Länge des für den Job verbrauchten Druckmediums in Metern.
`inkC, inkM, inkY, inkK`	number	Die Menge an Cyan-, Magenta-, Gelb- und Schwarztinte, die für den Job verbraucht wurde, angegeben pro Farbkanal in Kubikzentimetern (cc).
`flushingC, flushingM, flushingY, flushingK`	number	Die Menge an Cyan-, Magenta-, Gelb- und Schwarztinte, die während der mit dem Job verbundenen Spülvorgänge des Druckkopfs verbraucht wurde, angegeben pro Farbkanal in Kubikzentimetern (cc). Die Werte zum Spülen werden getrennt von den `inkC/M/Y/K` erfasst, sodass der produktive Tintenverbrauch vom Verbrauch für Wartungszwecke unterschieden werden kann.

GET /printer-states – Antwortfelder

Der Endpunkt /printer-states gibt pro Drucker-Engine und pro Zustandsintervall ein Objekt zurück. Welche Felder vorhanden sind, hängt vom Anforderungsmodus ab:

Aggregierte Historie (Standard): Es werden alle Felder zurückgegeben.
Nur aktueller Status (currentState=true): printerStateDuration, historyStartTime und historyEndTime werden weggelassen.
Nur Zustandskategorie (stateCategoryOnly=true): printerState wird weggelassen.

Feld	Typ	Beschreibung
`printerId`	Zeichenfolge (UUID)	Die Kennung des Druckers, auf den sich diese Zeile bezieht. Ist mit einer `printerId` aus der Antwort unter `/printers` übereinstimmend.
`engine`	Zeichenfolge	Der Motor im Drucker, auf den sich diese Zeile bezieht, beispielsweise `engine_1`, `engine_2` oder `engine_3`. Ein Drucker mit mehreren Druckwerken gibt für jedes Zustandsintervall eine Zeile pro Druckwerk zurück.
`stateCategory`	Zeichenfolge	Die übergeordnete Kategorie, in die der Motorstatus zusammengefasst wird. Mögliche Werte sind `up`, `down`, `idle` und `unknown`. Verwenden Sie dieses Feld für Kontrollanzeigen und Berichte, bei denen über alle Druckermodelle hinweg einheitliche Kategorien erforderlich sind.
`printerState`	Zeichenfolge	Der von der Drucker-Engine gemeldete Rohzustand, wie beispielsweise Printing, Preparing, Maintenance oder Sleeping. Die Rohwerte variieren je nach Druckermodell. Wird weggelassen, wenn `stateCategoryOnly=true` ist. Hinweis: Eine vollständige Liste der Bundesstaaten und ihrer Zuordnungen finden Sie unter Druckerzustände und Zustandskategorien.
`printerStateDuration`	ganze-zahl	Die Dauer, während der sich der Motor in diesem Zustand befand, in Millisekunden. Wird weggelassen, wenn `currentState=true` ist.
`historyStartTime`	Zeichenfolge (Datum/Uhrzeit)	Das lokale Datum und die Uhrzeit, zu denen der Motor diesen Zustand erreicht hat, in der in der Anfrage angegebenen Zeitzone. Wird weggelassen, wenn `currentState=true` ist.
`historyEndTime`	Zeichenfolge (Datum/Uhrzeit)	Das lokale Datum und die Uhrzeit, zu der die Engine diesen Zustand verlassen hat, in der in der Anfrage angegebenen Zeitzone. Für das jüngste Intervall in einer aggregierten Antwort kann dieser Wert dem Ende des angeforderten Zeitraums entsprechen. Wird weggelassen, wenn `currentState=true` ist.

GET /printer-interventions – Antwortfelder

Der Endpunkt /printer-interventions gibt für jedes Interventionsereignis ein Objekt zurück, und zwar für jede Druckereinheit jedes angeforderten Druckers innerhalb des angeforderten Zeitraums.

Feld	Typ	Beschreibung
`printerId`	Zeichenfolge (UUID)	Die Kennung des Druckers, auf den sich diese Zeile bezieht. Ist mit einer `printerId` aus der Antwort unter `/printers` übereinstimmend.
`interventionStartDate`	Zeichenfolge (Datum/Uhrzeit)	Das lokale Datum und die Uhrzeit des Beginns des Ereignisses in der in der Anfrage angegebenen Zeitzone.
`interventionEndDate`	Zeichenfolge (Datum/Uhrzeit)	Das lokale Datum und die Uhrzeit, zu denen das Ereignis abgewickelt wurde, in der in der Anfrage angegebenen Zeitzone.
`duration`	ganze-zahl	Die Dauer des Ereignisses in Millisekunden.
`description`	Zeichenfolge	Eine kurze Beschreibung der Bedingung, die die Warnung oder den Fehler ausgelöst hat, beispielsweise Medien leer oder Papierstau. Dieses Feld ist sprachabhängig: Es wird in der durch den `language`-Parameter angeforderten Sprache zurückgegeben oder auf Englisch, falls dieser Parameter weggelassen wird oder die Beschreibung in der angeforderten Sprache nicht verfügbar ist.
`engine`	Zeichenfolge	Der Motor im Drucker, auf den sich diese Zeile bezieht, beispielsweise `engine_1`, `engine_2` oder `engine_3`. Ein Drucker mit mehreren Modulen gibt für jedes Ereignis eine Zeile pro Modul zurück.
`jobName`	Zeichenfolge	Der Name des Jobs, der zum Zeitpunkt des Ereignisses gerade gedruckt wurde. Der Wert ist eine leere Zeichenfolge, wenn kein Job an dem Ereignis beteiligt war.
`interventionCode`	Zeichenfolge	Ein Code, der die Bedingung kennzeichnet. Im Gegensatz zur `description` ist dieser Wert sprachunabhängig; verwenden Sie ihn daher, wenn Sie Ereignisse sprachübergreifend gruppieren oder vergleichen möchten. Das Format des Codes hängt vom Drucker ab: Einzelblattdrucker geben eine beschreibende Zeichenfolge wie `coverOpen` aus, während Endlosdrucker einen Wert wie `CA00` oder `40000006` ausgeben.

1.5.5.1 Druckerzustände und Zustandskategorien

Der Endpunkt /printer-states gibt sowohl den Rohzustand des Druckers als auch eine übergeordnete Zustandskategorie zurück. Anhand der Tabellen in diesem Abschnitt können Sie nachvollziehen, welche Rohdaten in welche Kategorien zusammengefasst werden.

Über Druckerstatus und -kategorien

Für jede Drucker-Engine meldet die Datenexport-API zwei miteinander verbundene Werte:

printerState: Der von der Druckereinheit gemeldete aktuelle Betriebszustand, wie beispielsweise Drucken, Schlafmodus oder Wartung. Die Auswahl der Rohzustände variiert je nach Druckermodell.
stateCategory: Eine übergeordnete Gruppierung, die den Rohzustand als up, down, idle oder unknown klassifiziert. Die Kategorien sind über alle Druckermodelle hinweg einheitlich, weshalb sie die bessere Wahl für Kontrollanzeigen und Berichte darstellen, in denen Daten von mehreren Druckern zusammengefasst werden.

Die Kategorizierung wird unter RICOH Predictive Insight festgelegt und gilt einheitlich für alle Drucker, die Daten über die Datenexport-API übermitteln.

Up-Zustände

Das Druckwerk gilt als up, wenn er aktiv Leistung erzeugt oder sich aktiv darauf vorbereitet, Leistung zu erzeugen. Verwenden Sie diese Kategorie, um die produktive Betriebszeit zu erfassen.

Unbearbeiteter Druckerstatus	Beschreibung
`feeding`	Das Druckwerk führt das Druckmedium zu, um den Druck vorzubereiten.
`initializing`	Das Druckwerk wird im Rahmen des Startvorgangs eines Druckvorgangs initialisiert.
`preparing`	Das Druckwerk bereitet sich auf den Druckvorgang vor, beispielsweise durch das Laden von Daten für einen Job oder das Aufwärmen von Komponenten für einen bevorstehenden Job.
`printing`	Das Druckwerk druckt.
`processing`	Das Druckwerk verarbeitet Daten zu Jobs.
`receiving`	Das Druckwerk erhält einen Job vom Druckserver.

Down-Zustände

Ein Druckwerk wird als down gemeldet, wenn er nicht drucken kann und ein Eingriff durch den Operator oder den Kundendienst, eine Wartungsmaßnahme oder eine Wiederherstellung erforderlich ist oder gerade durchgeführt wird. Verwenden Sie diese Kategorie, um ungeplante und geplante Ausfallzeiten zu erfassen.

Unbearbeiteter Druckerstatus	Beschreibung
`adjusting`	Das Druckwerk führt derzeit einen Einstellvorgang durch, der den Druckvorgang verhindert.
`calibrating`	Das Druckwerk wird gerade kalibriert, beispielsweise hinsichtlich Farbe oder Ausrichtung.
`cleaning`	Das Druckwerk führt derzeit einen Reinigungsvorgang durch.
`disconnected`	Das Druckwerk hat die Verbindung zu RICOH Predictive Insight verloren.
`error`	Das Druckwerk hat eine Bedingung gemeldet, die den Druckvorgang verhindert.
`maintenance`	Das Druckwerk führt derzeit einen Wartungsvorgang durch.
`not available`	Das Druckwerk ist zwar zugänglich, kann jedoch derzeit nicht bearbeitet werden.
`pre/post busy`	Ein am Drucker angeschlossener Vor- oder Nachbearbeitungsgerät ist beschäftigt und blockiert den Druckvorgang.
`pre/post eof`	Ein Vor- oder Nachbearbeitungsgerät hat die Bedingung „Formularende“ erreicht, wodurch der Druckvorgang blockiert wird.
`pre/post paused`	Ein Vor- oder Nachbearbeitungsgerät wurde angehalten und blockiert den Druckvorgang.
`pre/post threading`	Ein Vor- oder Nachbearbeitungsgerät führt Druckmaterial ein und verhindert den Druckvorgang.
`rebooting`	Das Druckwerk wird neu gestartet.
`recirculation`	Das Druckwerk sorgt für die Rückführung der Tinte.
`restart`	Das Druckwerk befindet sich in einer betriebsbereiten Bedingung.
`restarting`	Das Druckwerk läuft wieder an.

Ruhezustände

Ein Druckwerk wird als idle gemeldet, wenn er betriebsbereit und druckfähig ist, derzeit jedoch keine Ausgabe erzeugt. Verwenden Sie diese Kategorie, um die verfügbare Kapazität zu ermitteln.

Unbearbeiteter Druckerstatus	Beschreibung
`checking`	Das Druckwerk führt eine Routineprüfung durch, die den Arbeitsablauf nicht behindert.
`idle`	Das Druckwerk ist betriebsbereit und steht für den Einsatz bereit.
`not ready`	Das Druckwerk ist betriebsbereit, befindet sich jedoch derzeit nicht in einem druckbereiten Zustand.
`pre/post not ready`	Eine Vor- oder Nachbehandlungsvorrichtung ist noch nicht betriebsbereit, doch der Motor selbst ist betriebsbereit.
`ready`	Das Druckwerk ist bereit, einen Job entgegenzunehmen und auszudrucken.
`shutdown`	Das Druckwerk wurde abgeschaltet.
`shutting down`	Das Druckwerk wird gerade abgeschaltet.
`sleeping`	Das Druckwerk befindet sich in einem energiesparenden Ruhezustand.
`start-up`	Das Druckwerk befindet sich in der Anlaufphase.
`started`	Das Druckwerk hat seinen Startvorgang abgeschlossen.
`starting`	Das Druckwerk springt an.
`stopping`	Das Druckwerk läuft langsam aus, ist jedoch noch nicht vollständig abgeschaltet.
`warming`	Das Druckwerk läuft warm.

Unbekannt

Die Kategorie unknown wird gemeldet, wenn RICOH Predictive Insight keine Kategorie für den Rohzustand ermitteln kann, beispielsweise weil der Wert des Rohzustands nicht erkannt wird. Sollte Ihre Anwendung regelmäßig auf unknown Kategorien stoßen, wenden Sie sich bitte an Ihren Ansprechpartner bei , um zu überprüfen, ob Ihr Drucker die erwarteten Statuswerte übermittelt.

1.5.5.2 Umgang mit den Antwortbeschränkungen der Datenexport-API

Die Datenexport-API führt keine Paginierung der Antworten durch. Sollte eine Anfrage mehr Daten zurückgeben, als die API in einer einzelnen Antwort zulässt, schlägt die Anfrage mit einer Fehlermeldung fehl, anstatt ein Teilergebnis zurückzugeben. Planen Sie Ihre Integrationen so, dass Sie die Grenzwerte einhalten, indem Sie den Datumsbereich eingrenzen, die Anzahl der Drucker pro Anfrage reduzieren oder beides tun.

Wo die Grenzen liegen

Für Abfragen, die einen Datumsbereich enthalten, gelten zwei Arten von Einschränkungen:

Maximaler Datumsbereich: Wenn der Zeitraum zwischen startDateTime und endDateTime sieben Tage überschreitet, gibt die API eine 400-Antwort mit dem Fehlercode ERR_DATE_RANGE_EXCEEDED zurück. Verringern Sie die Größe des angeforderten Zeitfensters und senden Sie die Anfrage erneut ab.
Maximale Antwortgröße: Die maximal unterstützte Größe einer Antwortdatei beträgt 6 MB, was ausreichen sollte, um die Daten von fast 10.000 Jobs zu speichern. Sollten die Daten, die einer Anfrage entsprechen, die maximale Antwortgröße überschreiten, gibt die API eine 413-Antwort mit dem Fehlercode ERR_RESPONSE_LIMIT_EXCEEDED zurück. Der Antworttext enthält einen maxJobs-Wert, der die geltende Obergrenze angibt. Um das Problem zu beheben, grenzen Sie den Datumsbereich ein, fordern Sie weniger Drucker an oder tun Sie beides, und senden Sie die Anfrage erneut ab.

Planungsanträge, die innerhalb der Grenzen bleiben sollen

Um eine Integration zu entwickeln, die zuverlässig innerhalb der Antwortgrenzen bleibt, sollten Sie folgende Faktoren berücksichtigen:

Auftragsvolumen pro Drucker. Ein Durchlaufdrucker mit hohem Durchsatz kann pro Stunde weitaus mehr Jobs verarbeiten als ein Einzelblattdrucker mit geringem Durchsatz. Wenn Sie beide in Ihrem Gerätepark kombinieren, bestimmen die Drucker mit hohem Druckvolumen, wie kurz Ihre Zeitfenster sein müssen.
Anzahl der Drucker pro Anfrage. Jede Anfrage kann mehrere printerId-Werte enthalten. Es ist zwar praktisch, mehrere Drucker in einer einzigen Anfrage zusammenzufassen, doch jeder zusätzliche Drucker erhöht die Antwortgröße und damit die Wahrscheinlichkeit, dass das Limit überschritten wird.
Tageszeit. Wenn Ihr Betrieb im Schichtbetrieb läuft, konzentrieren sich Jobs und Statusänderungen auf bestimmte Stunden. Ein 24-Stunden-Zeitraum kann sehr unterschiedliche Volumina ergeben, je nachdem, wann diese 24 Stunden beginnen und enden.
Toleranz für Wiederholungsversuche. Sollte eine Anfrage mit dem Fehler ERR_RESPONSE_LIMIT_EXCEEDED fehlschlagen, muss Ihre Integration die Anfrage aufteilen und einen erneuten Versuch unternehmen. Die Gestaltung für kleinere Fenster im Vordergrund ist in der Regel weniger komplex als die Umsetzung einer dynamischen Aufteilung.

Empfohlene Muster

Die folgenden Muster eignen sich gut für gängige Integrationsszenarien:

Nächtlicher Auszug für die Berichterstellung: Führen Sie einmal täglich einen geplanten Job aus, der die Daten der letzten 24 Stunden abruft, und zwar jeweils für einen Drucker nach dem anderen. Dieses Muster lässt sich einfach umsetzen, bei Fehlern leicht wiederholen und sorgt dafür, dass jede Antwort kurz bleibt. Führen Sie die Antworten für die einzelnen Drucker in Ihrem nachfolgenden Prozess zusammen.
Stündlicher Datenauszug für Kontrollanzeigen in nahezu Echtzeit: Führen Sie einmal pro Stunde einen geplanten Job aus, der in einem einzigen Aufruf die Daten der vergangenen Stunde für alle Drucker abruft. Durch stündliche Zeitfenster bleibt der Umfang der Antworten selbst bei Druckereien mit hohem Druckaufkommen gering. Sollten Sie über einen großen Fuhrpark verfügen, bestellen Sie die Drucker bitte in Gruppen und nicht alle auf einmal.
Nachträgliche Erfassung historischer Daten: Um ein Data Warehouse mit historischen Daten zu befüllen, durchlaufen Sie den Zeitbereich in Fenstern fester Größe (beispielsweise sechs Stunden pro Anfrage) und Ihre Drucker in kleinen Gruppen. Bearbeiten Sie jeweils ein Fenster nach dem anderen und speichern Sie die Ergebnisse, bevor Sie zum nächsten Fenster weitergehen. Sollte ein Fenster den Fehler ERR_RESPONSE_LIMIT_EXCEEDED auslösen, teilen Sie dieses Fenster in zwei Hälften und wiederholen Sie den Versuch mit den beiden Hälften.
Aktueller Druckerstatus zur Überwachung: Um den aktuellen Status jedes Druckers in Ihrem Bestand zu überwachen, ohne den Verlauf abzurufen, rufen Sie den Befehl /printer-states mit dem Parameter currentState=true auf. Die Antwort enthält eine Zeile pro Druckwerk und ist unabhängig vom Datumsbereich, sodass eine einzige Abfrage die gesamte Flotte abdecken kann.

Behandlung von Fehlern aufgrund von Antwortbeschränkungen in Ihrer Integration

Wenn Sie eine 413-Antwort mit dem Fehlercode ERR_RESPONSE_LIMIT_EXCEEDED erhalten, führen Sie eine oder mehrere der folgenden Maßnahmen durch, bevor Sie die Anfrage erneut versuchen:

Verkürzen Sie das Zeitfenster. Das Fenster in zwei Hälften zu teilen, ist eine bewährte Strategie; sollte die halbierte Anfrage weiterhin fehlschlagen, teilen Sie sie erneut.
Reduzieren Sie die Anzahl der printerId-Werte in der Anfrage. Falls ein Drucker den Großteil des Druckvolumens ausmacht, bestellen Sie diesen Drucker bitte separat.
Sollte die Anfrage einen aktuellen Snapshot und keine Historie betreffen, verwenden Sie bitte currentState=true bei /printer-states, um datumsbereichsabhängige Datenmengen vollständig zu vermeiden.

Versuchen Sie nicht, dieselbe Anfrage erneut auszuführen, ohne die Parameter zu ändern. Die API gibt keine Teilergebnisse zurück, sodass ein unveränderter erneuter Versuch erneut fehlschlagen wird.

1.5.6 Beispiele für Anfragen und Antworten der Datenexport-API

Nutzen Sie die Beispiele in diesem Abschnitt als Ausgangspunkt für Ihre eigene Integration. Jedes Beispiel zeigt eine repräsentative Anfrage-URL zusammen mit dem Antworttext, den die API zurückgibt.

Zu diesen Beispielen

In den Beispielen werden Platzhalter für API-Schlüssel und Drucker-IDs verwendet. Ersetzen Sie bei der Anpassung die Werte durch die für Ihre Umgebung geltenden.
In den Beispielen wird der Hostname für die USA und Japan verwendet. Falls Ihr Konto in Europa gehostet wird, verwenden Sie bitte stattdessen rpi-data-export.app-ricohsoftware.eu.
Datums- und Zeitangaben werden als Ortszeit in der mit der Anfrage angegebenen Zeitzone im Format JJJJ-MM-DDTHH:MM:SS.sss formatiert.
Alle Zeitangaben sind in Millisekunden angegeben. Alle Werte für die Tintenmenge und das Spülen sind in Kubikzentimetern (cc) angegeben.
Die Beispiele dienen der Veranschaulichung. Zahlenwerte wie Tintenverbrauch, Seitenzahlen und Laufzeiten stellen plausible Betriebsdaten dar, nicht jedoch Messwerte eines bestimmten Druckers.

GET /printers

Ruft die Drucker ab, die für den angegebenen API-Schlüssel verfügbar sind. Der Endpunkt nimmt keine Parameter entgegen.

Anforderung:

GET https://rpi-data-export.app-ricohsoftware.com/api/v1/printers
x-api-key: YOUR_API_KEY

Antwort (200 OK):

[
  {
    "printerName": "VC60000_Line1",
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "engines": 2,
    "manufacturer": "Ricoh",
    "model": "RICOH Pro VC60000",
    "printerMode": "duplex",
    "printerType": "continuous_feed",
    "serialNumber": "Printer 1: 10-11111 and Printer 2: 10-22222",
    "connectionStatus": "connected"
  },
  {
    "printerName": "VC80_2",
    "printerId": "0bc6b7b3-8df9-4293-cdd4-5ae3162c4d4c",
    "engines": 2,
    "manufacturer": "Ricoh",
    "model": "RICOH Pro VC80000",
    "printerMode": "duplex",
    "printerType": "continuous_feed",
    "serialNumber": "Printer 1: 10-33333 and Printer 2: 10-33334",
    "connectionStatus": "not_connected"
  },
  {
    "printerName": "IP 5000",
    "printerId": "0f8726da-8a37-4c3b-8710-065d7c265122",
    "engines": 1,
    "manufacturer": "InfoPrint",
    "model": "InfoPrint 5000 GP v3.17.129",
    "printerMode": "simplex",
    "printerType": "continuous_feed",
    "serialNumber": "10-1111111",
    "connectionStatus": "connected"
  }
]

GET /jobs

Ruft die Jobs ab, die von einem oder mehreren Druckern innerhalb eines bestimmten Zeitraums verarbeitet wurden. In diesem Beispiel wird ein einzelner Drucker für ein achtstündiges Zeitfenster in Ortszeit America/Denver abgefragt, wobei die Abfrage auf Jobs beschränkt ist, deren Druckvorgang erfolgreich abgeschlossen wurde.

Anforderung:

GET https://rpi-data-export.app-ricohsoftware.com/api/v1/jobs
    ?printerId=f7932e31-6545-4bff-8971-f84ef5f5b3dc
    &timezone=America/Denver
    &startDateTime=2026-03-15T08:00:00
    &endDateTime=2026-03-15T16:00:00
    &jobState=printed
x-api-key: YOUR_API_KEY

Antwort (200 OK):

[
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "jobId": "5ae3162c4d4c-1771233448485-Cust_MH_Arena.pdf-13925",
    "jobName": "Cust_MH_Arena.pdf",
    "jobPrintingSide": "duplex",
    "jobAction": "printed",
    "jobStartTime": "2026-03-15T08:14:22.000",
    "jobEndTime": "2026-03-15T08:47:51.000",
    "jobDuration": 2009000,
    "printedCopies": 1,
    "printedPages": 4800,
    "printedImpressions": 4800,
    "printedSheets": 2400,
    "printedRollFeet": 1640.5,
    "printedRollMeters": 500.02,
    "inkC": 184.6,
    "inkM": 172.3,
    "inkY": 198.1,
    "inkK": 245.7,
    "flushingC": 2.4,
    "flushingM": 2.4,
    "flushingY": 2.4,
    "flushingK": 2.4
  },
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "jobId": "5ae3162c4d4c-1771237012003-DM_Spring_Promo.pdf-13926",
    "jobName": "DM_Spring_Promo.pdf",
    "jobPrintingSide": "duplex",
    "jobAction": "printed",
    "jobStartTime": "2026-03-15T09:22:10.000",
    "jobEndTime": "2026-03-15T11:05:44.000",
    "jobDuration": 6214000,
    "printedCopies": 25000,
    "printedPages": 50000,
    "printedImpressions": 50000,
    "printedSheets": 25000,
    "printedRollFeet": 17082.0,
    "printedRollMeters": 5206.9,
    "inkC": 1923.4,
    "inkM": 1810.7,
    "inkY": 2055.2,
    "inkK": 2540.8,
    "flushingC": 12.6,
    "flushingM": 12.6,
    "flushingY": 12.6,
    "flushingK": 12.6
  }
]

Ein leeres Array ([]) ist eine gültige Antwort und bedeutet, dass keine Jobs mit der Anfrage übereinstimmten.

GET /printer-states (zusammengefasster Verlauf)

Im Standard-Antwortmodus wird pro Motor eine Zeile pro Zustandsintervall zurückgegeben, einschließlich der Felder für die Gesamtdauer und den Verlauf. In diesem Beispiel wird ein vierstündiges Zeitfenster für einen Drucker angefordert.

Anforderung:

GET https://rpi-data-export.app-ricohsoftware.com/api/v1/printer-states
    ?printerId=f7932e31-6545-4bff-8971-f84ef5f5b3dc
    &timezone=America/Denver
    &startDateTime=2026-03-15T08:00:00
    &endDateTime=2026-03-15T12:00:00
x-api-key: YOUR_API_KEY

Antwort (200 OK):

[
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "engine": "engine_1",
    "stateCategory": "idle",
    "printerState": "ready",
    "printerStateDuration": 854000,
    "historyStartTime": "2026-03-15T08:00:00.000",
    "historyEndTime": "2026-03-15T08:14:14.000"
  },
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "engine": "engine_1",
    "stateCategory": "up",
    "printerState": "printing",
    "printerStateDuration": 2017000,
    "historyStartTime": "2026-03-15T08:14:14.000",
    "historyEndTime": "2026-03-15T08:47:51.000"
  },
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "engine": "engine_1",
    "stateCategory": "down",
    "printerState": "maintenance",
    "printerStateDuration": 1980000,
    "historyStartTime": "2026-03-15T08:47:51.000",
    "historyEndTime": "2026-03-15T09:20:51.000"
  },
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "engine": "engine_2",
    "stateCategory": "idle",
    "printerState": "sleeping",
    "printerStateDuration": 14400000,
    "historyStartTime": "2026-03-15T08:00:00.000",
    "historyEndTime": "2026-03-15T12:00:00.000"
  }
]

GET /printer-states (nur aktueller Status)

Wenn Sie currentState=true festlegen, enthält die Antwort eine Zeile pro Motor mit dem aktuellen Status. Die Felder „Dauer“ und „Verlauf“ werden weggelassen.

Anforderung:

GET https://rpi-data-export.app-ricohsoftware.com/api/v1/printer-states
    ?printerId=f7932e31-6545-4bff-8971-f84ef5f5b3dc
    &timezone=America/Denver
    &currentState=true
x-api-key: YOUR_API_KEY

Antwort (200 OK):

[
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "engine": "engine_1",
    "stateCategory": "up",
    "printerState": "printing"
  },
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "engine": "engine_2",
    "stateCategory": "idle",
    "printerState": "ready"
  }
]

GET /printer-states (nur Zustandskategorie)

Wenn Sie stateCategoryOnly=true festlegen, wird in der Antwort das Feld printerState (Rohdaten) weggelassen und es wird lediglich die übergeordnete Kategorie angegeben. Die Felder „Dauer“ und „Verlauf“ bleiben erhalten.

Anforderung:

GET https://rpi-data-export.app-ricohsoftware.com/api/v1/printer-states
    ?printerId=f7932e31-6545-4bff-8971-f84ef5f5b3dc
    &timezone=America/Denver
    &startDateTime=2026-03-15T08:00:00
    &endDateTime=2026-03-15T12:00:00
    &stateCategoryOnly=true
x-api-key: YOUR_API_KEY

Antwort (200 OK):

[
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "engine": "engine_1",
    "stateCategory": "idle",
    "printerStateDuration": 854000,
    "historyStartTime": "2026-03-15T08:00:00.000",
    "historyEndTime": "2026-03-15T08:14:14.000"
  },
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "engine": "engine_1",
    "stateCategory": "up",
    "printerStateDuration": 2017000,
    "historyStartTime": "2026-03-15T08:14:14.000",
    "historyEndTime": "2026-03-15T08:47:51.000"
  }
]

GET /printer-interventions

Ruft die Interventionsereignisse ab, die innerhalb eines bestimmten Zeitraums auf einem oder mehreren Druckern aufgetreten sind. In diesem Beispiel wird ein vierstündiges Zeitfenster für einen Drucker angefordert und um Ereignisbeschreibungen in englischer Sprache gebeten. Da es sich bei dem Drucker in diesem Beispiel um ein Modell mit Endlosdruck handelt, entsprechen die Werte für interventionCode dem Endlosdruckformat.

Anforderung:

GET https://rpi-data-export.app-ricohsoftware.com/api/v1/printer-interventions
    ?printerId=f7932e31-6545-4bff-8971-f84ef5f5b3dc
    &timezone=America/Denver
    &startDateTime=2026-03-15T08:00:00
    &endDateTime=2026-03-15T12:00:00
    &language=en
x-api-key: YOUR_API_KEY

Antwort (200 OK):

[
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "interventionStartDate": "2026-03-15T08:47:51.000",
    "interventionEndDate": "2026-03-15T09:20:51.000",
    "duration": 1980000,
    "description": "Media empty",
    "engine": "engine_1",
    "jobName": "",
    "interventionCode": "CA00"
  },
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "interventionStartDate": "2026-03-15T09:05:33.000",
    "interventionEndDate": "2026-03-15T09:41:12.000",
    "duration": 2139000,
    "description": "Media empty",
    "engine": "engine_2",
    "jobName": "",
    "interventionCode": "CA00"
  },
  {
    "printerId": "f7932e31-6545-4bff-8971-f84ef5f5b3dc",
    "interventionStartDate": "2026-03-15T10:12:04.000",
    "interventionEndDate": "2026-03-15T10:19:47.000",
    "duration": 463000,
    "description": "Paper jam",
    "engine": "engine_1",
    "jobName": "DM_Spring_Promo.pdf",
    "interventionCode": "40000006"
  }
]

Die ersten beiden Einträge weisen ein leeres jobName-Feld auf, was bedeutet, dass an dem Ereignis kein Job beteiligt war. Der dritte Eintrag erfolgte während des Druckvorgangs eines Jobs, daher wird der Name des Jobs angegeben.

Beispiele für Fehlermeldungen

Jede Fehlermeldung weist dieselbe Struktur auf: ein JSON-Objekt mit einem code, einer message und einem numerischen statusCode. Als Anmerkung: Einige Fehlercodes enthalten zusätzliche Felder.

400 Ungültige Anforderung – ungültige Zeitzone:

{
  "code": "ERR_INVALID_TIMEZONE",
  "message": "The supplied timezone is not a valid IANA timezone identifier.",
  "statusCode": 400
}

400 Ungültige Anforderung – erforderlicher Parameter fehlt:

{
  "code": "ERR_MISSING_PRINTER_ID",
  "message": "At least one printerId value is required.",
  "statusCode": 400
}

400 Ungültige Anforderung – Der Datumsbereich überschreitet den maximal zulässigen Bereich:

{
  "code": "ERR_DATE_RANGE_EXCEEDED",
  "message": "The requested date range exceeds the maximum allowed range.",
  "statusCode": 400
}

400 Ungültige Anforderung – ungültige Sprache:

{
  "code": "ERR_INVALID_LANGUAGE",
  "message": "The supplied language is not a supported language code.",
  "statusCode": 400
}

401 Nicht autorisiert – ungültiger API-Schlüssel:

{
  "code": "ERR_INVALID_APIKEY",
  "message": "Failed to validate API key.",
  "statusCode": 401
}

403 Zugriff verweigert – Die Anfrage umfasst einen Drucker, auf den der API-Schlüssel keinen Zugriff hat:

{
  "code": "ERR_UNAUTHORIZED_PRINTERS",
  "message": "Unauthorized printers.",
  "statusCode": 403
}

413 Nutzlast zu groß – die Antwort würde die Größenbeschränkung überschreiten:

{
  "code": "ERR_RESPONSE_LIMIT_EXCEEDED",
  "message": "The response would exceed the maximum allowed size. Narrow the date range or request fewer printers.",
  "statusCode": 413,
  "maxJobs": 8000
}

500 Interner Serverfehler:

{
  "code": "ERR_INTERNAL_SERVER_ERROR",
  "message": "An internal server error occurred.",
  "statusCode": 500
}

1.5.7 Fehlerbehebung bei der Datenexport-API

Nutzen Sie diesen Abschnitt, um häufige Fehlermeldungen der Datenexport-API zu interpretieren und für jede einzelne die wahrscheinlichste Ursache sowie die entsprechende Abhilfe zu ermitteln. Jede Fehlermeldung enthält einen code, eine message und einen numerischen statusCode; der code-Wert gibt die jeweilige Bedingung an.

Fehler bei der Authentifizierung und Autorisierung

Fehlercode	Mögliche Ursache	Was Sie ausprobieren sollten
`ERR_INVALID_APIKEY` (401)	Die Kopfzeile `x-api-key` fehlt, ist fehlerhaft, abgelaufen oder wurde gelöscht. Tritt zudem kurzzeitig (in der Regel weniger als eine Minute) unmittelbar nach der Erstellung oder Rotation eines Schlüssels auf, bevor der neue Schlüssel registriert wird.	Bitte stellen Sie sicher, dass die Anfrage die Kopfzeile `x-api-key` mit dem vollständigen Schlüsselwert enthält. Überprüfen Sie unter Account Administration, ob der Schlüssel noch vorhanden ist und nicht abgelaufen ist. Falls der Schlüssel gerade erst erstellt oder rotiert wurde, warten Sie bitte eine Minute und versuchen Sie es dann erneut.
`ERR_UNAUTHORIZED_PRINTERS` (403)	Die Anfrage enthält einen oder mehrere `printerId`-Werte, auf die der API-Schlüssel keinen Zugriff hat.	Rufen Sie den Befehl `/printers` mit demselben API-Schlüssel auf, um genau zu sehen, welche Drucker verfügbar sind, und senden Sie die Anfrage anschließend erneut, wobei Sie nur diese Drucker-IDs angeben.
`ERR_TENANT_NOT_FOUND` (404)	Der API-Schlüssel wird erkannt, ist jedoch keinem aktiven Konto zugeordnet. Dies kann passieren, wenn ein Konto entfernt wurde oder falsch konfiguriert ist.	Wenden Sie sich bitte an Ihren Ricoh-Kundenbetreuer, um zu überprüfen, ob Ihr Mandant aktiv ist und ob der API-Schlüssel diesem zugeordnet ist.

Fehler bei der Parameterüberprüfung (400 Bad Request)

Jeder Fehler bei der Parameterüberprüfung führt zur Rückgabe des Statuscodes 400. Der code-Wert gibt das konkrete Problem an.

Fehlercode	Mögliche Ursache	Was Sie ausprobieren sollten
`ERR_MISSING_PRINTER_ID`	Die Anfrage enthielt keine `printerId`-Werte. Für `/Jobs`, `/printer-states` und `/printer-interventions` ist mindestens einer erforderlich.	Fügen Sie mindestens einen Abfrageparameter `printerId` hinzu. Wiederholen Sie die Angabe des Parameters, um mehrere Drucker einzubeziehen.
`ERR_INVALID_PRINTER_ID_FORMAT`	Der Wert `printerId` ist keine gültige UUID.	Vergleichen Sie den Wert mit der Antwort von `/printers`. Zu den häufigsten Fehlern zählen überflüssige Leerzeichen, fehlende Zeichen oder das Einfügen des Druckernamens anstelle der Drucker-ID.
`ERR_INVALID_TIMEZONE`	Der Wert für die `timezone` fehlt oder ist keine gültige IANA-Zeitzonenkennung.	Verwenden Sie eine Bereichs-Kennung wie `America/Denver` oder `Europe/Bucharest`. Dreistellige Abkürzungen wie `MST` oder `EST` werden nicht akzeptiert. Auf der interaktiven Dokumentationsseite gibt es eine Liste aller zulässigen Werte.
`ERR_INVALID_DATE_FORMAT`	Ein Wert für `startDateTime` oder `endDateTime` ist nicht übereinstimmend mit dem erwarteten Format.	Verwenden Sie das Format `JJJJ-MM-TTTHH:MM:SS`, optional mit dem Suffix `.sss` für Millisekunden. Geben Sie keinen UTC-Versatz und kein `Z`-Suffix an; die Zeitzone wird separat im Parameter `timezone` angegeben.
`ERR_INVALID_DATE_RANGE`	`startDateTime` ist gleich oder später als `endDateTime`.	Bitte überprüfen Sie, ob `startDateTime` in der angegebenen Zeitzone vor `endDateTime` liegt.
`ERR_DATE_RANGE_EXCEEDED`	Der Zeitraum zwischen `startDateTime` und `endDateTime` überschreitet den maximal zulässigen Bereich.	Verringern Sie die Dauer des angeforderten Zeitfensters. Anleitungen zur Chunking-Methode finden Sie unter Umgang mit den Antwortbeschränkungen der Datenexport-API.
`ERR_INVALID_JOB_STATE`	Der Wert `jobState` gehört nicht zu den zulässigen Werten.	Verwenden Sie eine der folgenden Optionen: `printing`, `printed`, `aborted` oder `completed`. Anmerkung: Der Begriff `completed` umfasst sowohl `printed` als auch `aborted` Jobs.
`ERR_INVALID_STATE_CATEGORY`	Der Wert `stateCategory` gehört nicht zu den zulässigen Werten.	Verwenden Sie eine der folgenden Optionen: `up`, `down` oder `idle`.
`ERR_INVALID_LANGUAGE`	Der an `/printer-interventions` übergebene `language` gehört nicht zu den zulässigen Werten.	Bitte wählen Sie eine der folgenden Sprachen aus: `en`, `de`, `ja`, `it`, `fr` oder `es`. Dieser Fehler bedeutet, dass der Code selbst abgelehnt wurde; ein Code, der zwar akzeptiert wird, für den jedoch keine Übersetzung für eine bestimmte Beschreibung vorliegt, führt nicht zu einem Fehler, da die API diese Beschreibung stattdessen auf Englisch zurückgibt.
`ERR_INVALID_BOOLEAN_PARAM`	Der Parameter `currentState` oder `stateCategoryOnly` hat einen anderen Wert als `true` oder `false`.	Verwenden Sie die wörtlichen Zeichenfolgen `true` oder `false` in Kleinbuchstaben.
`ERR_UNKNOWN_PARAMETERS`	Die Anfrage enthält einen oder mehrere Parameter, die der Endpunkt nicht akzeptiert.	Vergleichen Sie die Anfrage mit den Parametern, die in der interaktiven Dokumentation für den Endpunkt auf einer Liste aufgeführt sind. Häufige Ursachen sind Tippfehler, Parameter, die für einen anderen Endpunkt bestimmt sind, oder zusätzliche Tracking-Parameter, die von einem HTTP-Client hinzugefügt wurden.
`ERR_DUPLICATE_PARAMETERS`	Derselbe Parameter wird mehrmals übergeben, und der Endpunkt akzeptiert keine Duplikate für diesen Parameter.	Bitte überprüfen Sie die Liste der Parameter. Der Parameter `printerId` darf wiederholt werden (einmal pro Drucker); andere Parameter dürfen höchstens einmal vorkommen.
`ERR_EMPTY_PARAMETERS`	Ein obligatorischer Parameter ist vorhanden, weist jedoch keinen Wert auf.	Stellen Sie sicher, dass jeder erforderliche Parameter einen Wert enthält.
`ERR_INVALID_TENANT_ID`	Die dem API-Schlüssel zugeordnete Mandanten-ID ist ungültig.	Wenden Sie sich bitte an Ihren Ricoh-Kundenbetreuer.

Fehler bei der Antwortlänge und bei der Methode

Fehlercode	Mögliche Ursache	Was Sie ausprobieren sollten
`ERR_RESPONSE_LIMIT_EXCEEDED` (413)	Die Daten, die mit der Anfrage übereinstimmen, würden die maximale Antwortgröße überschreiten. Der Antworttext enthält ein Feld `maxJobs`, das die aktuell geltende Obergrenze angibt.	Grenzen Sie den Datumsbereich ein, geben Sie eine geringere Anzahl an Druckern an oder beides, und reichen Sie die Anfrage erneut ein. Empfohlene Chunking-Muster finden Sie unter Umgang mit den Antwortbeschränkungen der Datenexport-API.
`ERR_UNSUPPORTED_METHOD` (405)	Bei der Anfrage wurde eine andere HTTP-Methode als `GET` verwendet.	Die Datenexport-API unterstützt ausschließlich die `GET`-Methode. Aktualisieren Sie Ihren Client, damit er `GET` verwendet.

Serverfehler (500 Interner Serverfehler)

500 Antworten deuten auf eine unerwartete Bedingung auf dem Server hin. Wiederholungsversuche sind sicher, da jeder Endpunkt der Datenexport-API ein GET-Aufruf ist und keine Nebenwirkungen verursacht. Warten Sie einige Sekunden, bevor Sie es erneut versuchen, und wenden Sie ein exponentielles Backoff an, falls der Fehler weiterhin auftritt.

Fehlercode	Mögliche Ursache	Was Sie ausprobieren sollten
`ERR_INTERNAL_SERVER_ERROR`	Auf dem Server ist eine unerwartete Bedingung aufgetreten.	Bitte warten Sie einige Sekunden und versuchen Sie es erneut. Sollte der Fehler länger als einige Minuten bestehen bleiben, wenden Sie sich bitte an Ihren RICOH-Kundenbetreuer.
`ERR_TENANT_CHECK_FAILED`	Der Server konnte den mit dem API-Schlüssel verknüpften Mandanten nicht überprüfen.	Bitte warten Sie einige Sekunden und versuchen Sie es erneut. Sollte der Fehler weiterhin bestehen, wenden Sie sich bitte an Ihren Ricoh-Kundenbetreuer.
`ERR_PRINTERS_FETCH_FAILED`	Der Server konnte die Liste der Drucker für den Mandanten nicht abrufen.	Bitte warten Sie einige Sekunden und versuchen Sie es erneut. Sollte der Fehler weiterhin bestehen, wenden Sie sich bitte an Ihren Ricoh-Kundenbetreuer.
`ERR_PRINTER_STATES_FETCH_FAILED`	Der Server konnte die Druckerstatusdaten für die Anfrage nicht abrufen.	Bitte warten Sie einige Sekunden und versuchen Sie es erneut. Sollte der Fehler weiterhin bestehen, wenden Sie sich bitte an Ihren Ricoh-Kundenbetreuer.

Weitere Symptome

Die Antwort ist leer ([]), doch Sie erwarten Daten: Ein leeres Array bedeutet, dass keine Datensätze mit der Anfrage übereinstimmten. Überprüfen Sie das Zeitfenster (die API liefert nur Daten der letzten sieben Tage), die Zeitzone, die printerId-Werte sowie etwaige Filter wie jobState oder stateCategory.
Die Datums- und Zeitangaben in der Antwort sind nicht übereinstimmend mit Ihren Erwartungen: Die Zeitstempel der Antworten entsprechen der Ortszeit in der mit der Anfrage angegebenen Zeitzone. Wird dieselbe Anfrage mit einem anderen timezone gesendet, werden unterschiedliche Zeitstempel-Zeichenfolgen erzeugt, obwohl sie dieselben Ereignisse beschreiben. Siehe Umgang mit Datum und Uhrzeit in der Datenexport-API.
In der Antwort unter /printers fehlt ein Drucker: Die API gibt ausschließlich Drucker zurück, die von einem Data Collector überwacht werden. Sollte ein Drucker fehlen, überprüfen Sie bitte, ob dieser bei einem Data Collector registriert wurde und derzeit eine Verbindung hat.
Eine Antwort zu den Druckerstatus enthält unbekannte Kategorien: Eine unknown Kategorie bedeutet, dass der Rohzustand des Druckers nicht klassifiziert werden konnte. Die vollständige Zuordnung von Zuständen zu Kategorien finden Sie unter Druckerzustände und Zustandskategorien.

1.6 RICOH Cloud Connector

RICOH Cloud Connector ist eine lokale Systemanwendung, die eine sichere Verbindung mit RICOH TotalFlow Cloud herstellt. Es unterstützt Sie bei der Produktregistrierung und verwaltet bei Bedarf die Kommunikation mit RICOH TotalFlow Cloud-Anwendungen.

Hinweis:

Wenn Sie die RICOH InfoPrint Manager-Lizenz verwenden, wird RICOH Cloud Connector automatisch mit dem Produkt installiert. Wenn Sie RICOH InfoPrint Manager deinstallieren, wird RICOH Cloud Connector automatisch deinstalliert.
Sie brauchen RICOH Cloud Connector nicht zu installieren, um RICOH Predictive Insight zu verwenden.

Sie können RICOH Cloud Connector unter den folgenden Betriebssystemen installieren:

Unter Windows:
- Microsoft Windows 10 Pro/Enterprise
- Microsoft Windows 11 Pro
- Microsoft Windows Server 2019 Standard
- Microsoft Windows Server 2022 Standard
Unter Linux:
- Red Hat Enterprise Linux 8
- Red Hat Enterprise Linux 9
- Fedora Linux 38
- CentOS Stream 8
- Ubuntu 22.04 LTS
- openSUSE Leap 15.4

Hinweis:

Dies sind die neuesten Versionen, die mit RICOH Cloud Connector getestet wurden, aber Sie können auch spätere Versionen dieser Betriebssysteme verwenden.
Diese Betriebssysteme und ihre Aktualisierungen werden so lange unterstützt, wie der Hersteller seinen Kunden im Rahmen von Standardverträgen (ohne erweiterten Support) Support bietet.

Die Installation von RICOH Cloud Connector erfordert mindestens 1,1 GB freien Speicherplatz.

1.6.1 RICOH Cloud Connector herunterladen

Sie können die aktuelle Version von RICOH Cloud Connector über Lizenzen oder über den Reiter Konnektoren in RICOH Account Administration herunterladen. Laden Sie das Paket auf den Server herunter, auf dem Sie die Anwendung installieren möchten.

Stellen Sie vor dem Herunterladen von Cloud Connector sicher, dass diese Bedingungen erfüllt sind:

Die Einrichtungsseite Cloud Connector wird in einem Webbrowser geöffnet. Vergewissern Sie sich, dass auf dem System die neueste Version eines dieser Browser installiert ist:
- Mozilla Firefox
- Google Chrome
- Microsoft Edge
Sie haben Schreibrechte für den Standardinstallationsort:
- %ProgramData%\RICOH\Cloud Connector\ für Windows oder
- /opt/RICOH/RCC/ für Linux.
Wenn Sie einen anderen Installationspfad wählen, vergewissern Sie sich, dass dieser existiert und Sie Schreibrechte dafür haben. Wenn das Verzeichnis existiert, muss es leer sein.

So laden Sie RICOH Cloud Connector herunter:

Melden Sie sich bei dem Server, auf dem Sie Cloud Connector installieren möchten, als Administrator an.
Melden Sie sich bei RICOH TotalFlow Cloud als Benutzer mit Zugriff auf RICOH Account Administration an.
Klicken Sie in RICOH Account Administration im linken Bereich auf Lizenzen.
Sie sehen den Reiter Lizenzen und die Links zum Herunterladen des RICOH Cloud Connector-Pakets.
Klicken Sie abhängig von Ihrem Betriebssystem auf Download für Windows oder Download für Linux.
Speichern Sie das Installationspaket in einem Ordner, für den Sie Lese- und Ausführungsberechtigungen haben. Unter Linux laden Sie ein Archiv namens ricoh-cloud-connector-linux.gz herunter, das die ausführbare Datei enthält.
Der Name der heruntergeladenen Datei lautet:
- Unter Windows: ricoh-cloud-connector-win.exe
- Unter Linux: ricoh-cloud-connector-linux.gz

1.6.2 Installieren oder aktualisieren

Nachdem Sie die aktuelle Version von RICOH Cloud Connector heruntergeladen haben, installieren Sie sie auf dem von Ihnen festgelegten Server.

Hinweis:

Wenn Sie die Installationsdateien auf einen anderen Rechner heruntergeladen haben, kopieren Sie die Dateien auf das System, auf dem Sie das Programm installieren möchten.
Vergewissern Sie sich, dass Sie genügend Speicherplatz auf der Festplatte haben. Die Installation von RICOH Cloud Connector erfordert mindestens 1,1 GB freien Speicherplatz.

So installieren oder aktualisieren Sie RICOH Cloud Connector:

Melden Sie sich an dem Computer, auf den Sie die RICOH Cloud Connector-Installationsdateien heruntergeladen haben, als Administrator an.
In einem Linux-System müssen Sie sich mit einem Benutzerkonto anmelden, das Lese- und Schreibrechte für die folgenden Verzeichnisse hat:
- /var
- /etc
- /usr
- /opt
Außerdem benötigen Sie Ausführungsrechte für die heruntergeladene ausführbare RICOH Cloud Connector-Datei.
Wenn Sie die Installation unter Linux durchführen, suchen Sie nach ricoh-cloud-connector-linux.gz und doppelklicken Sie darauf, um die Installationsdateien zu entpacken.

Wichtig: Unter den entpackten Dateien sollten Sie die ausführbare Datei des Installationsprogramms mit dem Namen ricoh-cloud-connector-linux finden. Stellen Sie sicher, dass die Datei als ausführbare Datei ausgeführt werden kann. Befolgen Sie die Anweisungen für Ihre Linux-Version, um die Datei ausführbar zu machen.
Suchen Sie das ausführbare Installationsprogramm RICOH Cloud Connector und doppelklicken Sie darauf.
Der Name der ausführbaren Datei lautet:
- Unter Windows: ricoh-cloud-connector-win.exe
- Unter Linux: ricoh-cloud-connector-linux
Wenn Sie RICOH Cloud Connector zum ersten Mal installieren, wird die Seite Installation von RICOH Cloud Connector im Standardbrowser geöffnet.

Wenn Sie RICOH Cloud Connector aktualisieren, wird die Seite Aktualisierung von RICOH Cloud Connector im Standardbrowser geöffnet.

Hinweis: Wenn die Seite Installation von RICOH Cloud Connector nicht geöffnet wird, blockiert Ihr Antivirusprogramm oder Ihr Browser möglicherweise das Installationsprogramm.
Überprüfen Sie die Adressleiste Ihres Browsers, um festzustellen, ob er das Öffnen einer Seite blockiert hat. Wenn die Seite blockiert wurde, erteilen Sie die Erlaubnis, die Seite anzuzeigen. Wenn die Seite immer noch nicht angezeigt wird, lesen Sie den Abschnitt Fehlerbehebung weiter unten.
Wenn Sie die Installation zum ersten Mal vornehmen:
1. Überprüfen Sie die rechtlichen Bedingungen und wählen Sie Ich stimme den Bedingungen des Lizenzvertrags zu..
2. Vergewissern Sie sich, dass der Installationsort korrekt ist und Sie über Schreib- und Ausführungsberechtigungen dafür verfügen, und klicken Sie dann auf INSTALLIEREN.
Wenn Sie RICOH Cloud Connector aktualisieren:

Hinweis: Ihre bisherigen Einrichtungsdaten werden importiert, einschließlich der Annahme der Lizenz.
1. Überprüfen Sie die Informationen über Ihre aktuelle Version von RICOH Cloud Connector und die Update-Version.
2. Klicken Sie auf AKTUALISIEREN.

Die Installation beginnt und Sie können den Fortschritt verfolgen.

Sobald die Installation abgeschlossen ist, öffnet sich die Seite Konfiguration RICOH Cloud Connector automatisch.

Der Dienst RICOH Cloud Connector startet nach jeder erfolgreichen Installation, Aktualisierung bzw. nach jedem Neustart des Systems automatisch.

1.6.3 Einrichten

Nachdem Sie RICOH Cloud Connector installiert haben, müssen Sie es für die Kommunikation mit RICOH TotalFlow Cloud konfigurieren.

Wenn die Installation von RICOH Cloud Connector abgeschlossen ist, wird die Seite Konfiguration RICOH Cloud Connector im Standardbrowser geöffnet.

So richten Sie RICOH Cloud Connector ein:

Die Eigenschaft Systemname wird automatisch mit dem Namen des Systems ausgefüllt, wie er im Betriebssystem festgelegt ist. Sie können den Namen so ändern, dass er besser erkennbar oder leichter zu merken ist.
Wenn Ihr Unternehmen Proxyserver verwendet, fragen Sie Ihre IT-Abteilung nach der richtigen IP-Adresse oder dem richtigen Hostnamen und der richtigen Portnummer. Wählen Sie die Option Ich werden einen Proxyserver verwenden. und geben Sie die richtigen Werte in die Felder Proxyeinstellungen ein.
Klicken Sie auf Proxy testen. Wenn die Proxy-Einstellungen nicht validiert werden, wenden Sie sich an die IT-Abteilung, geben Sie die richtigen Werte ein und versuchen Sie es erneut.
Klicken Sie auf Code generieren.

Wenn Sie nicht bei Account Administration angemeldet sind, öffnet sich der Anmeldedialog. Melden Sie sich bei Account Administration an.

Wenn Sie angemeldet sind, sehen Sie das Einmaligen Code generieren-Fenster und einen eindeutigen Einmalcode, der 20 Minuten lang gültig ist.
Kopieren Sie den Code, kehren Sie zu RICOH Cloud Connector zurück und fügen Sie den Code in das Einmaliger Code-Feld ein.
Klicken Sie auf Übermitteln.
Wenn Ihre Autorisierung gültig ist, erhalten Sie eine Bestätigungsmeldung. Klicken Sie auf Schließen.
Sie sehen das Dialogfeld Lizenzeinstellungen.
Es enthält alle Details, die Sie während der Konfiguration eingegeben haben. Sie können Systemname und Proxyeinstellungen bei Bedarf bearbeiten.
Schließen Sie den Reiter oder das Fenster des Browsers, um die Einrichtung von RICOH Cloud Connector zu beenden.

1.6.3.1 Systemname

Zeigt den Namen des Geräts, auf dem Sie RICOH Cloud Connector einrichten.

Standardmäßig ist dieser Wert der im Betriebssystem zugewiesene Name dieses Systems. Sie können ihn in einen besser erkennbaren Namen ändern. RICOH Account Administration zeigt diesen Namen auf dem Reiter Konnektoren in der Tabelle der registrierten Konnektoren an.

1.6.3.2 Proxy-Einstellungen

Einige Unternehmen verwenden Proxyserver, um eine zusätzliche Ebene des Netzwerkschutzes bereitzustellen.

Wenn Ihr Unternehmen Proxyserver verwendet, fragen Sie Ihre IT-Abteilung nach der richtigen IP-Adresse oder dem richtigen Hostnamen und der richtigen Portnummer.

1.6.3.3 Einmalcode

Mit dem von RICOH Account Administration generierten Einmalcode müssen Sie RICOH Cloud Connector registrieren, damit Informationen von Ihrem Netzwerk an die RICOH TotalFlow Cloud-Anwendungen übertragen werden können.

Um sich bei RICOH Account Administration anzumelden, benötigen Sie eine RICOH TotalFlow Cloud-Benutzer-ID.

1.6.4 Deinstallieren von RICOH Cloud Connector

In diesem Abschnitt wird beschrieben, wie Sie RICOH Cloud Connector mit den Windows-Systemtools deinstallieren können.

Hinweis:

Um RICOH Cloud Connector unter Linux zu deinstallieren, folgen Sie den Anweisungen, die Ihre Linux-Distribution bereitstellt.

So deinstallieren Sie RICOH Cloud Connector unter Windows:

Melden Sie sich auf dem Computer, auf dem RICOH Cloud Connector installiert ist, als Administrator an.
Klicken Sie auf die Windows-Suchschaltfläche und suchen Sie nach der Seite Apps und Features.
Suchen Sie den Namen der Anwendung RICOH Cloud Connector und klicken Sie darauf.
Klicken Sie auf Deinstallieren.
Klicken Sie erneut auf Deinstallieren, um zu bestätigen, dass Sie verstehen, dass die Anwendung und die zugehörigen Informationen deinstalliert werden.
Sie sehen die Seite Deinstallation von RICOH Cloud Connector:
Überprüfen Sie die Informationen und wählen Sie Ich habe verstanden und möchte RICOH Cloud Connector deinstallieren. Abhängig von der Konfiguration wird das Gerät nach dem Deinstallationsvorgang möglicherweise neu gestartet..
- Wenn Sie RICOH Cloud Connector deinstallieren, funktionieren alle Programme, die die deinstallierte Cloud Connector-Version für ihre Lizenzen verwendet haben, nicht mehr.
Klicken Sie auf DEINSTALLIEREN.
Melden Sie sich bei RICOH Account Administration an und stellen Sie sicher, dass die deinstallierte Cloud Connector-Version nicht mehr in der Tabelle Konnektoren angezeigt wird.
Sie können sie manuell löschen, wenn sie nicht automatisch entfernt wurde.

1.6.5 Fehlerbehebung

1.6.5.1 Häufige Probleme

1.6.5.1.1 RICOH Cloud Connector konnte nicht installiert werden

Wenn Sie RICOH Cloud Connector installieren und die Installationsseite nicht angezeigt wird, versuchen Sie folgende Aktionen.

Mögliche Gründe, warum sich die Installationsseite nicht öffnet:

Sie sind nicht als Administrator angemeldet.
Melden Sie sich als Benutzer mit Administratorrechten an und versuchen Sie es erneut.
Unter Linux ist die Installationsdatei nicht als ausführbare Datei definiert.
Folgen Sie den Anweisungen für Ihre Linux-Version, um die Datei ausführbar zu machen.
Ein Werbeblocker verhindert, dass die Website Installation von RICOH Cloud Connector in einem neuen Browserfenster geöffnet wird.
Suchen Sie die Popup-Blocker-Einstellungen in Ihrem Browser und lassen Sie das Öffnen der Seite zu.
Ihre Antiviren-Software blockiert die Ausführung des Installationsprogramms.
Erlauben Sie in Ihrem Antivirenprogramm die Ausführung des Programms.
Sie haben die maximale Anzahl Cloud-Konnektoren erreicht, die Ihr Abonnement unterstützt.
Melden Sie sich bei RICOH Account Administration an und entfernen Sie die getrennten Cloud-Konnektoren aus der Tabelle Konnektoren. Oder wenden Sie sich an Ihren Ricoh-Vertriebsmitarbeiter, um Ihr Abonnement zu aktualisieren.

Wenn keiner der oben genannten Punkte zutrifft, verwenden Sie die Befehlszeilenprozedur, um RICOH Cloud Connector zu installieren:

Melden Sie sich an dem Computer, auf den Sie die Installationsdateien heruntergeladen haben, als Benutzer mit Administratorrechten an.
Öffnen Sie eine Eingabeaufforderung mit der Option Als Administrator ausführen und suchen Sie die ausführbare Datei RICOH Cloud Connector.
Wichtig: Stellen Sie sicher, dass Sie die Berechtigung haben, die Datei auszuführen. Stellen Sie sicher, dass die Datei ausführbar ist, wenn Sie mit Linux arbeiten. Wenn dies nicht der Fall ist, befolgen Sie die Anweisungen für Ihre Linux-Version, um die Datei ausführbar zu machen.
Geben Sie den folgenden Installationsbefehl ein:
rccInstallationsprogrammDateiname --install
Drücken Sie die Eingabetaste.

1.6.5.1.2 Edge wird bei der Installation von RICOH Cloud Connector nicht gestartet

Wenn Microsoft Edge Ihr Standardbrowser ist und Sie das integrierte Administratorkonto verwenden, wird der Browser nicht automatisch geöffnet, wenn Sie RICOH Cloud Connector installieren.

Sie können sich in diesem Fall entweder mit anderen Benutzerkonto-Anmeldedaten anmelden oder Ihren Standardbrowser zu einem anderen Browser (wie Chrome oder Firefox) umstellen. Starten Sie dann das RICOH Cloud Connector-Installationsprogramm erneut.

1.6.5.1.3 Cloud Connector-Fehler: Signatur noch nicht aktuell

Dieser Fehler kann auftreten, wenn die Serverzeit nicht mit Ihrer aktuellen Ortszeit synchronisiert ist.

Stellen Sie sicher, dass die Zeit Ihres Servers mit einer Genauigkeit von bis zu 5 Minuten mit der aktuellen Zeit synchronisiert ist.

Wenn Sie Windows verwenden, empfehlen wir Ihnen, die aktuelle Zeit automatisch einzustellen:

Melden Sie sich bei Windows als Administrator an.
Klicken Sie auf das Windows-Symbol in der Taskleiste.
Navigieren Sie zu Einstellungen ⇒ Zeit und Sprache ⇒ Datum und Uhrzeit.
Aktivieren Sie die Option Uhrzeit automatisch festlegen.
Blättern Sie nach unten zu Weitere Einstellungen und klicken Sie auf Jetzt synchronisieren.

1.6.5.2 Herunterladen von RICOH Cloud Connector-Protokollen

Wenn Sie bei der Verwendung von RICOH Cloud Connector auf Probleme stoßen, können Sie ganz einfach die Anwendungsprotokolle herunterladen, die bei der Problembehebung helfen können.

So laden Sie Protokolle herunter:

Öffnen Sie ein Webbrowser-Fenster.
Geben Sie die URL für die Konfiguration RICOH Cloud Connector-Seite in die Adressleiste ein:

http://server_address:port_number/license,

wobei server_address die IP-Adresse oder der Hostname des Computers ist, auf dem RICOH Cloud Connector installiert ist, und port_number der Anwendungsport.

Wenn Sie sich an dem Computer befinden, auf dem RICOH Cloud Connector installiert ist, und Sie den Standard-Port verwenden, können Sie http://localhost:15180/license aufrufen.
Klicken Sie auf , das Hilfe-Symbol, auf dem Banner und wählen Sie Protokolle herunterladen.
Speichern Sie das Protokollpaket auf Ihrem System.
Das Vorgehen beim Speichern der Datei hängt von den Webbrowser-Einstellungen ab.
Die Protokolle werden im ZIP-Format gespeichert und das resultierende Paket trägt den Namen RCC_logs_yyyy-mm-ddThh_mm_ss.zip, wobei yyyy-mm-dd und hh_mm_ss für das Datum und die Uhrzeit stehen, zu denen die Protokolle erfasst wurden.

1 RICOH Account Administration

1.1 Übersicht über RICOH Account Administration

1.1.1 Was gibt es Neues?

1.1.2 Systemobjekte

1.1.2.1 API-Schlüssel

Related information:

1.1.2.2 Konnektoren

Related information:

1.1.2.3 Benutzer

Related information:

1.1.3 Benutzeroberfläche

1.1.3.1 Banner

1.1.3.2 Hauptseite

1.1.3.2.1 API-Schlüssel-Reiter

Related information:

1.1.3.2.2 Konnektoren-Reiter

1.1.3.2.3 Details-Reiter

1.1.3.2.4 Lizenzen-Reiter

1.1.3.2.5 Benutzer-Reiter

1.1.4 RICOH Cloud Connector

Related information:

1.1.5 Barrierefreiheit

Barrierefreiheitfunktionen

Tastatur-Navigation

1.1.6 Marken

1.2 Erste Schritte mit RICOH TotalFlow™ Cloud

1.2.1 Erste Anmeldung bei RICOH TotalFlow Cloud

Related information:

1.2.2 Erste Schritte mit RICOH TotalFlow Cloud für Administratoren

Related information:

1.2.2.1 Lizenzen anzeigen

1.2.2.2 Benutzer hinzufügen

Related information:

1.2.3 Erste Schritte mit RICOH TotalFlow Cloud für Benutzer

Related information:

1.2.4 Cookie-Einstellungen verwalten

1.3 Konfiguration

1.3.1 Benutzer hinzufügen

Related information:

1.4 Verwalten von Objekten

1.4.1 Kontodetails verwalten

1.4.2 Benutzerinformationen ändern

1.4.3 Ihr Kennwort ändern

1.5 Arbeiten mit der Datenexport-API

Related information:

1.5.1 Datenexport-API

Authentifizierung

Verfügbare Endpunkte

Testen der API

1.5.2 Erstellen und Verwalten von API-Schlüsseln

Related information:

1.5.3 Die Datenexport-API ausprobieren

1.5.4 Umgang mit Datum und Uhrzeit in der Datenexport-API

Das Datum und Uhrzeitmodell

Datum und Uhrzeitformat

Standardzeitbereich

Aufbewahrungsfrist: die letzten sieben Tage

Regeln für den angeforderten Bereich

Angabe der Zeitzone

Bereitstellung der Sprache

Sommerzeit und mehrdeutige Zeitangaben

Empfehlungen zur Speicherung und zum Vergleich von Antwortzeitstempeln

Beispiele

Related information:

1.5.5 Feldnamen der Antwort der Datenexport-API

In dieser Referenz verwendete Konventionen

GET /printers – Antwortfelder

GET /Jobs – Antwortfelder

GET /printer-states – Antwortfelder

GET /printer-interventions – Antwortfelder

1.5.5.1 Druckerzustände und Zustandskategorien

Über Druckerstatus und -kategorien

Up-Zustände

Down-Zustände

Ruhezustände

Unbekannt

1.5.5.2 Umgang mit den Antwortbeschränkungen der Datenexport-API

Wo die Grenzen liegen

Planungsanträge, die innerhalb der Grenzen bleiben sollen