RICOH Account Administration

1 RICOH Account Administration

RICOH Account Administration is de beheerinterface voor RICOH TotalFlow Cloud-toepassingen, zoals RICOH Predictive Insight™.

Verwijzing: Zie RICOH TotalFlow Cloud Security Overview voor informatie over RICOH TotalFlow Cloud-beveiligingsbeleid.

1.1 Overzicht van RICOH Account Administration

Beheerders gebruiken RICOH Account Administration voor het beheer van RICOH TotalFlow Cloud-gebruikers en diverse andere objecten die in uw toepassingen worden gebruikt.

Welke functies beschikbaar zijn, is afhankelijk van de toepassingsabonnementen die uw bedrijf heeft gekocht. Voor alle TotalFlow Cloud-toepassingen gebruikt u Account Administration voor het volgende:

Gebruikers toevoegen, wijzigen en verwijderen.
Details over uw abonnementen bekijken.
Uw accountgegevens bekijken en wijzigen.

Voor sommige toepassingen zijn andere functies toegevoegd zodat u het volgende kunt doen:

RICOH Cloud Connector downloaden en installeren voor communicatie met Ricoh-toepassingen die in uw netwerk zijn geïnstalleerd.

1.1.1 Wat is er nieuw?

RICOH Account Administration werkt regelmatig de beschikbare functies bij en corrigeert defecten.

RICOH Account Administration omvat diverse correcties van defecten en beveiligingsupdates in elke implementatie. Een overzicht van aanvullende wijzigingen voor elke implementatie vindt u hier.

3 september 2026

De functie gegevensexport-API van RICOH Predictive Insight is nu beschikbaar. De bèta-notatie is hier uit de documentatie verwijderd: Werken met de gegevensexport-API

5 augustus 2026

Bugfixes en beveiligingsupdates, waaronder oplossingen voor CVE-2026-42198, CVE-2026-44431, CVE-2026-44432, CVE-2026-48522, CVE-2026-48524, CVE-2026-48525 en CVE-2026-48526.

21 juli 2026

Bugfixes en beveiligingsupdates voor RICOH Cloud Connector, waaronder oplossingen voor 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 en CVE-2026-48779.

1 juli 2026

Bugfixes en beveiligingsupdates, waaronder oplossingen voor 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 en CVE-2026-47244.

12 juni 2026

Foutcorrecties en beveiligingsupdates, waaronder oplossingen voor CWE-117 en CWE-93.

11 juni 2026

Het helpsysteem is bijgewerkt met informatie over de gegevensexport-API, een functie die momenteel beschikbaar is voor bètatests: Werken met de gegevensexport-API

1 mei 2026

Bijgewerkt overzicht van de beveiliging van RICOH TotalFlow Cloud.

7 april 2026

Foutcorrecties en beveiligingsupdates, waaronder oplossingen voor CVE-2025-45768 en CVE-2026-26007.

21 januari 2026

Bugfixes en beveiligingsupdates, inclusief fixes voor CVE-2025-66418 en CVE-2025-66471.

17 december 2025

Bugfixes en beveiligingsupdates, inclusief fixes voor CVE-2025-48976, CVE-2025-7962 en CVE-2025-12383.

30 oktober 2025

Bugfixes en beveiligingsupdates, inclusief fixes voor CVE-2025-9636 en CVE-2025-48924.

30 juli 2025

Bugfixes en beveiligingsupdates, inclusief fixes voor CVE-2024-37891 en CVE-2024-12797.

23 juli 2025

Bugfixes en beveiligingsupdates, inclusief fixes voor CVE-2025-50181 en CVE-2025-50182.

9 juli 2025

Privacybeleid voor Japan bijgewerkt.
Ondersteuning toegevoegd voor klanten in Slovenië en Kroatië.
Bugfixes en beveiligingsupdates, inclusief fixes voor CVE-2021-28168.

2 juli 2025

Bugfixes en beveiligingsupdates, inclusief fixes voor CVE-2023-52428 en CVE-2023-1370.

4 juni 2025

Bugfixes en beveiligingsupdates, inclusief fixes voor CVE-2024-47554 en XUC-XUC-MAVEN-100000.

23 april 2025

Bugfixes en beveiligingsupdates, waaronder een fix voor CVE-2024-37891.

8 april 2025

Het document RICOH TotalFlow Cloud Security is bijgewerkt.

2 april 2025

Bijgewerkt om de naam RICOH Supervisor in alle verwijzingen te wijzigen in RICOH Predictive Insight.
Beveiligingsupdates en bugfixes.

12 maart 2025

Prestatieverbeteringen.
Beveiligingsupdates en bugfixes.

4 februari 2025

Diverse beveiligingsupdates, waaronder fixes voor CVE-2024-45296, CVE-2024-45590, CVE-2017-20165 en CVE-2024-39338.
Redactionele wijzigingen en bugfixes.

29 januari 2025

Diverse beveiligingsupdates, waaronder fixes voor CWE-798.
Redactionele wijzigingen en bugfixes.

5 december 2024

Het privacybeleid van Ricoh Europe is nu ook van toepassing op Oekraïne, Roemenië en Israël.
Redactionele wijzigingen en bugfixes.

30 oktober 2024

Diverse beveiligingsupdates, waaronder fixes voor CVE-2024-37891.
Redactionele wijzigingen en bugfixes.

2 oktober 2024

Diverse beveiligingsupdates, waaronder fixes voor CVE-2023-2650, CVE-2023-3446, CVE-2023-49083, CVE-2023-50782, CVE-2024-0727, CVE-2024-26130 en CVE-2023-4807.
Redactionele wijzigingen en bugfixes.

17 juli 2024

Ondersteuning voor RICOH TotalFlow Producer verwijderd.
Redactionele wijzigingen en bugfixes.

20 juni 2024

Redactionele wijzigingen en bugfixes.

11 juni 2024

Redactionele wijzigingen en bugfixes.

22 mei 2024

De lijst met ondersteunde printers voor abonnementen op RICOH TotalFlow Producer Advanced is bijgewerkt en bevat nu ondersteuning voor printers met de interne standaardcontroller van Ricoh.
Redactionele wijzigingen en bugfixes.

30 april 2024

Redactionele wijzigingen en bugfixes.

15 april 2024

Redactionele wijzigingen en bugfixes.

9 april 2024

Redactionele wijzigingen en bugfixes.

14 maart 2024

Redactionele wijzigingen en bugfixes.

7 maart 2024

Redactionele wijzigingen en bugfixes.

27 februari 2024

Voor abonnementen op RICOH TotalFlow Producer Advanced heeft RICOH Account Administration ondersteuning toegevoegd voor het configureren en beheren van printers.
RICOH Cloud Connector bevat nu het onderdeel RICOH Printer Connector om te communiceren met de printers die in uw omgeving actief zijn. Het RICOH Printer Connector-onderdeel is momenteel alleen beschikbaar in de Windows-versie van RICOH Cloud Connector.
Redactionele wijzigingen en bugfixes.

13 februari 2024

Redactionele wijzigingen en bugfixes.

30 januari 2024

Redactionele wijzigingen en bugfixes.

14 november 2023

Ter ondersteuning van RICOH TotalFlow Producer heeft RICOH Account Administration ondersteuning toegevoegd voor de bètafunctie Office-conversie.
Deze functie is beschikbaar bij het abonnement op RICOH TotalFlow Producer Advanced.

2 augustus 2023

Ter ondersteuning van RICOH TotalFlow Producer heeft RICOH Account Administration ondersteuning toegevoegd voor deze systeemobjecten:
- Automatiseringen
- Connectoren
- Klanten
- Hotfolders
Deze objecten zijn alleen zichtbaar nadat u een abonnement voor RICOH TotalFlow Producer hebt geactiveerd. Instructies voor het beheren ervan zijn echter opgenomen in het Help-systeem.

21 juni 2023

Updates voor het Help-systeem.

1 maart 2023

Diverse beveiligingsupdates, waaronder oplossingen voor CVE-2022-41946 en CVE-2022-42003.

10 november 2022

Diverse beveiligingsupdates, waaronder oplossingen voor CVE-2022-42889.

24 augustus 2022

Diverse beveiligingsupdates, waaronder oplossingen voor CVE-2022-31197.

27 juli 2022

Diverse beveiligingsupdates.

24 juni 2022

Ondersteuning toegevoegd voor het configureren van RICOH Cloud Connector om HTTPS te gebruiken.
Diverse beveiligingsupdates, waaronder oplossingen voor CVE-2022-21724.

17 mei 2022

Installatie van RICOH Cloud Connector via de gebruikersinterface is nu beschikbaar.

11 maart 2022

Vertalingen bijgewerkt met RICOH Cloud Connector-inhoud.
Bijgewerkte Engelse documentatie voor RICOH Cloud Connector en overzichtsonderwerpen.

23 februari 2022

Ondersteuning toegevoegd voor klanten in Canada.

19 januari 2022

Diverse beveiligingsupdates, waaronder oplossingen voor CVE-2021-44228.

27 oktober 2021

RICOH Cloud Connector is nu beschikbaar.

1 september 2021

Ondersteuning toegevoegd voor klanten in Frankrijk.

25 augustus 2021

Ondersteuning toegevoegd voor klanten in Duitsland.

28 juli 2021

Ondersteuning toegevoegd voor klanten in Vietnam.

12 mei 2021

Ondersteuning toegevoegd voor klanten in België en Luxemburg.

7 mei 2021

Het cookiebeleid voor klanten in Japan is bijgewerkt.

17 maart 2021

Ondersteuning toegevoegd voor klanten in Portugal.

17 februari 2021

Ondersteuning toegevoegd voor klanten in Spanje.

16 december 2020

Support toegevoegd voor klanten in Filipijnen.

2 december 2020

Support toegevoegd voor klanten in Zwitserland.

9 September 2020

Support toegevoegd voor klanten in Japan.

2 September 2020

Privacybeleid bijgewerkt voor klanten in de Verenigde Staten.

5 Augustus 2020

Support toegevoegd voor klanten in Zweden.

20 mei 2020

Extra ondersteuning voor klanten in Maleisië en Mexico.

1.1.2 Systeemobjecten

Systeemobjecten zijn items die u definieert in TotalFlow Cloud-toepassingen en worden gebruikt om uw oplossing te bouwen zoals u dat wilt. In Account Administration zijn gebruikers en connectoren enkele voorbeelden van systeemobjecten.

De systeemobjecten die u in Account Administration definieert, kunnen worden gebruikt in TotalFlow Cloud-toepassingen.

1.1.2.1 API-sleutels

Een API-sleutel is een referentie waarmee een toepassing toestemming krijgt om namens uw account verzoeken in te dienen bij een RICOH TotalFlow Cloud API. U kunt API-sleutels instellen op RICOH Account Administration.

Toepassingen die gebruikmaken van een API in plaats van de gebruikersinterface, kunnen zich niet als gebruiker aanmelden. In plaats daarvan bevat elk verzoek de waarde van een API-sleutel, waarmee het account wordt geïdentificeerd waartoe het verzoek behoort. Aangezien de sleutel uw accountidentiteit bevat, hoeft bij verzoeken geen account- of tenant-parameter te worden opgegeven.

U kunt maximaal tien sleutels voor uw account instellen. Veel organisaties maken voor elke toepassing die gegevens ophaalt één sleutel aan, zodat een sleutel kan worden vervangen of verwijderd zonder dat dit de andere toepassingen verstoort. Elke sleutel heeft een naam, een beschrijving en een vervaldatum.

De waarde van een sleutel wordt slechts één keer weergegeven, namelijk op het moment dat u de sleutel aanmaakt of vervangt. Account Administration slaat de waarde niet op in een vorm waarin deze opnieuw kan worden weergegeven; u dient de waarde daarom te kopiëren en veilig op te slaan op het moment dat deze wordt getoond. Als een waarde verloren gaat, draait u de sleutel om een nieuwe te genereren. Iedereen die over de waarde beschikt, kan verzoeken indienen via uw account; beveilig uw sleutels daarom op dezelfde manier als u een wachtwoord beveiligt. Sleutels zijn niet beperkt tot bepaalde printers.

Sleutels worden beheerd op het tabblad API-sleutels. U kunt de naam, de beschrijving of de vervaldatum van een sleutel wijzigen; een sleutel roteren om de waarde ervan te vervangen met behoud van de identiteit; of een sleutel verwijderen om de toegang onmiddellijk in te trekken.

Op RICOH TotalFlow Cloud worden API-sleutels gebruikt in combinatie met de gegevensexport-API, waarmee informatie over printers, afdruktaken en de status van printers wordt opgehaald die is verzameld via RICOH Predictive Insight. Het aantal API-verzoeken dat uw account kan indienen, over alle API-sleutels heen, wordt bepaald door uw abonnement. Voor elk abonnement geldt een maximum voor het aantal API-verzoeken dat is toegestaan binnen een voortschrijdende periode van 30 dagen. Indien u het aantal oproepen overschrijdt dat in uw abonnement is inbegrepen, worden er geen verzoeken meer geaccepteerd totdat het totale aantal verzoeken van de afgelopen 30 dagen onder de abonnementslimiet daalt. Om te zien hoeveel gesprekken uw abonnement omvat en hoeveel u er in de afgelopen 30 dagen hebt verbruikt, raadpleegt u de pagina API-sleutels. Mocht u merken dat u meer capaciteit nodig heeft voor API-verzoeken, neem dan contact op met uw Ricoh-vertegenwoordiger om uw abonnement uit te breiden.

1.1.2.2 Connectors

Connectors zijn toepassingen die op uw lokale systemen zijn opgeslagen en die een koppeling tot stand brengen tussen cloudtoepassingen en software of apparaten die op locatie zijn geïnstalleerd. Deze verbinding brengt een veilig communicatiepad tussen de systemen tot stand. Installeer RICOH Cloud Connector op een server in uw netwerk om verbinding te maken met RICOH TotalFlow Cloud.

Deze toepassingen gebruiken RICOH Cloud Connector om abonnementslicenties te installeren en beheren.

RICOH InfoPrint Manager voor Windows en voor Linux
RICOH Auto Color Adjuster

1.1.2.3 Gebruikers

Iedereen die met RICOH TotalFlow Cloud-toepassingen werkt, moet worden gedefinieerd als een Gebruiker.

Wanneer Ricoh uw account aanvankelijk instelt, wordt één Beheerder-gebruiker aangemaakt. De beheerder ontvangt een welkomstmail van TotalFlow Cloud, met een koppeling voor aanmelden en het wijzigen van het oorspronkelijke wachtwoord. Deze beheerder is verantwoordelijk voor het aanmaken van gebruikers voor de rest van uw organisatie.

Gebruikers zijn toegewezen rollen voor elke toepassing waarvoor u een abonnement hebt gekocht. Rollen zijn gebaseerd op de functieverantwoordelijkheden van de gebruiker en verschillen per toepassing. Account Administration heeft bijvoorbeeld twee rollen die u aan gebruikers kunt toewijzen:

Beheerder: Gebruikers die toestemming hebben om gegevens over uw account te bekijken, andere gebruikers aan te maken en te beheren en andere objecten naar behoefte te beheren.
Geen: Gebruikers die als taak hebben in uw geabonneerde toepassingen te werken, maar geen gebruikers of andere objecten beheren.

Een gebruiker kan een Beheerder zijn in Account Administration, maar een Kijker in een toepassing zoals RICOH Predictive Insight.

Gebruikers krijgen ook een rol toegewezen binnen het TotalFlow Cloud-platform. De meeste gebruikers zijn toegewezen aan de platformrol Standaard. Door andere toepassingen kunnen echter speciale platformrollen worden toegevoegd.

