RICOH Account Administration

1 RICOH Account Administration

RICOH Account Administration è l'interfaccia di amministrazione per le applicazioni RICOH TotalFlow Cloud come RICOH Predictive Insight™.

Riferimento: Per informazioni sui criteri di sicurezza di RICOH TotalFlow Cloud, vedere RICOH TotalFlow Cloud Security Overview.

1.1 Panoramica di RICOH Account Administration

Gli amministratori utilizzano RICOH Account Administration per gestire gli utenti di RICOH TotalFlow Cloud e altri oggetti utilizzati nelle applicazioni.

Le funzioni disponibili variano in base agli abbonamenti all'applicazione acquistati dall'azienda. Per tutte le applicazioni di TotalFlow Cloud, si utilizza Account Administration per:

Aggiungere, modificare ed eliminare gli utenti.
Visualizzare i dettagli degli abbonamenti.
Visualizzare e modificare i dettagli dell'account.

Per alcune applicazioni, sono state aggiunte altre funzioni che consentono di:

Scaricare e installare RICOH Cloud Connector, per facilitare la comunicazione con le applicazioni Ricoh installate in rete.

1.1.1 Novità

RICOH Account Administration aggiorna regolarmente le funzioni disponibili e corregge i difetti.

RICOH Account Administration include varie correzioni di difetti e aggiornamenti di sicurezza in ogni distribuzione. Le modifiche aggiuntive per ogni distribuzione sono elencate qui.

3 settembre 2026

È ora disponibile la funzione dell'API di esportazione dei dati di RICOH Predictive Insight. La rimozione della notazione beta dalla documentazione è avvenuta qui: Utilizzo dell'API di esportazione dei dati

5 agosto 2026

Correzioni di bug e aggiornamenti di sicurezza, comprese le correzioni relative a CVE-2026-42198, CVE-2026-44431, CVE-2026-44432, CVE-2026-48522, CVE-2026-48524, CVE-2026-48525 e CVE-2026-48526.

21 luglio 2026

Correzioni di bug e aggiornamenti di sicurezza per RICOH Cloud Connector, comprese le correzioni relative a 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 e CVE-2026-48779.

1° luglio 2026

Correzioni di bug e aggiornamenti di sicurezza, comprese le correzioni relative a 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 e CVE-2026-47244.

12 giugno 2026

Correzioni di bug e aggiornamenti di sicurezza, comprese le correzioni relative a CWE-117 e CWE-93.

11 giugno 2026

Il sistema di guida è stato aggiornato per includere contenuti relativi all'API di esportazione dei dati, una funzionalità disponibile per il beta testing: Utilizzo dell'API di esportazione dei dati

1° maggio 2026

Aggiornamento del documento Ricoh TotalFlow Cloud Security Overview.

7 aprile 2026

Correzioni di bug e aggiornamenti di sicurezza, comprese le correzioni relative alle vulnerabilità CVE-2025-45768 e CVE-2026-26007.

21 gennaio 2026

Correzioni di bug e aggiornamenti di sicurezza, incluse le correzioni per CVE-2025-66418 e CVE-2025-66471.

17 dicembre 2025

Correzioni di bug e aggiornamenti di sicurezza, incluse le correzioni per CVE-2025-48976, CVE-2025-7962 e CVE-2025-12383.

30 ottobre 2025

Correzioni di bug e aggiornamenti di sicurezza, incluse le correzioni per CVE-2025-9636 e CVE-2025-48924.

30 luglio 2025

Correzioni di bug e aggiornamenti di sicurezza, incluse le correzioni per CVE-2024-37891 e CVE-2024-12797.

23 luglio 2025

Correzioni di bug e aggiornamenti di sicurezza, incluse le correzioni per CVE-2025-50181 e CVE-2025-50182.

9 luglio 2025

Aggiornamento dell'Informativa sulla privacy per il Giappone.
Aggiunto il supporto per i clienti in Slovenia e Croazia.
Correzioni di bug e aggiornamenti di sicurezza, incluse le correzioni per CVE-2021-28168.

2 luglio 2025

Correzioni di bug e aggiornamenti di sicurezza, incluse le correzioni per CVE-2023-52428 e CVE-2023-1370.

4 giugno 2025

Correzioni di bug e aggiornamenti di sicurezza, incluse le correzioni per CVE-2024-47554 e XUC-XUC-MAVEN-100000.

23 aprile 2025

Correzioni di bug e aggiornamenti di sicurezza, inclusa una correzione per CVE-2024-37891.

8 aprile 2025

Aggiornamento del documento RICOH TotalFlow Cloud Security.

2 aprile 2025

Aggiornato per cambiare il nome di RICOH Supervisor in RICOH Predictive Insight in tutti i riferimenti.
Aggiornamenti di sicurezza e correzioni di bug.

12 marzo 2025

Miglioramenti delle prestazioni.
Aggiornamenti di sicurezza e correzioni di bug.

4 febbraio 2025

Vari aggiornamenti di sicurezza, tra cui le correzioni per CVE-2024-45296, CVE-2024-45590, CVE-2017-20165 e CVE-2024-39338.
Modifiche editoriali e correzioni di bug.

29 gennaio 2025

Vari aggiornamenti di sicurezza, incluse le correzioni per CWE-798.
Modifiche editoriali e correzioni di bug.

5 dicembre 2024

L'Informativa sulla privacy di Ricoh Europe si applica ora anche a Ucraina, Romania e Israele.
Modifiche editoriali e correzioni di bug.

30 ottobre 2024

Vari aggiornamenti di sicurezza, tra cui le correzioni per CVE-2024-37891.
Modifiche editoriali e correzioni di bug.

2 ottobre 2024

Vari aggiornamenti di sicurezza, tra cui le correzioni per CVE-2023-2650, CVE-2023-3446, CVE-2023-49083, CVE-2023-50782, CVE-2024-0727, CVE-2024-26130 e CVE-2023-4807.
Modifiche editoriali e correzioni di bug.

17 luglio 2024

Rimosso il supporto per RICOH TotalFlow Producer.
Modifiche editoriali e correzioni di bug.

20 giugno 2024

Modifiche editoriali e correzioni di bug.

11 giugno 2024

Modifiche editoriali e correzioni di bug.

22 maggio 2024

Aggiornato l'elenco delle stampanti supportate per l'abbonamento RICOH TotalFlow Producer Advanced e incluso il supporto per le stampanti con controller interno standard Ricoh.
Modifiche editoriali e correzioni di bug.

30 aprile 2024

Modifiche editoriali e correzioni di bug.

15 aprile 2024

Modifiche editoriali e correzioni di bug.

9 aprile 2024

Modifiche editoriali e correzioni di bug.

14 marzo 2024

Modifiche editoriali e correzioni di bug.

7 marzo 2024

Modifiche editoriali e correzioni di bug.

27 febbraio 2024

Per l'abbonamento RICOH TotalFlow Producer Advanced, RICOH Account Administration ha aggiunto il supporto per la configurazione e la gestione delle stampanti.
Per comunicare con le stampanti in esecuzione nell'ambiente, RICOH Cloud Connector include ora il componente RICOH Printer Connector. Il componente RICOH Printer Connector è attualmente disponibile solo nella versione Windows di RICOH Cloud Connector.
Modifiche editoriali e correzioni di bug.

13 febbraio 2024

Modifiche editoriali e correzioni di bug.

30 gennaio 2024

Modifiche editoriali e correzioni di bug.

14 novembre 2023

A supporto di RICOH TotalFlow Producer, RICOH Account Administration ha aggiunto il supporto per la funzione BETA Conversione Office.
Questa funzione è disponibile con un abbonamento RICOH TotalFlow Producer Advanced.

2 agosto 2023

A supporto di RICOH TotalFlow Producer, RICOH Account Administration ha aggiunto il supporto per questi oggetti di sistema:
- Automazioni
- Connettori
- Clienti
- Hot folder
Questi oggetti sono visibili solo dopo aver attivato un abbonamento a RICOH TotalFlow Producer, ma le istruzioni per gestirli sono incluse nella guida.

21 giugno 2023

Aggiornamenti del sistema della guida.

1 marzo 2023

Vari aggiornamenti di sicurezza, tra cui le correzioni per CVE-2022-41946 e CVE-2022-42003.

10 novembre 2022

Vari aggiornamenti di sicurezza, tra cui le correzioni per CVE-2022-42889.

24 agosto 2022

Vari aggiornamenti di sicurezza, tra cui le correzioni per CVE-2022-31197.

27 luglio 2022

Vari aggiornamenti di sicurezza.

24 giugno 2022

È stato aggiunto il supporto per la configurazione di RICOH Cloud Connector per l'utilizzo di HTTPS.
Vari aggiornamenti di sicurezza, tra cui le correzioni per CVE-2022-21724.

17 maggio 2022

È ora disponibile l'installazione di RICOH Cloud Connector attraverso l'interfaccia utente.

11 marzo 2022

Traduzioni aggiornate per includere il contenuto di RICOH Cloud Connector.
Documentazione in inglese aggiornata per RICOH Cloud Connector e gli argomenti della panoramica.

23 febbraio 2022

Aggiunto il supporto per i clienti in Canada.

19 gennaio 2022

Vari aggiornamenti di sicurezza, tra cui le correzioni per CVE-2021-44228.

27 ottobre 2021

RICOH Cloud Connector è ora disponibile.

1 settembre 2021

Aggiunto il supporto per i clienti in Francia.

25 agosto 2021

Aggiunto il supporto per i clienti in Germania.

28 luglio 2021

Aggiunto il supporto per i clienti in Vietnam.

12 maggio 2021

Aggiunto il supporto per i clienti in Belgio e Lussemburgo.

7 maggio 2021

Aggiornata la politica sui cookie per i clienti in Giappone.

17 marzo 2021

Aggiunto il supporto per i clienti in Portogallo.

17 febbraio 2021

Aggiunto il supporto per i clienti in Spagna.

16 dicembre 2020

Aggiunto il supporto per i clienti nelle Filippine.

2 dicembre 2020

Aggiunto il supporto per i clienti in Svizzera.

9 settembre 2020

Aggiunto il supporto per i clienti in Giappone.

2 settembre 2020

Aggiornata la politica per la privacy per i clienti negli Stati Uniti.

5 agosto 2020

Aggiunto il supporto per i clienti in Svezia.

20 maggio 2020

Supporto aggiunto per clienti in Malesia e Messico.

1.1.2 Oggetti del sistema

Gli oggetti del sistema sono elementi che si definiscono nelle applicazioni di TotalFlow Cloud e si usano per creare la soluzione come si desidera. In Account Administration, alcuni esempi di oggetti del sistema sono gli utenti e i connettori.

Gli oggetti del sistema definiti in Account Administration potrebbero essere utilizzati in tutte le applicazioni di TotalFlow Cloud.

1.1.2.1 Chiavi API

Un’ Chiave API è una credenziale che autorizza un’applicazione a inviare richieste a un’API di RICOH TotalFlow Cloud per conto del Suo account. È possibile definire le chiavi API in RICOH Account Administration.

Le applicazioni che utilizzano un'API anziché l'interfaccia utente non possono effettuare l'accesso come utente. Ogni richiesta include invece il valore di una chiave API, che identifica l'account a cui appartiene la richiesta. Poiché la chiave contiene l'identificativo del Suo account, non è necessario specificare un parametro relativo all'account o al tenant nelle richieste.

È possibile definire fino a dieci chiavi per il proprio account. Molte organizzazioni creano una chiave per ciascuna applicazione che recupera dati, in modo che una chiave possa essere sostituita o eliminata senza interrompere il funzionamento delle altre applicazioni. Ogni chiave è dotata di un nome, una descrizione e una data di scadenza.

Il valore di una chiave viene visualizzato una sola volta, nel momento in cui la si crea o la si ruota. Account Administration non memorizza il valore in un formato che ne consenta la successiva visualizzazione; pertanto, è necessario copiarlo e conservarlo in modo sicuro nel momento in cui viene mostrato. Se un valore viene perso, è necessario ruotare la chiave per generarne uno nuovo. Chiunque disponga di tale valore può inviare richieste a nome del Suo account; pertanto, protegga le chiavi con la stessa cura con cui protegge una password. Le chiavi non sono limitate a stampanti specifiche.

Le chiavi vengono gestite nella scheda Chiavi API. È possibile modificare il nome, la descrizione o la data di scadenza di una chiave; effettuare la rotazione di una chiave per sostituirne il valore mantenendo la sua identità; oppure eliminare una chiave per revocarne immediatamente l'accesso.

In RICOH TotalFlow Cloud, le chiavi API vengono utilizzate con l'API di esportazione dei dati, che recupera le informazioni relative alle stampanti, ai lavori e allo stato delle stampanti raccolte da RICOH Predictive Insight. Il numero di richieste API che il Suo account può effettuare, considerando tutte le chiavi API, è determinato dal Suo abbonamento. Ogni abbonamento stabilisce un limite massimo per il numero di richieste API consentite in un periodo di 30 giorni consecutivi. Se si supera il numero di chiamate previsto dal proprio abbonamento, non verrà accettata alcuna richiesta fino a quando il totale delle richieste degli ultimi 30 giorni non scenderà al di sotto del limite previsto dall’abbonamento. Per verificare il numero di chiamate incluse nel Suo abbonamento e quante ne ha effettuate negli ultimi 30 giorni, consulti la pagina Chiavi API. Se dovesse riscontrare la necessità di una maggiore capacità per le richieste API, si rivolga al Suo rappresentante Ricoh per informazioni sull’aggiornamento del Suo abbonamento.

1.1.2.2 Connettori

Connettori sono applicazioni memorizzate nei sistemi locali che creano un collegamento tra le applicazioni cloud e il software o i dispositivi installati in locale. Questa connessione crea un percorso di comunicazione tra i sistemi. Per collegarsi a RICOH TotalFlow Cloud, si installa RICOH Cloud Connector su un server della rete.

Queste applicazioni utilizzano RICOH Cloud Connector per installare e gestire le licenze di abbonamento:

RICOH InfoPrint Manager per Windows e per Linux
RICOH Auto Color Adjuster

1.1.2.3 Utenti

Chiunque lavori con le applicazioni di RICOH TotalFlow Cloud deve essere definito come Utente.

Quando Ricoh configura inizialmente l'account, viene creato un utente Amministratore. L'amministratore riceve un'e-mail di benvenuto da TotalFlow Cloud, con un link per accedere e modificare la password iniziale. Questo amministratore è responsabile della creazione di utenti per il resto dell'organizzazione.

A Utenti vengono assegnati ruoli per ogni applicazione per la quale si è acquistato un abbonamento. I ruoli si basano sulle responsabilità lavorative dell'utente e variano da un'applicazione all'altra. Ad esempio, Account Administration ha due ruoli che si possono assegnare agli utenti:

Amministratore: Utenti autorizzati a visualizzare i dettagli dell'account, a creare e gestire altri utenti e ad amministrare altri oggetti come richiesto.
Nessuno: Utenti le cui responsabilità lavorative includono il lavoro nelle applicazioni sottoscritte, ma non l'amministrazione di utenti o altri oggetti.

Un utente potrebbe essere un Amministratore in Account Administration, ma un Visualizzatore in un'applicazione come RICOH Predictive Insight.

A Utenti viene anche assegnato un ruolo all'interno della piattaforma TotalFlow Cloud. La maggior parte degli utenti è assegnata al ruolo della piattaforma Standard. Tuttavia, altre applicazioni possono aggiungere ruoli speciali alla piattaforma.

Ad esempio, RICOH Predictive Insight aggiunge il ruolo piattaforma Schermo grande. Si crea un utente con il ruolo piattaforma Schermo grande quando, ad esempio, si desidera visualizzare i dashboard di RICOH Predictive Insight su uno schermo nell'area di produzione per mostrare lo stato corrente. Un dipendente dell'azienda si collega come utente di Schermo grande e ingrandisce la finestra del browser sullo schermo grande. L'utente di Schermo grande ha accesso in sola visualizzazione e può rimanere connesso per il tempo massimo consentito.

1.1.3 Interfaccia utente

Gli utenti con autorizzazione all'accesso a RICOH Account Administration possono aprire l'interfaccia utente da qualsiasi sistema connesso a Internet e che dispone di un browser supportato installato.

1.1.3.1 Intestazione

L'intestazione è la barra nera si trova nella parte superiore dell'interfaccia utente. È disponibile in tutte le pagine dell'interfaccia.

Le icone dell'intestazione consentono di eseguire una serie di operazioni:

Passare a un'altra applicazione RICOH TotalFlow Cloud a cui si ha accesso.
Fare clic su , l'icona App Switcher e scegliere l'applicazione da aprire. L'applicazione si apre nella stessa scheda.
Inviare idee per migliorare le nostre applicazioni.
Fare clic su , l'icona Invia idee, quindi fare clic su Aggiungi una nuova idea per descrivere cosa aggiungere. È inoltre possibile esaminare le idee inviate da altri clienti. Se l'idea piace, votarla. Le idee sostenute da più di un cliente attireranno probabilmente la nostra attenzione e avranno maggiori possibilità di essere realizzate!
Visualizzare le notifiche inviate dagli amministratori di sistema o dalle applicazioni stesse.
Fare clic su , l'icona Notifiche.
- È possibile visualizzare alcune notifiche senza aprire l'elenco Notifiche. Queste notifiche appaiono in una striscia sopra o sotto l'intestazione o nella parte inferiore della finestra del browser.
Visualizzare i dettagli relativi al proprio ID utente o all'account della propria azienda.
Fare clic su , l'icona Account. L'ID utente e il nome account si trovano nella parte superiore del menu. Selezionare un'opzione per visualizzare le impostazioni o le informazioni associate.
Ottenere assistenza utilizzando l'applicazione.
Fare clic su , l'icona Guida, e selezionare Guida.
Visualizzare le Condizioni d'uso per le applicazioni TotalFlow Cloud.
Fare clic su , l'icona Guida, e selezionare Condizioni d'uso.

1.1.3.2 Pagina principale

Quando si accede a RICOH Account Administration o vi si ritorna da un'altra applicazione, si visualizza la pagina principale con una delle schede aperte.

Il numero di schede disponibili varia in base alle applicazioni a cui si è iscritti. Tutte le applicazioni includono queste schede:

Sottoscrizioni
Utenti
Dettagli

Altre applicazioni aggiungono altre schede a seconda delle necessità. Ad esempio, con un abbonamento RICOH Auto Color Adjuster è disponibile anche la scheda Connettori.

La maggior parte delle schede mostra un elenco di oggetti in una tabella. In tutte le tabelle è possibile:

Ordinare le voci.
Fare clic sull'intestazione della tabella una volta per ordinare in ordine crescente e un'altra volta per ordinare in ordine decrescente.
Modificare e riorganizzare le colonne visualizzate.
Fare clic su , l'icona dell'ingranaggio, e selezionare Gestisci colonne.
Cercare il testo nella tabella.
Fare clic su , l'icona di ricerca, e digitare il testo da trovare.

1.1.3.2.1 Scheda Chiavi API

Le chiavi API definite per il proprio account sono elencate nella scheda Chiavi API in RICOH Account Administration. Utilizzare questa scheda per creare le chiavi che autorizzano le richieste all'API di esportazione dei dati e per gestirle per tutta la loro durata.

Scheda Chiavi API

La scheda Chiavi API è disponibile solo se il Suo account dispone di un abbonamento a RICOH Predictive Insight. Per visualizzare la scheda e utilizzare i tasti, è necessario disporre di un accesso di tipo Amministratore al sito Account Administration.

I due collegamenti nella parte superiore della scheda consentono di visualizzare le informazioni di riferimento relative all'API di esportazione dei dati:

Introduzione alle chiavi API: Apre la guida relativa all'API di esportazione dei dati, nella quale è possibile trovare informazioni su come iniziare a utilizzare le chiavi API, nonché sugli endpoint disponibili, sui campi restituiti da ciascuno di essi e sui limiti applicabili alle richieste.
Apri l'Esploratore API: Apre la pagina della documentazione interattiva relativa all'API, dove è possibile esaminare ciascun endpoint, visualizzare i parametri che accetta e inviare richieste di esempio direttamente dal proprio browser. Per inviare una richiesta da quella pagina è necessario il valore di una chiave API.

Di seguito sono indicate le azioni che si possono eseguire in questa scheda:

Visualizzi tutte le chiavi definite per il Suo account e le relative proprietà, quali: Nome, Stato e Data di scadenza.
La tabella non riporta il valore di una chiave.
Creare una chiave.
Fare clic su Crea chiave API. Le chiavi sono solitamente attive entro 30 secondi, ma sono possibili ritardi.
Si prega di monitorare le richieste API dell'account rispetto ai limiti dell'abbonamento.
Il riquadro sopra la tabella delle chiavi API mostra il piano di utilizzo dell'account e il numero massimo di chiamate API consentite in un periodo di 30 giorni. Tenga traccia del numero di chiamate effettuate negli ultimi 30 giorni.
Modifichi il nome, la descrizione o la data di scadenza di una chiave esistente.
Fare clic con il pulsante destro del mouse su una riga e selezionare Modifica chiave API. La modifica di una chiave non ne altera il valore, pertanto le applicazioni che già utilizzano tale chiave continuano a funzionare.
Ruotare una chiave per sostituirne il valore.
Fare clic con il pulsante destro del mouse su una riga e selezionare Ruota chiave API. Impostare un periodo di sovrapposizione in modo che sia il valore attuale sia quello nuovo rimangano validi per alcuni giorni, consentendo così di avere il tempo necessario per aggiornare le proprie applicazioni. La chiave con il nuovo valore è solitamente disponibile entro 30 secondi, ma sono possibili dei ritardi.
Eliminare una chiave.
Fare clic con il pulsante destro del mouse su una riga e selezionare Elimina immediatamente.
- L'eliminazione di una chiave comporta la sua rimozione dal sistema entro un minuto, sebbene possano verificarsi dei ritardi. Le chiavi eliminate subiscono la rimozione definitiva. Se si tenta di inviare una richiesta API utilizzando una chiave dopo averla eliminata, la richiesta non va a buon fine.
- L'eliminazione di una chiave elimina tutte le versioni della stessa. Se si ruota una chiave e poi la si elimina, entrambe le versioni della chiave vengono eliminate, anche se il periodo di sovrapposizione è ancora attivo.

Importante: Il valore di una chiave viene visualizzato una sola volta, al momento della creazione o della rotazione della chiave. Non è possibile visualizzarlo nuovamente da questa scheda. Copiate il valore e conservatelo in un luogo sicuro in quel momento. In caso di smarrimento, ruoti la chiave per generare un nuovo valore.

Le chiavi non sono limitate alle singole stampanti. Chiunque disponga del valore di una chiave può inviare richieste a nome del Suo account. Condivida le chiavi esclusivamente con le persone incaricate dello sviluppo delle integrazioni e le sostituisca periodicamente in conformità con le vostre procedure di sicurezza.

Facendo clic su , l'icona degli strumenti, si apre un menu dal quale è possibile aggiornare le informazioni della tabella e gestire le colonne della tabella.

1.1.3.2.2 Scheda Connettori

I connettori registrati sono elencati nella scheda Connettori in RICOH Account Administration.

Scheda Connettori

Di seguito sono indicate le azioni che si possono eseguire in questa scheda:

Visualizzare tutti i connettori registrati e le loro proprietà, come ad esempio: Stato, Versione, Piattaforma o quando sono stati contattati l'ultima volta.
Scaricare l'ultima versione di RICOH Cloud Connector per il sistema operativo in uso.
Fare clic su Scarica e selezionare il sistema operativo.
Generare un codice unico per registrare un connettore cloud.
Fare clic su Genera codice unico.
Modificare, eliminare o visualizzare le connessioni associate a un connettore.
Fare clic con il pulsante destro del mouse su un connettore e selezionare un'opzione dal menu.
- Per modificare un connettore, il server su cui è definito il connettore deve essere in funzione e si deve disporre di una connessione di rete funzionante.
- Quando si elimina un connettore, l'istanza di RICOH Cloud Connector non viene disinstallata, ma non è più registrata nel cloud e ciò potrebbe influire sugli abbonamenti associati.

Facendo clic su , l'icona degli strumenti, si apre un menu dal quale è possibile aggiornare le informazioni della tabella e gestire le colonne della tabella.

1.1.3.2.3 Scheda Dettagli

Utilizzare la scheda Dettagli per visualizzare le informazioni sull'account aziendale.

È possibile fare clic su Modifica dettagli, nell'angolo superiore destro della pagina, per aggiornare la ragione sociale, le informazioni di contatto e di fatturazione, la lingua predefinita e il periodo di timeout per tutti gli utenti dell'azienda.

1.1.3.2.4 Scheda Sottoscrizioni

Utilizzare la scheda Sottoscrizioni per visualizzare tutti gli abbonamenti associati al proprio account, inclusi quelli scaduti. È anche possibile scaricare RICOH Cloud Connector, se necessario.

Scheda Sottoscrizioni

Ogni abbonamento acquistato dall'azienda viene visualizzato come scheda nella scheda Sottoscrizioni. La scheda riporta le date di inizio e di scadenza dell'abbonamento. Facendo clic su Dettagli si apre una finestra di dialogo che mostra ulteriori informazioni, tra cui:

Il numero e il tipo di licenze incluse con l'applicazione
Dettagli sull'abbonamento, compresi eventuali componenti aggiuntivi acquistati con esso

1.1.3.2.5 Scheda Utenti

Utilizzare la scheda Utenti per creare e gestire gli utenti che hanno accesso alle applicazioni.

Scheda Utenti

Nella scheda Utenti è possibile:

Creare nuovi utenti.
Fare clic su Aggiungi utente.
Modificare, copiare ed eliminare gli utenti esistenti.
Fare clic con il pulsante destro del mouse su una riga e selezionare l'opzione corretta.
Reinviare gli inviti agli utenti che non hanno risposto all'invito iniziale.
Fare clic con il pulsante destro del mouse su una riga e selezionare Invia nuovamente invito.

1.1.4 RICOH Cloud Connector

RICOH Cloud Connector è un'applicazione installata sulla rete per gestire la comunicazione con RICOH TotalFlow Cloud.

Cloud Connector è richiesto solo con prodotti specifici e in determinate configurazioni:

RICOH InfoPrint Manager Subscription
Se si acquista RICOH InfoPrint Manager Subscription, Cloud Connector è installato con il prodotto. Si collega a RICOH TotalFlow Cloud per verificare che l'abbonamento non sia scaduto.
RICOH Auto Color Adjuster
RICOH Auto Color Adjuster utilizza Cloud Connector per gestire gli abbonamenti.

1.1.5 Accesso facilitato

Ricoh si impegna a fornire prodotti accessibili a tutti, indipendentemente dall'età e dalle capacità.

Per ulteriori informazioni sull'impegno che abbiamo assunto nei confronti dell'accesso facilitato, consultare la pagina Accesso facilitato sul sito web di Ricoh.

Funzioni di accesso facilitato

Le funzioni di accesso facilitato aiutano gli utenti con disabilità, come mobilità ridotta o vista limitata, a utilizzare correttamente i prodotti informatici.

Le principali funzioni di accesso facilitato di questo prodotto consentono di:

Sfruttare utilità per la lettura dello schermo, lenti d'ingrandimento e altre tecnologie di assistenza.
Utilizzare la tastiera anziché il mouse.
Modificare attributi quali volume, colore, contrasto e dimensione dei caratteri.
Distinguere i tasti al tatto senza attivarli.
Collegare dispositivi di input e output alternativi, come dispositivi di puntamento speciali e schermi Braille.

Inoltre, il centro informazioni e le pubblicazioni del prodotto sono in formato accessibile.

Navigazione da tastiera

Questo prodotto utilizza i tasti di navigazione standard di Microsoft Windows.

1.1.6 Marchi

RICOH InfoPrint Manager™ e RICOH Predictive Insight™ sono marchi registrati di Ricoh Company, Ltd. negli Stati Uniti, in altri paesi o entrambi.

Firefox è un marchio registrato di Mozilla Foundation.

Google e Chrome sono marchi di Google Inc.

Java e tutti i marchi e i logo Java sono marchi di Oracle e/o società affiliate.

Linux è un marchio registrato di Linus Torvalds negli Stati Uniti e/o in altri Paesi.

Microsoft, Windows, Windows Server, Windows Vista e Internet Explorer sono marchi o marchi registrati di Microsoft Corporation negli Stati Uniti e/o in altri paesi.

I nomi propri dei sistemi operativi Windows sono i seguenti:

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 è un marchio di Oracle America, Inc. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o società affiliate. Copyright Oracle America, Inc.

Altri nomi prodotto qui utilizzati sono solo a scopo identificativo e possono essere marchi delle rispettive aziende. Decliniamo qualsiasi diritto su questi marchi.

1.2 Introduzione a RICOH TotalFlow™ Cloud

Familiarizzate con le applicazioni TotalFlow Cloud per iniziare a lavorare.

1.2.1 Primo accesso a RICOH TotalFlow Cloud

Quando viene creato l'account, si riceve un'e-mail da RICOH TotalFlow Cloud. Utilizzare il pulsante contenuto nell'e-mail per effettuare il primo accesso.

Per accedere a RICOH TotalFlow Cloud per la prima volta, procedere come segue:

Aprire l'e-mail ricevuta da RICOH TotalFlow Cloud.
Fare clic su Accedi al tuo account.
La pagina di accesso si apre nel browser Web predefinito.
Digitare una password nei campi Nuova password e Conferma password, quindi fare clic su crea password.
Le password devono avere più di otto caratteri e soddisfare i criteri elencati nella pagina.
- L'invito via e-mail scade dopo sette giorni. Se si fa clic sul collegamento dopo la scadenza dell'invito, si apre una pagina di errore e viene inviato automaticamente un nuovo invito via e-mail.
  Importante: Fare clic sul collegamento Invia nuovamente invito in tale pagina solo se non si visualizza una nuova e-mail da RICOH TotalFlow Cloud entro 15 minuti.
- Se si verificano altri problemi nella creazione dell'account, contattare l'amministratore e chiedere di inviare nuovamente l'invito.

1.2.2 Introduzione a RICOH TotalFlow Cloud per gli amministratori

Gli amministratori configurano gli oggetti e le applicazioni di TotalFlow Cloud per prepararli all'uso da parte di altri. Creano ID utente per altri e sono al corrente dei tempi di inattività programmati, degli aggiornamenti del sistema e delle informazioni sugli abbonamenti.

Gli amministratori svolgono la maggior parte delle loro attività nell'applicazione RICOH Account Administration, ma possono accedere e utilizzare anche altre applicazioni.

Per iniziare a utilizzare RICOH TotalFlow Cloud come amministratore:

Accedere e modificare la password.
Una volta creato l'ID utente, si riceverà un'e-mail che invita a effettuare l'accesso e a iniziare a utilizzare le applicazioni RICOH TotalFlow Cloud. Al primo accesso è necessario reimpostare la password.
- Ricoh crea un solo utente per l'account. L'utente è un amministratore. Il primo utente ha la responsabilità di aggiungere altri utenti e concedere loro l'accesso alle applicazioni corrette. È possibile creare altri amministratori e delegare loro delle responsabilità.
Come amministratore, si viene indirizzati all'applicazione Account Administration.
Intervenire sulle impostazioni dei cookie.
Le applicazioni TotalFlow Cloud utilizzano i cookie, alcuni dei quali sono obbligatori. Consultare Gestione delle impostazioni dei cookie per saperne di più sui cookie e sulle azioni che è possibile intraprendere.
Familiarizzare con l'interfaccia dell'applicazione. Rivedere questi argomenti:
- Intestazione
- Pagina principale
Rivedere le informazioni sul proprio account e gli abbonamenti.
- Gestione dei dettagli dell'account
  È possibile aggiornare i dati di contatto secondo le necessità.
- Visualizzazione degli abbonamenti
  Per qualsiasi domanda, contattare il rappresentante Ricoh.
Analizzare i componenti del sistema, in modo da poter iniziare a pianificare gli oggetti da creare.
- Oggetti del sistema
- RICOH Cloud Connector
Utilizzare le procedure incluse in questa sezione e nella sezione Configurazione per creare gli ID utente e gli altri oggetti necessari all'account.

1.2.2.1 Visualizzazione degli abbonamenti

È possibile visualizzare i dettagli degli abbonamenti in RICOH Account Administration.

Per visualizzare gli abbonamenti:

Accedere a RICOH Account Administration.
Fare clic su Sottoscrizioni nel riquadro a sinistra.

La pagina Sottoscrizioni contiene le schede degli abbonamenti, insieme al loro stato corrente e alle date di scadenza. Una sottoscrizione può avere i seguenti stati:

Attivo

L'abbonamento è attualmente disponibile per l'uso.

In attesa

la data di inizio della sottoscrizione è nel futuro.

Sospeso

la sottoscrizione è stata disattivata a causa di un evento, ad esempio la violazione dei termini e delle condizioni o il mancato pagamento. È possibile ripristinarla quando il problema sarà risolto.

Scaduta

Il termine dell'abbonamento è trascorso.
Per espandere i dettagli dell'abbonamento, fare clic su Dettagli.

La tabella Licenze contiene informazioni sulle licenze per le varie funzioni incluse nell'abbonamento e su tutti i componenti aggiuntivi, nonché sul numero di licenze acquistate nell'ambito dell'abbonamento.

La tabella Dettagli dell'abbonamento contiene un riepilogo del prodotto e di tutti i componenti aggiuntivi inclusi nell'abbonamento.

Per rinnovare un abbonamento o acquistare altri componenti aggiuntivi, contattare il proprio rappresentante Ricoh.

1.2.2.2 Aggiunta di utenti

Quando si aggiunge un utente, è necessario specificare le relative informazioni di contatto e il tipo di ruolo che ricopre per ciascuna applicazione.

È possibile creare un nuovo utente o copiare un utente esistente. La copia di utenti può far risparmiare tempo, specialmente quando è necessario creare più utenti con proprietà simili.

Per aggiungere un utente:

Nel riquadro di sinistra, fare clic su Utenti.
Scegliere una delle seguenti opzioni:
- Per aggiungere un nuovo utente: fare clic su Aggiungi utente nell'angolo in alto a destra della finestra.
- Per copiare un utente esistente: fare clic con il tasto destro del mouse sulla riga di un utente esistente e selezionare Duplica.
Nella finestra di dialogo che si apre, inserire i dettagli dell'utente.
In Tipo di utente, selezionare Interno per creare un account utente per uno dei propri dipendenti.
In Ruolo piattaforma, selezionare una delle seguenti opzioni:
- Standard - L'utente può effettuare l'accesso all'applicazione con le opzioni di time-out e accesso standard.
- Schermo grande - L'utente ha accesso all'applicazione in sola visualizzazione su uno schermo grande e l'accesso non scade.
In Accesso e ruoli, selezionare l'accesso e il ruolo dell'utente per ogni applicazione. Fare clic sulla freccia nella colonna Accesso e ruoli per ciascuna applicazione.
- Alcuni abbonamenti includono limitazioni al numero di utenti che è possibile assegnare a ciascun ruolo.
Fare clic su Ok.

L'utente riceve un'e-mail che lo invita ad accedere a RICOH TotalFlow Cloud, dove può modificare le proprie informazioni e cambiare la password. L'invito via e-mail è valido per sette giorni.

Nota:

Se l'utente non accede prima della scadenza dell'invito via e-mail, è possibile inviare nuovamente l'invito. Fare clic con il tasto destro del mouse sull'utente e scegliere Invia nuovamente invito.

1.2.3 Introduzione a RICOH TotalFlow Cloud per gli utenti

Gli utenti delle applicazioni di RICOH TotalFlow Cloud ricoprono diversi ruoli, dagli analisti di business intelligence agli operatori di tipografie.

La maggior parte degli utenti ha accesso a un'applicazione RICOH TotalFlow Cloud. È inoltre possibile aggiornare i dettagli relativi al proprio ID utente e alla propria password.

Per iniziare a utilizzare le applicazioni di RICOH TotalFlow Cloud come utente:

Accedere e modificare la password.
Una volta creato l'ID utente, si riceverà un'e-mail che invita a effettuare l'accesso e a iniziare a utilizzare le applicazioni RICOH TotalFlow Cloud. Al primo accesso è necessario reimpostare la password.
Dopo aver modificato la password, viene visualizzata l'applicazione che è possibile utilizzare.
Intervenire sulle impostazioni dei cookie.
Le applicazioni TotalFlow Cloud utilizzano i cookie, alcuni dei quali sono obbligatori. Consultare Gestione delle impostazioni dei cookie per saperne di più sui cookie e sulle azioni che è possibile intraprendere.
Familiarizzare con l'interfaccia dell'applicazione. Esaminare gli argomenti applicabili alla propria situazione:
Informazioni sui componenti del sistema.
- Oggetti del sistema

1.2.4 Gestione delle impostazioni dei cookie

Le applicazioni RICOH TotalFlow Cloud utilizzano i cookie per migliorare l'esperienza degli utenti con il nostro software. È possibile controllare le impostazioni di alcuni di questi cookie.

Le applicazioni RICOH TotalFlow Cloud potrebbero utilizzare questi tipi di cookie:

Cookie strettamente necessari: Si tratta di cookie essenziali per il funzionamento delle nostre applicazioni. Se si decide di non accettare questi cookie, potrebbe non essere possibile accedere alle nostre applicazioni o utilizzare altre funzioni essenziali.
Cookie di prestazione: I cookie di prestazione, noti anche come cookie statistici, raccolgono informazioni sul funzionamento delle nostre applicazioni. Queste informazioni sono aggregate e rese anonime, quindi non possono essere utilizzate per identificare l'utente.; I dati sulle prestazioni raccolti comprendono le informazioni raccolte da Google Analytics. Per evitare che i dati vengano raccolti da Google Analytics, disattivare i cookie di prestazione.
Cookie di funzionalità: I cookie di funzionalità, noti anche come cookie di preferenze, ricordano informazioni come l'ultima pagina visitata o la lingua preferita.
Cookie di marketing: I cookie di marketing raccolgono informazioni sull'attività online per contribuire a fornire pubblicità pertinenti.

Per gestire le impostazioni dei cookie:

Accedere a qualsiasi applicazione TotalFlow Cloud.
Nel banner, fare clic su , l'icona Account, e selezionare Impostazioni dei cookie.
Nella finestra di dialogo Impostazioni dei cookie, fare clic su Visualizza informativa sui cookie per visualizzare un elenco dei cookie utilizzati nelle applicazioni TotalFlow Cloud e le relative descrizioni.
Utilizzare gli interruttori per attivare o disattivare ciascun tipo di cookie.
Per impostazione predefinita, tutti i cookie sono attivati:
Fare clic su OK.

1.3 Configurazione

Utilizzare queste procedure per configurare il sistema in modo che possa essere utilizzato da altri dipendenti dell'azienda.

1.3.1 Aggiunta di utenti

Quando si aggiunge un utente, è necessario specificare le relative informazioni di contatto e il tipo di ruolo che ricopre per ciascuna applicazione.

È possibile creare un nuovo utente o copiare un utente esistente. La copia di utenti può far risparmiare tempo, specialmente quando è necessario creare più utenti con proprietà simili.

Per aggiungere un utente:

Nel riquadro di sinistra, fare clic su Utenti.
Scegliere una delle seguenti opzioni:
- Per aggiungere un nuovo utente: fare clic su Aggiungi utente nell'angolo in alto a destra della finestra.
- Per copiare un utente esistente: fare clic con il tasto destro del mouse sulla riga di un utente esistente e selezionare Duplica.
Nella finestra di dialogo che si apre, inserire i dettagli dell'utente.
In Tipo di utente, selezionare Interno per creare un account utente per uno dei propri dipendenti.
In Ruolo piattaforma, selezionare una delle seguenti opzioni:
- Standard - L'utente può effettuare l'accesso all'applicazione con le opzioni di time-out e accesso standard.
- Schermo grande - L'utente ha accesso all'applicazione in sola visualizzazione su uno schermo grande e l'accesso non scade.
In Accesso e ruoli, selezionare l'accesso e il ruolo dell'utente per ogni applicazione. Fare clic sulla freccia nella colonna Accesso e ruoli per ciascuna applicazione.
- Alcuni abbonamenti includono limitazioni al numero di utenti che è possibile assegnare a ciascun ruolo.
Fare clic su Ok.

L'utente riceve un'e-mail che lo invita ad accedere a RICOH TotalFlow Cloud, dove può modificare le proprie informazioni e cambiare la password. L'invito via e-mail è valido per sette giorni.

Nota:

Se l'utente non accede prima della scadenza dell'invito via e-mail, è possibile inviare nuovamente l'invito. Fare clic con il tasto destro del mouse sull'utente e scegliere Invia nuovamente invito.

1.4 Gestione degli oggetti

Dopo aver creato gli utenti e configurato i dettagli dell'account è possibile aggiornarli secondo le necessità.

1.4.1 Gestione dei dettagli dell'account

È possibile modificare i dettagli dell'account, incluse le informazioni sulla società e di contatto.

Per gestire i dettagli account:

Fare clic su Dettagli nel pannello a sinistra.
Fare clic su Modifica dettagli.
Modificare le informazioni in base alle necessità e fare clic su Ok.

1.4.2 Modifica delle informazioni dell'utente

È possibile modificare le informazioni dell'utente, se necessario.

Per modificare le informazioni dell'utente:

Fare clic su Utenti nel riquadro a sinistra.
Fare clic con il pulsante destro del mouse sull'utente di cui si desidera modificare le informazioni e selezionare Modifica.
Modificare le informazioni dell'utente in base alle necessità e fare clic su Ok.

1.4.3 Modifica della password

Modificare la password per garantire la sicurezza dell'account.

Nota:

Se non si conosce la password corrente, aprire la pagina di login a RICOH TotalFlow Cloud e fare clic su Password dimenticata. Digitare l'indirizzo e-mail e fare clic su Avanti. Controllare l'e-mail per ricevere un messaggio da RICOH TotalFlow Cloud contenente le istruzioni per reimpostare la password.

Per modificare la password:

Accedere a RICOH TotalFlow Cloud.
Nel banner, fare clic su , l'icona Account e scegliere Impostazioni profilo.
Sul lato sinistro della pagina Profilo e preferenze Ricoh, fare clic su Password.
Immettere due volte la password attuale e la nuova password.
Fare clic su Modifica password.
Fare clic su Chiudi.

Al successivo accesso, assicurarsi di utilizzare la nuova password.

1.5 Utilizzo dell'API di esportazione dei dati

Grazie all'API di esportazione dei dati, è possibile estrarre le informazioni raccolte da RICOH Predictive Insight per utilizzarle in altri processi e strumenti all'interno della propria organizzazione.

L'API di esportazione dei dati consente l'accesso programmatico alle informazioni relative alla stampante, alla cronologia dei lavori, ai dati sullo stato della stampante e agli eventi di intervento sulla stampante. Può utilizzarlo per alimentare strumenti di reporting, compilare dashboard, archiviare dati operativi o integrare i dati di RICOH Predictive Insight con altri sistemi presenti nel Suo ambiente.

1.5.1 API di esportazione dei dati

L'API di esportazione dei dati è un'API REST che mette a disposizione quattro endpoint. È possibile utilizzare tali endpoint per scaricare informazioni relative alle proprie stampanti e ai processi da esse elaborati, nonché sugli stati operativi di tali stampanti nel corso del tempo e sugli eventi che hanno generato messaggi di avviso o di errore sulla stampante.

È possibile utilizzare l'API di esportazione dei dati per importare RICOH Predictive Insight data negli strumenti di business intelligence, nei data warehouse, nei dashboard e nelle altre applicazioni della propria organizzazione.

Autenticazione