Door RICOH Predictive Insight wordt bijvoorbeeld de platformrol Groot scherm toegevoegd. U maakt een gebruiker aan met de platformrol Groot scherm wanneer u bijvoorbeeld RICOH Predictive Insight-dashboards wilt tonen op een scherm in uw productieruimte om de huidige status te tonen. Iemand in uw bedrijf meldt zich aan als de Groot scherm-gebruiker en maximaliseert het browservenster op het grote scherm. De gebruiker met de rol van Groot scherm heeft alleen-weergeven toegang en kan de maximaal toegestane tijd aangemeld blijven.

1.1.3 Gebruikersinterface

Gebruikers met een machtiging voor toegang tot RICOH Account Administration kunnen de gebruikersinterface openen vanaf elk systeem dat is verbonden met internet en waarop een ondersteunde browser is geïnstalleerd.

1.1.3.1 Banner

De banner is de zwarte balk bovenaan de gebruikersinterface. Deze is beschikbaar op alle pagina's in de interface.

Met de pictogrammen in de banner kunt u verschillende taken uitvoeren:

Schakel over naar een andere RICOH TotalFlow Cloud-toepassing waartoe u toegang hebt.
Klik op , het pictogram Appwisselaar, en kies welke app u wilt openen. De toepassing wordt geopend in hetzelfde tabblad.
Ideeën indienen om onze toepassingen te verbeteren.
Klik op , het pictogram Ideeën indienen, en klik vervolgens op Een nieuw idee toevoegen om te beschrijven wat we moeten toevoegen. U kunt ook ideeën bekijken die door andere klanten zijn ingediend. Als u het een goed idee vindt, stem er dan voor. Ideeën die door meer dan één klant worden gesteund, trekken waarschijnlijk onze aandacht en hebben een grotere kans om te worden uitgevoerd!
Bekijk meldingen die zijn verzonden door systeembeheerders of door de toepassingen zelf.
Klik op , het pictogram Meldingen.
- U kunt sommige meldingen zien zonder de lijst Meldingen te openen. Deze meldingen verschijnen in een strook boven of onder de banner of onderaan het browservenster.
Bekijk details over uw gebruikers-ID of het account van uw bedrijf.
Klik op , het pictogram Account. Uw gebruikers-ID en accountnaam staan boven aan het menu. Selecteer een optie om de bijbehorende instellingen of informatie te bekijken.
Krijg hulp bij het gebruik van de toepassing.
Klik op , het pictogram Help, en selecteer Help.
Bekijk de Gebruiksovereenkomst voor TotalFlow Cloud-toepassingen.
Klik op , het pictogram Help, en selecteer Gebruiksovereenkomst.

1.1.3.2 Hoofdpagina

Wanneer u zich aanmeldt bij RICOH Account Administration of ernaar terugkeert vanuit een andere toepassing, ziet u de hoofdpagina waarop een van de tabbladen is geopend.

Hoeveel tabbladen beschikbaar zijn, is afhankelijk van de toepassingen waarop u bent geabonneerd. Alle toepassingen bevatten deze tabbladen:

Abonnementen
Gebruikers
Details

In andere toepassingen kunt u naar behoefte andere tabbladen toevoegen. Met een abonnement op RICOH Auto Color Adjuster is bijvoorbeeld ook het tabblad Connectors beschikbaar.

Op de meeste tabbladen wordt een lijst getoond van objecten in een tabel. In alle tabellen kunt u:

De vermeldingen sorteren.
Klik eenmaal op de tabelkop om oplopend te sorteren en nogmaals om aflopend te sorteren.
De kolommen wijzigen en herschikken die worden weergegeven.
Klik op, het tandwielpictogram, en selecteer Kolommen beheren.
Zoeken naar tekst in de tabel.
Klik op , het zoekpictogram, en typ de tekst waarnaar u zoekt.

1.1.3.2.1 Tabblad API-sleutels

De API-sleutels die voor uw account zijn gedefinieerd, staan op de lijst op het tabblad API-sleutels op RICOH Account Administration. Gebruik dit tabblad om de sleutels aan te maken waarmee verzoeken aan de gegevensexport-API worden geautoriseerd, en om deze gedurende hun gehele levensduur te beheren.

Tabblad API-sleutels

Het tabblad API-sleutels is alleen beschikbaar als uw account is geabonneerd op RICOH Predictive Insight. Om het tabblad te kunnen zien en met sleutels te kunnen werken, moet u beschikken over toegang via Beheerder tot Account Administration.

Twee links bovenaan het tabblad openen referentie-informatie over de gegevensexport-API:

Aan de slag met API-sleutels: Hiermee opent u de helppagina voor de gegevensexport-API, waar u kunt lezen wat u moet doen om aan de slag te gaan met API-sleutels, evenals welke eindpunten beschikbaar zijn, welke velden elk eindpunt retourneert en welke limieten van toepassing zijn op verzoeken.
API-verkenner openen: Hiermee opent u de interactieve documentatiepagina voor de API, waar u elk eindpunt kunt bekijken, kunt zien welke parameters het accepteert en voorbeeldverzoeken rechtstreeks vanuit uw browser kunt verzenden. U hebt de waarde van een API-sleutel nodig om vanaf die pagina een verzoek in te dienen.

Dit zijn de acties die u op dit tabblad kunt uitvoeren:

Bekijk alle sleutels die voor uw account zijn gedefinieerd, evenals de bijbehorende eigenschappen, zoals: Naam, Status en Vervaldatum.
In de tabel wordt de waarde van een sleutel niet weergegeven.
Maak een sleutel aan.
Klik op API-sleutel maken. De codes zijn doorgaans binnen 30 seconden actief, maar er kunnen vertragingen optreden.
Houd de API-verzoeken van het account in de gaten en controleer of deze binnen de limieten van het abonnement blijven.
In het vak boven de tabel met API-sleutels worden het gebruiksabonnement van het account en het maximale aantal toegestane API-aanroepen per periode van 30 dagen weergegeven. Houd bij hoeveel telefoongesprekken er in de afgelopen 30 dagen zijn gevoerd.
Wijzig de naam, de beschrijving of de vervaldatum van een bestaande sleutel.
Klik met de rechtermuisknop op een rij en selecteer API-sleutel bewerken. Het bewerken van een sleutel heeft geen invloed op de waarde ervan, zodat toepassingen die de sleutel al gebruiken, gewoon blijven functioneren.
Draai een sleutel om de waarde ervan te wijzigen.
Klik met de rechtermuisknop op een rij en selecteer API-sleutel roteren. Stel een overlappingsperiode in, zodat zowel de huidige waarde als de nieuwe waarde nog een aantal dagen geldig blijven; dit geeft u de tijd om uw applicaties aan te passen. De sleutel met de nieuwe waarde is doorgaans binnen 30 seconden beschikbaar voor gebruik, maar er kunnen vertragingen optreden.
Een sleutel verwijderen.
Klik met de rechtermuisknop op een rij en selecteer Direct verwijderen.
- Wanneer u een sleutel verwijdert, wordt deze binnen een minuut uit het systeem verwijderd, hoewel er vertragingen kunnen optreden. Verwijderde sleutels worden definitief verwijderd. Indien u probeert een API-verzoek te verzenden met een sleutel nadat u deze hebt verwijderd, mislukt het verzoek.
- Als u een sleutel verwijdert, worden alle versies van die sleutel verwijderd. Als u een sleutel roteert en vervolgens verwijdert, worden beide versies van de sleutel verwijderd, zelfs als de overlappingsperiode nog steeds van kracht is.

Belangrijk: De waarde van een sleutel wordt slechts één keer weergegeven, namelijk wanneer u de sleutel aanmaakt of vervangt. U kunt het vanaf dit tabblad niet opnieuw weergeven. Kopieer de waarde en bewaar deze op dat moment op een veilige plaats. Mocht u de sleutel kwijtraken, draai deze dan om een nieuwe waarde te genereren.

Sleutels zijn niet beperkt tot afzonderlijke printers. Iedereen die over de waarde van een sleutel beschikt, kan verzoeken indienen namens uw account. Deel sleutels uitsluitend met de personen die integraties ontwikkelen, en vervang deze regelmatig in overeenstemming met uw beveiligingsprocedures.

Als u op , het hulpprogrammapictogram, klikt, wordt een menu geopend waarmee u de informatie in de tabel kunt vernieuwen en de tabelkolommen kunt beheren.

1.1.3.2.2 Tabblad Connectors

Geregistreerde connectors worden weergegeven op het tabblad Connectors in RICOH Account Administration.

Tabblad Connectors

Dit zijn de acties die u op dit tabblad kunt uitvoeren:

Bekijk alle geregistreerde connectors en hun eigenschappen, zoals: Status, Versie, Platform, of wanneer er voor het laatst contact mee is opgenomen.
Download de laatste versie van RICOH Cloud Connector voor uw besturingssysteem.
Klik op Downloaden en selecteer het besturingssysteem.
Genereer een eenmalige code om een cloudconnector te registreren.
Klik op Genereer een eenmalige code.
Bewerk, verwijder of bekijk de verbindingen die bij een connector horen.
Klik met de rechtermuisknop op een connector en kies een optie uit het menu.
- Als u een connector wilt bewerken, moet de server waarop de connector is gedefinieerd worden uitgevoerd en moet er een werkende netwerkverbinding mee zijn.
- Als u een connector verwijdert, wordt de RICOH Cloud Connector-instantie niet verwijderd, maar wordt deze uit de cloud verwijderd. Dit is mogelijk ook van invloed op bijbehorende abonnementen.

Als u op , het hulpprogrammapictogram, klikt, wordt een menu geopend waarmee u de informatie in de tabel kunt vernieuwen en de tabelkolommen kunt beheren.

1.1.3.2.3 Tabblad Details

Gebruik het tabblad Details om informatie over uw bedrijfsaccount te bekijken.

U kunt in de rechterbovenhoek van de pagina op Details bewerken klikken om uw bedrijfsnaam, contact- en factuurgegevens, standaardtaal en de time-outperiode voor alle gebruikers in uw bedrijf bij te werken.

1.1.3.2.4 Tabblad Abonnementen

Gebruik het tabblad Abonnementen om alle aan uw account gekoppelde abonnementen te bekijken, inclusief de abonnementen die zijn verlopen. U kunt indien nodig ook RICOH Cloud Connector downloaden.

Tabblad Abonnementen

Elk abonnement dat uw bedrijf heeft gekocht, wordt als een kaart weergegeven op het tabblad Abonnementen. Op de kaart staan de begin- en vervaldatum van het abonnement. Als u op Details klikt, wordt een dialoogvenster geopend met meer informatie, waaronder:

Het aantal en de soorten licenties die bij de aanvraag zijn gevoegd
Details over het abonnement, inclusief eventuele bijbehorende add-ons

1.1.3.2.5 Het tabblad Gebruikers

Gebruik het tabblad Gebruikers om de gebruikers aan te maken en te beheren die toegang hebben tot uw toepassingen.

Het tabblad Gebruikers

Op het tabblad Gebruikers kunt u:

nieuwe gebruikers aanmaken;
Klik op Gebruiker toevoegen.
bestaande gebruikers bewerken, kopiëren en verwijderen;
Klik met de rechtermuisknop op een rij en selecteer de juiste optie.
uitnodigingen opnieuw versturen naar gebruikers die niet op hun eerste uitnodiging hebben gereageerd.
Klik met de rechtermuisknop op een rij en selecteer Uitnodiging opnieuw verzenden.

1.1.4 RICOH Cloud Connector

RICOH Cloud Connector is een toepassing die u op uw netwerk installeert om de communicatie met de RICOH TotalFlow Cloud te beheren.

Cloud Connector is alleen vereist bij specifieke producten en in bepaalde configuraties:

RICOH InfoPrint Manager Subscription
Als u RICOH InfoPrint Manager Subscription koopt, wordt Cloud Connector bij het product geïnstalleerd. Het maakt verbinding met RICOH TotalFlow Cloud om te controleren of uw abonnement niet is verlopen.
RICOH Auto Color Adjuster
RICOH Auto Color Adjuster gebruikt Cloud Connector om abonnementen te beheren.

1.1.5 Toegankelijkheid

Ricoh streeft ernaar producten te leveren die voor iedereen toegankelijk zijn, ongeacht leeftijd of vermogen.

Voor meer informatie over onze inspanningen op het gebied van toegankelijkheid kunt u de pagina Toegankelijkheid op de website van Ricoh raadplegen.

Toegankelijkheidsfuncties

Toegankelijkheidsfuncties helpen gebruikers met een handicap, zoals beperkte mobiliteit of beperkt zicht, om met succes gebruik te maken van informatietechnologieproducten.

Met de belangrijkste toegankelijkheidsfuncties in dit product kunt u:

Schermlezers, schermvergroters en andere ondersteunende technologieën gebruiken.
Een toetsenbord gebruiken in plaats van een muis.
Kenmerken zoals volume, kleur, contrast en lettergrootte wijzigen.
Toetsen onderscheiden door aanraking zonder ze te activeren.
Alternatieve invoer- en uitvoerapparaten, zoals speciale aanwijsapparaten en brailleleesregels, aansluiten.

Bovendien hebben het Informatiecentrum en de publicaties voor het product een toegankelijk formaat.

Toetsenbordnavigatie

Voor dit product worden de standaardnavigatietoetsen van Microsoft Windows gebruikt.

1.1.6 Handelsmerken

RICOH InfoPrint Manager™ en RICOH Predictive Insight™ zijn handelsmerken van Ricoh Company, Ltd. in de Verenigde Staten en/of andere landen.

Firefox is een geregistreerd handelsmerk van de Mozilla Foundation.

Google en Chrome zijn handelsmerken van Google Inc.

Java en alle op Java gebaseerde handelsmerken en logo's zijn handelsmerken of geregistreerde handelsmerken van Oracle en/of diens gelieerde ondernemingen.

Linux is een geregistreerd handelsmerk van Linus Torvalds in de Verenigde Staten en/of andere landen.

Microsoft, Windows, Windows Server, Windows Vista en Internet Explorer zijn geregistreerde handelsmerken of handelsmerken van Microsoft Corporation in de Verenigde Staten en/of andere landen.

De juiste namen van de besturingssystemen van Windows zijn als volgt:

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 is een handelsmerk van Oracle America, Inc. Java en OpenJDK zijn handelsmerken of gedeponeerde handelsmerken van Oracle en/of diens gelieerde ondernemingen. Copyright Oracle America, Inc.

Andere hierin gebruikte productnamen worden uitsluitend ter identificatie gebruikt en zijn mogelijk handelsmerken van hun respectievelijke eigenaars. Wij maken geen enkele aanspraak op deze merken.

1.2 Aan de slag met RICOH TotalFlow™ Cloud

Maak uzelf vertrouwd met TotalFlow Cloud-toepassingen zodat u aan de slag kunt.

1.2.1 Voor de eerste keer aanmelden bij RICOH TotalFlow Cloud

Zodra uw account is aangemaakt, ontvangt u een e-mail van RICOH TotalFlow Cloud. Gebruik de knop in die e-mail om voor de eerste keer in te loggen.

Volg deze stappen om voor de eerste keer in te loggen op RICOH TotalFlow Cloud:

Open de e-mail die u hebt ontvangen van RICOH TotalFlow Cloud.
Klik op Inloggen bij uw account.
De aanmeldpagina wordt geopend in uw standaard webbrowser.
Typ een wachtwoord in de velden Nieuw wachtwoord en Wachtwoord bevestigen en klik vervolgens op wachtwoord maken.
Wachtwoorden moeten minimaal acht tekens lang zijn en voldoen aan de criteria die op de pagina worden vermeld.
- De uitnodiging per e-mail verloopt na zeven dagen. Als u op de koppeling klikt nadat de uitnodiging is verlopen, wordt er een foutpagina geopend en wordt er automatisch een nieuwe e-mailuitnodiging naar u gestuurd.
  Belangrijk: Klik alleen op de koppeling Uitnodiging opnieuw verzenden op die pagina als u niet binnen 15 minuten een nieuwe e-mail van RICOH TotalFlow Cloud ziet.
- Als u andere problemen ondervindt bij het aanmaken van uw account neemt u contact op met uw beheerder met de vraag om uw uitnodiging opnieuw te versturen.

1.2.2 Aan de slag met RICOH TotalFlow Cloud voor beheerders

Beheerders stellen TotalFlow Cloud-objecten en -toepassingen in om ze klaar te maken voor gebruik door anderen. Zij maken gebruikers-ID's aan voor anderen en blijven op de hoogte van geplande downtime, systeemupdates en abonnementsinformatie.

Beheerders voeren hun meeste taken uit in de toepassing RICOH Account Administration, maar ze kunnen ook andere toepassingen openen en gebruiken.

Ga als volgt als beheerder aan de slag met RICOH TotalFlow Cloud:

Meld u aan en wijzig uw wachtwoord.
Wanneer uw gebruikers-ID is aangemaakt, ontvangt u een e-mail waarin u wordt uitgenodigd om u aan te melden en gebruik te maken van RICOH TotalFlow Cloud-toepassingen. De eerste keer dat u zich aanmeldt, moet u uw wachtwoord opnieuw instellen.
- Ricoh maakt slechts één gebruiker aan voor uw account. Die gebruiker is een beheerder. Als u de eerste gebruiker bent, bent u verantwoordelijk voor het toevoegen van meer gebruikers en hen toegang tot de juiste toepassingen verlenen. U kunt andere beheerders aanmaken en verantwoordelijkheden aan hen delegeren.
Als beheerder wordt u doorverwezen naar de toepassing Account Administration.
Voer actie uit op cookie-instellingen.
TotalFlow Cloud-toepassingen gebruiken cookies, waarvan sommige vereist zijn. Bekijk Cookie-instellingen beheren voor meer informatie over cookies en de acties die u kunt ondernemen.
Maak uzelf vertrouwd met de interface van de toepassing. Bekijk deze onderwerpen:
- Banner
- Hoofdpagina
Controleer uw accountgegevens en abonnementen.
- Accountdetails beheren
  U kunt de contactgegevens zo nodig bijwerken.
- Abonnementen weergeven
  Neem bij vragen contact op met uw Ricoh-vertegenwoordiger.
Leer meer over de onderdelen van uw systeem, zodat u de objecten kunt gaan plannen die u moet maken.
- Systeemobjecten
- RICOH Cloud Connector
Gebruik de procedures in dit deel en in het deel Configureren om de gebruikers-ID's en andere objecten aan te maken die voor uw account nodig zijn.

1.2.2.1 Abonnementen weergeven

U kunt details over uw abonnementen bekijken in RICOH Account Administration.

Abonnementen bekijken:

Meld u aan bij RICOH Account Administration.
Klik in het linkerdeelvenster op Abonnementen.

De pagina Abonnementen bevat uw abonnementkaarten, evenals de huidige status en de vervaldatum ervan. Een abonnementsstatus kan zijn:

Actief

Het abonnement kan momenteel worden gebruikt.

In behandeling

De startdatum van het abonnement is nog niet aangebroken.

Onderbroken

Het abonnement is gedeactiveerd vanwege een gebeurtenis zoals schending van de algemene voorwaarden of een uitgebleven betaling. Het kan worden hersteld wanneer het probleem is opgelost.

Verlopen

De looptijd van het abonnement is verstreken.
Om de details van het abonnement uit te vouwen, klikt u op Details.

De tabel Licenties bevat informatie over de licenties voor verschillende functies die in het abonnement zijn opgenomen en alle uitbreidingen en het aantal van elk type licentie dat u onder dit abonnement hebt aangeschaft.

De tabel Gegevens van abonnement bevat een overzicht van het product en alle add-ons die bij dit abonnement horen.

Neem contact op met uw Ricoh-vertegenwoordiger als u een abonnement wilt verlengen of meer add-ons wilt aanschaffen.

1.2.2.2 Gebruikers toevoegen

Wanneer u een gebruiker toevoegt, voert u de contactgegevens van de gebruiker in en selecteert u welk type rol de gebruiker heeft voor elke toepassing.

U kunt een nieuwe gebruiker aanmaken of een bestaande gebruiker kopiëren. Gebruikers kopiëren kan tijd besparen, vooral wanneer u verschillende gebruikers moet aanmaken met vergelijkbare eigenschappen.

Voeg als volgt een gebruiker toe:

Klik in het linkerdeelvenster op Gebruikers.
Kies een van deze opties:
- Een nieuwe gebruiker toevoegen: klik op Gebruiker toevoegen rechtsboven in het venster.
- Een bestaande gebruiker kopiëren: klik met de rechtermuisknop op de rij voor een bestaande gebruiker en selecteer Dupliceren.
Voer in het geopende dialoogvenster de gegevens van de gebruiker in.
Onder Type gebruiker selecteert u Intern om een gebruikersaccount aan te maken voor een van uw medewerkers.
Selecteer onder Platformrol een van deze opties:
- Standaard - De gebruiker kan zich aanmelden bij de toepassing met standaardopties voor time-out en toegang.
- Groot scherm - De gebruiker heeft alleen-lezen toegang tot de toepassing op een groot scherm en er treedt geen time-out op.
Selecteer onder Toegang en rollen de toegang en de rol van de gebruiker voor elke toepassing. Klik op de pijl in de kolom Toegang en rollen voor elke toepassing.
- Voor sommige abonnementen gelden beperkingen voor wat betreft het aantal gebruikers dat aan elke rol kan worden toegewezen.
Klik op OK.

Gebruikers ontvangen een e-mail waarin ze worden uitgenodigd om zich aan te melden bij RICOH TotalFlow Cloud, waar ze hun gegevens en wachtwoord kunnen wijzigen. De uitnodiging per e-mail is zeven dagen geldig.

Opmerking:

Als de gebruiker zich niet aanmeldt voordat de e-mailuitnodiging verloopt, kunt u de uitnodiging opnieuw versturen. Klik met de rechtermuisknop op de gebruiker en kies Uitnodiging opnieuw verzenden.

1.2.3 Aan de slag met RICOH TotalFlow Cloud voor gebruikers

Gebruikers van RICOH TotalFlow Cloud-toepassingen hebben verschillende rollen, van business intelligence-analisten tot operators in de drukkerij.

De meeste gebruikers hebben toegang tot één RICOH TotalFlow Cloud-toepassing. U kunt ook gegevens over uw eigen gebruikers-ID en uw wachtwoord bijwerken.

U kunt als volgt als gebruiker aan de slag met RICOH TotalFlow Cloud-toepassingen:

Meld u aan en wijzig uw wachtwoord.
Wanneer uw gebruikers-ID is aangemaakt, ontvangt u een e-mail waarin u wordt uitgenodigd om u aan te melden en gebruik te maken van RICOH TotalFlow Cloud-toepassingen. De eerste keer dat u zich aanmeldt, moet u uw wachtwoord opnieuw instellen.
Nadat u uw wachtwoord hebt gewijzigd, ziet u de toepassing die u kunt gebruiken.
Voer actie uit op cookie-instellingen.
TotalFlow Cloud-toepassingen gebruiken cookies, waarvan sommige vereist zijn. Bekijk Cookie-instellingen beheren voor meer informatie over cookies en de acties die u kunt ondernemen.
Maak uzelf vertrouwd met de interface van de toepassing. Bekijk deze onderwerpen als ze op u van toepassing zijn:
Leer meer over de onderdelen van uw systeem.
- Systeemobjecten

1.2.4 Cookie-instellingen beheren

RICOH TotalFlow Cloud-toepassingen gebruiken cookies om uw ervaring met onze software te verbeteren. U kunt de instellingen voor sommige van deze cookies zelf bepalen.

RICOH TotalFlow Cloud-toepassingen kunnen dit soort cookies gebruiken:

Strikt noodzakelijke cookies: Dit zijn cookies die essentieel zijn voor het functioneren van onze toepassingen. Als u ervoor kiest deze cookies niet te accepteren, kunt u mogelijk niet inloggen op onze toepassingen of gebruik maken van andere essentiële functies.
Prestatiecookies: Prestatiecookies, ook bekend als statistische cookies, verzamelen informatie over hoe goed onze toepassingen functioneren. Deze informatie wordt samengevoegd en anoniem gemaakt, zodat het niet kan worden gebruikt om u te identificeren.; De verzamelde prestatiegegevens omvatten informatie die door Google Analytics wordt verzameld. Om te voorkomen dat uw gegevens door Google Analytics worden verzameld, schakelt u prestatiecookies uit.
Functionele cookies: Functionele cookies, ook bekend als voorkeurscookies, onthouden informatie zoals de laatste pagina die u hebt bezocht of welke taal u kiest.
Marketingcookies: Marketingcookies verzamelen informatie over uw onlineactiviteiten om u relevante advertenties te kunnen aanbieden.

U kunt de cookie-instellingen als volgt beheren:

Meld u aan bij een TotalFlow Cloud-toepassing.
Klik in de banner op , het pictogram Account, en selecteer Cookie-instellingen.
Klik in het dialoogvenster Cookie-instellingen op Cookieverklaring bekijken om een lijst te zien van de cookies die in TotalFlow Cloud-toepassingen worden gebruikt en hun beschrijvingen.
Gebruik de schakelaars om elk type cookie in of uit te schakelen.
Standaard zijn alle cookies ingeschakeld:
Klik op OK.

1.3 Configureren

Gebruik deze procedures om uw systeem in te stellen zodat andere mensen in uw bedrijf het kunnen gebruiken.

1.3.1 Gebruikers toevoegen

Wanneer u een gebruiker toevoegt, voert u de contactgegevens van de gebruiker in en selecteert u welk type rol de gebruiker heeft voor elke toepassing.

Voeg als volgt een gebruiker toe:

Klik in het linkerdeelvenster op Gebruikers.
Kies een van deze opties:
- Een nieuwe gebruiker toevoegen: klik op Gebruiker toevoegen rechtsboven in het venster.
- Een bestaande gebruiker kopiëren: klik met de rechtermuisknop op de rij voor een bestaande gebruiker en selecteer Dupliceren.
Voer in het geopende dialoogvenster de gegevens van de gebruiker in.
Onder Type gebruiker selecteert u Intern om een gebruikersaccount aan te maken voor een van uw medewerkers.
Selecteer onder Platformrol een van deze opties:
- Standaard - De gebruiker kan zich aanmelden bij de toepassing met standaardopties voor time-out en toegang.
- Groot scherm - De gebruiker heeft alleen-lezen toegang tot de toepassing op een groot scherm en er treedt geen time-out op.
Selecteer onder Toegang en rollen de toegang en de rol van de gebruiker voor elke toepassing. Klik op de pijl in de kolom Toegang en rollen voor elke toepassing.
- Voor sommige abonnementen gelden beperkingen voor wat betreft het aantal gebruikers dat aan elke rol kan worden toegewezen.
Klik op OK.

Opmerking:

Als de gebruiker zich niet aanmeldt voordat de e-mailuitnodiging verloopt, kunt u de uitnodiging opnieuw versturen. Klik met de rechtermuisknop op de gebruiker en kies Uitnodiging opnieuw verzenden.

1.4 Objecten beheren

Nadat u objecten zoals gebruikers en connectoren hebt aangemaakt en geconfigureerd, kunt u deze zo nodig bijwerken.

1.4.1 Accountdetails beheren

U kunt uw accountgegevens, inclusief uw bedrijfs- en contactgegevens, wijzigen.

Beheer accountgegevens als volgt:

Klik in het linkerdeelvenster op Details.
Klik op Details bewerken.
Pas de informatie naar behoefte aan en klik op OK.

1.4.2 Gebruikersinformatie aanpassen

U kunt de gegevens van een gebruiker wijzigen wanneer dat nodig is.

Pas gebruikersgegevens als volgt aan:

Klik in het linkerdeelvenster op Gebruikers.
Klik met de rechtermuisknop op de gebruiker waarvan u de informatie wilt wijzigen en klik op Bewerken.
Pas de informatie van de gebruiker naar behoefte aan en klik op OK.

1.4.3 Uw wachtwoord wijzigen

Wijzig uw wachtwoord om de beveiliging van uw account te waarborgen.

Opmerking:

Als u uw huidige wachtwoord niet weet, opent u de aanmeldpagina voor RICOH TotalFlow Cloud en klikt u op Wachtwoord vergeten. Typ uw e-mailadres en klik op Volgende. Controleer uw e-mail voor een bericht van RICOH TotalFlow Cloud met instructies voor het opnieuw instellen van uw wachtwoord.

Wijzig uw wachtwoord als volgt:

Meld u aan bij RICOH TotalFlow Cloud.
Klik in de banner op , het pictogram Account en kies Profielinstellingen.
Klik links op de pagina Profiel en voorkeuren van Ricoh Software op Wachtwoord.
Voer uw huidige wachtwoord en uw nieuwe wachtwoord twee keer in.
Klik op Wachtwoord wijzigen.
Klik op Sluiten.

De volgende keer dat u zich aanmeldt, moet u het nieuwe wachtwoord gebruiken.

1.5 Werken met de gegevensexport-API

Met de gegevensexport-API kunt u informatie die door RICOH Predictive Insight is verzameld, extraheren voor gebruik in andere processen en tools binnen uw organisatie.

De gegevensexport-API biedt programmatische toegang tot printerinformatie, de geschiedenis van de uitgevoerde taken, gegevens over de printerstatus en gebeurtenissen waarbij ingrijpen in de printer vereist is. U kunt het gebruiken om rapportagetools te voeden, dashboards te vullen, operationele gegevens te archiveren of gegevens uit de RICOH Predictive Insight te integreren met andere systemen in uw omgeving.

1.5.1 Gegevensexport-API

De gegevensexport-API is een REST-API die vier eindpunten biedt. U kunt deze eindpunten gebruiken om informatie te downloaden over uw printers en de taken die zij hebben verwerkt, evenals de bedrijfsstatus van die printers in de loop van de tijd en gebeurtenissen die aanleiding hebben gegeven tot waarschuwings- of foutmeldingen op de printer.

U kunt de gegevensexport-API gebruiken om gegevens uit de RICOH Predictive Insight te importeren in business intelligence-tools, datawarehouses, dashboards en andere applicaties binnen uw organisatie.

Verificatie

U kunt API-sleutels aanmaken en beheren op RICOH Account Administration. U kunt zoveel sleutels aanmaken als u nodig heeft: één per toepassing die gegevens downloadt of één sleutel voor gebruik binnen uw hele organisatie. Stel de vervaldatum vast in overeenstemming met uw beveiligingsbeleid en wissel de sleutels indien nodig af. U kunt de overlappingsperiode instellen, zodat zowel de oude als de nieuwe sleutels gedurende een aantal dagen werken. Indien nodig kunt u een sleutel verwijderen om deze onmiddellijk te deactiveren.

De API-sleutel bevat tevens uw tenant-identiteit; daarom is bij geen enkel verzoek een tenant- of accountparameter vereist. Iedereen die over de sleutelwaarde beschikt, kan verzoeken indienen als uw tenant; beveilig API-sleutels daarom op dezelfde manier als u een wachtwoord zou beveiligen.