È possibile creare e gestire le chiavi API in RICOH Account Administration. È possibile creare tutte le chiavi necessarie: una per ogni applicazione che scarica dati oppure una chiave da utilizzare a livello dell’intera organizzazione. Impostino la data di scadenza in base alle proprie procedure di sicurezza e procedano alla rotazione delle chiavi secondo necessità. È possibile impostare il periodo di sovrapposizione, in modo che sia la vecchia chiave che quella nuova funzionino per un certo numero di giorni. Se necessario, è possibile eliminare una chiave per disattivarla immediatamente.

La chiave API contiene anche l'identità del proprio tenant; per questo motivo non è necessario specificare alcun parametro relativo al tenant o all'account in nessuna richiesta. Chiunque disponga del valore della chiave può inviare richieste a nome del proprio tenant; pertanto, è necessario proteggere le chiavi API con la stessa cura con cui si proteggerebbe una password.

Endpoint disponibili

L'API comprende i seguenti endpoint:

/printers

Restituisce l'elenco delle stampanti presenti nel Suo account, includendo il nome della stampante, il modello, il produttore, il numero di serie, i motori e lo stato attuale della connessione.

/jobs

Restituisce i dettagli a livello di lavoro relativi a una o più stampanti, inclusi i tempi, le copie stampate, le pagine, le impressioni, i fogli, la lunghezza del rotolo e il consumo di inchiostro e di scaricamento per ciascun canale di colore. Per impostazione predefinita, la risposta copre le ultime 24 ore.

/printer-states

Restituisce lo stato operativo di ciascun motore della stampante, sotto forma di cronologia aggregata relativa a un intervallo di tempo oppure solo come stato attuale. È possibile recuperare gli stati effettivi della stampante, quali: Stampa, Preparazione, Manutenzione o Sospensione; in alternativa, tali stati possono essere raggruppati nelle seguenti categorie: up, down, idle o unknown.

Suggerimento: L'endpoint /printer-states riporta le informazioni sullo stato per ciascun motore della stampante, non per ciascuna stampante. Una stampante dotata di più motori restituisce una riga per ciascun motore.

/printer-interventions

Restituisce gli eventi che hanno causato avvisi o errori su una o più stampanti, quali un inceppamento della carta o l’esaurimento della carta. Ogni evento viene riportato per un singolo motore di stampa, indicando l’ora di inizio, l’ora di fine, la durata, un codice che identifica la condizione e, se presente, il nome del lavoro in corso di stampa. Per impostazione predefinita, la risposta copre le ultime 24 ore. È possibile richiedere le descrizioni degli eventi in una qualsiasi delle lingue supportate.

Verifica dell'API

È disponibile una pagina di documentazione interattiva che Le consente di esaminare ciascun endpoint, visualizzarne i parametri accettati e provare richieste di esempio direttamente dal Suo browser. Per aprire la pagina, si rechi all'indirizzo:

Stati Uniti e Giappone: https://rpi-data-export.app-ricohsoftware.com/api/v1/api-docs
Europa: https://rpi-data-export.app-ricohsoftware.eu/api/v1/api-docs

Per inviare richieste dalla pagina della documentazione o dalle proprie applicazioni, è necessario innanzitutto creare una chiave API. È possibile creare e gestire le chiavi API in Account Administration.

1.5.2 Creazione e gestione delle chiavi API

Una chiave API autorizza le richieste all'API di esportazione dei dati. È possibile creare e gestire le chiavi API in Account Administration e fornire la chiave quando si inviano richieste dalla pagina Esploratore API o dalle proprie applicazioni.

Ogni richiesta all'API di esportazione dei dati deve includere una chiave API valida nell'intestazione della richiesta x-api-key. La chiave autentica la richiesta relativa al Suo account (tenant).

Per creare chiavi API, è necessario disporre dell'accesso Amministratore a Account Administration.

Si utilizzino le procedure descritte in questa sezione per:

Creare una nuova chiave API.
Modifichi il nome, la data di scadenza o la descrizione di una chiave esistente.
Ruotare una chiave per sostituirne il valore segreto senza modificarne l'identità.
Rimozione di una chiave dal sistema.

Nota: Quando si crea o si aggiorna una chiave API, trascorre un breve lasso di tempo prima che la chiave venga registrata e sia pronta per l'uso. In genere, tale intervallo è inferiore a un minuto.

Per creare una nuova chiave API:
1. Nel riquadro di sinistra di Account Administration, faccia clic su Chiavi API.
2. Fare clic su Crea chiave API.
3. Inserisca un nome e una descrizione per questa chiave.
4. Per Data di scadenza, scelga una data entro 367 giorni dal momento attuale.
5. Per Licenze, selezionare Piano di utilizzo dell'esportazione dei dati RPI per le chiavi API.
6. Fare clic su Avanti.
  La chiave è stata generata e salvata.
7. Clicchi su Coppia per copiare la chiave generata negli appunti. Lo conservi in un luogo sicuro.
  
  Importante: Il valore completo della chiave viene visualizzato solo al momento della creazione della chiave. Non potrà accedervi nuovamente. Se si perde il valore, è necessario ruotare la chiave per generarne una nuova.
1. Clicchi su Ho salvato la mia chiave per chiudere la finestra di dialogo.
Per modificare una chiave API esistente:
1. Nel riquadro di sinistra di Account Administration, faccia clic su Chiavi API.
2. Individuate la chiave che desiderate modificare. Faccia clic con il tasto destro del mouse sulla riga relativa alla chiave e selezioni Modifica chiave API.
3. Aggiorni il nome, la data di scadenza o la descrizione secondo necessità.
  La modifica di una chiave non comporta alcuna variazione del valore della chiave. Le applicazioni che già utilizzano la chiave continuano a funzionare senza modifiche.
4. Fare clic su Ok.
Per ruotare una chiave API:
1. Nel riquadro di sinistra di Account Administration, faccia clic su Chiavi API.
2. Individui la chiave che desidera ruotare. Faccia clic con il tasto destro del mouse sulla riga relativa alla chiave e selezioni Ruota chiave API.
3. Impostare il parametro Periodo di sovrapposizione in giorni sul numero di giorni per i quali si desidera che sia la chiave esistente sia la versione ruotata rimangano attive contemporaneamente.
4. Impostare un nuovo valore di Data di scadenza per la chiave.
5. Fare clic su Ok.
6. Clicchi su Coppia per copiare la chiave generata negli appunti. Lo conservi in un luogo sicuro.
  
  Importante: Il valore completo della chiave viene visualizzato solo al momento della creazione della chiave. Non potrà accedervi nuovamente. Se si perde il valore, è necessario ruotare la chiave per generarne una nuova.
7. Aggiorni tutte le applicazioni, gli script o le sessioni di documentazione interattiva salvate che utilizzano la chiave prima della scadenza del periodo di sovrapposizione.
Per la rimozione di una chiave dal sistema:
1. Nel riquadro di sinistra di Account Administration, faccia clic su Chiavi API.
2. Individui la chiave che desidera ruotare. Faccia clic con il tasto destro del mouse sulla riga relativa alla chiave e selezioni Elimina immediatamente.
3. Nella finestra di dialogo, selezionare Sì, elimina la chiave.
  Questo passaggio è necessario, poiché eliminare è definitivo. Una volta eliminata la chiave, non sarà più possibile recuperarla.
4. Fare clic su Ok.

È possibile utilizzare la chiave API nuova o aggiornata nella pagina della documentazione interattiva per testare l'API di esportazione dei dati, nonché in qualsiasi applicazione che invii richieste all'API.

1.5.3 Provare l'API di esportazione dei dati

Segua questa procedura per una breve introduzione all'API, utilizzando la pagina della documentazione interattiva come guida.

Prima di iniziare questa operazione, crei una chiave API utilizzando RICOH Account Administration.

Questa procedura illustra come eseguire le seguenti operazioni:

Autenticazione della pagina di documentazione interattiva
Recupero dell'elenco degli ID stampante per le stampanti del proprio account
Recupero dello stato di una o più stampanti
Richiesta di informazioni relative ai lavori associati a una o più di tali stampanti

Per utilizzare l'API di esportazione dei dati:

Apra qui la documentazione interattiva dell'API di esportazione dei dati:
- Stati Uniti e Giappone: https://rpi-data-export.app-ricohsoftware.com/api/v1/api-docs
- Europa: https://rpi-data-export.app-ricohsoftware.eu/api/v1/api-docs
Autenticarsi utilizzando una chiave API:
1. Clicchi su Autorizza nella parte destra della pagina.
2. Nella finestra di dialogo Autorizzazioni disponibili, immettere la chiave API nel campo Valore.
1. Clicchi su Autorizza per effettuare l'autenticazione.
2. Fare clic su Close.
Ora potete provare le funzioni API disponibili. Utilizzare questa interfaccia per acquisire familiarità con la sintassi prima di integrare l'API nelle proprie applicazioni.
Recuperare l'elenco degli ID stampante per le stampanti definite nel proprio account.
Per recuperare le informazioni relative allo stato dei lavori e delle stampanti, è necessario includere i valori dell'ID della stampante nelle richieste API. Gli ID delle stampanti non cambiano. Se si recuperano ora e si salvano i valori, è possibile utilizzare gli ID in altre chiamate API.
1. Apra la sezione Stampanti, quindi apra l'endpoint GET /printers.
  Come potete vedere, per questo endpoint non sono richiesti parametri.
2. Fare clic su Prova, quindi su Esegui.
3. Esamini il corpo della risposta. Viene visualizzato un elenco di informazioni relative alle stampanti monitorate da RICOH Predictive Insight. La risposta è simile a questa:
```
[
  {
    "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"
  }
]
```
  Si prega di registrare i valori dei parametri printerId per ciascuna delle vostre stampanti.
Richiedere la cronologia dello stato della stampante per una o più stampanti nel proprio sistema.
1. Apra l'endpoint GET /printer-states.
2. Clicchi su Prova.
3. Accanto a printerId, faccia clic su Aggiungi elemento stringa.
4. Sostituisca il testo nel campo con uno dei valori dell'ID della stampante che ha recuperato al punto 3.
  Per recuperare la cronologia degli stati di altre stampanti, fare nuovamente clic su Aggiungi elemento stringa e inserire un altro valore di ID stampante.
5. Per il fuso orario, scegliere il fuso orario da utilizzare per i dati.
6. Specifichi gli orari di inizio e di fine dell'intervallo di tempo oggetto del report. Lasci i campi vuoti per recuperare i dati relativi alle ultime 24 ore.
7. Lasci i tre ultimi valori impostati sui valori predefiniti, in modo da poter visualizzare l'elenco completo delle informazioni che l'API è in grado di restituire.
8. Clicchi su Esegui.
9. Esamini il corpo della risposta. Per ogni motore della stampante viene visualizzato un elenco dei dati sullo stato della stampante, con una stanza per ogni modifica dello stato della stampante.
10. Modifichi i valori dei parametri currentState, stateCategoryOnly e stateCategory, quindi faccia nuovamente clic su Esegui per osservare come cambia la risposta.
  - Lasciare questi parametri impostati sui valori predefiniti (non specificati) ha lo stesso effetto che impostarli su falso.
  - Potete utilizzarli singolarmente o in combinazione tra loro.
Richieda informazioni sui lavori associati a una o più di tali stampanti:
1. Sezione Lavori della pagina.
2. Apra l'endpoint GET /jobs.
3. Clicchi su Prova.
4. Accanto a printerId, faccia clic su Aggiungi elemento stringa.
5. Sostituisca il testo nel campo con uno dei valori dell'ID della stampante che ha recuperato al punto 3.
  Per recuperare le informazioni lavoro per altre stampanti, fare nuovamente clic su Aggiungi elemento stringa e inserire un altro valore di ID stampante.
6. Per il fuso orario, scegliere il fuso orario da utilizzare per i dati.
7. Specifichi gli orari di inizio e di fine dell'intervallo di tempo oggetto del report. Lasci i campi vuoti per recuperare i dati relativi alle ultime 24 ore.
8. Per jobState, lasciare il valore vuoto per visualizzare l'intera gamma di risposte che l'API può restituire.
9. Clicchi su Esegui.
10. Esamini la risposta per visualizzare le informazioni lavoro restituiti.
11. Modifichi il valore di jobState e faccia nuovamente clic su Esegui per osservare come cambia la risposta.

1.5.4 Date e ora: gestione nell'API di esportazione dei dati

L'API di esportazione dei dati utilizza un unico modello coerente per la gestione di date e ore: ogni richiesta specifica un fuso orario IANA, ogni valore di data e ora viene interpretato in base a tale fuso orario e ogni valore di data e ora presente nella risposta viene formattato secondo lo stesso fuso orario. Utilizzi questa sezione per comprendere il funzionamento del modello ed evitare gli errori più comuni.

Il modello di data e ora

Tre regole descrivono il modo in cui l’API gestisce le date e gli orari:

Ogni richiesta indirizzata a /jobs, /printer-states e /printer-interventions deve includere un parametro timezone contenente un identificatore di fuso orario IANA valido, ad esempio America/Denver o Europe/Bucharest.
Qualsiasi valore startDateTime o endDateTime fornito nella richiesta viene interpretato come ora locale nel fuso orario specificato. I valori non includono l'Offset UTC.
Ogni valore relativo alla data e all’ora contenuto nella risposta è formattato come ora locale nello stesso fuso orario, utilizzando il formato YYYY-MM-DDTHH:MM:SS.sss.

Il parametro timezone determina il significato della richiesta e la formattazione della risposta. Due richieste relative agli stessi dati sottostanti, inviate con fusi orari diversi, generano risposte con stringhe di data/ora diverse, sebbene descrivano gli stessi eventi.

Formato di data e ora

L'API utilizza un unico formato per tutti i valori relativi alla data e all'ora, sia nelle richieste che nelle risposte:

YYYY-MM-DDTHH:MM:SS.sss

Ad esempio, 2026-03-15T14:30:00.000 corrisponde alle 14:30:00 del 15 marzo 2026, secondo il fuso orario specificato nella richiesta.

Importante: Il formato non include un Offset UTC (ad esempio -06:00) né il suffisso Z. Non ne aggiunga uno. Sia le richieste che le risposte utilizzano esclusivamente l'ora locale, mentre il fuso orario viene indicato separatamente come parametro della richiesta.

Nelle richieste, la parte relativa ai millisecondi (.sss) è facoltativa. Nelle risposte, è sempre presente.

Intervallo di tempo predefinito

È possibile omettere startDateTime, endDateTime o entrambi. Le due impostazioni predefinite vengono applicate in modo indipendente:

Se si omette il parametro startDateTime, l'API utilizza come punto di inizio dell'intervallo il momento che precede di 24 ore l'ora corrente.
Se si omette il parametro endDateTime, l'API utilizza l'ora corrente come data di fine dell'intervallo.