Beschikbare eindpunten

De API bevat de volgende eindpunten:

/printers

Geeft de lijst met printers in uw account weer, inclusief de naam van de printer, het model, de fabrikant, het serienummer, de printkoppen en de huidige status van de verbinding.

/jobs

Geeft details op taakniveau weer voor één of meer printers, waaronder tijdstippen, afgedrukte exemplaren, pagina’s, afdrukken, vellen, rollengte en het verbruik van inkt en spoelen per kleurkanaal. Standaard heeft het overzicht betrekking op de afgelopen 24 uur.

/printer-states

Geeft de bedrijfsstatus van elke printerengine weer, hetzij als een samengevatte geschiedenis over een bepaald tijdsbestek, hetzij uitsluitend als de huidige status. U kunt de actuele statussen van de printer opvragen, zoals: Bezig met afdrukken, Bezig met voorbereiden, Onderhoud of Slaapstand, of deze statussen kunnen worden gegroepeerd in de volgende categorieën: up, down, idle of unknown.

Tip: Het eindpunt /printer-states geeft statusinformatie weer per printerengine, niet per printer. Een printer met meerdere printmotoren geeft één rij per printmotor weer.

/printer-interventions

Geeft de gebeurtenissen weer die op één of meer printers tot waarschuwingen of fouten hebben geleid, zoals een papierstoring of een lege mediabron. Elke gebeurtenis wordt per afdrukmechanisme gerapporteerd, met vermelding van het tijdstip waarop deze begon, het tijdstip waarop deze eindigde, de duur ervan, een code die de voorwaarde aangeeft en, indien van toepassing, de naam van de taak die op dat moment werd afgedrukt. Standaard heeft het overzicht betrekking op de afgelopen 24 uur. U kunt beschrijvingen van evenementen aanvragen in elk van de ondersteunde talen.

De API testen

Er is een interactieve documentatiepagina beschikbaar waarmee u elk eindpunt kunt bekijken, kunt zien welke parameters het accepteert en voorbeeldverzoeken rechtstreeks vanuit uw browser kunt uitproberen. Om de pagina te openen, gaat u naar:

De VS en Japan: https://rpi-data-export.app-ricohsoftware.com/api/v1/api-docs
Europa: https://rpi-data-export.app-ricohsoftware.eu/api/v1/api-docs

Om verzoeken in te dienen via de documentatiepagina of vanuit uw eigen applicaties, dient u eerst een API-sleutel aan te maken. U kunt API-sleutels aanmaken en beheren op Account Administration.

1.5.2 API-sleutels aanmaken en beheren

Een API-sleutel autoriseert verzoeken aan de gegevensexport-API. U maakt API-sleutels aan en beheert deze op Account Administration, en u voert de sleutel in wanneer u verzoeken indient via de API-verkenner-pagina of vanuit uw eigen applicaties.

Elk verzoek aan de gegevensexport-API moet een geldige API-sleutel bevatten in de x-api-key -koptekst. De sleutel verifieert het verzoek aan uw account (tenant).

Om API-sleutels aan te maken, dient u over Beheerder-toegang tot Account Administration te beschikken.

Gebruik de procedures in dit onderwerp om:

Maak een nieuwe API-sleutel aan.
Wijzig de naam, de vervaldatum of de beschrijving van een bestaande sleutel.
Draai een sleutel om de geheime waarde ervan te vervangen zonder de identiteit van de sleutel te wijzigen.
Verwijder een sleutel uit het systeem.

Opmerking: Wanneer u een API-sleutel aanmaakt of vervangt, is er een korte periode waarin de sleutel nog niet is geregistreerd en nog niet klaar is voor gebruik. Over het algemeen duurt dit minder dan één minuut.

Om een nieuwe API-sleutel aan te maken:
1. Klik in het linkerdeelvenster van Account Administration op API-sleutels.
2. Klik op API-sleutel maken.
3. Voer een naam en een beschrijving voor deze sleutel in.
4. Kies voor Vervaldatum een datum die maximaal 367 dagen in de toekomst ligt.
5. Kies voor Licenties het „RPI Data Export Usage Plan“ voor API-sleutels.
6. Klik op Volgende.
  De sleutel is gegenereerd en opgeslagen.
7. Klik op Kopiëren om de gegenereerde sleutel naar uw klembord te kopiëren. Bewaar het op een veilige plaats.
  
  Belangrijk: De volledige sleutelwaarde wordt alleen weergegeven wanneer de sleutel wordt aangemaakt. U hebt er geen toegang meer toe. Indien u de waarde kwijtraakt, dient u de sleutel te vernieuwen om een nieuwe te genereren.
1. Klik op Ik heb mijn sleutel opgeslagen om het dialoogvenster te sluiten.
Om een bestaande API-sleutel te bewerken:
1. Klik in het linkerdeelvenster van Account Administration op API-sleutels.
2. Zoek de sleutel die u wilt wijzigen. Klik met de rechtermuisknop op de rij van de sleutel en selecteer API-sleutel bewerken.
3. Pas de naam, de vervaldatum of de beschrijving indien nodig aan.
  Het bewerken van een sleutel heeft geen invloed op de waarde van de sleutel. Toepassingen die de sleutel al gebruiken, blijven zonder aanpassingen functioneren.
4. Klik op OK.
Om een API-sleutel te vernieuwen:
1. Klik in het linkerdeelvenster van Account Administration op API-sleutels.
2. Zoek de sleutel die u wilt draaien. Klik met de rechtermuisknop op de rij van de sleutel en selecteer API-sleutel roteren.
3. Stel de parameter Overlappingsperiode in dagen in op het aantal dagen gedurende welke zowel de bestaande sleutel als de gewijzigde versie tegelijkertijd actief moeten zijn.
4. Stel een nieuwe waarde Vervaldatum in voor de sleutel.
5. Klik op OK.
6. Klik op Kopiëren om de gegenereerde sleutel naar uw klembord te kopiëren. Bewaar het op een veilige plaats.
  
  Belangrijk: De volledige sleutelwaarde wordt alleen weergegeven wanneer de sleutel wordt aangemaakt. U hebt er geen toegang meer toe. Indien u de waarde kwijtraakt, dient u de sleutel te vernieuwen om een nieuwe te genereren.
7. Werk alle toepassingen, scripts of opgeslagen interactieve documentatiesessies die de sleutel gebruiken bij voordat de overlappingsperiode afloopt.
Om een sleutel uit het systeem te verwijderen:
1. Klik in het linkerdeelvenster van Account Administration op API-sleutels.
2. Zoek de sleutel die u wilt draaien. Klik met de rechtermuisknop op de rij van de sleutel en selecteer Direct verwijderen.
3. Selecteer in het dialoogvenster Ja, verwijder de sleutel.
  Deze stap is noodzakelijk, aangezien het verwijderen onomkeerbaar is. Nadat u de sleutel hebt verwijderd, kunt u deze niet meer herstellen.
4. Klik op OK.

U kunt de nieuwe of bijgewerkte API-sleutel op de pagina met interactieve documentatie gebruiken om de gegevensexport-API te testen, evenals in elke toepassing die verzoeken naar de API verzendt.

1.5.3 De Gegevensexport-API uitproberen

Volg deze procedure voor een korte inleiding tot de API, waarbij u de interactieve documentatiepagina als leidraad gebruikt.

Voordat u met deze taak begint, dient u een API-sleutel aan te maken via RICOH Account Administration.

Deze procedure leidt u door de volgende stappen:

Verificatie van de interactieve documentatiepagina
De lijst met printer-ID’s voor de printers in uw account ophalen
De status van één of meer printers opvragen
Informatie opvragen over taken die verband houden met een of meer van die printers

Om de Gegevensexport-API te gebruiken:

Open hier de interactieve documentatie van de Gegevensexport-API:
- De VS en Japan: https://rpi-data-export.app-ricohsoftware.com/api/v1/api-docs
- Europa: https://rpi-data-export.app-ricohsoftware.eu/api/v1/api-docs
Authenticeren met behulp van een API-sleutel:
1. Klik op Autoriseren aan de rechterkant van de pagina.
2. Voer in het dialoogvenster Beschikbare autorisaties uw API-sleutel in het veld Waarde in.
1. Klik op Autoriseren om u te authenticeren.
2. Klik op Sluiten.
U kunt nu de beschikbare API-functies testen. Gebruik deze interface om vertrouwd te raken met de syntaxis voordat u de API in uw applicaties integreert.
Haal de lijst met printer-ID’s op voor de printers die in uw account zijn gedefinieerd.
Om informatie over de status van afdruktaken en printers op te vragen, dient u de printer-ID’s in uw API-verzoeken op te nemen. Printer-ID’s veranderen niet. Als u ze nu opvraagt en de waarden opslaat, kunt u de ID’s in andere API-aanroepen gebruiken.
1. Open het gedeelte Printers en open vervolgens het endpoint GET /printers.
  U ziet dat er voor dit endpoint geen parameters nodig zijn.
2. Klik op Probeer het eens en vervolgens op Uitvoeren.
3. Controleer de inhoud van het antwoord. U ziet een lijst met gegevens over de printers die worden bewaakt door RICOH Predictive Insight. Het antwoord ziet er ongeveer zo uit:
```
[
  {
    "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"
  }
]
```
  Noteer de waarden van de printerId-parameters voor elk van uw printers.
Vraag de printerstatusgeschiedenis op van één of meer printers in uw systeem.
1. Open het endpoint GET /printer-states.
2. Klik op Probeer het uit.
3. Klik naast printerId op Tekenreeks toevoegen.
4. Vervang de tekst in het veld door een van de printer-ID-waarden die u in stap 3 hebt opgehaald.
  Om de statusgeschiedenis voor andere printers op te halen, klikt u nogmaals op Tekenreeks toevoegen en voegt u nog een printer-ID toe.
5. Kies bij tijdzone de tijdzone die u voor de gegevens wilt gebruiken.
6. Geef de begin- en eindtijd op voor de periode waarover u een rapport wilt genereren. Laat deze velden leeg om gegevens van de afgelopen 24 uur op te halen.
7. Laat de laatste drie waarden op de standaardinstelling staan, zodat u de volledige lijst met informatie kunt zien die de API kan retourneren.
8. Klik op Uitvoeren.
9. Controleer de inhoud van het antwoord. U ziet een lijst met gegevens over de printerstatus voor elke printerengine, met één regel per wijziging in de printerstatus.
10. Wijzig de waarden voor de parameters currentState, stateCategoryOnly en stateCategory en klik opnieuw op Uitvoeren om te zien hoe het antwoord verandert.
  - Als u deze parameters op de standaardinstelling (niet ingesteld) laat staan, heeft dit hetzelfde effect als wanneer u ze op onwaar instelt.
  - U kunt deze afzonderlijk of in combinatie met elkaar gebruiken.
Vraag informatie aan over taken die verband houden met een of meer van deze printers:
1. Ga naar het gedeelte Taken op de pagina.
2. Open het endpoint GET /jobs.
3. Klik op Probeer het uit.
4. Klik naast printerId op Tekenreeks toevoegen.
5. Vervang de tekst in het veld door een van de printer-ID-waarden die u in stap 3 hebt opgehaald.
  Om taakinformatie voor extra printers op te halen, klikt u nogmaals op Tekenreeks toevoegen en voegt u nog een printer-ID toe.
6. Kies bij tijdzone de tijdzone die u voor de gegevens wilt gebruiken.
7. Geef de begin- en eindtijd op voor de periode waarover u een rapport wilt genereren. Laat deze velden leeg om gegevens van de afgelopen 24 uur op te halen.
8. Laat het veld Taakstatus leeg om het volledige scala aan antwoorden te zien dat de API kan retourneren.
9. Klik op Uitvoeren.
10. Bekijk het antwoord om de teruggestuurde taakinformatie te bekijken.
11. Wijzig de waarde van Taakstatus en klik nogmaals op Uitvoeren om te zien hoe het antwoord verandert.

1.5.4 Verwerking van datum en tijd in de gegevensexport-API

De gegevensexport-API maakt gebruik van één enkel, consistent model voor de verwerking van datums en tijden: bij elk verzoek wordt een IANA-tijdzone opgegeven, elke datum- en tijdwaarde wordt in die tijdzone geïnterpreteerd en elke datum- en tijdwaarde in het antwoord wordt in diezelfde tijdzone weergegeven. Gebruik dit onderwerp om inzicht te krijgen in de werking van het model en om veelvoorkomende fouten te voorkomen.

Het datum- en tijdmodel

Er zijn drie regels die beschrijven hoe de API met datums en tijden omgaat:

Elk verzoek aan /jobs, /printer-states en /printer-interventions moet een timezone bevatten met een geldige IANA-tijdzone-identificatie, bijvoorbeeld America/Denver of Europe/Bucharest.
Elke waarde voor startDateTime of endDateTime die in het verzoek wordt opgegeven, wordt geïnterpreteerd als lokale tijd in de opgegeven tijdzone. De waarden bevatten geen UTC-verschuiving.
Elke datum- en tijdwaarde in het antwoord wordt weergegeven als lokale tijd in dezelfde tijdzone, volgens het patroon JJJJ-MM-DDTHH:MM:SS.sss.

De parameter timezone bepaalt de betekenis van het verzoek en de opmaak van het antwoord. Twee verzoeken om dezelfde onderliggende gegevens, die met verschillende tijdzones zijn ingediend, leveren antwoorden op met verschillende tijdstempeltekenreeksen, ook al hebben deze betrekking op dezelfde gebeurtenissen.

Datum- en tijdnotatie

De API hanteert één indeling voor alle datum- en tijdwaarden, zowel in verzoeken als in antwoorden:

YYYY-MM-DDTHH:MM:SS.sss

Zo is 2026-03-15T14:30:00.000 bijvoorbeeld 14:30:00 uur op 15 maart 2026, geïnterpreteerd in de tijdzone die bij het verzoek is opgegeven.

Belangrijk: Het formaat bevat geen UTC-verschuiving (zoals -06:00) of een Z-achtervoegsel. Voeg er geen toe. Zowel verzoeken als antwoorden maken uitsluitend gebruik van de lokale tijd, waarbij de tijdzone afzonderlijk als verzoekparameter wordt meegestuurd.

In verzoeken is het gedeelte in milliseconden (.sss) optioneel. In reacties is het altijd aanwezig.

Standaard tijdsperiode

U kunt startDateTime, endDateTime of beide weglaten. De twee standaardinstellingen worden afzonderlijk toegepast:

Indien u startDateTime weglaat, gebruikt de API het tijdstip 24 uur vóór het huidige tijdstip als begin van het bereik.
Indien u endDateTime weglaat, gebruikt de API de huidige tijd als eindtijd van het tijdsbereik.

De standaardinstellingen werken samen zoals u zou verwachten:

Indien u beide waarden weglaat, retourneert de API gegevens over de afgelopen 24 uur.
Indien u startDateTime instelt op ‘één uur geleden’ en endDateTime weglaat, retourneert de API gegevens voor het afgelopen uur.
Indien u endDateTime opgeeft en startDateTime weglaat, retourneert de API gegevens voor het tijdsbestek dat begint 24 uur vóór het verzoek en eindigt op het tijdstip van endDateTime.

Standaardwaarden worden berekend in de tijdzone die bij het verzoek is opgegeven.

Bewaartermijn van gegevens: de afgelopen zeven dagen

De gegevensexport-API levert operationele gegevens in realtime. Taken-gegevens, de geschiedenis van de printerstatus en interventiegebeurtenissen zijn slechts beschikbaar voor de afgelopen zeven dagen. Een verzoek om gegevens die ouder zijn dan zeven dagen levert een foutmelding op.