Le impostazioni predefinite si combinano nel modo che ci si aspetterebbe:

Se si omettono entrambi i valori, l'API restituisce i dati relativi alle ultime 24 ore.
Se si specifica startDateTime come "un’ora fa" e si omette endDateTime, l’API restituisce i dati relativi all’ora precedente.
Se si specifica endDateTime e si omette startDateTime, l’API restituisce i dati relativi all’intervallo che inizia 24 ore prima della richiesta e termina all’endDateTime.

I valori predefiniti vengono calcolati in base al fuso orario specificato nella richiesta.

Conservazione dei dati: gli ultimi sette giorni

L'API di esportazione dei dati fornisce dati operativi in tempo reale. I registri dei lavori, la cronologia dello stato della stampante e gli eventi di intervento sono disponibili solo per i sette giorni precedenti. Una richiesta relativa a dati risalenti a più di sette giorni fa genera un errore.

Pianifichi l’integrazione in modo che le estrazioni pianificate vengano eseguite con una frequenza sufficiente a acquisire tutti i dati prima che questi diventino obsoleti:

Per gli estratti notturni, si raccomanda di prevedere un margine di almeno uno o due giorni. Se un'esecuzione pianificata non va a buon fine, ha il tempo di indagare e di rieseguirla prima che i dati non siano più disponibili.
Per i riempimenti o le estrazioni una tantum, non richieda dati risalenti a più di sette giorni fa.

Regole relative all'intervallo richiesto

startDateTime deve essere precedente a endDateTime. Una richiesta che violi questa regola genera l'errore ERR_INVALID_DATE_RANGE.
Entrambi i valori devono rispettare il formato descritto all'indirizzo Formato di data e ora. Una richiesta contenente un valore non valido genera un errore ERR_INVALID_DATE_FORMAT.
L'intervallo di tempo compreso tra startDateTime e endDateTime non deve superare l'intervallo massimo consentito. Una richiesta che superi il limite massimo genera un errore ERR_DATE_RANGE_EXCEEDED.

Indicare il fuso orario

Il parametro timezone accetta gli identificatori di fuso orario IANA, quali America/Denver, America/New_York, Europe/Bucharest, Asia/Tokyo o UTC. La pagina della documentazione interattiva presenta un elenco di tutti i valori accettati dall'API.

Un identificatore non valido o non riconosciuto genera l'errore ERR_INVALID_TIMEZONE. Le abbreviazioni di tre lettere, quali MST o EST, non sono identificatori IANA e non sono accettate; si prega di utilizzare invece il corrispondente identificatore basato sull'area (ad esempio, America/Denver o America/New_York).

Fornitura della lingua

Il parametro timezone non è l'unico parametro che determina il modo in cui l'API formatta una risposta. L'endpoint /printer-interventions accetta anche un parametro facoltativo relativo alla language, che determina la lingua del campo description nella risposta.

I valori ammessi sono en (inglese), de (tedesco), ja (giapponese), it (italiano), fr (francese) ed es (spagnolo). Se il valore non è presente in questo elenco, l'operazione genera un errore con codice ERR_INVALID_LANGUAGE.

È opportuno tenere in considerazione due aspetti di questo parametro:

Se omette il parametro, oppure se la descrizione non è disponibile nella lingua da Lei richiesta, la descrizione verrà restituita in inglese. La richiesta va a buon fine in entrambi i casi, pertanto la vostra integrazione non può dare per scontato che la lingua di una descrizione sia corrispondente a quella richiesta.
Il parametro influisce esclusivamente sul campo della description. Il campo interventionCode ad esso associato è indipendente dalla lingua; pertanto, lo utilizzi quando ha bisogno di raggruppare, confrontare o memorizzare gli eventi in modo coerente, indipendentemente dalla lingua richiesta.

Ora legale e orari ambigui

Poiché le richieste e le risposte sono espresse in ora locale, i passaggi all’ora legale danno luogo a due situazioni di cui occorre tenere conto:

Orari locali saltati durante il passaggio all'ora legale: Quando si sposta in avanti l’orologio, un’ora dell’ora locale non esiste. Ad esempio, nel fuso orario America/Denver, il giorno del passaggio all’ora legale, le 02:30:00 non costituiscono un’ora locale valida. Si prega di evitare di utilizzare orari compresi nell'ora saltata come startDateTime o endDateTime.
Orari locali ripetuti durante il passaggio all’autunno: Quando si sposta indietro l’orologio, un’ora di ora locale si verifica due volte. Un valore come 01:30:00 nel giorno del cambio di ora autunnale è ambiguo. Scelga orari al di fuori dell'ora ripetuta per evitare incertezze riguardo all'istanza che sta richiedendo.

Se la Sua integrazione viene eseguita in modo automatico e potrebbe inviare una richiesta il cui orario di inizio o di fine ricada all’interno di una transizione, pianifichi l’esecuzione della richiesta in modo che avvenga a distanza di alcune ore dalla transizione oppure utilizzi orari che siano chiaramente al di fuori di essa.

Raccomandazioni per l'archiviazione e il confronto delle date/ore delle risposte

Le date/ore delle risposte indicano l'ora locale senza alcun offset. Per evitare ambiguità nei sistemi a valle, si raccomanda di adottare uno dei seguenti approcci:

Salvi la data/ora della risposta insieme al fuso orario specificato nella richiesta. Questi due elementi, considerati nel loro insieme, definiscono un istante unico nel tempo.
Nella Sua integrazione, converta ogni data/ora della risposta in UTC prima di memorizzarla, utilizzando il fuso orario specificato nella richiesta. La memorizzazione dei valori UTC semplifica i confronti tra dati estratti con fusi orari diversi.
Inviate sempre le richieste utilizzando lo stesso fuso orario, ad esempio UTC, in modo che tutte le date/ore memorizzate siano direttamente comparabili.

Esempi

Gli esempi seguenti illustrano come il fuso orario, l'ora di inizio e l'ora di fine interagiscano tra loro.

Finestra predefinita in Mountain Time: Una richiesta inviata alle ore 9:00 del 15 marzo 2026, nel fuso orario America/Denver, senza che siano state specificate né l'ora di inizio né quella di fine, restituisce i dati compresi tra 2026-03-14T09:00:00 e 2026-03-15T09:00:00, con entrambi gli orari interpretati in Mountain Time.
Fascia oraria specifica nell’Europa orientale: Una richiesta che specifichi timezone=Europe/Bucharest, startDateTime=2026-03-15T08:00:00 e endDateTime=2026-03-15T16:00:00 restituisce i dati relativi alla giornata lavorativa di otto ore secondo l’ora locale di Bucarest. Anche le date/ore delle risposte sono espresse nell'ora locale di Bucarest.
La stessa finestra visualizzata in due fusi orari: Per recuperare due volte gli stessi dati sottostanti, formattati per due diversi gruppi di destinatari, invii due richieste con valori timezone diversi e modifichi startDateTime e endDateTime in modo che corrispondano agli stessi istanti in ciascun fuso orario. I payload delle risposte descrivono gli stessi eventi, ma utilizzano stringhe di data/ora diverse.

1.5.5 Campi della risposta dell'API di esportazione dei dati

Ogni endpoint dell'API di esportazione dei dati restituisce un array JSON di oggetti. Utilizzi le tabelle riportate in questa sezione per interpretare i campi presenti in ciascuna risposta.

Convenzioni utilizzate nel presente documento di riferimento

Tutte le durate sono espresse in millisecondi.
Tutti i valori relativi alla data e all'ora vengono formattati in base al timezone specificato dal parametro di richiesta timezone, utilizzando il formato YYYY-MM-DDTHH:MM:SS.sss.
I campi identificativi (printerId, jobId) rimangono invariati tra una richiesta e l’altra e possono essere memorizzati nella cache dalle applicazioni integrate. Il printerId non cambia mai, pertanto i valori possono essere memorizzati e riutilizzati tra una sessione e l’altra.

Campi di risposta dell'operazione GET /printers

L'endpoint /printers restituisce un oggetto per ciascuna stampante identificata nell'account e monitorata dalla raccolta dati.

Campo	Tipo	Descrizione
`printerName`	stringa	Il nome visualizzato assegnato alla stampante in RICOH Predictive Insight.
`printerId`	stringa (UUID)	L'identificatore univoco della stampante. Utilizzi questo valore come parametro `printerId` quando effettua una chiamata alle API `/jobs`, `/printer-states` o `/printer-interventions`.
`engines`	intero	Il numero di moduli di stampa presenti nella stampante. Le stampanti a alimentazione continua possono essere dotate di uno o più motori; le stampanti a fogli singoli, invece, dispongono in genere di un unico motore. Ogni motore viene riportato come riga separata nelle risposte dei file `/printer-states` e `/printer-interventions`.
`manufacturer`	stringa	Il produttore della stampante, ad esempio Ricoh o InfoPrint.
`model`	stringa	Il modello della stampante indicato dal dispositivo, ad esempio RICOH Pro VC80000.
`printerMode`	stringa	Se la stampante sta funzionando in modalità `simplex` o `duplex`. Questo campo può essere assente per i tipi di stampante in cui il valore non è applicabile, come ad esempio i dispositivi a fogli singoli.
`printerType`	stringa	Se la stampante supporta la carta a `continuous_feed` o a `cut_sheet`.
`serialNumber`	stringa	Il numero di serie indicato dalla stampante. Nel caso delle stampanti multimotore, questo campo può contenere i numeri di serie di ciascun motore in un'unica stringa; ad esempio, Stampante 1: 10-11111 e Stampante 2: 10-11112.
`connectionStatus`	stringa	Indica se, al momento, RICOH Predictive Insight è in grado di connettersi alla stampante. I valori possibili sono `connected` e `not_connected`.

Campi della risposta GET /jobs

L'endpoint /jobs restituisce un oggetto per ogni processo elaborato dalle stampanti specificate nell'intervallo di tempo richiesto.

Campo	Tipo	Descrizione
`printerId`	stringa (UUID)	L'identificativo della stampante che ha elaborato il lavoro. È un valore corrispondente a un `printerId` presente nella risposta `/printers`.
`jobId`	stringa	L'identificatore univoco del lavoro.
`jobName`	stringa	Il nome del lavoro così come è stato inviato alla stampante, solitamente il nome del file di origine.
`jobPrintingSide`	stringa	Il lato o i lati su cui viene stampato il presente lavoro, ad esempio in modalità `simplex` o `duplex`.
`jobAction`	stringa	Lo stato del lavoro al momento dell'elaborazione della richiesta. Valori possibili: `printing`: al momento dell'invio della richiesta, il lavoro era in fase di stampa. `imprinting`: il lavoro di stampa si è concluso con esito positivo. `aborted`: il lavoro si è concluso prima che la stampa fosse completata. `completed`: il lavoro ha raggiunto lo stato finale. Questo valore costituisce un insieme più ampio che comprende sia i lavori `printed` sia quelli `aborted`. Utilizzatelo quando desiderate recuperare tutti i lavori che non sono più attivi, indipendentemente dall'esito.
`jobStartTime`	stringa (data e ora)	La data e l'ora locali in cui è iniziata la stampa del lavoro, nel fuso orario specificato nella richiesta.
`jobEndTime`	stringa (data e ora)	La data e l'ora locali in cui il lavoro è terminato, nel fuso orario specificato nella richiesta.
`jobDuration`	intero	Il tempo di stampa trascorso per il lavoro, espresso in millisecondi.
`printedCopies`	intero	Il numero di copie prodotte per il lavoro.
`printedPages`	intero	Il numero totale di pagine logiche stampate per il lavoro, comprese tutte le copie.
`printedImpressions`	intero	Il numero totale di copie stampate. Un'impressione corrisponde a un lato di un foglio; pertanto, un lavoro fronte-retro produce due impressioni per foglio.
`printedSheets`	intero	Il numero totale di fogli cartacei utilizzati per i lavori.
`printedRollFeet`	number	Per le stampanti a alimentazione continua, la lunghezza del supporto consumato dal lavoro, espressa in piedi.
`printedRollMeters`	number	Per le stampanti a alimentazione continua, la lunghezza del supporto consumato dal lavoro, espressa in metri.
`inkC, inkM, inkY, inkK`	number	La quantità di inchiostro ciano, magenta, giallo e nero consumata dal lavoro, indicata per ciascun canale di colore in centimetri cubi (cc).
`flushingC, flushingM, flushingY, flushingK`	number	La quantità di inchiostro ciano, magenta, giallo e nero consumata durante le operazioni di scaricamento della testina di stampa associate al lavoro, indicata per ciascun canale di colore in centimetri cubi (cc). I valori relativi allo scaricamento vengono monitorati separatamente da `inkC/M/Y/K`, in modo da poter distinguere l'utilizzo produttivo dell'inchiostro da quello legato alla manutenzione.

Campi della risposta GET /printer-states

L'endpoint /printer-states restituisce un oggetto per ogni motore della stampante, per ogni intervallo di stato. La presenza dei campi dipende dalla modalità di richiesta:

Cronologia aggregata (impostazione predefinita): vengono restituiti tutti i campi.
Solo stato attuale (currentState=true): printerStateDuration, historyStartTime e historyEndTime vengono omessi.
Solo categoria di stato (stateCategoryOnly=true): printerState viene omesso.

Campo	Tipo	Descrizione
`printerId`	stringa (UUID)	L'identificatore della stampante a cui si riferisce questa riga. È un valore corrispondente a un `printerId` presente nella risposta `/printers`.
`engine`	stringa	Il motore all’interno della stampante a cui si riferisce questa riga, ad esempio `engine_1`, `engine_2` o `engine_3`. Una stampante dotata di più motori restituisce una riga per ogni motore per ciascun intervallo di stato.
`stateCategory`	stringa	La categoria di livello superiore a cui si ricollega lo stato del motore. I valori possibili sono: `up`, `down`, `idle` e `unknown`. Utilizzi questo campo per i dashboard e i report che richiedono categorie uniformi per tutti i modelli di stampante.
`printerState`	stringa	Lo stato grezzo segnalato dal motore di stampa, ad esempio Stampa, Preparazione, Manutenzione o Sospensione. I valori grezzi variano a seconda del modello di stampante. Viene omesso quando `stateCategoryOnly=true`. Nota: Si prega di consultare il sito Stati della stampante e categorie di stato per un elenco completo degli Stati e delle relative corrispondenze.
`printerStateDuration`	intero	Il tempo, espresso in millisecondi, durante il quale il motore è rimasto in tale stato. Viene omesso quando `currentState=true`.
`historyStartTime`	stringa (data e ora)	La data e l'ora locali in cui il motore è entrato in questo stato, nel fuso orario specificato nella richiesta. Viene omesso quando `currentState=true`.
`historyEndTime`	stringa (data e ora)	La data e l'ora locali in cui il motore ha lasciato questo stato, nel fuso orario specificato nella richiesta. Per l'intervallo più recente in una risposta aggregata, tale valore può corrispondere alla fine dell'intervallo di tempo richiesto. Viene omesso quando `currentState=true`.

Campi della risposta GET /printer-interventions

L'endpoint /printer-interventions restituisce un oggetto per ogni evento di intervento, per ciascun motore di ciascuna stampante richiesta, nell'intervallo di tempo specificato.

Campo	Tipo	Descrizione
`printerId`	stringa (UUID)	L'identificatore della stampante a cui si riferisce questa riga. È un valore corrispondente a un `printerId` presente nella risposta `/printers`.
`interventionStartDate`	stringa (data e ora)	La data e l'ora locali in cui l'evento ha avuto inizio, nel fuso orario specificato nella richiesta.
`interventionEndDate`	stringa (data e ora)	La data e l'ora locali in cui l'evento è stato risolto, nel fuso orario specificato nella richiesta.
`duration`	intero	La durata dell'evento, espressa in millisecondi.
`description`	stringa	Una breve descrizione della condizione che ha causato l'avviso o l'errore, ad esempio Supporti di stampa vuoti o Inceppamento carta. Questo campo dipende dalla lingua: viene restituito nella lingua specificata dal parametro `language`, oppure in inglese qualora tale parametro venga omesso o la descrizione non sia disponibile nella lingua richiesta.
`engine`	stringa	Il motore all’interno della stampante a cui si riferisce questa riga, ad esempio `engine_1`, `engine_2` o `engine_3`. Una stampante dotata di più motori restituisce una riga per ogni motore per ciascun evento.
`jobName`	stringa	Il nome del lavoro di stampa in corso al momento in cui si è verificato l’evento. Il valore è una stringa vuota qualora l'evento non riguardasse alcun lavoro.
`interventionCode`	stringa	Un codice che identifica la condizione. A differenza della `description`, questo valore è indipendente dalla lingua; lo utilizzi quindi quando ha bisogno di raggruppare o confrontare eventi tra lingue diverse. Il formato del codice dipende dalla stampante: le stampanti a fogli singoli riportano una stringa descrittiva, ad esempio `coverOpen`, mentre le stampanti a modulo continuo riportano un valore, ad esempio `CA00` o `40000006`.

1.5.5.1 Stati della stampante e categorie di stato

L'endpoint /printer-states riporta sia lo stato grezzo della stampante sia una categoria di stato di alto livello. Utilizzi le tabelle riportate in questa sezione per comprendere quali stati grezzi rientrino nelle diverse categorie.

Informazioni sugli stati e sulle categorie delle stampanti

Per ogni motore di stampa, l'API di esportazione dei dati riporta due valori correlati:

printerState: Lo stato operativo grezzo segnalato dal motore di stampa, ad esempio printing, sleeping o maintenance. L'insieme degli stati grezzi varia a seconda del modello di stampante.
stateCategory: Un raggruppamento di alto livello che classifica lo stato grezzo come up, down, idle o unknown. Le categorie sono uniformi tra i diversi modelli di stampante; pertanto, rappresentano la scelta migliore per i cruscotti e i report che aggregano i dati provenienti da più stampanti.

Le assegnazioni alle categorie sono definite da RICOH Predictive Insight e si applicano in modo uniforme a tutte le stampanti che inviano dati tramite l'API di esportazione dei dati.

Stati a nord

Un motore viene considerato up quando sta attivamente generando potenza o si sta attivamente preparando a generarla. Utilizzi questa categoria per misurare il tempo operativo produttivo.

Stato grezzo della stampante	Descrizione
`feeding`	La macchina sta alimentando il materiale in vista della stampa.
`initializing`	Il motore è in fase di inizializzazione nell'ambito dell'avvio di un'operazione di stampa.
`preparing`	Il motore si sta preparando alla stampa, ad esempio caricando i dati del lavoro o riscaldando i componenti in vista di un lavoro imminente.
`printing`	Il motore sta stampando.
`processing`	Il motore sta elaborando i dati relativi ai lavori.
`receiving`	Il motore sta ricevendo un lavoro dal server di stampa.

Stati del sud

Un motore viene segnalato come down quando non è in grado di stampare e sono necessari o in corso un intervento dell'operatore o del servizio di assistenza, un intervento di manutenzione o un ripristino. Utilizzi questa categoria per quantificare i tempi di inattività pianificati e non pianificati.

Stato grezzo della stampante	Descrizione
`adjusting`	Il motore sta eseguendo un'operazione di regolazione che impedisce la stampa.
`calibrating`	Il motore sta effettuando la calibrazione, ad esempio per il colore o l’allineamento.
`cleaning`	Il motore sta eseguendo un'operazione di pulizia.
`disconnected`	Il motore ha perso la connessione con RICOH Predictive Insight.
`error`	Il motore ha segnalato una condizione di errore che impedisce la stampa.
`maintenance`	Il motore sta eseguendo un'operazione di manutenzione.
`not available`	Il motore è raggiungibile, ma al momento non è possibile intervenire su di esso.
`pre/post busy`	Un dispositivo di pre- o post-elaborazione collegato al motore è in funzione e sta bloccando la stampa.
`pre/post eof`	Un dispositivo di pre- o post-elaborazione ha raggiunto una condizione di fine modulo che sta impedendo la stampa.
`pre/post paused`	Un dispositivo di pre- o post-elaborazione è in pausa e sta bloccando la stampa.
`pre/post threading`	Un dispositivo di pre- o post-elaborazione sta inserendo il supporto e sta bloccando la stampa.
`rebooting`	Il motore si sta riavviando.
`recirculation`	Il motore sta effettuando il ricircolo dell'inchiostro.
`restart`	Il motore si trova in una condizione di riavvio.
`restarting`	Il motore si sta riavviando.

Stati di inattività

Un motore viene segnalato come idle quando è operativo e in grado di stampare, ma al momento non sta producendo alcun output. Utilizzi questa categoria per valutare la capacità disponibile.

Stato grezzo della stampante	Descrizione
`checking`	Il motore sta eseguendo un controllo di routine che non ostacola il lavoro.
`idle`	Il motore è funzionante e pronto per essere messo in funzione.
`not ready`	Il motore è operativo, ma al momento non è pronto per la stampa.
`pre/post not ready`	Un dispositivo di pre- o post-trattamento non è pronto, ma il motore stesso è operativo.
`ready`	Il motore è pronto a ricevere e a stampare un lavoro.
`shutdown`	Il Motore è stata chiusa.
`shutting down`	Il motore è in processo di arresto in corso.
`sleeping`	Il motore si trova in uno stato di sospensione a basso consumo.
`start-up`	Il motore si trova in fase di avvio.
`started`	Il motore ha completato la sequenza di avviamento.
`starting`	Il motore si sta avviando.
`stopping`	Il motore sta rallentando, ma non si è ancora spento.
`warming`	Il motore si sta riscaldando.

Sconosciuto

La categoria unknown viene segnalata quando RICOH Predictive Insight non è in grado di determinare una categoria per lo stato grezzo, ad esempio perché il valore dello stato grezzo non viene riconosciuto. Se la Sua applicazione rileva regolarmente categorie unknown, contatti il Suo referente per verificare che la Sua stampante stia segnalando i valori di stato previsti.

1.5.5.2 Gestione dei limiti delle risposte dell'API di esportazione dei dati

L'API di esportazione dei dati non utilizza la paginazione per le risposte. Qualora una richiesta dovesse restituire una quantità di dati superiore a quella consentita dall’API in una singola risposta, la richiesta fallirà generando un errore anziché restituire un risultato parziale. Pianifichi le Sue integrazioni in modo da rimanere entro i limiti, restringendo l'intervallo di date, riducendo il numero di stampanti per richiesta o entrambe le cose.

Quali sono i limiti

Alle richieste che includono un intervallo di date si applicano due tipi di limiti:

Intervallo di date massimo: Se l'intervallo di tempo tra startDateTime e endDateTime supera i sette giorni, l'API restituisce una risposta 400 con il codice di errore ERR_DATE_RANGE_EXCEEDED. Riduca l'intervallo di tempo richiesto e invii nuovamente la richiesta.
Dimensione massima della risposta: La dimensione massima supportata di un file di risposta è di 6 MB, che dovrebbe essere sufficiente a contenere i dati relativi a quasi 10.000 lavori. Qualora i dati corrispondenti a una richiesta superino la dimensione massima della risposta, l'API restituisce una risposta 413 con il codice di errore ERR_RESPONSE_LIMIT_EXCEEDED. Il corpo della risposta include un valore maxJobs che indica il limite in vigore. Per risolvere il problema, restringa l'intervallo di date, richieda un numero inferiore di stampanti, oppure faccia entrambe le cose, e invii nuovamente la richiesta.

Richieste di pianificazione volte a rimanere entro i limiti

Per progettare un'integrazione che rimanga in modo affidabile entro i limiti di risposta, si prega di tenere in considerazione i seguenti fattori:

Volume di lavori per stampante. Una stampante ad alta produttività con alimentazione continua è in grado di produrre un numero di lavori all’ora molto superiore rispetto a una stampante a fogli singoli per piccoli volumi. Se nella vostra flotta sono presenti entrambe le tipologie, saranno le stampanti ad alto volume a determinare quanto brevi dovranno essere le vostre fasce orarie.
Numero di stampanti per richiesta. Ogni richiesta può includere più valori di printerId. Raggruppare più stampanti in un’unica richiesta è pratico, ma ogni stampante aggiuntiva aumenta la dimensione della risposta e il rischio di superare il limite.
Ora del giorno. Se la vostra attività opera a turni, i lavori e i cambiamenti di stato si concentrano in determinate ore. Un intervallo di 24 ore può restituire volumi molto diversi a seconda di quando iniziano e finiscono tali 24 ore.
Tolleranza per i tentativi successivi. Se una richiesta fallisce con l'errore ERR_RESPONSE_LIMIT_EXCEEDED, la Sua integrazione deve suddividere la richiesta ed effettuare un nuovo tentativo. Progettare fin dall’inizio per finestre di dimensioni ridotte è solitamente meno complesso rispetto all’implementazione della suddivisione dinamica.

Modelli consigliati

I seguenti modelli si prestano bene agli scenari di integrazione più comuni:

Estrazione notturna per la reportistica: Esegua un lavoro pianificato una volta al giorno che richieda i dati relativi alle ultime 24 ore, una stampante alla volta. Questo modello è semplice da implementare, consente di ripetere facilmente il tentativo in caso di errore e garantisce che ogni risposta sia di dimensioni ridotte. Integri le risposte relative a ciascuna stampante nel Suo processo a valle.
Estrazione oraria per dashboard in tempo quasi reale: Eseguire un lavoro pianificato una volta all’ora che richieda, in un’unica richiesta, i dati relativi all’ora precedente per tutte le stampanti. Le finestre orarie consentono di mantenere ridotte le dimensioni delle risposte anche per le stampanti ad alto volume. Se la Sua flotta è di grandi dimensioni, richieda le stampanti in gruppi anziché tutte in una volta.
Inserimento retroattivo dei dati storici: Per alimentare un data warehouse con dati storici, proceda per iterazioni sull’intervallo di tempo in finestre di dimensioni fisse (ad esempio, sei ore per richiesta) e sulle stampanti in piccoli gruppi. Elabori una finestra alla volta e salvi i risultati prima di spostare in quella successiva. Se una finestra genera l'errore ERR_RESPONSE_LIMIT_EXCEEDED, la si dividerà in due parti e si riproverà con ciascuna delle due parti.
Stato attuale della stampante ai fini del monitoraggio: Per monitorare lo stato attuale di ogni stampante del Suo parco stampanti senza recuperare la cronologia, chiami /printer-states con currentState=true. La risposta comprende una riga per ciascun motore e non è influenzata dall'intervallo di date; pertanto, una singola richiesta può coprire l'intera flotta.

Gestione degli errori relativi al limite di risposta nella Sua integrazione

Quando riceve una risposta 413 con codice ERR_RESPONSE_LIMIT_EXCEEDED, adotti una o più delle seguenti misure prima di riprovare a inviare la richiesta:

Riduca l'intervallo di tempo. Dividere la finestra a metà è una strategia affidabile; se la richiesta divisa a metà continua a fallire, la si divide nuovamente.
Riduca il numero di valori di printerId presenti nella richiesta. Se una stampante è responsabile della maggior parte del volume di stampa, la richieda separatamente.
Se la richiesta riguarda un'istantanea dello stato attuale anziché una cronologia, utilizzare currentState=true su /printer-states per evitare del tutto il volume determinato dall'intervallo di date.

Non riprovi a inviare la stessa richiesta senza modificare i parametri. L'API non restituisce risultati parziali, pertanto un nuovo tentativo senza modifiche fallirà nuovamente.

1.5.6 Esempi di richieste e risposte dell'API di esportazione dei dati

Utilizzi gli esempi riportati in questa sezione come punto di partenza per la propria integrazione. Ciascun esempio illustra un URL di richiesta rappresentativo insieme al corpo della risposta restituita dall'API.

Informazioni su questi esempi

Gli esempi utilizzano chiavi API e ID delle stampanti fittizi. Quando li adatterete, sostituite i valori con quelli relativi al vostro ambiente.
Negli esempi viene utilizzato il nome-host relativo agli Stati Uniti e al Giappone. Se il Suo account è ospitato in Europa, utilizzi invece rpi-data-export.app-ricohsoftware.eu.
I valori relativi alla data e all'ora sono formattati come ora locale nel fuso orario specificato nella richiesta, secondo il formato YYYY-MM-DDTHH:MM:SS.sss.
Tutte le durate sono espresse in millisecondi. Tutti i valori relativi all’inchiostro e allo scaricamento sono espressi in centimetri cubi (cc).
Gli esempi hanno scopo illustrativo. I valori numerici quali il consumo di inchiostro, il numero di pagine e la durata rappresentano dati operativi plausibili, non misurazioni relative a una stampante specifica.

GET /printers

Recupera le stampanti disponibili per la chiave API specificata. L'endpoint non accetta parametri.

Richiesta:

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

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

Recupera i lavori elaborati da una o più stampanti in un determinato intervallo di tempo. L'esempio richiede i dati relativi a una singola stampante per una finestra temporale di otto ore nell'ora locale di America/Denver, limitandosi ai lavori la cui stampa è stata completata con esito positivo.

Richiesta:

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

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

Un array vuoto ([]) costituisce una risposta valida e indica che nessun processo corrispondeva alla richiesta.

GET /printer-states (cronologia aggregata)