Plan uw integratie zodanig dat geplande extracties vaak genoeg worden uitgevoerd om alle gegevens vast te leggen voordat deze verouderd raken:

Houd voor de nachtelijke extracties rekening met een marge van ten minste één of twee dagen. Als een geplande taak mislukt, heeft u de tijd om de oorzaak te achterhalen en de taak opnieuw uit te voeren voordat de gegevens niet meer beschikbaar zijn.
Vraag bij aanvullingen of eenmalige gegevensopvragingen geen gegevens op die ouder zijn dan zeven dagen.

Regels voor het gevraagde bereik

startDateTime moet eerder zijn dan endDateTime. Een verzoek dat in strijd is met deze regel leidt tot de foutmelding ERR_INVALID_DATE_RANGE.
Beide waarden moeten de indeling volgen die wordt beschreven op Datum- en tijdnotatie. Een verzoek met een ongeldige waarde leidt tot een foutmelding ERR_INVALID_DATE_FORMAT.
De periode tussen startDateTime en endDateTime mag het maximaal toegestane bereik niet overschrijden. Een verzoek dat de maximale waarde overschrijdt, leidt tot de foutmelding ERR_DATE_RANGE_EXCEEDED.

Het opgeven van de tijdzone

De parameter tijdzone accepteert IANA-tijdzone-identificaties, zoals America/Denver, America/New_York, Europe/Bucharest, Asia/Tokyo of UTC. Op de interactieve documentatiepagina is een lijst met alle waarden te vinden die de API accepteert.

Een ongeldige of niet-herkende identificatiecode leidt tot de foutmelding ERR_INVALID_TIMEZONE. Afkortingen van drie letters, zoals MST of EST, zijn geen IANA-identificatiecodes en worden niet geaccepteerd; gebruik in plaats daarvan de bijbehorende, op de regio gebaseerde identificatiecode (bijvoorbeeld America/Denver of America/New_York).

De taal leveren

De parameter timezone is niet de enige parameter die bepaalt hoe de API een antwoord opmaakt. Het eindpunt /printer-interventions accepteert tevens een optionele language-parameter, die de taal van het description-veld in het antwoord bepaalt.

De toegestane waarden zijn en (Engels), de (Duits), ja (Japans), it (Italiaans), fr (Frans) en es (Spaans). Een waarde die niet in deze lijst voorkomt, leidt tot een fout met de foutcode ERR_INVALID_LANGUAGE.

Er zijn twee aspecten van deze parameter waarmee u bij de planning rekening dient te houden:

Indien u de parameter weglaat, of indien er geen beschrijving beschikbaar is in de door u gevraagde taal, wordt de beschrijving in het Engels weergegeven. Het verzoek wordt in beide gevallen uitgevoerd, dus uw integratie mag er niet van uitgaan dat de taal van een beschrijving overeenkomt met de taal waarnaar is gevraagd.
Deze parameter is uitsluitend van invloed op het description-veld. Het bijbehorende veld interventionCode is taalonafhankelijk; maak daarom gebruik van dit veld wanneer u gebeurtenissen op een consistente manier wilt groeperen, vergelijken of opslaan, ongeacht de gevraagde taal.

Zomertijd en onduidelijke tijdsaanduidingen

Aangezien verzoeken en antwoorden worden uitgedrukt in lokale tijden, leiden de overgangen naar en van de zomertijd tot twee situaties waarmee u rekening dient te houden:

Overgeslagen lokale tijden tijdens de overgang naar de lente: Wanneer de klokken worden verzet, bestaat er één uur lokale tijd niet. In America/Denver is bijvoorbeeld op de dag van de overgang naar de zomertijd 02:30:00 geen geldige lokale tijd. Vermijd het gebruik van tijdstippen binnen het overgeslagen uur als startDateTime of endDateTime.
Herhaalde lokale tijden tijdens de overgang naar de herfst: Wanneer de klokken een uur achteruit worden gezet, komt er één uur lokale tijd twee keer voor. Een waarde zoals 01:30:00 op de dag van de overgang naar de herfst is dubbelzinnig. Kies tijdstippen buiten het herhaalde uur om onduidelijkheid te voorkomen over welke instantie u aanvraagt.

Indien uw integratie zonder toezicht wordt uitgevoerd en er een verzoek zou kunnen worden verzonden waarvan de start- of eindtijd binnen een overgang valt, plan het verzoek dan zo in dat het enkele uren vóór of na de overgang wordt uitgevoerd, of gebruik tijdstippen die duidelijk buiten de overgang vallen.

Aanbevelingen voor het opslaan en vergelijken van tijdstempels van reacties

De tijdstempels van de reacties zijn lokale tijden zonder verschuiving. Om onduidelijkheden in de daaropvolgende systemen te voorkomen, kunt u een van de volgende benaderingen overwegen:

Sla de tijdstempel van het antwoord op, samen met de tijdzone die u in het verzoek hebt opgegeven. Samen geven deze twee een uniek moment in de tijd weer.
Zorg er in uw integratie voor dat u elke tijdstempel van een antwoord omzet naar UTC voordat u deze opslaat, waarbij u de tijdzone gebruikt die u in het verzoek hebt opgegeven. Het opslaan van UTC-waarden vereenvoudigt het vergelijken van gegevens die in verschillende tijdzones zijn verzameld.
Dien verzoeken altijd in met dezelfde tijdzone, bijvoorbeeld UTC, zodat alle opgeslagen tijdstempels direct met elkaar te vergelijken zijn.

Voorbeelden

De volgende voorbeelden laten zien hoe de tijdzone, de starttijd en de eindtijd op elkaar zijn afgestemd.

Standaardvenster in Mountain Time: Een verzoek dat op 15 maart 2026 om 09.00 uur is ingediend, in de tijdzone America/Denver, zonder opgegeven begin- of eindtijd, levert gegevens op vanaf 2026-03-14T09:00:00 tot en met 2026-03-15T09:00:00, beide uitgedrukt in Mountain Time.
Specifiek tijdvak in Oost-Europese tijd: Een verzoek met de parameters timezone=Europe/Bucharest, startDateTime=2026-03-15T08:00:00, en endDateTime=2026-03-15T16:00:00, levert gegevens op voor de werkdag van acht uur in de lokale tijd van Boekarest. De tijdstempels van de reacties worden eveneens weergegeven in lokale tijd van Boekarest.
Hetzelfde venster weergegeven in twee tijdzones: Om dezelfde onderliggende gegevens tweemaal op te halen, opgemaakt voor twee doelgroepen, dient u twee verzoeken in te dienen met verschillende tijdzonewaarden en de parameters startDateTime en endDateTime zodanig aan te passen dat zij in elke tijdzone dezelfde tijdstippen aangeven. De antwoordpayloads beschrijven dezelfde gebeurtenissen, maar gebruiken verschillende tekenreeksen voor tijdstempels.

1.5.5 Velden in het antwoord van de gegevensexport-API

Elk eindpunt van de gegevensexport-API retourneert een JSON-array met objecten. Gebruik de tabellen in dit onderwerp om de velden in elk antwoord te interpreteren.

In deze referentie gehanteerde conventies

Alle tijdsduur wordt uitgedrukt in milliseconden.
Alle datum- en tijdwaarden worden weergegeven in de tijdzone die is opgegeven via de parameter timezone, volgens het patroon JJJJ-MM-DDTHH:MM:SS.sss.
Identificatievelden (printerId, jobId) blijven bij alle verzoeken hetzelfde en kunnen door geïntegreerde applicaties in de cache worden opgeslagen. De printerId verandert nooit, zodat waarden kunnen worden opgeslagen en gedurende meerdere sessies kunnen worden hergebruikt.

GET /printers – responsvelden

Het eindpunt /printers retourneert één object per printer die in het account is geïdentificeerd en door een data collector wordt bijgehouden.

Veld	Type	Beschrijving
`printerName`	tekenreeks	De weergavenaam die aan de printer is toegewezen in RICOH Predictive Insight.
`printerId`	tekenreeks (UUID)	De unieke identificatiecode van de printer. Gebruik deze waarde als de parameter `printerId` wanneer u de `/jobs`, `/printer-states` of `/printer-interventions` aanroept.
`engines`	integer	Het aantal afdrukmotoren in de printer. Printers voor continu-invoer kunnen één of meer printmodules hebben; printers voor losse vellen beschikken doorgaans over één printmodule. Elke motor wordt als een afzonderlijke rij weergegeven in de reacties op `/printer-states` en `/printer-interventions`.
`manufacturer`	tekenreeks	De fabrikant van de printer, bijvoorbeeld Ricoh of InfoPrint.
`model`	tekenreeks	Het printermodel zoals door het apparaat wordt aangegeven, bijvoorbeeld RICOH Pro VC80000.
`printerMode`	tekenreeks	Of de printer nu in de `simplex` of `duplex` modus werkt. Dit veld is afwezig bij printertypes waarvoor de waarde niet van toepassing is, zoals printers voor losse vellen.
`printerType`	tekenreeks	Of de printer papier in doorloopvorm ( `continuous_feed` ) of losse vellen ( `cut_sheet` ) ondersteunt.
`serialNumber`	tekenreeks	Het serienummer dat door de printer wordt weergegeven. Bij printers met meerdere printkoppen kunnen in dit veld de serienummers van elke printkop in één tekenreeks worden opgenomen, bijvoorbeeld Printer 1: 10-11111 en Printer 2: 10-11112.
`connectionStatus`	tekenreeks	Geeft aan of RICOH Predictive Insight momenteel verbinding kan maken met de printer. Mogelijke waarden zijn `connected` en `not_connected`.

GET /jobs-antwoordvelden

Het eindpunt /jobs retourneert één object per taak die door de opgegeven printers binnen het opgegeven tijdsbestek is verwerkt.

Veld	Type	Beschrijving
`printerId`	tekenreeks (UUID)	De identificatiecode van de printer die de taak heeft verwerkt. Is overeenkomend met een `printerId` uit het `/printers` -antwoord.
`jobId`	tekenreeks	De unieke identificatiecode van de taak.
`jobName`	tekenreeks	De naam van de taak zoals deze bij de drukker is ingediend; doorgaans de bestandsnaam van het bronbestand.
`jobPrintingSide`	tekenreeks	De zijde of zijden die voor deze taak worden bedrukt, bijvoorbeeld `enkelzijdig` of `dubbelzijdig`.
`jobAction`	tekenreeks	De status van de taak op het moment dat de aanvraag werd verwerkt. Mogelijke waarden: `printing`: de taak werd afgedrukt toen het verzoek werd verzonden. `printed`: de afdruktaak is succesvol voltooid. `aborted`: de taak is beëindigd voordat het afdrukken was voltooid. `completed`: de taak heeft de eindstatus bereikt. Deze waarde vormt een bovenliggende verzameling die zowel `afgedrukte` als `afgebroken` taken omvat. Gebruik deze optie wanneer u alle taken wilt ophalen die niet langer actief zijn, ongeacht de uitkomst.
`jobStartTime`	tekenreeks (datum en tijd)	De lokale datum en tijd waarop de taak is begonnen met afdrukken, in de tijdzone die in het verzoek is opgegeven.
`jobEndTime`	tekenreeks (datum en tijd)	De lokale datum en tijd waarop de taak is voltooid, in de tijdzone die in de aanvraag is opgegeven.
`jobDuration`	integer	De verstreken afdruktijd voor de taak, in milliseconden.
`printedCopies`	integer	Het aantal exemplaren dat van de taken is geproduceerd.
`printedPages`	integer	Het totale aantal logische pagina’s dat voor de taak is afgedrukt, inclusief alle exemplaren.
`printedImpressions`	integer	Het totale aantal gedrukte exemplaren. Een afdruk is één zijde van één vel; bij een dubbelzijdige afdrukopdracht worden dus twee afdrukken per vel geproduceerd.
`printedSheets`	integer	Het totale aantal fysieke vellen dat voor deze taak is gebruikt.
`printedRollFeet`	number	Voor printers met doorloopvoeding: de lengte van het door de taak verbruikte drukmedium, in feet.
`printedRollMeters`	number	Voor printers met doorvoer: de lengte van het medium dat voor de taak wordt verbruikt, in meters.
`inkC, inkM, inkY, inkK`	number	De hoeveelheid cyaan-, magenta-, gele en zwarte inkt die door de opdracht is verbruikt, uitgedrukt per kleurkanaal in kubieke centimeter (cc).
`flushingC, flushingM, flushingY, flushingK`	number	De hoeveelheid cyaan-, magenta-, gele en zwarte inkt die is verbruikt tijdens het spoelen van de printkop in verband met de opdracht, weergegeven per kleurkanaal in kubieke centimeter (cc). De spoelwaarden worden apart bijgehouden van de `inkt (C/M/Y/K)`, zodat een onderscheid kan worden gemaakt tussen productief inktverbruik en onderhoudsverbruik.

GET /printer-states - responsvelden

Het eindpunt /printer-states retourneert één object per printerengine, per statusinterval. Welke velden aanwezig zijn, hangt af van de verzoekmodus:

Geaggregeerde geschiedenis (standaard): alle velden worden weergegeven.
Alleen de huidige status (currentState=true): printerStateDuration, historyStartTime en historyEndTime worden weggelaten.
Alleen statuscategorie (stateCategoryOnly=true): printerState wordt weggelaten.

Veld	Type	Beschrijving
`printerId`	tekenreeks (UUID)	De identificatiecode van de printer waarop deze rij betrekking heeft. Is overeenkomend met een `printerId` uit het `/printers` -antwoord.
`engine`	tekenreeks	De motor in de printer die in deze rij wordt beschreven, bijvoorbeeld `engine_1`, `engine_2` of `engine_3`. Een printer met meerdere printkoppen geeft per statusinterval één rij per printkop weer.
`stateCategory`	tekenreeks	De overkoepelende categorie waarnaar de motortoestand wordt samengevat. Mogelijke waarden zijn `up`, `down`, `idle` en `unknown`. Gebruik dit veld voor dashboards en rapportages waarbij voor alle printermodellen dezelfde categorieën moeten worden gebruikt.
`printerState`	tekenreeks	De door de printermotor gerapporteerde ruwe status, zoals Afdrukken, Voorbereiden, Onderhoud of Slaapstand. De onbewerkte statuswaarden verschillen per printermodel. Wordt weggelaten wanneer `stateCategoryOnly=true`. Opmerking: Zie Printertoestanden en toestandscategorieën voor een volledige lijst van staten en de bijbehorende toewijzingen.
`printerStateDuration`	integer	De tijd dat de motor in deze toestand verbleef, uitgedrukt in milliseconden. Wordt weggelaten wanneer `currentState=true`.
`historyStartTime`	tekenreeks (datum en tijd)	De lokale datum en tijd waarop de engine in deze toestand is gekomen, in de tijdzone die in het verzoek is opgegeven. Wordt weggelaten wanneer `currentState=true`.
`historyEndTime`	tekenreeks (datum en tijd)	De lokale datum en tijd waarop de engine deze status heeft verlaten, in de tijdzone die in het verzoek is opgegeven. Voor het meest recente interval in een geaggregeerd antwoord kan deze waarde gelijk zijn aan het einde van het opgevraagde tijdsbereik. Wordt weggelaten wanneer `currentState=true`.

GET /printer-interventions - responsvelden

Het eindpunt /printer-interventions retourneert één object per interventiegebeurtenis, voor elke printermotor van elke opgevraagde printer, binnen het opgegeven tijdsbereik.

Veld	Type	Beschrijving
`printerId`	tekenreeks (UUID)	De identificatiecode van de printer waarop deze rij betrekking heeft. Is overeenkomend met een `printerId` uit het `/printers` -antwoord.
`interventionStartDate`	tekenreeks (datum en tijd)	De lokale datum en tijd waarop de gebeurtenis begon, in de tijdzone die in het verzoek is opgegeven.
`interventionEndDate`	tekenreeks (datum en tijd)	De lokale datum en tijd waarop het voorval is opgelost, in de tijdzone die in het verzoek is opgegeven.
`duration`	integer	De duur van de gebeurtenis, uitgedrukt in milliseconden.
`description`	tekenreeks	Een korte beschrijving van de voorwaarde die aanleiding gaf tot de waarschuwing of foutmelding, bijvoorbeeld Geen media of Papierstoring. Dit veld is taalafhankelijk: het wordt weergegeven in de taal die via de `language`-parameter is opgegeven, of in het Engels indien die parameter is weggelaten of de beschrijving niet beschikbaar is in de opgegeven taal.
`engine`	tekenreeks	De motor in de printer die in deze rij wordt beschreven, bijvoorbeeld `engine_1`, `engine_2` of `engine_3`. Een printer met meerdere motoren retourneert voor elke gebeurtenis één rij per motor.
`jobName`	tekenreeks	De naam van de taak die op dat moment werd afgedrukt toen de gebeurtenis plaatsvond. De waarde is een lege tekenreeks wanneer er geen taak bij de gebeurtenis betrokken was.
`interventionCode`	tekenreeks	Een code die de voorwaarde aanduidt. In tegenstelling tot de `description` is deze waarde taalonafhankelijk; gebruik deze daarom wanneer u gebeurtenissen over verschillende talen heen wilt groeperen of vergelijken. De indeling van de code is afhankelijk van de printer: printers voor losse vellen geven een beschrijvende tekenreeks weer, zoals `coverOpen`, terwijl printers voor doorlooppapier een waarde weergeven, zoals `CA00` of `40000006`.

1.5.5.1 Printertoestanden en toestandscategorieën

Het eindpunt /printer-states geeft zowel de ruwe status van de printer als een algemene statuscategorie weer. Gebruik de tabellen in dit onderwerp om te begrijpen welke ruwe statussen in welke categorieën worden ondergebracht.

Over de statussen en categorieën van printers

Voor elke printerengine rapporteert de gegevensexport-API twee gerelateerde waarden:

printerState: De door de printermotor gemelde huidige bedrijfsstatus, zoals afdrukken, slaapstand of onderhoud. De reeks onbewerkte statussen verschilt per printermodel.
stateCategory: Een groepering op hoog niveau die de ruwe status classificeert als up, down, idle of unknown. De categorieën zijn voor alle printermodellen hetzelfde; daarom vormen zij de betere keuze voor dashboards en rapporten waarin gegevens van meerdere printers worden samengevoegd.

De categorie-indelingen worden vastgesteld via RICOH Predictive Insight en gelden uniform voor elke printer die gegevens rapporteert via de gegevensexport-API.

In de noordelijke staten

Een motor wordt als up gemeld wanneer deze actief vermogen levert of zich actief voorbereidt om vermogen te leveren. Gebruik deze categorie om de productieve bedrijfstijd te meten.

Oorspronkelijke status van de printer	Beschrijving
`feeding`	De machine voert drukmateriaal aan ter voorbereiding op het afdrukken.
`initializing`	De motor wordt opgestart als onderdeel van het starten van een afdruktaak.
`preparing`	De printer bereidt zich voor op het afdrukken, bijvoorbeeld door opdrachtgegevens te laden of onderdelen op te warmen voor een aanstaande taak.
`printing`	De motor is aan het draaien.
`processing`	De engine verwerkt gegevens over taken.
`receiving`	De engine ontvangt een taak van de afdrukserver.

Down-statussen

Een motor wordt als down gemeld wanneer deze niet kan afdrukken en er een ingreep door de operator of de onderhoudsdienst, onderhoud of herstelwerkzaamheden nodig zijn of momenteel in voortgang zijn. Gebruik deze categorie om ongeplande en geplande stilstand te meten.

Oorspronkelijke status van de printer	Beschrijving
`adjusting`	De printer voert momenteel een afstelprocedure uit, waardoor er niet kan worden afgedrukt.
`calibrating`	De printer is bezig met het kalibreren, bijvoorbeeld voor kleur of registratie.
`cleaning`	De motor voert momenteel een reinigingsprocedure uit.
`disconnected`	De motor heeft de verbinding met RICOH Predictive Insight verloren.
`error`	De printer heeft een voorwaarde weergegeven waardoor afdrukken niet mogelijk is.
`maintenance`	De motor voert momenteel een onderhoudsbewerking uit.
`not available`	De motor is bereikbaar, maar kan op dit moment geen werk aannemen.
`pre/post busy`	Een aan de motor gekoppeld voor- of nabewerkingsapparaat is bezig en blokkeert het afdrukken.
`pre/post eof`	Een voor- of nabewerkingsapparaat heeft de voorwaarde ‘einde vel’ bereikt, waardoor het afdrukken wordt geblokkeerd.
`pre/post paused`	Een voor- of nabewerkingsapparaat is gepauzeerd en belemmert het afdrukken.
`pre/post threading`	Een voor- of nabewerkingsapparaat raakt verstrikt in het drukmateriaal en belemmert het afdrukken.
`rebooting`	De motor wordt opnieuw opgestart.
`recirculation`	De motor zorgt voor de recirculatie van de inkt.
`restart`	De motor voldoet aan de voorwaarde om opnieuw te worden gestart.
`restarting`	De motor wordt opnieuw gestart.

Rusttoestanden

Een motor wordt als idle aangemerkt wanneer deze operationeel is en in staat is om af te drukken, maar op dat moment geen uitvoer produceert. Gebruik deze categorie om de beschikbare capaciteit te meten.

Oorspronkelijke status van de printer	Beschrijving
`checking`	De motor voert een routinecontrole uit die het werk niet hindert.
`idle`	De motor is operationeel en staat klaar om ingezet te worden.
`not ready`	De motor is operationeel, maar bevindt zich momenteel niet in een staat waarin hij klaar is om te worden afgedrukt.
`pre/post not ready`	Een voor- of nabehandelingsapparaat is nog niet gereed, maar de motor zelf is operationeel.
`ready`	De printer is gereed om een taak te ontvangen en af te drukken.
`shutdown`	De motor is uitgeschakeld.
`shutting down`	De motor wordt momenteel uitgeschakeld.
`sleeping`	De motor bevindt zich in een energiezuinige slaapstand.
`start-up`	De motor bevindt zich in de opstartfase.
`started`	De motor heeft de startprocedure voltooid.
`starting`	De motor start.
`stopping`	De motor loopt uit, maar is nog niet volledig uitgeschakeld.
`warming`	De motor is aan het opwarmen.

Onbekend

De categorie unknown wordt gemeld wanneer RICOH Predictive Insight geen categorie voor de ruwe status kan vaststellen, bijvoorbeeld omdat de waarde van de ruwe status niet wordt herkend. Indien uw toepassing regelmatig unknown categorieën tegenkomt, neem dan contact op met uw vertegenwoordiger van om te controleren of uw printer de verwachte statuswaarden doorgeeft.

1.5.5.2 Omgaan met responslimieten van de gegevensexport-API

De gegevensexport-API voert geen paginering van de antwoorden uit. Indien een verzoek meer gegevens zou opleveren dan de API in één enkel antwoord toestaat, mislukt het verzoek met een foutmelding in plaats van dat er een gedeeltelijk resultaat wordt teruggegeven. Plan uw integraties zodanig dat u binnen de limieten blijft door de datumperiode te beperken, het aantal printers per verzoek te verminderen, of beide.

Wat de grenzen zijn

Er gelden twee soorten beperkingen voor verzoeken waarin een datumbereik is opgenomen:

Maximale datumperiode: Indien het tijdsbestek tussen startDateTime en endDateTime langer is dan zeven dagen, retourneert de API een 400-antwoord met de foutcode ERR_DATE_RANGE_EXCEEDED. Verminder de omvang van het gevraagde tijdvenster en dien het verzoek opnieuw in.
Maximale grootte van het antwoord: De maximaal ondersteunde grootte van een responsbestand is 6 MB, wat ruim voldoende zou moeten zijn om de gegevens van bijna 10.000 taken te bevatten. Indien de gegevens die overeenkomen met een verzoek de maximale responsgrootte zouden overschrijden, retourneert de API een 413-respons met de foutcode ERR_RESPONSE_LIMIT_EXCEEDED. De inhoud van het antwoord bevat een maxJobs-waarde die de geldende limiet aangeeft. Om het probleem op te lossen, kunt u de datumperiode beperken, minder printers aanvragen of beide, en de aanvraag vervolgens opnieuw indienen.

Verzoeken om binnen de gestelde grenzen te blijven

Om een integratie te ontwerpen die betrouwbaar binnen de responslimieten blijft, dient u rekening te houden met de volgende factoren:

Aantal taken per printer. Een printer met hoge doorvoercapaciteit en continue invoer kan veel meer taken per uur verwerken dan een printer voor losse vellen met een laag volume. Als u beide typen in uw machinepark combineert, bepalen de printers met een hoog printvolume hoe kort uw tijdsvensters moeten zijn.
Aantal printers per aanvraag. Elk verzoek kan meerdere printerId -waarden bevatten. Het is handig om meerdere printers in één verzoek samen te voegen, maar elke extra printer vergroot de omvang van het antwoord en de kans dat de limiet wordt overschreden.
Tijdstip van de dag. Indien uw bedrijf in ploegen werkt, concentreren de taken en statuswijzigingen zich op bepaalde uren. Een periode van 24 uur kan zeer uiteenlopende volumes opleveren, afhankelijk van het tijdstip waarop die 24 uur beginnen en eindigen.
Aantal toegestane herpogingen. Indien een verzoek mislukt met de foutcode ERR_RESPONSE_LIMIT_EXCEEDED, dient uw integratie het verzoek op te splitsen en het opnieuw te proberen. Het ontwerpen met het oog op kleinere vensters is doorgaans minder complex dan het implementeren van dynamische verdeling.

Aanbevolen patronen

De volgende patronen zijn geschikt voor veelvoorkomende integratiescenario’s:

Nachtelijk overzicht voor rapportage: Voer één keer per dag een geplande taak uit waarbij de gegevens van de afgelopen 24 uur worden opgevraagd, printer voor printer. Dit patroon is eenvoudig te implementeren, kan bij een mislukking gemakkelijk opnieuw worden uitgevoerd en zorgt ervoor dat elk antwoord kort blijft. Verwerk de antwoorden per printer in uw vervolgproces.
Uurlijkse gegevensopname voor dashboards die bijna in realtime werken: Voer één keer per uur een geplande taak uit waarmee in één verzoek de gegevens van het voorgaande uur voor alle printers worden opgevraagd. Door het gebruik van uurvensterperioden blijven de responsgroottes beperkt, zelfs bij drukkers met een hoog drukvolume. Indien u over een groot wagenpark beschikt, verzoekt u erom de printers in groepen aan te vragen in plaats van allemaal tegelijk.
Achteraf invoeren van historische gegevens: Om een datawarehouse te vullen met historische gegevens, doorloopt u het tijdsbereik in vensters van vaste grootte (bijvoorbeeld zes uur per verzoek) en uw printers in kleine groepen. Verwerk één venster tegelijk en sla de resultaten op voordat u naar het volgende venster gaat. Indien een venster de foutmelding ERR_RESPONSE_LIMIT_EXCEEDED weergeeft, verdeel dat venster dan in twee gelijke delen en probeer het opnieuw met beide delen.
Huidige status van de printer ten behoeve van de bewaking: Om de huidige status van elke printer in uw printerpark te controleren zonder de geschiedenis op te halen, roept u /printer-states aan met currentState=true. Het antwoord bevat één rij per motor en wordt niet beïnvloed door de datumperiode, zodat één enkel verzoek de gehele vloot kan omvatten.

Omgaan met fouten in verband met responslimieten in uw integratie

Wanneer u een 413-antwoord ontvangt met de foutcode ERR_RESPONSE_LIMIT_EXCEEDED, voer dan een of meer van de volgende handelingen uit voordat u het verzoek opnieuw probeert:

Verkort het tijdsvenster. Het venster in tweeën splitsen is een betrouwbare strategie; als het gehalveerde verzoek nog steeds mislukt, splitst u het opnieuw.
Verminder het aantal printerId -waarden in het verzoek. Indien één printer verantwoordelijk is voor het grootste deel van het printvolume, dient u die printer afzonderlijk aan te vragen.
Indien het verzoek betrekking heeft op een actueel momentopname in plaats van op een historisch overzicht, gebruikt u currentState=true op /printer-states om het door datumbereiken bepaalde volume volledig te vermijden.

Probeer hetzelfde verzoek niet opnieuw uit te voeren zonder de parameters te wijzigen. De API levert geen gedeeltelijke resultaten op, dus een herhalingspoging zonder aanpassingen zal opnieuw mislukken.

1.5.6 Voorbeelden van verzoeken en antwoorden voor de gegevensexport-API

Gebruik de voorbeelden in dit onderwerp als uitgangspunt voor uw eigen integratie. Elk voorbeeld toont een representatieve aanvraag-URL, samen met de inhoud van het antwoord dat de API retourneert.

Over deze voorbeelden

In de voorbeelden worden tijdelijke API-sleutels en printer-ID’s gebruikt. Vul bij het aanpassen de waarden in die voor uw eigen omgeving gelden.
In de voorbeelden wordt de hostnaam voor de Verenigde Staten en Japan gebruikt. Indien uw account in Europa wordt gehost, gebruikt u in plaats daarvan rpi-data-export.app-ricohsoftware.eu.
Datum- en tijdwaarden worden weergegeven als lokale tijden in de tijdzone die bij het verzoek is opgegeven, volgens het patroon JJJJ-MM-DDTHH:MM:SS.sss.
Alle tijdsduur wordt uitgedrukt in milliseconden. Alle waarden voor inkt en spoelen worden uitgedrukt in kubieke centimeter (cc).
De voorbeelden dienen ter verduidelijking. Cijfergegevens zoals inktverbruik, paginatellingen en looptijden zijn representatieve bedrijfsgegevens, en geen metingen van een specifieke printer.

GET /printers

Haal de printers op die beschikbaar zijn voor de opgegeven API-sleutel. Het eindpunt heeft geen parameters.

Aanvraag:

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

Antwoord (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

Haal de taken die door één of meer printers binnen een bepaald tijdsbestek zijn verwerkt, op. In dit voorbeeld wordt een verzoek ingediend voor één printer gedurende een periode van acht uur volgens de lokale tijd in America/Denver, waarbij alleen taken worden meegenomen die met succes zijn voltooid.

Aanvraag:

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

Antwoord (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
  }
]

Een lege array ([]) is een geldig antwoord en betekent dat er geen overeenkomende taken zijn gevonden.

GET /printer-states (geaggregeerde geschiedenis)

De standaardresponsmodus levert één rij per statusinterval per motor op, met velden voor de volledige duur en de geschiedenis. In het voorbeeld wordt een tijdsvenster van vier uur aangevraagd voor één printer.

Aanvraag:

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