La modalità di risposta predefinita restituisce una riga per ogni intervallo di stato per ciascun motore, con i campi completi relativi alla durata e alla cronologia. Nell’esempio si richiede una finestra temporale di quattro ore per una stampante.

Richiesta:

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

Risposta (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 (solo stato attuale)

Quando si imposta currentState=true, la risposta include una riga per ciascun motore con lo stato corrente. I campi relativi alla durata e alla cronologia vengono omessi.

Richiesta:

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

Risposta (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 (solo categoria di stato)

Quando si imposta stateCategoryOnly=true, la risposta omette il campo printerState non elaborato e riporta solo la categoria di livello superiore. I campi relativi alla durata e alla cronologia vengono mantenuti.

Richiesta:

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

Risposta (200 OK):

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

GET /printer-interventions

Recupera gli eventi di intervento verificatisi su una o più stampanti in un determinato intervallo di tempo. L'esempio richiede una finestra temporale di quattro ore per una stampante e richiede che le descrizioni degli eventi siano in inglese. Poiché la stampante utilizzata in questo esempio è un modello a alimentazione continua, i valori di interventionCode utilizzano il formato proprio di tale tipo di alimentazione.

Richiesta:

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

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

Le prime due voci presentano un campo jobName vuoto, il che significa che nessun lavoro è stato coinvolto nell'evento. La terza registrazione si è verificata mentre era in corso la stampa di un lavoro, pertanto viene riportato il nome del lavoro.

Esempi di risposte di errore

Ogni risposta di errore utilizza la stessa struttura: un oggetto JSON con un code, un message e un statusCodenumerico. Come indicato in una nota, alcuni codici di errore includono campi aggiuntivi.

400 Richiesta non valida — fuso orario non valido:

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

400 Richiesta non valida — parametro obbligatorio mancante:

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

400 Richiesta non valida — l'intervallo di date supera il limite massimo consentito:

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

400 Richiesta non valida — lingua non valida:

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

401 Non autorizzato — chiave API non valida:

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

403 Accesso negato — la richiesta include una stampante a cui la chiave API non può accedere:

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

413 Payload troppo grande—la risposta supererebbe il limite di dimensione:

{
  "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
}

Errore 500 del server interno:

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

1.5.7 Risoluzione dei problemi relativi all'API di esportazione dei dati

Utilizzare questa sezione per interpretare le risposte di errore più comuni dell'API di esportazione dei dati e per individuare la causa più probabile e la soluzione per ciascuna di esse. Ogni risposta di errore include un code, un message e un statusCode numerico; il valore del code identifica la condizione specifica.

Errori di autenticazione e autorizzazione

Codice di errore	Probabile causa	Cosa provare
`ERR_INVALID_APIKEY` (401)	L'intestazione `x-api-key` è assente, non conforme, scaduta o è stata eliminata. Si verifica inoltre per un breve periodo (in genere meno di un minuto) immediatamente dopo la creazione o la rotazione di una chiave, prima che la nuova chiave venga registrata.	Si assicuri che la richiesta includa l'intestazione `x-api-key` con il valore completo della chiave API. In Account Administration, verifichi che la chiave esista ancora e non sia scaduta. Se la chiave è stata appena creata o aggiornata, attenda un minuto e riprovi.
`ERR_UNAUTHORIZED_PRINTERS` (403)	La richiesta include uno o più valori di `printerId` a cui la chiave API non può accedere.	Chiamare `/printers` utilizzando la stessa chiave API per verificare esattamente quali stampanti sono disponibili, quindi inviare nuovamente la richiesta indicando solo gli ID di tali stampanti.
`ERR_TENANT_NOT_FOUND` (404)	La chiave API viene riconosciuta, ma non è associata a un account attivo. Ciò può verificarsi qualora un account sia stato sottoposto a rimozione o sia configurato in modo errato.	Contattare il proprio referente commerciale Ricoh per verificare che il proprio tenant sia attivo e che la chiave API sia associata a esso.

Errori di convalida dei parametri (400 Richiesta non valida)

Ogni errore di convalida dei parametri restituisce un codice di stato 400. Il valore del code identifica il problema specifico.

Codice di errore	Probabile causa	Cosa provare
`ERR_MISSING_PRINTER_ID`	La richiesta non includeva alcun valore di `printerId`. È richiesto almeno uno per i `/jobs`, `/printer-states` e `/printer-interventions`.	Aggiunga almeno un parametro di query `printerId`. Ripetete il parametro per includere più stampanti.
`ERR_INVALID_PRINTER_ID_FORMAT`	Il valore `printerId` non è un UUID valido.	Verifichi il valore confrontandolo con la risposta ottenuta da `/printers`. Tra gli errori più comuni figurano spazi superflui, caratteri mancanti o l’inserimento del nome della stampante anziché del suo ID.
`ERR_INVALID_TIMEZONE`	Il valore di `timezone` è mancante oppure non costituisce un identificatore di fuso orario IANA valido.	Utilizzi un identificatore basato sull'area, ad esempio `America/Denver` o `Europe/Bucharest`. Non sono ammesse abbreviazioni di tre lettere, quali `MST` o `EST`. La pagina della documentazione interattiva presenta un elenco di tutti i valori ammessi.
`ERR_INVALID_DATE_FORMAT`	Il valore di `startDateTime` o `endDateTime` non è corrispondente al formato previsto.	Si utilizzi il formato `YYYY-MM-DDTHH:MM:SS`, eventualmente con il suffisso `.sss` che indica i millisecondi. Non includa un offset UTC né un suffisso `Z`; il fuso orario viene specificato separatamente nel parametro `timezone`.
`ERR_INVALID_DATE_RANGE`	`startDateTime` è uguale o posteriore a `endDateTime`.	Si verifichi che `startDateTime` sia anteriore a `endDateTime` nel fuso orario specificato.
`ERR_DATE_RANGE_EXCEEDED`	L'intervallo di tempo compreso tra `startDateTime` e `endDateTime` supera l'intervallo massimo consentito.	Riduca l’ampiezza dell’intervallo di tempo richiesto. Per indicazioni sulla suddivisione in blocchi, si prega di consultare il sito Gestione dei limiti delle risposte dell'API di esportazione dei dati.
`ERR_INVALID_JOB_STATE`	Il valore di `jobState` non rientra tra i valori ammessi.	Utilizzi uno dei seguenti termini: in fase di `printing`, `printed`, `aborted` o `completed`. Si noti che la voce `completed` comprende sia i lavori `printed` che quelli `aborted`.
`ERR_INVALID_STATE_CATEGORY`	Il valore di `stateCategory` non rientra tra i valori consentiti.	Utilizzi una delle seguenti opzioni: `up`, `down` o `idle`.
`ERR_INVALID_LANGUAGE`	Il valore della `language` fornito a `/printer-interventions` non rientra tra i valori ammessi.	Si prega di utilizzare una delle seguenti lingue: `en`, `de`, `ja`, `it`, `fr` o `es`. Questo errore indica che il codice stesso è stato rifiutato; un codice che viene accettato ma per il quale non è disponibile una traduzione di una determinata descrizione non genera un errore, poiché l'API restituisce invece quella descrizione in inglese.
`ERR_INVALID_BOOLEAN_PARAM`	Il parametro `currentState` o `stateCategoryOnly` ha un valore diverso da `true` o `false`.	Si utilizzino le stringhe letterali in minuscolo `true` o `false`.
`ERR_UNKNOWN_PARAMETERS`	La richiesta contiene uno o più parametri che l'endpoint non accetta.	Confronti la richiesta con l'elenco dei parametri per l'endpoint nella documentazione interattiva. Tra le cause più comuni figurano errori di battitura, parametri destinati a un endpoint diverso o parametri di tracciamento aggiuntivi inseriti da un client HTTP.
`ERR_DUPLICATE_PARAMETERS`	Lo stesso parametro viene fornito più di una volta e l'endpoint non accetta duplicati per quel parametro.	Verifichi l'elenco dei parametri. Il parametro `printerId` può essere ripetuto (una volta per ogni stampante); gli altri parametri devono comparire al massimo una volta.
`ERR_EMPTY_PARAMETERS`	È presente un parametro obbligatorio, ma privo di valore.	Si assicuri che ogni parametro obbligatorio abbia un valore non vuoto.
`ERR_INVALID_TENANT_ID`	L'identificativo del tenant associato alla chiave API non è valido.	Si prega di contattare il proprio referente commerciale Ricoh.

Errori relativi alle dimensioni della risposta e al metodo

Codice di errore	Probabile causa	Cosa provare
`ERR_RESPONSE_LIMIT_EXCEEDED` (413)	I dati corrispondenti alla richiesta supererebbero la dimensione massima della risposta. Il corpo della risposta include un campo `maxJobs` che indica il limite in vigore.	Restringa l'intervallo di date, richieda un numero inferiore di stampanti, oppure faccia entrambe le cose, e invii nuovamente la richiesta. Si veda Gestione dei limiti delle risposte dell'API di esportazione dei dati per i modelli di suddivisione consigliati.
`ERR_UNSUPPORTED_METHOD` (405)	La richiesta ha utilizzato un metodo HTTP diverso da `GET`.	L'API di esportazione dei dati supporta esclusivamente il metodo `GET`. Aggiorni il Suo client in modo che utilizzi il metodo `GET`.

Errori del server (500 Errore interno del server)

Il codice di risposta 500 indica una condizione imprevista sul server. I tentativi ripetuti sono sicuri poiché ogni endpoint dell'API di esportazione dei dati è di tipo GET e non produce effetti collaterali. Attenda alcuni secondi prima di riprovare e, qualora l'errore dovesse persistere, ricorra al backoff esponenziale.

Codice di errore	Probabile causa	Cosa provare
`ERR_INTERNAL_SERVER_ERROR`	Si è verificata una condizione imprevista sul server.	Attenda qualche secondo e riprovi. Se l'errore persiste per più di qualche minuto, si prega di contattare il proprio referente commerciale Ricoh.
`ERR_TENANT_CHECK_FAILED`	Il server non è riuscito a verificare il tenant associato alla chiave API.	Attenda qualche secondo e riprovi. Se l'errore persiste, si prega di contattare il proprio referente commerciale Ricoh.
`ERR_PRINTERS_FETCH_FAILED`	Il server non è riuscito a recuperare l'elenco delle stampanti relative al tenant.	Attenda qualche secondo e riprovi. Se l'errore persiste, si prega di contattare il proprio referente commerciale Ricoh.
`ERR_PRINTER_STATES_FETCH_FAILED`	Il server non è riuscito a recuperare i dati relativi allo stato della stampante per la richiesta in questione.	Attenda qualche secondo e riprovi. Se l'errore persiste, si prega di contattare il proprio referente commerciale Ricoh.

Altri sintomi

La risposta è vuota ([]) ma Lei si aspetta dei dati: Un array vuoto indica che nessun record corrispondeva alla richiesta. Verifichi l'intervallo di tempo (l'API fornisce dati solo relativi agli ultimi sette giorni), il fuso orario, i valori di printerId ed eventuali filtri quali jobState o stateCategory.
I valori relativi alla data e all'ora presenti nella risposta non corrispondono a quanto da Lei previsto: Le date/ore delle risposte corrispondono all'ora locale nel fuso orario specificato nella richiesta. L'invio della stessa richiesta con un valore di timezone diverso genera stringhe di data/ora diverse, sebbene descrivano gli stessi eventi. Consultare Date e ora: gestione nell'API di esportazione dei dati.
Nella risposta /printers manca una stampante: L'API restituisce solo le stampanti monitorate dalla raccolta dati. Se manca una stampante, verifichi che sia stata registrata su un dispositivo di raccolta dati e che abbia attualmente una connessione.
Una risposta relativa allo stato delle stampanti include categorie unknown: Una categoria unknown indica che non è stato possibile classificare lo stato grezzo della stampante. Si prega di consultare il sito Stati della stampante e categorie di stato per la mappatura completa tra stato e categoria.

1.6 RICOH Cloud Connector

RICOH Cloud Connector è un'applicazione di sistema locale che fornisce una connessione sicura con RICOH TotalFlow Cloud. Assiste nella registrazione del prodotto e, se necessario, gestisce la comunicazione con le applicazioni RICOH TotalFlow Cloud.

Nota:

Se si utilizza l'abbonamento RICOH InfoPrint Manager, RICOH Cloud Connector viene installato automaticamente con il prodotto. Quando si disinstalla RICOH InfoPrint Manager, RICOH Cloud Connector viene disinstallato automaticamente.
Non è necessario installare RICOH Cloud Connector per utilizzare RICOH Predictive Insight.

È possibile installare RICOH Cloud Connector sui seguenti sistemi operativi:

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

Nota:

Queste sono le ultime versioni testate con RICOH Cloud Connector, ma è possibile utilizzare anche versioni successive di questi sistemi operativi.
Questi sistemi operativi e i relativi aggiornamenti sono supportati fino a quando il produttore continua a fornire assistenza ai propri clienti nell'ambito di contratti standard, escluso il supporto esteso.

L'installazione di RICOH Cloud Connector richiede almeno 1,1 GB di spazio libero.

1.6.1 Download di RICOH Cloud Connector

È possibile scaricare l'ultima versione di RICOH Cloud Connector dalla scheda Sottoscrizioni o Connettori in RICOH Account Administration. Scaricare il pacchetto sul server in cui si intende installare l'applicazione.

Prima di scaricare Cloud Connector, accertarsi che siano soddisfatte le seguenti condizioni:

La pagina di configurazione di Cloud Connector si apre in un browser Web. Verificare che sul sistema sia installata la versione più recente di uno di questi browser:
- Mozilla Firefox
- Google Chrome
- Microsoft Edge
L'utente dispone dell'autorizzazione alla scrittura sul percorso di installazione predefinito:
- %ProgramData%\RICOH\Cloud Connector\ per Windows o
- /opt/RICOH/RCC/ per Linux.
Se si sceglie un percorso di installazione diverso, accertarsi che esista e che si disponga delle autorizzazioni alla scrittura. Se la directory esiste, deve essere vuota.

Per scaricare RICOH Cloud Connector:

Accedere al server su cui si desidera installare Cloud Connector come amministratore.
Accedere a RICOH TotalFlow Cloud come utente con accesso a RICOH Account Administration.
In RICOH Account Administration, fare clic su Sottoscrizioni nel riquadro a sinistra.
Vengono visualizzati la scheda Sottoscrizioni e i collegamenti per scaricare il pacchetto RICOH Cloud Connector.
Fare clic su Download per Windows o Download per Linux, a seconda del sistema operativo.
Salvare il pacchetto di installazione in una ubicazione in cui si dispone delle autorizzazioni di scrittura ed esecuzione. Su Linux, si scarica un archivio denominato ricoh-cloud-connector-linux.gz, che contiene il file eseguibile.
Il nome del file scaricato è:
- Su Windows: ricoh-cloud-connector-win.exe
- Su Linux: ricoh-cloud-connector-linux.gz

1.6.2 Installazione o aggiornamento

Dopo aver scaricato la versione corrente di RICOH Cloud Connector, installarla sul server individuato.

Nota:

Se i file di installazione sono stati scaricati su un altro computer, copiarli sul sistema in cui si desidera installare il programma.
Assicurarsi di avere spazio sufficiente sul disco. L'installazione di RICOH Cloud Connector richiede almeno 1,1 GB di spazio libero.

Per installare o aggiornare RICOH Cloud Connector:

Accedere al computer dove è stato scaricato l'eseguibile del programma di installazione RICOH Cloud Connector come Amministratore.
In un sistema Linux, è necessario accedere con un account utente che disponga delle autorizzazioni di lettura e scrittura sulle seguenti directory:
- /var
- /etc
- /usr
- /opt
Inoltre, è necessario il permesso di esecuzione per il file eseguibile RICOH Cloud Connector scaricato.
Per l'installazione su Linux, trovare e fare doppio clic su ricoh-cloud-connector-linux.gz per scompattare i file del programma di installazione.

Importante: Tra i file scompattati, si dovrebbe vedere il file eseguibile del programma di installazione, denominato ricoh-cloud-connector-linux. Verificare che il file possa essere eseguito come un file eseguibile. Seguire la procedura dedicata alla versione di Linux per renderlo eseguibile.
Individuare e fare doppio clic sull'eseguibile del programma di installazione RICOH Cloud Connector.
Il nome del file eseguibile è:
- Su Windows: ricoh-cloud-connector-win.exe
- Su Linux: ricoh-cloud-connector-linux
Se si installa RICOH Cloud Connector per la prima volta, la pagina Installazione di RICOH Cloud Connector si apre nel browser predefinito.

Se si aggiorna RICOH Cloud Connector, la pagina Aggiornamento di RICOH Cloud Connector si apre nel browser predefinito.

Nota: Se la pagina Installazione di RICOH Cloud Connector non si apre, l'antivirus o il browser potrebbe bloccare il programma di installazione.
Controllare la barra degli indirizzi del browser per verificare se ha bloccato l'apertura di una pagina. Se la pagina è stata bloccata, concedere l'autorizzazione a visualizzarla. Se la pagina continua a non essere visualizzata, consultare l'argomento Risoluzione dei problemi riportato di seguito.
Se l'installazione avviene per la prima volta:
1. Leggere i termini legali e selezionare Accetto i termini dell'accordo di licenza..
2. Verificare la posizione di installazione e di disporre delle autorizzazioni di scrittura ed esecuzione, quindi fare clic su INSTALLA.
Se si sta aggiornando RICOH Cloud Connector:

Nota: I dettagli della configurazione precedente vengono importati, compresa l'accettazione della licenza.
1. Controllare le informazioni sulla versione corrente di RICOH Cloud Connector e sulla versione di aggiornamento.
2. Fare clic su AGGIORNA.

L'installazione viene avviata ed è possibile visualizzarne l'avanzamento.

Una volta completata l'installazione, la pagina Configurazione di RICOH Cloud Connector si apre automaticamente.

Il servizio RICOH Cloud Connector si avvia automaticamente dopo ogni installazione, aggiornamento o riavvio del sistema riuscito.

1.6.3 Impostazione

Dopo aver installato RICOH Cloud Connector, è necessario configurarlo per comunicare con RICOH TotalFlow Cloud.

Al termine dell'installazione di RICOH Cloud Connector, si apre la pagina Configurazione di RICOH Cloud Connector nel browser predefinito.

Per configurare RICOH Cloud Connector:

La proprietà Nome del sistema viene compilata automaticamente con il nome del sistema impostato nel sistema operativo. È possibile aggiornarlo con qualcosa di più riconoscibile o più facile da ricordare.
Se l'azienda utilizza server proxy, chiedere al reparto IT l'indirizzo IP o il nome host e il numero di porta corretti da utilizzare. Selezionare l'opzione Utilizzerò un server proxy. e digitare i valori corretti nei campi Impostazioni proxy.
Fare clic su Test proxy. Se le impostazioni del proxy non vengono convalidate, verificarle con il reparto IT, inserire i valori corretti e riprovare.
Fare clic su Genera codice.

Se non si è connessi a Account Administration, si apre la finestra di dialogo di accesso. Accedere a Account Administration.

Quando è stato eseguito l'accesso, viene visualizzata la finestra Genera un codice unico e un codice univoco unico valido per 20 minuti.
Copiare il codice, tornare a RICOH Cloud Connector e incollare il codice nel campo Codice monouso.
Fare clic su Invia.
Se l'autorizzazione è valida, si riceve un messaggio di conferma. Fare clic su Chiudi.
Viene visualizzata la finestra di dialogo Impostazioni della licenza.
Contiene tutti i dettagli inseriti durante la configurazione. È possibile modificare Nome del sistema e Impostazioni proxy, se necessario.
Chiudere la scheda o la finestra del browser per uscire da RICOH Cloud Connector.

1.6.3.1 Nome sistema

Visualizza il nome del dispositivo su cui si sta configurando RICOH Cloud Connector.

Per impostazione predefinita, questo valore è il nome del sistema assegnato dal sistema operativo. È possibile cambiarlo con un nome più riconoscibile. RICOH Account Administration visualizza questo nome nella scheda Connettori, nella tabella dei connettori registrati.

1.6.3.2 Impostazioni proxy

Alcune aziende utilizzano server proxy per fornire un ulteriore livello di protezione della rete.

Se l'azienda utilizza server proxy, chiedere al reparto IT l'indirizzo IP o il nome host e il numero di porta corretti da utilizzare.

1.6.3.3 Codice unico

Il codice unico generato da RICOH Account Administration che deve essere utilizzato per registrare RICOH Cloud Connector, in modo che le informazioni possano essere trasmesse dalla rete alle applicazioni RICOH TotalFlow Cloud.

Per accedere a RICOH Account Administration è necessario un ID utente di RICOH TotalFlow Cloud.

1.6.4 Disinstallazione di RICOH Cloud Connector

Questa sezione descrive come disinstallare RICOH Cloud Connector utilizzando gli strumenti di sistema di Windows.

Nota:

Per disinstallare RICOH Cloud Connector su Linux, seguire le istruzioni fornite dalla propria distribuzione Linux.

Per disinstallare RICOH Cloud Connector su Windows:

Accedere al computer dove è installato RICOH Cloud Connector come Amministratore.
Fare clic sul pulsante di ricerca di Windows e cercare la pagina App e funzionalità.
Cercare e fare clic sul nome dell'applicazione RICOH Cloud Connector.
Fare clic su Disinstalla.
Fare nuovamente clic su Disinstalla per confermare di aver capito che l'applicazione e le sue informazioni correlate saranno disinstallate.
Viene visualizzata la pagina Disinstallazione di RICOH Cloud Connector:
Controllare le informazioni e selezionare Accetto e desidero disinstallare RICOH Cloud Connector. A seconda della configurazione, la macchina potrebbe riavviarsi dopo il processo di disinstallazione..
- Se si disinstalla RICOH Cloud Connector, tutti i programmi che utilizzavano Cloud Connector disinstallato per i loro abbonamenti smettono di funzionare.
Fare clic su DISINSTALLA.
Accedere a RICOH Account Administration e verificare che Cloud Connector disinstallato non sia più visualizzato nella tabella Connettori.
È possibile eliminarlo manualmente se non è stato rimosso automaticamente.

1.6.5 Risoluzione dei problemi

1.6.5.1 Problemi comuni

1.6.5.1.1 Impossibile installare RICOH Cloud Connector

Quando si installa RICOH Cloud Connector e la pagina di installazione non viene visualizzata, provare a eseguire le seguenti operazioni.

Possibili motivi per cui la pagina di installazione non si apre:

Non è stato effettuato l'accesso come amministratore.
Accedere come utente con diritti di amministratore e riprovare.
In Linux, il file di installazione non è definito come file eseguibile.
Seguire le istruzioni dedicate alla versione di Linux per rendere il file eseguibile.
Un blocco degli annunci impedisce a Installazione di RICOH Cloud Connector di aprirsi in una nuova finestra del browser.
Individuare le impostazioni del blocco pop-up nel browser e consentire l'apertura della pagina.
Il software antivirus blocca l'esecuzione del programma di installazione.
Concedere l'autorizzazione all'esecuzione del programma all'interno del programma antivirus.
È stato raggiunto il numero massimo di connettori cloud supportati dall'abbonamento.
Accedere a RICOH Account Administration e rimuovere i connettori cloud scollegati dalla tabella Connettori. In alternativa, contattate il rappresentante vendite Ricoh per aggiornare l'abbonamento.

Se nessuna delle precedenti condizioni è vera, utilizzare la procedura della riga di comando per installare RICOH Cloud Connector:

Accedere al computer dove sono stati scaricati i file di installazione come utente con diritti di amministratore.
Aprire un prompt dei comandi con l'opzione Esegui come amministratore e individuare il file eseguibile RICOH Cloud Connector.
Importante: Assicurarsi di disporre dell'autorizzazione per eseguire il file. Se si utilizza Linux, assicurarsi che il file sia eseguibile. Se non lo è, seguire la procedura dedicata alla versione di Linux per renderlo eseguibile.
Digitare il seguente comando di installazione:
rccInstallerFileName --install
Premere Invio.

1.6.5.1.2 Edge non si avvia quando si installa RICOH Cloud Connector

Se Microsoft Edge è il browser predefinito e si utilizza l'account amministratore integrato, il browser non si apre automaticamente quando si installa RICOH Cloud Connector.

Se si verifica ciò, è possibile accedere con le credenziali di un altro account utente o cambiare il browser predefinito con uno diverso, come Chrome o Firefox. Quindi avviare nuovamente il programma di installazione di RICOH Cloud Connector.

1.6.5.1.3 Errore Cloud Connector: Firma non ancora aggiornata

Questo errore potrebbe verificarsi se l'ora del server non è sincronizzata con l'ora locale.

Assicurarsi che l'ora del server sia sincronizzata con l'ora corrente con una precisione massima di 5 minuti.

Se si utilizza Windows, si consiglia di impostare automaticamente l'ora corrente:

Accedere a Windows come amministratore.
Fare clic sull'icona Windows sulla barra delle applicazioni.
Andare a Impostazioni ⇒ Ora e lingua ⇒ Data e ora.
Attivare l'opzione Imposta automaticamente ora.
Scorrere fino a Impostazioni aggiuntive e fare clic su Sincronizza ora.

1.6.5.2 Download dei registri di RICOH Cloud Connector

Se si verificano problemi durante l'utilizzo di RICOH Cloud Connector, è possibile scaricare facilmente i registri dell'applicazione che contribuiscono a risolvere il problema.

Per scaricare i registri:

Aprire una finestra del browser Web.
Immettere l'URL per la pagina Configurazione di RICOH Cloud Connector nella barra degli indirizzi:

http://server_address:port_number/license,

dove server_address è l'indirizzo IP o nome host del computer in cui è installato RICOH Cloud Connector e port_number è la porta dell'applicazione.

Se si utilizza il computer su cui è installato RICOH Cloud Connector con la porta predefinita, è possibile andare a http://localhost:15180/license.
Fare clic su , l'icona Guida sul banner e selezionare Scarica registri.
Salvare il pacchetto di registri nel sistema.
La procedura di salvataggio del file dipende dalle impostazioni del browser Web.
I registri vengono salvati in formato ZIP e il pacchetto risultante è denominato RCC_logs_yyyy-mm-ddThh_mm_ss.zip, dove yyyy-mm-dd e hh_mm_ss rappresentano la data e l'ora in cui i registri sono stati raccolti.

1 RICOH Account Administration

1.1 Panoramica di RICOH Account Administration

1.1.1 Novità

1.1.2 Oggetti del sistema

1.1.2.1 Chiavi API

Related information:

1.1.2.2 Connettori

Related information:

1.1.2.3 Utenti

Related information:

1.1.3 Interfaccia utente

1.1.3.1 Intestazione

1.1.3.2 Pagina principale

1.1.3.2.1 Scheda Chiavi API

Related information:

1.1.3.2.2 Scheda Connettori

1.1.3.2.3 Scheda Dettagli

1.1.3.2.4 Scheda Sottoscrizioni

1.1.3.2.5 Scheda Utenti

1.1.4 RICOH Cloud Connector

Related information:

1.1.5 Accesso facilitato

Funzioni di accesso facilitato

Navigazione da tastiera

1.1.6 Marchi

1.2 Introduzione a RICOH TotalFlow™ Cloud

1.2.1 Primo accesso a RICOH TotalFlow Cloud

Related information:

1.2.2 Introduzione a RICOH TotalFlow Cloud per gli amministratori

Related information:

1.2.2.1 Visualizzazione degli abbonamenti

1.2.2.2 Aggiunta di utenti

Related information:

1.2.3 Introduzione a RICOH TotalFlow Cloud per gli utenti

Related information:

1.2.4 Gestione delle impostazioni dei cookie

1.3 Configurazione

1.3.1 Aggiunta di utenti

Related information:

1.4 Gestione degli oggetti

1.4.1 Gestione dei dettagli dell'account

1.4.2 Modifica delle informazioni dell'utente

1.4.3 Modifica della password

1.5 Utilizzo dell'API di esportazione dei dati

Related information:

1.5.1 API di esportazione dei dati

Autenticazione

Endpoint disponibili

Verifica dell'API

1.5.2 Creazione e gestione delle chiavi API

Related information:

1.5.3 Provare l'API di esportazione dei dati

1.5.4 Date e ora: gestione nell'API di esportazione dei dati

Il modello di data e ora

Formato di data e ora

Intervallo di tempo predefinito

Conservazione dei dati: gli ultimi sette giorni

Regole relative all'intervallo richiesto

Indicare il fuso orario

Fornitura della lingua

Ora legale e orari ambigui

Raccomandazioni per l'archiviazione e il confronto delle date/ore delle risposte

Esempi

Related information:

1.5.5 Campi della risposta dell'API di esportazione dei dati

Convenzioni utilizzate nel presente documento di riferimento

Campi di risposta dell'operazione GET /printers

Campi della risposta GET /jobs

Campi della risposta GET /printer-states

Campi della risposta GET /printer-interventions

1.5.5.1 Stati della stampante e categorie di stato

Informazioni sugli stati e sulle categorie delle stampanti

Stati a nord

Stati del sud

Stati di inattività

Sconosciuto

1.5.5.2 Gestione dei limiti delle risposte dell'API di esportazione dei dati

Quali sono i limiti

Richieste di pianificazione volte a rimanere entro i limiti