Antwoord (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 (alleen de huidige status)

Wanneer u currentState=true instelt, bevat het antwoord één rij per motor met de huidige status. De velden „Duur” en „Geschiedenis” worden weggelaten.

Aanvraag:

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

Antwoord (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 (alleen de categorie ‘status’)

Wanneer u stateCategoryOnly=true instelt, wordt het ruwe printerState-veld in het antwoord weggelaten en wordt alleen de categorie op hoog niveau weergegeven. De velden ‘Duur’ en ‘Geschiedenis’ blijven behouden.

Aanvraag:

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

Antwoord (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-ingrepen

Haal de interventiegebeurtenissen op die zich binnen een bepaald tijdsbestek op één of meer printers hebben voorgedaan. In het voorbeeld wordt een tijdsbestek van vier uur aangevraagd voor één printer en wordt gevraagd om gebeurtenisbeschrijvingen in het Engels. Aangezien de printer in dit voorbeeld een model met doorloopvoeding is, hanteren de waarden van de interventionCode het formaat voor doorloopvoeding.

Aanvraag:

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

Antwoord (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"
  }
]

Bij de eerste twee vermeldingen is het veld jobName leeg, wat betekent dat er bij de gebeurtenis geen taak betrokken was. De derde vermelding vond plaats terwijl een taak werd afgedrukt; daarom wordt de naam van de taak vermeld.

Voorbeelden van foutmeldingen

Elke foutmelding heeft dezelfde structuur: een JSON-object met een code, een message en een numerieke statusCode. Er is een opmerking gemaakt over het feit dat sommige foutcodes extra velden bevatten.

400 Ongeldige aanvraag — ongeldige tijdzone:

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

400 Ongeldige aanvraag — vereiste parameter ontbreekt:

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

400 Ongeldige aanvraag — het datumbereik overschrijdt de maximaal toegestane waarde:

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

400 Ongeldige aanvraag — ongeldige taal:

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

401 Niet geautoriseerd — ongeldige API-sleutel:

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

403 Toegang geweigerd — het verzoek betreft een printer waartoe de API-sleutel geen toegang heeft:

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

413 Payload te groot — het antwoord zou de maximale grootte overschrijden:

{
  "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 Interne serverfout:

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

1.5.7 Problemen met de gegevensexport-API oplossen

Gebruik dit onderwerp om veelvoorkomende foutmeldingen van de gegevensexport-API te interpreteren en voor elke fout de meest waarschijnlijke oorzaak en oplossing te achterhalen. Elke foutmelding bevat een code, een message en een numerieke statusCode; de waarde van de code geeft de specifieke voorwaarde aan.

Fouten bij authenticatie en autorisatie

Foutcode	Waarschijnlijke oorzaak	Wat u kunt proberen
`ERR_INVALID_APIKEY` (401)	De `x-api-key` koptekst ontbreekt, is onjuist opgebouwd, is verlopen of is verwijderd. Dit treedt ook kortstondig op (doorgaans minder dan één minuut) onmiddellijk nadat een sleutel is aangemaakt of gewijzigd, voordat de nieuwe sleutel wordt geregistreerd.	Controleer of het verzoek de koptekst `x-api-key` bevat met de volledige waarde van de API-sleutel. Controleer in Account Administration of de sleutel nog steeds bestaat en niet is verlopen. Indien de sleutel zojuist is aangemaakt of vernieuwd, wacht dan één minuut en probeer het opnieuw.
`ERR_UNAUTHORIZED_PRINTERS` (403)	Het verzoek bevat één of meer `printerId` -waarden waartoe de API-sleutel geen toegang heeft.	Roep `/printers` met dezelfde API-sleutel aan om precies te zien welke printers beschikbaar zijn, en dien het verzoek vervolgens opnieuw in met uitsluitend die printer-ID’s.
`ERR_TENANT_NOT_FOUND` (404)	De API-sleutel wordt herkend, maar is niet gekoppeld aan een actief account. Dit kan gebeuren als een account is verwijderd of onjuist is geconfigureerd.	Neem contact op met uw RICOH-accountmanager om te controleren of uw tenant actief is en of de API-sleutel daaraan is gekoppeld.

Fouten bij de validatie van parameters (400 Ongeldig verzoek)

Elke fout bij de validatie van een parameter levert een 400-statuscode op. De codewaarde geeft het specifieke probleem aan.

Foutcode	Waarschijnlijke oorzaak	Wat u kunt proberen
`ERR_MISSING_PRINTER_ID`	Het verzoek bevatte geen `printerId` -waarden. Er is ten minste één vereist voor `/jobs`, `/printer-states` en `/printer-interventions`.	Toevoeg ten minste één queryparameter `printerId` toe. Herhaal de parameter om meerdere printers op te nemen.
`ERR_INVALID_PRINTER_ID_FORMAT`	De waarde van `printerId` is geen geldige UUID.	Controleer of de waarde overeenkomt met het antwoord van `/printers`. Veelvoorkomende fouten zijn onder meer extra witruimte, ontbrekende tekens of het invoegen van de naam van de printer in plaats van het printer-ID.
`ERR_INVALID_TIMEZONE`	De `timezone`-waarde ontbreekt of is geen geldige IANA-tijdzone-identificatie.	Gebruik een op regio gebaseerde identificatiecode, zoals `America/Denver` of `Europe/Bucharest`. Afkortingen van drie letters, zoals `MST` of `EST`, worden niet geaccepteerd. Op de interactieve documentatiepagina is een lijst met alle toegestane waarden te vinden.
`ERR_INVALID_DATE_FORMAT`	De waarde van `startDateTime` of `endDateTime` is niet overeenkomend met de verwachte notatie.	Gebruik de notatie `JJJJ-MM-DDTHH:MM:SS`, eventueel met het achtervoegsel `.sss` voor milliseconden. Vermeld geen UTC-verschuiving of het achtervoegsel `Z`; de tijdzone wordt afzonderlijk opgegeven in de parameter `tijdzone`.
`ERR_INVALID_DATE_RANGE`	`startDateTime` is gelijk aan of later dan `endDateTime`.	Controleer of `startDateTime` vroeger is dan `endDateTime` in de opgegeven tijdzone.
`ERR_DATE_RANGE_EXCEEDED`	De periode tussen `startDateTime` en `endDateTime` overschrijdt het maximaal toegestane bereik.	Verminder de omvang van het gevraagde tijdvenster. Zie Omgaan met responslimieten van de gegevensexport-API voor richtlijnen inzake chunking.
`ERR_INVALID_JOB_STATE`	De waarde van `jobState` is geen van de toegestane waarden.	Gebruik een van de volgende termen: `wordt afgedrukt`, `afgedrukt`, `afgebroken` of `voltooid`. Opmerking: onder `completed` vallen zowel `printed` als `aborted` taken.
`ERR_INVALID_STATE_CATEGORY`	De waarde van `stateCategory` behoort niet tot de toegestane waarden.	Kies een van de volgende opties: `up`, `down` of `idle`.
`ERR_INVALID_LANGUAGE`	De `language`-waarde die aan `/printer-interventions` is doorgegeven, behoort niet tot de toegestane waarden.	Gebruik een van de volgende talen: `en`, `de`, `ja`, `it`, `fr` of `es`. Deze foutmelding betekent dat de code zelf is afgewezen; een code die wel wordt geaccepteerd maar waarvoor geen vertaling voor een bepaalde omschrijving beschikbaar is, leidt niet tot een fout, omdat de API die omschrijving in plaats daarvan in het Engels retourneert.
`ERR_INVALID_BOOLEAN_PARAM`	De parameter `currentState` of `stateCategoryOnly` heeft een andere waarde dan `true` of `false`.	Gebruik de letterlijke tekenreeksen `true` of `false` in kleine letters.
`ERR_UNKNOWN_PARAMETERS`	Het verzoek bevat een of meer parameters die het eindpunt niet accepteert.	Vergelijk het verzoek met de lijst met parameters voor het eindpunt in de interactieve documentatie. Veelvoorkomende oorzaken zijn onder meer typefouten, parameters die voor een ander eindpunt zijn bedoeld, of extra trackingparameters die door een HTTP-client zijn toegevoegd.
`ERR_DUPLICATE_PARAMETERS`	Dezelfde parameter wordt meer dan eens doorgegeven en het eindpunt accepteert geen duplicaten voor die parameter.	Controleer de lijst met parameters. De parameter `printerId` mag herhaald worden (één keer per printer); andere parameters mogen maximaal één keer voorkomen.
`ERR_EMPTY_PARAMETERS`	Er is een verplichte parameter aanwezig, maar deze heeft geen waarde.	Controleer of elke verplichte parameter een niet-lege waarde heeft.
`ERR_INVALID_TENANT_ID`	De tenant-ID die aan de API-sleutel is gekoppeld, is ongeldig.	Neem contact op met uw Ricoh-accountmanager.

Fouten in de omvang van de respons en de onderzoeksmethode

Foutcode	Waarschijnlijke oorzaak	Wat u kunt proberen
`ERR_RESPONSE_LIMIT_EXCEEDED` (413)	De gegevens die overeenkomen met de aanvraag, zouden de maximale responsgrootte overschrijden. De responstekst bevat een veld `maxJobs` dat de geldende limiet aangeeft.	Beperk de datumperiode, vraag minder printers aan, of doe beide, en dien de aanvraag opnieuw in. Zie Omgaan met responslimieten van de gegevensexport-API voor aanbevolen patronen voor het opdelen in blokken.
`ERR_UNSUPPORTED_METHOD` (405)	Bij het verzoek werd een andere HTTP-methode dan `GET` gebruikt.	De gegevensexport-API ondersteunt uitsluitend de `GET` -methode. Werk uw client bij zodat deze `GET` gebruikt.

Serverfouten (500 Interne serverfout)

500 reacties duiden op een onverwachte voorwaarde op de server. Herhalingspogingen zijn veilig omdat elk eindpunt van de gegevensexport-API een GET-verzoek is en geen neveneffecten veroorzaakt. Wacht enkele seconden voordat u het opnieuw probeert, en pas exponentiële backoff toe als de fout blijft optreden.

Foutcode	Waarschijnlijke oorzaak	Wat u kunt proberen
`ERR_INTERNAL_SERVER_ERROR`	Er heeft zich een onverwachte voorwaarde op de server voorgedaan.	Wacht enkele seconden en probeer het opnieuw. Mocht de fout langer dan enkele minuten aanhouden, neem dan contact op met uw Ricoh-accountmanager.
`ERR_TENANT_CHECK_FAILED`	De server kon de tenant die aan de API-sleutel is gekoppeld, niet verifiëren.	Wacht enkele seconden en probeer het opnieuw. Mocht de fout blijven bestaan, neem dan contact op met uw RICOH-accountmanager.
`ERR_PRINTERS_FETCH_FAILED`	De server kon de lijst met printers voor de tenant niet ophalen.	Wacht enkele seconden en probeer het opnieuw. Mocht de fout blijven bestaan, neem dan contact op met uw RICOH-accountmanager.
`ERR_PRINTER_STATES_FETCH_FAILED`	De server kon de gegevens over de status van de printer voor het verzoek niet ophalen.	Wacht enkele seconden en probeer het opnieuw. Mocht de fout blijven bestaan, neem dan contact op met uw RICOH-accountmanager.

Overige symptomen

Het antwoord is leeg ([]), maar u verwacht gegevens: Een lege array betekent dat er geen overeenkomende records zijn gevonden. Controleer het tijdsbestek (de API geeft alleen gegevens van de afgelopen zeven dagen weer), de tijdzone, de printerId-waarden en eventuele filters, zoals JobState of stateCategory.
De datum- en tijdwaarden in het antwoord zijn niet-overeenkomend met wat u had verwacht: De tijdstempels van de reacties zijn lokale tijden in de tijdzone die bij het verzoek is opgegeven. Wanneer u hetzelfde verzoek indient met een andere tijdzonewaarde, worden er verschillende tijdstempelstekenreeksen gegenereerd, ook al hebben deze betrekking op dezelfde gebeurtenissen. Zie Verwerking van datum en tijd in de gegevensexport-API.
Er ontbreekt een printer in het antwoord van /printers: De API geeft uitsluitend printers weer die door een data collector worden gemonitord. Indien een printer ontbreekt, controleer dan of deze bij een data collector is geregistreerd en momenteel heeft hij een verbinding.
Een reactie van de printerstatus bevat unknown categorieën: Een unknown categorie geeft aan dat de ruwe status van de printer niet kon worden ingedeeld. Zie Printertoestanden en toestandscategorieën voor het volledige overzicht van de koppeling tussen staten en categorieën.

1.6 RICOH Cloud Connector

RICOH Cloud Connector is een lokale systeemtoepassing die een beveiligde verbinding biedt met RICOH TotalFlow Cloud. Het helpt bij het registreren van producten en beheert, indien nodig, de communicatie met de RICOH TotalFlow Cloud-toepassingen.

Opmerking:

Als u het RICOH InfoPrint Manager-abonnement gebruikt, wordt RICOH Cloud Connector automatisch met het product geïnstalleerd. Wanneer u RICOH InfoPrint Manager verwijdert, wordt RICOH Cloud Connector automatisch ook verwijderd.
U hoeft RICOH Cloud Connector niet te installeren om RICOH Predictive Insight te gebruiken.

U kunt RICOH Cloud Connector installeren op de volgende besturingssystemen:

In Windows:
- Microsoft Windows 10 Pro/Enterprise
- Microsoft Windows 11 Pro
- Microsoft Windows Server 2019 Standard
- Microsoft Windows Server 2022 Standard
Op 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

Opmerking:

Dit zijn de nieuwste versies die getest zijn met RICOH Cloud Connector, maar u kunt ook latere versies van deze besturingssystemen gebruiken.
Deze besturingssystemen en hun updates worden ondersteund zolang de fabrikant ondersteuning blijft bieden aan hun klanten onder standaardovereenkomsten, met uitzondering van uitgebreide ondersteuning.

Voor de installatie van RICOH Cloud Connector is ten minste 1,1 GB aan vrije ruimte vereist.

1.6.1 RICOH Cloud Connector wordt gedownload

U kunt de nieuwste versie van RICOH Cloud Connector downloaden van Abonnementen of het tabblad Connectors in RICOH Account Administration. Download het pakket op de server waar u de toepassing wilt installeren.

Voordat u Cloud Connector downloadt, moet u ervoor zorgen dat aan deze voorwaarden is voldaan:

De instellingspagina voor Cloud Connector wordt geopend in een webbrowser. Zorg ervoor dat op het systeem de nieuwste versies van een van deze browsers zijn geïnstalleerd:
- Mozilla Firefox
- Google Chrome
- Microsoft Edge
U hebt schrijfrechten op de standaardinstallatielocatie:
- %ProgramData%\RICOH\Cloud Connector\ voor Windows, of
- /opt/RICOH/RCC/ voor Linux.
Als u een ander installatiepad kiest, moet u controleren of dit pad bestaat en dat u er schrijfrechten voor hebt. Als de map bestaat, moet deze leeg zijn.

RICOH Cloud Connector downloaden:

Log als beheerder in op de server waarop u Cloud Connector wilt installeren.
Log in op RICOH TotalFlow Cloud als gebruiker met toegang tot RICOH Account Administration.
Klik in RICOH Account Administration in het linkerdeelvenster op Abonnementen.
U ziet het tabblad Abonnementen en de koppelingen voor het downloaden van het pakket RICOH Cloud Connector.
Klik op Downloaden voor Windows of Downloaden voor Linux, afhankelijk van het besturingssysteem.
Sla het installatiepakket op in een locatie waar u schrijf- en uitvoeringsrechten hebt. Op Linux downloadt u een archief met de naam ricoh-cloud-connector-linux.gz, dat het uitvoerbare bestand bevat.
De naam van het gedownloade bestand is:
- Op Windows: ricoh-cloud-connector-win.exe
- Op Linux: ricoh-cloud-connector-linux.gz

1.6.2 Installeren of bijwerken

Nadat u de huidige versie van RICOH Cloud Connector hebt gedownload, installeert u deze op de server die u hebt geïdentificeerd.

Opmerking:

Als u de installatiebestanden naar een andere computer hebt gedownload, kopieert u de bestanden naar het systeem waarop u het programma wilt installeren.
Controleer of er voldoende ruimte op de schijf beschikbaar is. Voor de installatie van RICOH Cloud Connector is ten minste 1,1 GB aan vrije ruimte vereist.

RICOH Cloud Connector installeren of bijwerken:

Log in op de computer waar u het installatiebestand van RICOH Cloud Connector hebt gedownload als beheerder.
In een Linux-systeem moet u inloggen met een gebruikersaccount dat lees- en schrijfrechten heeft op de volgende mappen:
- /var
- /etc
- /usr
- /opt
U hebt ook toestemming nodig om het uitvoerbare bestand van RICOH Cloud Connector dat u hebt gedownload uit te voeren.
Installatie op Linux: zoek ricoh-cloud-connector-linux.gz en dubbelklik erop om de installatiebestanden uit te pakken.

Belangrijk: Onder de uitgepakte bestanden zou u het uitvoerbare bestand van het installatieprogramma moeten zien, met de naam ricoh-cloud-connector-linux. Controleer of het bestand kan worden uitgevoerd als uitvoerbaar bestand. Volg de procedure voor uw Linux-versie om het bestand uitvoerbaar te maken.
Zoek en dubbelklik op het uitvoerbare bestand van het installatieprogramma van RICOH Cloud Connector.
De naam van het uitvoerbare bestand is:
- Op Windows: ricoh-cloud-connector-win.exe
- Op Linux: ricoh-cloud-connector-linux
Als u RICOH Cloud Connector voor de eerste keer installeert, wordt de pagina Installatie van RICOH Cloud Connector geopend in de standaardbrowser.

Als u RICOH Cloud Connector bijwerkt, wordt de pagina RICOH Cloud Connector-update geopend in de standaardbrowser.

Opmerking: Als de pagina Installatie van RICOH Cloud Connector niet wordt geopend, wordt het installatieprogramma mogelijk geblokkeerd door uw antivirusprogramma of browser.
Controleer de adresbalk van uw browser om te zien of deze pagina's blokkeert zodat ze niet kunnen worden geopend. Als de pagina is geblokkeerd, moet u toestemming geven om de pagina weer te geven. Als de pagina nog steeds niet wordt weergegeven, raadpleegt u het onderstaande onderwerp Problemen oplossen.
Als u voor de eerste keer installeert:
1. Bekijk de juridische voorwaarden en selecteer Ik accepteer de voorwaarden van de licentieovereenkomst..
2. Controleer de installatielocatie en of u schrijf- en uitvoerrechten hebt voor de installatie. Klik vervolgens op INSTALLEREN.
Als u RICOH Cloud Connector bijwerkt:

Opmerking: Uw vorige installatiegegevens worden geïmporteerd, inclusief het accepteren van de licentie.
1. Bekijk de informatie over uw huidige versie van RICOH Cloud Connector en de updateversie.
2. Klik op UPDATE.

De installatie wordt gestart en u kunt de voortgang bekijken.

Zodra de installatie is voltooid, wordt automatisch de pagina Installatie van RICOH Cloud Connector geopend.

De service RICOH Cloud Connector start automatisch na elke succesvolle installatie, update of herstart van het systeem.

1.6.3 Instellen

Nadat u RICOH Cloud Connector hebt geïnstalleerd, moet u dit configureren om te communiceren met RICOH TotalFlow Cloud.

Wanneer de installatie van RICOH Cloud Connector is voltooid, wordt de pagina Installatie van RICOH Cloud Connector geopend in de standaardbrowser.

Stel RICOH Cloud Connector als volgt in:

De eigenschap Systeemnaam wordt automatisch ingevuld met de naam van het systeem zoals ingesteld in het besturingssysteem. U kunt het bijwerken tot iets dat herkenbaarder of gemakkelijker te onthouden is.
Als uw bedrijf proxyservers gebruikt, vraag dan uw IT-afdeling om het juiste IP-adres of de juiste hostnaam en poortnummer die moeten worden gebruikt. Selecteer de optie Ik ga een proxyserver gebruiken en typ de juiste waarden in de Proxyinstellingen-velden.
Klik op Proxy testen. Als de proxy-instellingen niet zijn gevalideerd, controleert u dit bij de IT-afdeling, voert u de juiste waarden in en probeert u het opnieuw.
Klik op Code genereren.

Als u niet bent aangemeld op Account Administration wordt het aanmeldvenster geopend. Meld u aan bij Account Administration.

Wanneer u bent aangemeld, ziet u het venster Genereer een eenmalige code en een unieke eenmalige code die 20 minuten geldig is.
Kopieer de code, keer terug naar RICOH Cloud Connector en plak de code in het veld Eenmalige code.
Klik op Indienen.
Als uw machtiging geldig is, ontvangt u een bevestigingsbericht. Klik op Sluiten.
U ziet het dialoogvenster Licentie-instellingen.
Het bevat alle details die u hebt ingevoerd tijdens de installatie. U kunt de Systeemnaam en Proxyinstellingen, indien nodig, bewerken.
Sluit het browsertabblad of het venster om de instelling van RICOH Cloud Connector af te sluiten.

1.6.3.1 Systeemnaam

Toont de naam van het apparaat waarop u RICOH Cloud Connector instelt.

Standaard is deze waarde de naam van dit systeem die in het besturingssysteem is toegewezen. U kunt dit wijzigen in een meer herkenbare naam. In RICOH Account Administration wordt deze naam op het tabblad Connectors weergegeven, in de tabel met geregistreerde connectoren.

1.6.3.2 Proxy-instellingen

Sommige bedrijven gebruiken proxyservers om een extra netwerkbeveiligingslaag te bieden.

Als uw bedrijf proxyservers gebruikt, vraag dan uw IT-afdeling om het juiste IP-adres of de juiste hostnaam en poortnummer die moeten worden gebruikt.

1.6.3.3 Eenmalige code

De door RICOH Account Administration gegenereerde eenmalige code die u moet gebruiken om RICOH Cloud Connector te registreren, zodat informatie van uw netwerk naar de RICOH TotalFlow Cloud-toepassingen kan worden verzonden.

Om u aan te melden bij RICOH Account Administration hebt u een RICOH TotalFlow Cloud-gebruikers-ID nodig.

1.6.4 Installatie van RICOH Cloud Connector ongedaan maken

In dit gedeelte wordt beschreven hoe u RICOH Cloud Connector verwijdert met behulp van de systeemtools van Windows.

Opmerking:

Om RICOH Cloud Connector onder Linux te verwijderen, volgt u de instructies van uw Linux-distributie.

Om RICOH Cloud Connector onder Windows te verwijderen:

Log in op de computer waar u RICOH Cloud Connector hebt geïnstalleerd als beheerder.
Klik op de knop Zoeken van Windows en zoek naar de pagina Apps & Functies.
Zoek de naam van de toepassing RICOH Cloud Connector en klik hierop.
Klik op Verwijderen.
Klik nogmaals op Verwijderen om te bevestigen dat u begrijpt dat de toepassing en de bijbehorende informatie zullen worden verwijderd.
U ziet de pagina RICOH Cloud Connector verwijderen:
Bekijk de informatie en selecteer Ik begrijp het en ik wil de RICOH Cloud Connector verwijderen. Afhankelijk van de configuratie moet u uw apparaat mogelijk opnieuw opstarten na het verwijderingsproces..
- Als u RICOH Cloud Connector verwijdert, stoppen alle programma's die de verwijderde Cloud Connector voor hun abonnementen gebruikten.
Klik op VERWIJDEREN.
Log in bij RICOH Account Administration en controleer of de verwijderde Cloud Connector niet meer wordt weergegeven in de tabel Connectors.
U kunt deze handmatig verwijderen als het niet automatisch is verwijderd.

1.6.5 Problemen oplossen

1.6.5.1 Veelvoorkomende problemen

1.6.5.1.1 Kan RICOH Cloud Connector niet installeren

Als u RICOH Cloud Connector installeert en de installatiepagina niet wordt weergegeven, probeer dan het volgende.

Mogelijke redenen waarom de installatiepagina niet wordt geopend:

U bent niet ingelogd als beheerder.
Log in als gebruiker met beheerdersrechten en probeer het opnieuw.
Op Linux is het installatiebestand niet gedefinieerd als een uitvoerbaar bestand.
Volg de instructies voor uw versie van Linux om het bestand uitvoerbaar te maken.
Een advertentieblokkering voorkomt dat de Installatie van RICOH Cloud Connector in een nieuw browservenster wordt geopend.
Zoek de instellingen voor pop-upblokkering in uw browser en geef op dat de pagina mag worden geopend.
De antivirussoftware blokkeert de uitvoering van het installatieprogramma.
Geef toestemming voor de uitvoering van het programma binnen uw antivirusprogramma.
Het maximum aantal cloudconnectors is bereikt dat door uw abonnement wordt ondersteund.
Log in op RICOH Account Administration en verwijder de niet-verbonden cloudconnectors uit de tabel Connectors. Of neem contact op met uw Ricoh-verkoper om uw abonnement te upgraden.

Als er geen sprake is van een van de bovenstaande situaties, gebruik dan de opdrachtregelprocedure om RICOH Cloud Connector te installeren:

Log in op de computer waar u de installatiebestanden hebt gedownload, als gebruiker met beheerdersrechten.
Open een opdrachtprompt met de optie Uitvoeren als beheerder en zoek het uitvoerbare bestand RICOH Cloud Connector.
Belangrijk: Controleer of u toestemming hebt om het bestand uit te voeren. Gebruikt u Linux, controleer dan of het bestand uitvoerbaar is. Als dat niet zo is, volg dan de procedure voor uw Linux-versie om het bestand uitvoerbaar te maken.
Typ de volgende installatieopdracht:
rccInstallerFileName --install
Druk op Enter.

1.6.5.1.2 Edge start niet op bij het installeren van RICOH Cloud Connector

Als Microsoft Edge uw standaardbrowser is en u het ingebouwde beheerdersaccount gebruikt, wordt de browser niet automatisch geopend wanneer u RICOH Cloud Connector installeert.

Als dit gebeurt, kunt u zich aanmelden met andere gebruikersaccountgegevens of uw standaardbrowser wijzigen in een andere browser, zoals Chrome of Firefox. Start vervolgens het installatieprogramma voor RICOH Cloud Connector opnieuw.

1.6.5.1.3 Cloud Connector-fout: handtekening nog niet bijgewerkt

Deze fout kan optreden als de servertijd niet is gesynchroniseerd met uw huidige lokale tijd.

Zorg ervoor dat de tijd van de server is gesynchroniseerd met de huidige tijd met een nauwkeurigheid tot 5 minuten.

Als u Windows gebruikt, raden we u aan de huidige tijd automatisch in te stellen:

Log in bij Windows als beheerder.
Kik op het Windows-pictogram op de taakbalk.
Ga naar Instellingen ⇒ Tijd en taal ⇒ Datum en tijd.
Schakel de optie Tijd automatisch instellen in.
Blader omlaag naar Extra instellingen en klik op Nu synchroniseren.

1.6.5.2 RICOH Cloud Connector-logboeken worden gedownload

Als u problemen ondervindt tijdens het gebruik van RICOH Cloud Connector, kunt u eenvoudig de toepassingslogboeken downloaden die u kunt gebruiken om het probleem op te lossen.

U kunt als volgt logboeken downloaden:

Open een webbrowservenster.
Voer in de adresbalk de URL voor de pagina Installatie van RICOH Cloud Connector in:

http://server_address:port_number/license,

waarbij server_address het IP-adres of de hostnaam is van de computer waarop RICOH Cloud Connector is geïnstalleerd en port_number de toepassingspoort.

Als u zich op de computer bevindt waarop RICOH Cloud Connector is geïnstalleerd en u de standaardpoort gebruikt, kunt u naar http://localhost:15180/license gaan.
Klik op de banner op , het pictogram Help, en selecteer Logboeken downloaden.
Sla het logboekpakket op in uw systeem.
De procedure voor het opslaan van het bestand hangt af van de webbrowserinstellingen.
De logboeken worden opgeslagen in ZIP-formaat en het resulterende pakket krijgt de naam RCC_logboeken_yyyy-mm-ddThh_mm_ss.zip, waarbij yyyy-mm-dd en hh_mm_ss staan voor de datum en tijd waarop de logboeken werden verzameld.

1 RICOH Account Administration

1.1 Overzicht van RICOH Account Administration

1.1.1 Wat is er nieuw?

1.1.2 Systeemobjecten

1.1.2.1 API-sleutels

Related information:

1.1.2.2 Connectors

Related information:

1.1.2.3 Gebruikers

Related information:

1.1.3 Gebruikersinterface

1.1.3.1 Banner

1.1.3.2 Hoofdpagina

1.1.3.2.1 Tabblad API-sleutels

Related information:

1.1.3.2.2 Tabblad Connectors

1.1.3.2.3 Tabblad Details

1.1.3.2.4 Tabblad Abonnementen

1.1.3.2.5 Het tabblad Gebruikers

1.1.4 RICOH Cloud Connector

Related information:

1.1.5 Toegankelijkheid

Toegankelijkheidsfuncties

Toetsenbordnavigatie

1.1.6 Handelsmerken

1.2 Aan de slag met RICOH TotalFlow™ Cloud

1.2.1 Voor de eerste keer aanmelden bij RICOH TotalFlow Cloud

Related information:

1.2.2 Aan de slag met RICOH TotalFlow Cloud voor beheerders

Related information:

1.2.2.1 Abonnementen weergeven

1.2.2.2 Gebruikers toevoegen

Related information:

1.2.3 Aan de slag met RICOH TotalFlow Cloud voor gebruikers

Related information:

1.2.4 Cookie-instellingen beheren

1.3 Configureren

1.3.1 Gebruikers toevoegen

Related information:

1.4 Objecten beheren

1.4.1 Accountdetails beheren

1.4.2 Gebruikersinformatie aanpassen

1.4.3 Uw wachtwoord wijzigen

1.5 Werken met de gegevensexport-API

Related information:

1.5.1 Gegevensexport-API

Verificatie

Beschikbare eindpunten

De API testen

1.5.2 API-sleutels aanmaken en beheren

Related information:

1.5.3 De Gegevensexport-API uitproberen

1.5.4 Verwerking van datum en tijd in de gegevensexport-API

Het datum- en tijdmodel

Datum- en tijdnotatie

Standaard tijdsperiode

Bewaartermijn van gegevens: de afgelopen zeven dagen

Regels voor het gevraagde bereik

Het opgeven van de tijdzone

De taal leveren

Zomertijd en onduidelijke tijdsaanduidingen

Aanbevelingen voor het opslaan en vergelijken van tijdstempels van reacties

Voorbeelden

Related information:

1.5.5 Velden in het antwoord van de gegevensexport-API

In deze referentie gehanteerde conventies

GET /printers – responsvelden

GET /jobs-antwoordvelden

GET /printer-states - responsvelden

GET /printer-interventions - responsvelden

1.5.5.1 Printertoestanden en toestandscategorieën

Over de statussen en categorieën van printers

In de noordelijke staten

Down-statussen

Rusttoestanden

Onbekend

1.5.5.2 Omgaan met responslimieten van de gegevensexport-API

Wat de grenzen zijn

Verzoeken om binnen de gestelde grenzen te blijven