xxnullxx - 5e4f0aeccfd5400001c7b322

RICOH Account Administration

Ricoh Company, Ltd

1 RICOH Account Administration

RICOH Account Administration est l'interface d'administration pour les applications RICOH TotalFlow Cloud telles que RICOH Predictive Insight™.
Référence: Pour plus d'informations sur les stratégies de sécurité de RICOH TotalFlow Cloud, consultez RICOH TotalFlow Cloud Security Overview.

1.1 Présentation de RICOH Account Administration

Les administrateurs ont recours à RICOH Account Administration pour gérer les utilisateurs de RICOH TotalFlow Cloud et d'autres objets utilisés dans vos applications.

Les fonctions disponibles dépendent des abonnements aux applications auxquels votre entreprise a souscrit. Pour toutes les applications TotalFlow Cloud, vous utilisez Account Administration pour :

  • Ajouter, modifier et supprimer des utilisateurs.
  • Afficher les détails au sujet de vos abonnements.
  • Consulter et modifier les détails de votre compte.

Pour certaines applications, d'autres fonctions sont ajoutées afin que vous puissiez :

  • Télécharger et installer RICOH Cloud Connector, pour faciliter la communication avec les applications Ricoh installées sur votre réseau.

1.1.1 Nouveautés

L'application RICOH Account Administration met à jour les fonctions disponibles et apporte des correctifs de façon régulière.

L'application RICOH Account Administration inclut plusieurs correctifs et mises à jour de sécurité avec chaque déploiement. Les modifications apportées avec chaque déploiement sont répertoriées ici.

3 septembre 2026
La fonction API d'exportation de données de RICOH Predictive Insight est désormais disponible. La notation bêta a été supprimée de la documentation ici : Utilisation de l'API d'exportation de données
5 août 2026
Corrections de bogues et mises à jour de sécurité, notamment des correctifs pour les vulnérabilités CVE-2026-42198, CVE-2026-44431, CVE-2026-44432, CVE-2026-48522, CVE-2026-48524, CVE-2026-48525 et CVE-2026-48526.
21 juillet 2026
Corrections de bogues et mises à jour de sécurité pour RICOH Cloud Connector, notamment des correctifs pour les vulnérabilités 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 et CVE-2026-48779.
1er juillet 2026
Corrections de bogues et mises à jour de sécurité, notamment des correctifs pour les vulnérabilités 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 et CVE-2026-47244.
12 juin 2026
Corrections de bogues et mises à jour de sécurité, notamment des corrections concernant les vulnérabilités CWE-117 et CWE-93.
11 juin 2026
Mise à jour du système d'aide afin d'y inclure des informations sur l'API d'exportation de données, une fonctionnalité disponible en version bêta : Utilisation de l'API d'exportation de données
1er mai 2026
Mise à jour de Ricoh TotalFlow Cloud Security Overview.
7 avril 2026
Corrections de bogues et mises à jour de sécurité, notamment des correctifs pour les vulnérabilités CVE-2025-45768 et CVE-2026-26007.
21 janvier 2026
Corrections de bogues et mises à jour de sécurité, y compris des correctifs pour CVE-2025-66418 et CVE-2025-66471.
17 décembre 2025
Corrections de bogues et mises à jour de sécurité, y compris des corrections pour CVE-2025-48976, CVE-2025-7962, et CVE-2025-12383.
30 octobre 2025
Corrections de bogues et mises à jour de sécurité, y compris des correctifs pour CVE-2025-9636 et CVE-2025-48924.
30 juillet 2025
  • Corrections de bogues et mises à jour de sécurité, y compris des correctifs pour CVE-2024-37891 et CVE-2024-12797.
23 juillet 2025
  • Corrections de bogues et mises à jour de sécurité, y compris des correctifs pour CVE-2025-50181 et CVE-2025-50182.
9 juillet 2025
  • Mise à jour de la politique de confidentialité pour le Japon.
  • Ajout d'un support pour les clients en Slovénie et en Croatie.
  • Corrections de bogues et mises à jour de sécurité, y compris des correctifs pour CVE-2021-28168.
2 juillet 2025
  • Corrections de bogues et mises à jour de sécurité, y compris des correctifs pour CVE-2023-52428 et CVE-2023-1370.
4 juin 2025
  • Corrections de bogues et mises à jour de sécurité, y compris des corrections pour CVE-2024-47554 et XUC-XUC-MAVEN-100000.
23 avril 2025
  • Corrections de bogues et mises à jour de sécurité, y compris un correctif pour CVE-2024-37891.
8 avril 2025
2 avril 2025
  • Mise à jour pour changer le nom de RICOH Supervisor en RICOH Predictive Insight dans toutes les références.
  • Mises à jour de sécurité et corrections de bogues.
12 mars 2025
  • Amélioration des performances.
  • Mises à jour de sécurité et corrections de bogues.
4 février 2025
  • Diverses mises à jour de sécurité, y compris des corrections pour CVE-2024-45296, CVE-2024-45590, CVE-2017-20165, et CVE-2024-39338.
  • Modifications rédactionnelles et corrections de bugs.
29 janvier 2025
  • Diverses mises à jour de sécurité, y compris des correctifs pour CWE-798.
  • Modifications rédactionnelles et corrections de bugs.
5 décembre 2024
  • La politique de confidentialité de Ricoh Europe s'applique désormais également à l'Ukraine, à la Roumanie et à Israël.
  • Modifications rédactionnelles et corrections de bugs.
30 octobre 2024
  • Diverses mises à jour de sécurité, y compris des correctifs concernant CVE-2024-37891.
  • Modifications rédactionnelles et corrections de bugs.
2 octobre 2024
  • Diverses mises à jour de sécurité, y compris des correctifs concernant CVE-2023-2650, CVE-2023-3446, CVE-2023-49083, CVE-2023-50782, CVE-2024-0727, CVE-2024-26130 et CVE-2023-4807.
  • Modifications rédactionnelles et corrections de bugs.
17 juillet 2024
  • Suppression de la prise en charge de RICOH TotalFlow Producer.
  • Modifications rédactionnelles et corrections de bugs.
20 juin 2024
  • Modifications rédactionnelles et corrections de bugs.
11 juin 2024
  • Modifications rédactionnelles et corrections de bugs.
22 mai 2024
  • Mise à jour de la liste des imprimantes prises en charge pour l'abonnement avancé RICOH TotalFlow Producer et ajout de la prise en charge des imprimantes avec le contrôleur interne standard de Ricoh.
  • Modifications rédactionnelles et corrections de bugs.
30 avril 2024
  • Modifications rédactionnelles et corrections de bugs.
15 avril 2024
  • Modifications rédactionnelles et corrections de bugs.
9 avril 2024
  • Modifications rédactionnelles et corrections de bugs.
14 mars 2024
  • Modifications rédactionnelles et corrections de bugs.
7 mars 2024
  • Modifications rédactionnelles et corrections de bugs.
27 février 2024
  • Pour l'abonnement avancé RICOH TotalFlow Producer, ajout de la prise en charge de la configuration et de la gestion des imprimantes par RICOH Account Administration.

    Afin de communiquer avec les imprimantes de votre environnement, RICOH Cloud Connector intègre désormais le composant RICOH Printer Connector. Le composant RICOH Printer Connector n'est actuellement disponible que dans la version Windows de RICOH Cloud Connector.

  • Modifications rédactionnelles et corrections de bugs.
13 février 2024
  • Modifications rédactionnelles et corrections de bugs.
30 janvier 2024
  • Modifications rédactionnelles et corrections de bugs.
14 novembre 2023
  • Ajout de la prise en charge de la fonctionnalité BÊTA Conversion Office par RICOH Account Administration afin de renforcer RICOH TotalFlow Producer.

    Cette fonction est disponible avec l'abonnement avancé RICOH TotalFlow Producer.

2 août 2023
  • Ajout de la prise en charge des objets système suivants par RICOH Account Administration afin de renforcer RICOH TotalFlow Producer :
    • Automatisations
    • Connecteurs
    • Clients
    • Dossiers dynamiques

    Ces objets ne sont visibles qu'après l'activation d'un abonnement RICOH TotalFlow Producer, mais les instructions pour les gérer sont incluses dans le système d'aide.

21 juin 2023
  • Mises à jour du système d'aide.
1er mars 2023
  • Diverses mises à jour de sécurité, y compris des correctifs concernant CVE-2022-41946 et CVE-2022-42003.
10 novembre 2022
  • Diverses mises à jour de sécurité, y compris des correctifs concernant CVE-2022-42889.
24 août 2022
  • Diverses mises à jour de sécurité, y compris des correctifs concernant CVE-2022-31197.
27 juillet 2022
  • Diverses mises à jour de sécurité.
24 juin 2022
  • Ajout de la prise en charge de la configuration de RICOH Cloud Connector pour utiliser HTTPS.
  • Diverses mises à jour de sécurité, y compris des correctifs concernant CVE-2022-21724.
17 mai 2022
  • Il est désormais possible d'installer RICOH Cloud Connector à partir de l'interface utilisateur.
11 mars 2022
  • Mise à jour des traductions afin d'y inclure le contenu lié à RICOH Cloud Connector.
  • Mise à jour de la documentation en anglais concernant RICOH Cloud Connector et les rubriques de présentation.
23 février 2022
  • Ajout de la prise en charge des clients au Canada.
19 janvier 2022
  • Diverses mises à jour de sécurité, y compris des correctifs concernant CVE-2021-44228.
27 octobre 2021
  • RICOH Cloud Connector est désormais disponible.
1er septembre 2021
  • Ajout de la prise en charge des clients en France.
25 août 2021
  • Ajout de la prise en charge des clients en Allemagne.
28 juillet 2021
  • Ajout de la prise en charge des clients au Vietnam.
12 mai 2021
  • Ajout de la prise en charge des clients en Belgique et au Luxembourg.
7 mai 2021
  • Mise à jour de la politique en matière de cookies pour les clients au Japon.
17 mars 2021
  • Ajout de la prise en charge des clients au Portugal.
17 février 2021
  • Ajout de la prise en charge des clients en Espagne.
16 décembre 2020
  • Ajout de la prise en charge des clients aux Philippines.
2 décembre 2020
  • Ajout de la prise en charge des clients en Suisse.
9 septembre 2020
  • Ajout de la prise en charge des clients au Japon.
2 septembre 2020
  • Mise à jour de la politique de confidentialité pour les clients des États-Unis.
5 août 2020
  • Ajout de la prise en charge des clients en Suède.
20 mai 2020
  • Ajout de la prise en charge des clients en Malaisie et au Mexique.

1.1.2 Objets système

Les objets système sont des éléments que vous définissez dans les applications TotalFlow Cloud et que vous utilisez pour construire votre solution comme vous le souhaitez. Dans Account Administration, les utilisateurs et les connecteurs sont des exemples d'objets système.

Les objets système que vous définissez dans Account Administration peuvent être utilisés dans les applications TotalFlow Cloud.

1.1.2.1 Clés API

Un Clé API est une information d'identification qui autorise une application à envoyer des requêtes à l'API RICOH TotalFlow Cloud au nom de votre compte. Vous définissez les clés API dans RICOH Account Administration.

Les applications qui utilisent une API au lieu de l'interface utilisateur ne peuvent pas se connecter en tant qu'utilisateur. Au lieu de cela, chaque requête contient la valeur d'une clé API, qui identifie le compte auquel appartient la requête. La clé contenant l'identifiant de votre compte, il n'est pas nécessaire d'indiquer de paramètre de compte ou de locataire dans les requêtes.

Vous pouvez définir jusqu'à dix clés pour votre compte. De nombreuses organisations créent une clé distincte pour chaque application qui récupère des données, de sorte qu'une clé puisse être remplacée ou supprimée sans perturber le fonctionnement des autres applications. Chaque clé possède un nom, une description et une date d'expiration.

La valeur d'une clé n'est affichée qu'une seule fois, au moment où vous créez ou renouvelez la clé. Account Administration ne stocke pas cette valeur sous une forme permettant de l'afficher à nouveau ; vous devez donc la copier et la conserver en lieu sûr dès qu'elle s'affiche. En cas de perte d'une valeur, vous faites pivoter la clé pour en générer une nouvelle. Toute personne en possession de cette valeur peut envoyer des requêtes en se faisant passer pour votre compte ; veillez donc à protéger vos clés comme vous protégez un mot de passe. Les clés ne sont pas limitées à des imprimantes spécifiques.

La gestion des clés s'effectue dans l'onglet Clés API. Vous pouvez modifier le nom, la description ou la date d'expiration d'une clé ; effectuer une rotation de clé afin de remplacer sa valeur tout en conservant son identité ; ou supprimer une clé pour révoquer immédiatement l'accès.

Dans RICOH TotalFlow Cloud, les clés API sont utilisées avec l'API d'exportation de données, qui récupère les informations relatives aux imprimantes, aux travaux et à l'état des imprimantes collectées par RICOH Predictive Insight. Le nombre de requêtes API que votre compte peut effectuer, toutes clés API confondues, est déterminé par votre abonnement. Chaque abonnement fixe une limite maximale pour le nombre de requêtes API autorisées sur une période glissante de 30 jours. Si vous dépassez le nombre d'appels autorisé par votre abonnement, aucune requête ne sera acceptée tant que le nombre total de requêtes des 30 derniers jours n'aura pas repassé sous la limite fixée par votre abonnement. Pour connaître le nombre d'appels inclus dans votre abonnement et le nombre d'appels que vous avez utilisés au cours des 30 derniers jours, consultez la page Clés API. Si vous constatez que vous avez besoin d'une capacité supplémentaire pour les requêtes API, veuillez vous adresser à votre représentant Ricoh pour passer à un abonnement supérieur.

Related information:

Création et gestion des clés API
Utilisation de l'API d'exportation de données
Onglet Clés API

1.1.2.2 Connecteurs

Les Connecteurs sont des applications stockées sur vos systèmes locaux qui créent un lien entre les applications cloud et les logiciels ou appareils installés sur site. Cette connexion établit un canal de communication entre les systèmes. Pour vous connecter à RICOH TotalFlow Cloud, vous devez installer RICOH Cloud Connector sur un serveur de votre réseau.

Ces applications utilisent RICOH Cloud Connector pour installer et gérer les licences d'abonnement :

  • RICOH InfoPrint Manager pour Windows et Linux
  • RICOH Auto Color Adjuster

Related information:

RICOH Cloud Connector

1.1.2.3 Utilisateurs

Toute personne qui travaille avec des applications RICOH TotalFlow Cloud doit être définie comme Utilisateur.

Lorsque Ricoh configure votre compte pour la première fois, un utilisateur Administrateur est créé. L'administrateur reçoit un e-mail de bienvenue de TotalFlow Cloud, avec un lien lui permettant de se connecter et de modifier son mot de passe initial. Cet administrateur est chargé de créer des utilisateurs pour le reste de votre organisation.

Des rôles sont attribués aux Utilisateurs pour chaque application pour laquelle vous avez souscrit un abonnement. Les rôles sont basés sur les responsabilités professionnelles de l'utilisateur et varient d'une application à l'autre. Par exemple, Account Administration a deux rôles que vous pouvez attribuer aux utilisateurs :

Administrateur
Utilisateurs autorisés à consulter les détails de votre compte, à créer et à gérer d'autres utilisateurs et à gérer d'autres objets si nécessaire.
Aucune
Utilisateurs dont les responsabilités professionnelles consistent à travailler dans les applications auxquelles ils sont abonnés, mais pas à gérer des utilisateurs ou d'autres objets.

Un utilisateur peut être un Administrateur dans Account Administration, mais un Visualiseur dans une application comme RICOH Predictive Insight.

Les Utilisateurs se voient également attribuer un rôle au sein de la plateforme TotalFlow Cloud. La plupart des utilisateurs sont affectés au rôle de plateforme Standard. Cependant, d'autres applications peuvent ajouter des rôles de plateforme spéciaux.

Par exemple, RICOH Predictive Insight ajoute le rôle de plateforme Affichage grand format. Vous créez un utilisateur avec le rôle de plateforme Affichage grand format lorsque, par exemple, vous souhaitez afficher les tableaux de bord RICOH Predictive Insight sur un écran dans votre zone de production pour montrer le statut actuel. Un membre de votre entreprise se connecte en tant qu'utilisateur Affichage grand format et agrandit la fenêtre du navigateur sur l'affichage grand format. L'utilisateur Affichage grand format dispose d'un accès en lecture seule et peut rester connecté pendant la durée maximale autorisée.

Related information:

Ajout d'utilisateurs

1.1.3 Interface utilisateur

Les utilisateurs disposant d'un droit d'accès à RICOH Account Administration peuvent ouvrir l'interface utilisateur depuis n'importe quel système connecté à Internet et doté d'un navigateur pris en charge.

1.1.3.1 Bannière

La bannière est la barre noire figurant en haut de l'interface utilisateur. Elle est disponible sur toutes les pages de l'interface.

Les icônes figurant dans la bannière vous permettent d'effectuer diverses tâches :

  • Passer à une autre application RICOH TotalFlow Cloud à laquelle vous avez accès.

    Cliquez sur , l'icône Sélecteur d'applications, puis sélectionnez l'application à ouvrir. L'application s'ouvre dans le même onglet.

  • Soumettre des idées afin d'améliorer nos applications.

    Cliquez sur , sur l'icône Soumettre des idées, puis sur Ajouter une nouvelle idée pour décrire les éléments à ajouter. Vous pouvez également consulter les idées soumises par d'autres clients. Si l'idée vous plaît, vous pouvez voter pour. Les idées soutenues par plusieurs clients ont plus de chances de retenir notre attention et d'être implémentées !

  • Afficher les notifications envoyées par les administrateurs système ou par les applications.

    Cliquez sur , l'icône Notifications.

      Remarque:
    • Vous pouvez consulter certaines notifications sans avoir à ouvrir la liste Notifications. Ces notifications s'affichent dans une bande au-dessus ou au-dessous de la bannière, ou en bas de la fenêtre du navigateur.

  • Afficher les détails concernant votre ID utilisateur ou le compte de votre entreprise.

    Cliquez sur , l'icône Compte. Votre ID utilisateur ainsi que le nom de votre compte se trouvent en haut du menu. Sélectionnez une option pour voir les paramètres ou les informations associés.

  • Obtenir de l'aide pour utiliser l'application.

    Cliquez sur , l'icône Aide, puis sélectionnez Aide.

  • Consulter les conditions d'utilisation des applications TotalFlow Cloud.

    Cliquez sur , l'icône Aide, puis sélectionnez Conditions d'utilisation.

1.1.3.2 Page principale

Lorsque vous vous connectez à RICOH Account Administration ou que vous y revenez à partir d'une autre application, la page principale s'affiche avec l'un des onglets ouverts.

Le nombre d'onglets disponibles varie en fonction des applications auxquelles vous êtes abonné. Toutes les applications comprennent ces onglets :

  • Abonnements
  • Utilisateurs
  • Détails

D'autres applications ajoutent d'autres onglets selon les besoins. Par exemple, avec un abonnement à RICOH Auto Color Adjuster, l'onglet Connecteurs est également disponible.

La plupart des onglets affichent une liste d'objets dans un tableau. Sur tous les tableaux, vous pouvez :

  • Trier les entrées.

    Cliquez une fois sur l'en-tête du tableau pour le trier par ordre croissant et une autre fois pour le trier par ordre décroissant.

  • Changer et réorganiser les colonnes affichées.

    Cliquez sur Roue dentée, l'icône représentant une roue dentée, puis sélectionnez Gérer les colonnes.

  • Rechercher du texte dans le tableau.

    Cliquez sur Icône Rechercher, l'icône Rechercher, puis saisissez le texte à rechercher.

1.1.3.2.1 Onglet Clés API

Les clés API définies pour votre compte sont répertoriées dans l'onglet Clés API de RICOH Account Administration. Utilisez cet onglet pour créer les clés permettant d'autoriser les requêtes adressées à l'API d'exportation de données et pour les gérer tout au long de leur cycle de vie.

Onglet Clés API

L'onglet Clés API n'est disponible que si votre compte dispose d'un abonnement à RICOH Predictive Insight. Pour afficher l'onglet et utiliser les touches de raccourci, vous devez disposer d'un accès Administrateur à Account Administration.

Deux liens situés en haut de l'onglet permettent d'accéder aux informations de référence concernant l'API d'exportation de données :

Premiers pas avec les clés API
Ouvre l'aide relative à l'API d'exportation de données, où vous trouverez des informations sur la marche à suivre pour commencer à utiliser les clés API, ainsi que sur les points de terminaison disponibles, les champs renvoyés par chacun d'entre eux et les limites applicables aux requêtes.
Ouvrir l'explorateur d'API
Ouvre la page de documentation interactive de l'API, sur laquelle vous pouvez consulter chaque point de terminaison, découvrir les paramètres qu'il accepte et envoyer des exemples de requêtes directement depuis votre navigateur. Vous devez disposer de la valeur d'une clé API pour envoyer une requête à partir de cette page.

Voici les actions que vous pouvez effectuer dans cet onglet :

  • Consultez toutes les clés définies pour votre compte ainsi que leurs propriétés, telles que : Nom, Statut et Date d'expiration.

    La table n'affiche pas la valeur d'une clé.

  • Créez une clé.

    Cliquez sur Créer une clé API. Les clés sont généralement actives dans les 30 secondes, mais des retards sont possibles.

  • Surveillez les requêtes API du compte par rapport aux limites de l'abonnement.

    L'encadré situé au-dessus de la table des clés API indique le forfait d'utilisation du compte ainsi que le nombre maximal d'appels API autorisés sur une période de 30 jours. Suivez le nombre d'appels passés au cours des 30 derniers jours.

  • Modifiez le nom, la description ou la date d'expiration d'une clé existante.

    Cliquez avec le bouton droit de la souris sur une ligne et sélectionnez Modifier la clé API. La modification d'une clé n'entraîne pas de changement de sa valeur ; les applications qui utilisent déjà cette clé continuent donc de fonctionner.

  • Faites pivoter une clé pour remplacer sa valeur.

    Cliquez avec le bouton droit de la souris sur une ligne et sélectionnez Renouveler la clé API. Définissez une période de chevauchement afin que la valeur actuelle et la nouvelle valeur soient toutes deux valides pendant un certain nombre de jours, ce qui vous laissera le temps de mettre à jour vos applications. La clé associée à la nouvelle valeur est généralement disponible dans un délai de 30 secondes, mais des retards sont possibles.

  • Supprimer une clé.

    Cliquez avec le bouton droit de la souris sur une ligne et sélectionnez Supprimer immédiatement.

      Remarque:
    • La suppression d'une clé supprime celle-ci du système en moins d'une minute, bien que des retards soient possibles. Les clés supprimées sont effacées définitivement. Si vous essayez d'envoyer une requête API à l'aide d'une clé API après l'avoir supprimée, la requête échouera.
    • La suppression d'une clé supprime toutes ses versions. Si vous effectuez une rotation de clé puis que vous la supprimez, les deux versions de la clé sont supprimées, même si la période de chevauchement est toujours en cours.

Important: La valeur d'une clé n'est affichée qu'une seule fois, lors de la création ou de la rotation de la clé. Vous ne pouvez plus l'afficher à partir de cet onglet. Copiez la valeur et conservez-la en lieu sûr à ce moment-là. Si vous la perdez, tournez la clé pour générer une nouvelle valeur.

Les clés ne sont pas limitées à des imprimantes spécifiques. Toute personne disposant de la valeur d'une clé peut envoyer des requêtes au nom de votre compte. Ne communiquez les clés qu'aux personnes chargées du développement des intégrations, et remplacez-les régulièrement conformément à vos procédures de sécurité.

En cliquant sur , l'icône Outils, vous ouvrez un menu à partir duquel vous pouvez actualiser les informations du tableau et gérer ses colonnes.

Related information:

Création et gestion des clés API
Utilisation de l'API d'exportation de données
Clés API

1.1.3.2.2 Onglet Connecteurs

Les connecteurs enregistrés sont répertoriés dans l'onglet Connecteurs, sur RICOH Account Administration.

Onglet Connecteurs

Voici les actions que vous pouvez effectuer dans cet onglet :

  • Afficher tous les connecteurs enregistrés et leurs propriétés, telles que : Statut, Version, Plateforme ou la date de leur dernière utilisation.
  • Télécharger la dernière version de RICOH Cloud Connector pour votre système d'exploitation.

    Cliquez sur Télécharger, puis sélectionnez le système d'exploitation.

  • Générer un code à usage unique pour enregistrer un connecteur Cloud.

    Cliquez sur Générer un code ponctuel.

  • Modifier, supprimer ou visualiser les connexions associées à un connecteur.

    Cliquez avec le bouton droit de la souris sur un connecteur et sélectionnez une option dans le menu.

      Remarque:
    • Pour modifier un connecteur, le serveur sur lequel le connecteur est défini doit être en cours d'exécution et vous devez disposer d'une connexion réseau fonctionnelle avec ce serveur.
    • Lorsque vous supprimez un connecteur, l'instance de RICOH Cloud Connector n'est pas désinstallée, mais elle n'est plus enregistrée sur le cloud, et les abonnements associés peuvent être affectés.

En cliquant sur , l'icône Outils, vous ouvrez un menu à partir duquel vous pouvez actualiser les informations du tableau et gérer ses colonnes.

1.1.3.2.3 Onglet Détails

L'onglet Détails permet de consulter les informations relatives au compte de votre entreprise.

Vous pouvez cliquer sur Modifier les détails, dans le coin supérieur droit de la page, pour mettre à jour le nom de votre entreprise, les informations de contact et de facturation, la langue par défaut et la période d'inactivité pour tous les utilisateurs de votre entreprise.

1.1.3.2.4 Onglet Abonnements

L'onglet Abonnements permet de visualiser tous les abonnements associés à votre compte, y compris ceux qui ont expiré. Vous pouvez également télécharger RICOH Cloud Connector, si vous en avez besoin.

Onglet Abonnements

Chaque abonnement souscrit par votre entreprise est affiché sous forme de carte dans l'onglet Abonnements. La carte indique les dates de début et d'expiration de l'abonnement. En cliquant sur Détails, une boîte de dialogue s'ouvre et fournit des informations supplémentaires, notamment sur les points suivants :

  • Le nombre et les types de chaque licence incluse avec l'application
  • Les détails de l'abonnement, y compris les modules complémentaires achetés avec celui-ci

1.1.3.2.5 Onglet Utilisateurs

L'onglet Utilisateurs permet de créer et de gérer les utilisateurs qui ont accès à vos applications.

Onglet Utilisateurs

Dans l'onglet Utilisateurs, vous pouvez :

  • Créer des utilisateurs.

    Cliquez sur Ajouter un utilisateur.

  • Modifier, copier et supprimer des utilisateurs existants.

    Cliquez avec le bouton droit de la souris sur une ligne et sélectionnez l'option appropriée.

  • Renvoyer des invitations aux utilisateurs qui n'ont pas répondu à l'invitation initiale.

    Cliquez avec le bouton droit de la souris sur une ligne et sélectionnez Renvoyer l'invitation.

1.1.4 RICOH Cloud Connector

RICOH Cloud Connector est une application que vous installez sur votre réseau pour gérer la communication avec RICOH TotalFlow Cloud.

Cloud Connector n'est nécessaire qu'avec certains produits et dans certaines configurations :

  • RICOH InfoPrint Manager Subscription

    Si vous achetez RICOH InfoPrint Manager Subscription, Cloud Connector est installé avec le produit. Il se connecte à RICOH TotalFlow Cloud pour s'assurer que votre abonnement n'a pas expiré.

  • RICOH Auto Color Adjuster

    RICOH Auto Color Adjuster utilise Cloud Connector pour gérer les abonnements.

Related information:

RICOH Cloud Connector

1.1.5 Accessibilité

Ricoh s'efforce de fournir des produits accessibles à tous, indépendamment de l'âge ou des capacités.

Pour plus d'informations sur l'engagement que nous avons pris en matière d'accessibilité, reportez-vous à la page Accessibilité du site web de Ricoh.

Caractéristiques d'accessibilité

Les caractéristiques d'accessibilité aident les utilisateurs en situation de handicap, tel qu'une mobilité réduite ou une vision limitée, à utiliser avec succès les produits des technologies de l'information.

Les principales fonctions d'accessibilité de ce produit vous permettent d'effectuer les actions suivantes :

  • Utiliser des lecteurs d'écran, des agrandisseurs d'écran et d'autres technologies d'assistance.
  • Utiliser un clavier au lieu d'une souris.
  • Modifier les attributs tels que le volume, la couleur, le contraste et la taille de la police.
  • Distinguer les touches par le toucher sans les activer.
  • Fixer des dispositifs d'entrée et de sortie alternatifs, tels que des dispositifs de pointage spéciaux et des afficheurs en braille.

En outre, le centre d'information et les publications relatives au produit sont dans un format accessible.

Navigation au clavier

Ce produit utilise les touches de navigation standard de Microsoft Windows.

1.1.6 Marques

RICOH InfoPrint Manager™ et RICOH Predictive Insight™ sont des marques commerciales de Ricoh Company, Ltd. aux États-Unis et/ou dans d'autres pays.

Firefox est une marque déposée de la Mozilla Foundation.

Google et Chrome sont des marques commerciales de Google Inc.

Java ainsi que tous les logos et les marques incluant Java sont des marques, déposées ou non, d'Oracle et/ou de ses filiales.

Linux est une marque déposée de Linus Torvalds aux États-Unis et dans d'autres pays.

Microsoft, Windows, Windows Server, Windows Vista et Internet Explorer sont des marques déposées ou des marques commerciales de Microsoft Corporation aux États-Unis et/ou dans d'autres pays.

Les noms corrects des systèmes d’exploitation Windows sont les suivants :

  • 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 est une marque commerciale d'Oracle America, Inc. Java et OpenJDK sont des marques déposées d'Oracle et/ou de ses filiales. Copyright Oracle America, Inc.

Les autres noms de produits utilisés dans le présent document servent uniquement à des fins d'identification et peuvent constituer des marques commerciales de leurs sociétés. Nous ne nous prévalons d'aucun droit sur ces marques.

1.2 Premiers pas avec RICOH TotalFlow™ Cloud

Familiarisez-vous avec les applications TotalFlow Cloud afin de pouvoir commencer à travailler.

1.2.1 Première connexion à RICOH TotalFlow Cloud

Lorsque votre compte est créé, vous recevez un e-mail de RICOH TotalFlow Cloud. Utilisez le bouton figurant dans cet e-mail pour vous connecter pour la première fois.

Pour vous connecter à RICOH TotalFlow Cloud pour la première fois, suivez ces étapes :
  1. Ouvrez l'e-mail envoyé par RICOH TotalFlow Cloud.
  2. Cliquez sur Connexion à votre compte.
    La page de connexion s'ouvre dans votre navigateur web par défaut.
  3. Saisissez un mot de passe dans les champs Nouveau mot de passe et Confirmer le mot de passe, puis cliquez sur créer un mot de passe.
    Les mots de passe doivent comporter plus de huit caractères et répondre aux critères indiqués sur la page.
      Remarque:
    • L'e-mail d'invitation expire au bout de sept jours. Si vous cliquez sur le lien après la date d'expiration de l'invitation, une page d'erreur s'ouvre et une nouvelle invitation par e-mail vous est envoyée automatiquement.
      Important: Ne cliquez sur le lien Renvoyer l'invitation de cette page que si vous ne recevez pas de nouvel e-mail de RICOH TotalFlow Clouddans les 15 minutes.
    • Si vous rencontrez d'autres problèmes lors de la création de votre compte, contactez votre administrateur et demandez-lui de vous renvoyer l'invitation.

Related information:

Premiers pas avec RICOH TotalFlow Cloud pour les administrateurs
Premier pas avec RICOH TotalFlow Cloud pour les utilisateurs

1.2.2 Premiers pas avec RICOH TotalFlow Cloud pour les administrateurs

Les administrateurs configurent les objets et les applications TotalFlow Cloud pour les préparer à être utilisés par d'autres. Ils créent des identifiants pour d'autres utilisateurs et se tiennent au courant des temps d'arrêt programmés, des mises à jour du système et des informations relatives aux abonnements.

Les administrateurs effectuent la plupart de leurs tâches dans l'application RICOH Account Administration, mais ils peuvent également accéder à d'autres applications et les utiliser.

Pour commencer à utiliser RICOH TotalFlow Cloud en tant qu'administrateur :

  1. Connectez-vous et changez votre mot de passe.
    Une fois votre identifiant créé, vous recevez un e-mail vous invitant à vous connecter et à commencer à utiliser les applications RICOH TotalFlow Cloud. La première fois que vous vous connectez, vous devez réinitialiser votre mot de passe.
      Remarque:
    • Ricoh ne crée qu'un seul utilisateur pour votre compte. Cet utilisateur est un administrateur. Si vous êtes le premier utilisateur, vous êtes chargé d'ajouter d'autres utilisateurs et de leur donner accès aux applications appropriées. Vous pouvez créer d'autres administrateurs et leur déléguer des responsabilités.

    En tant qu'administrateur, vous êtes dirigé vers l'application Account Administration.

  2. Définissez les mesures applicables aux paramètres des cookies.
    Les applications TotalFlow Cloud utilisent des cookies, dont certains sont obligatoires. Consultez la section Gestion des paramètres des cookies pour en savoir plus sur les cookies et les mesures que vous pouvez prendre.
  3. Familiarisez-vous avec l'interface de l'application. Consultez les sections suivantes :
  4. Examinez les informations relatives à votre compte et à vos abonnements.
  5. Apprenez à connaître les composants de votre système afin de commencer à planifier les objets que vous devez créer.
  6. Appliquez les procédures de cette section et de la section Configuration pour créer les ID utilisateur et autres objets nécessaires à votre compte.

Related information:

Première connexion à RICOH TotalFlow Cloud

1.2.2.1 Affichage des abonnements

Vous pouvez afficher les détails de vos abonnements dans RICOH Account Administration.
Pour afficher les abonnements :
  1. Connectez-vous à RICOH Account Administration.
  2. Cliquez sur Abonnements dans la sous-fenêtre de gauche.
    La page Abonnements contient les cartes de vos abonnements, ainsi que leur état actuel et leur date d'expiration. Le statut d'un abonnement peut être :
    Actif
    L'abonnement est actuellement disponible.
    En attente
    La date de début de l'abonnement n'est pas encore arrivée.
    Suspendu
    L'abonnement a été désactivé en raison d'un événement tel qu'une violation des conditions générales ou un défaut de paiement. Il peut être restauré lorsque le problème est résolu.
    Expiré
    L'abonnement est arrivé à expiration.
  3. Pour développer les détails de l'abonnement, cliquez sur Détails.

    Le tableau Licences comprend des informations sur les licences des différentes fonctions incluses dans l'abonnement et tous les modules complémentaires, ainsi que la quantité de chaque type de licence que vous avez achetée dans le cadre de cet abonnement.

    Le tableau Détails de l'abonnement de l'abonnement contient un résumé du produit et de tous les modules complémentaires inclus dans cet abonnement.

Pour renouveler un abonnement ou acheter d'autres modules complémentaires, contactez votre représentant Ricoh.

1.2.2.2 Ajout d'utilisateurs

Lorsque vous ajoutez un utilisateur, indiquez ses coordonnées et le type de rôle qu'il possède pour chaque application.

Vous pouvez créer un utilisateur ou copier un utilisateur existant. La copie d'utilisateurs peut vous faire gagner du temps, notamment quand vous devez créer plusieurs utilisateurs ayant des propriétés similaires.

Pour ajouter un utilisateur :

  1. Dans le volet de gauche, cliquez sur Utilisateurs.
  2. Choisissez l'une de ces options :
    • Pour ajouter un nouvel utilisateur : cliquez sur Ajouter un utilisateur dans l'angle supérieur droit de la fenêtre.
    • Pour copier un utilisateur existant : cliquez avec le bouton droit de la souris sur la ligne d'un utilisateur existant et sélectionnez Dupliquer.
  3. Dans la boîte de dialogue qui s'ouvre, saisissez les détails de l'utilisateur.
  4. Sous Type d'utilisateur, sélectionnez Interne pour créer un compte utilisateur pour l'un de vos employés.
  5. Sous Rôle de plateforme, sélectionnez l'une de ces options :
    • Standard - L'utilisateur peut se connecter à l'application à l'aide d'options standard de délai d'expiration et d'accès.
    • Affichage grand format - L'utilisateur dispose d'un accès en lecture seule à l'application sur un grand écran. La connexion de l'utilisateur n'expire pas.
  6. Sous Accès et rôles, sélectionnez l'accès et le rôle de l'utilisateur pour chaque application. Cliquez sur la flèche dans la colonne Accès et rôles pour chaque application.
      Remarque:
    • Certains abonnements comportent des restrictions concernant le nombre d'utilisateurs pouvant être affectés à chaque rôle.
  7. Cliquez sur OK.
L'utilisateur reçoit un e-mail l'invitant à se connecter à RICOH TotalFlow Cloud, où il peut modifier ses informations et changer son mot de passe. L'invitation par e-mail est valable pendant sept jours.
    Remarque:
  • Si l'utilisateur ne se connecte pas avant l'expiration de l'invitation par e-mail, vous pouvez renvoyer l'invitation. Cliquez avec le bouton droit de la souris sur l'utilisateur et choisissez Renvoyer l'invitation.

Related information:

Utilisateurs

1.2.3 Premier pas avec RICOH TotalFlow Cloud pour les utilisateurs

Les utilisateurs des applications RICOH TotalFlow Cloud ont des rôles très variés, allant de l'analyste décisionnel à l'opérateur de l'atelier d'impression.

La plupart des utilisateurs ont accès à une application RICOH TotalFlow Cloud. Vous pouvez également mettre à jour les détails relatifs à votre propre identifiant et à votre mot de passe.

Pour commencer à utiliser les applications RICOH TotalFlow Cloud en tant qu'utilisateur :

  1. Connectez-vous et changez votre mot de passe.
    Une fois votre identifiant créé, vous recevez un e-mail vous invitant à vous connecter et à commencer à utiliser les applications RICOH TotalFlow Cloud. La première fois que vous vous connectez, vous devez réinitialiser votre mot de passe.

    Après avoir modifié votre mot de passe, vous voyez l'application que vous pouvez utiliser.

  2. Définissez les mesures applicables aux paramètres des cookies.
    Les applications TotalFlow Cloud utilisent des cookies, dont certains sont obligatoires. Consultez la section Gestion des paramètres des cookies pour en savoir plus sur les cookies et les mesures que vous pouvez prendre.
  3. Familiarisez-vous avec l'interface de l'application. Consultez les sections suivantes qui présentent un intérêt pour vous :
  4. Apprenez à connaître les composants de votre système.

Related information:

Première connexion à RICOH TotalFlow Cloud

1.2.4 Gestion des paramètres des cookies

Les applications RICOH TotalFlow Cloud utilisent des cookies pour améliorer votre expérience avec notre logiciel. Vous pouvez contrôler les paramètres de certains de ces cookies.
Les applications RICOH TotalFlow Cloud peuvent utiliser les types de cookies suivants :
Cookies strictement nécessaires
Il s'agit de cookies qui sont essentiels au fonctionnement de nos applications. Si vous choisissez de ne pas accepter ces cookies, vous pourriez ne pas être en mesure de vous connecter à nos applications ou d'utiliser d'autres fonctions essentielles.
Cookies de performance
Les cookies de performance, également appelés cookies de statistiques, collectent des informations sur le fonctionnement de nos applications. Ces informations sont agrégées et rendues anonymes, de sorte qu'elles ne peuvent pas être utilisées pour vous identifier.
Les données de performance collectées comprennent les informations recueillies par Google Analytics. Pour empêcher la collecte de vos données par Google Analytics, désactivez les cookies de performance.
Cookies de fonctionnalité
Les cookies de fonctionnalité, également appelés cookies de préférences, mémorisent des informations telles que la dernière page que vous avez consultée ou la langue que vous préférez.
Cookies marketing
Les cookies marketing collectent des informations sur votre activité en ligne afin de vous proposer des publicités pertinentes.

Pour gérer les paramètres des cookies :

  1. Connectez-vous à une application TotalFlow Cloud.
  2. Dans la bannière, cliquez sur icône Compte, l'icône Compte, puis choisissez Paramètres des cookies.
  3. Dans la boîte de dialogue Paramètres des cookies, cliquez sur Afficher la déclaration sur les cookies pour afficher la liste des cookies utilisés dans les applications TotalFlow Cloud et leurs descriptions.
  4. Utilisez les commutateurs pour activer ou désactiver chaque type de cookie.
    Par défaut, tous les cookies sont désactivés :
  5. Cliquez sur OK.

1.3 Configuration

Procédez comme suit pour configurer votre système afin que d'autres personnes de votre entreprise puissent l'utiliser.

1.3.1 Ajout d'utilisateurs

Lorsque vous ajoutez un utilisateur, indiquez ses coordonnées et le type de rôle qu'il possède pour chaque application.

Vous pouvez créer un utilisateur ou copier un utilisateur existant. La copie d'utilisateurs peut vous faire gagner du temps, notamment quand vous devez créer plusieurs utilisateurs ayant des propriétés similaires.

Pour ajouter un utilisateur :

  1. Dans le volet de gauche, cliquez sur Utilisateurs.
  2. Choisissez l'une de ces options :
    • Pour ajouter un nouvel utilisateur : cliquez sur Ajouter un utilisateur dans l'angle supérieur droit de la fenêtre.
    • Pour copier un utilisateur existant : cliquez avec le bouton droit de la souris sur la ligne d'un utilisateur existant et sélectionnez Dupliquer.
  3. Dans la boîte de dialogue qui s'ouvre, saisissez les détails de l'utilisateur.
  4. Sous Type d'utilisateur, sélectionnez Interne pour créer un compte utilisateur pour l'un de vos employés.
  5. Sous Rôle de plateforme, sélectionnez l'une de ces options :
    • Standard - L'utilisateur peut se connecter à l'application à l'aide d'options standard de délai d'expiration et d'accès.
    • Affichage grand format - L'utilisateur dispose d'un accès en lecture seule à l'application sur un grand écran. La connexion de l'utilisateur n'expire pas.
  6. Sous Accès et rôles, sélectionnez l'accès et le rôle de l'utilisateur pour chaque application. Cliquez sur la flèche dans la colonne Accès et rôles pour chaque application.
      Remarque:
    • Certains abonnements comportent des restrictions concernant le nombre d'utilisateurs pouvant être affectés à chaque rôle.
  7. Cliquez sur OK.
L'utilisateur reçoit un e-mail l'invitant à se connecter à RICOH TotalFlow Cloud, où il peut modifier ses informations et changer son mot de passe. L'invitation par e-mail est valable pendant sept jours.
    Remarque:
  • Si l'utilisateur ne se connecte pas avant l'expiration de l'invitation par e-mail, vous pouvez renvoyer l'invitation. Cliquez avec le bouton droit de la souris sur l'utilisateur et choisissez Renvoyer l'invitation.

Related information:

Utilisateurs

1.4 Gestion d'objets

Une fois que vous avez créé des utilisateurs et configuré les détails de votre compte, vous pouvez les mettre à jour si nécessaire.

1.4.1 Gestion des informations du compte

Vous pouvez modifier les informations de votre compte, y compris vos coordonnées et celles de votre entreprise.
Pour gérer les détails du compte :
  1. Cliquez sur Détails dans le panneau de gauche.
  2. Cliquez sur Modifier les détails.
  3. Modifiez les informations nécessaires et cliquez sur OK.

1.4.2 Modification des informations utilisateur

Vous pouvez modifier les informations d'un utilisateur si nécessaire.
Pour modifier les informations relatives aux utilisateurs :
  1. Cliquez sur Utilisateurs dans la sous-fenêtre de gauche.
  2. Cliquez avec le bouton droit de la souris sur l'utilisateur dont vous souhaitez modifier les informations, puis sélectionnez Modifier.
  3. Effectuez les modifications nécessaires, puis cliquez sur OK.

1.4.3 Modification du mot de passe

Changez votre mot de passe pour assurer la sécurité de votre compte.
    Remarque:
  • Si vous ne connaissez pas votre mot de passe actuel, ouvrez la page de connexion pour RICOH TotalFlow Cloud et cliquez sur Mot de passe oublié. Saisissez votre adresse électronique et cliquez sur Suivant. Consultez votre courrier électronique pour y trouver un message de RICOH TotalFlow Cloud contenant des instructions pour réinitialiser votre mot de passe.

Pour modifier votre mot de passe :

  1. Connectez-vous à RICOH TotalFlow Cloud.
  2. Dans la bannière, cliquez sur icône Compte, l'icône Compte, puis choisissez Paramètres du profil.
  3. Dans la partie gauche de la page Profil et préférences du logiciel Ricoh, cliquez sur Mot de passe.
  4. Saisissez deux fois votre mot de passe actuel et votre nouveau mot de passe.
  5. Cliquez sur Modifier le mot de passe.
  6. Cliquez sur Fermer.
La prochaine fois que vous vous connecterez, veillez à utiliser le nouveau mot de passe.

1.5 Utilisation de l'API d'exportation de données

Grâce à l'API d'exportation de données, vous pouvez extraire les informations collectées par RICOH Predictive Insight afin de les utiliser dans d'autres processus et outils au sein de votre organisation.

L'API d'exportation de données permet d'accéder par programmation aux informations relatives à l'imprimante, à l'historique des travaux, aux données d'état de l'imprimante et aux événements d'intervention sur l'imprimante. Vous pouvez l'utiliser pour alimenter des outils de reporting, remplir des tableaux de bord, archiver des données opérationnelles ou intégrer des données RICOH Predictive Insight à d'autres systèmes de votre environnement.

Related information:

Création et gestion des clés API
Onglet Clés API
Clés API

1.5.1 API d'exportation de données

L'API d'exportation de données est une API REST qui propose quatre points de terminaison. Vous pouvez utiliser ces points de terminaison pour télécharger des informations concernant vos imprimantes et les travaux qu'elles ont traités, ainsi que l'historique de leur état de fonctionnement et les événements ayant déclenché des messages d'avertissement ou d'erreur sur l'imprimante.

Vous pouvez utiliser l'API d'exportation des données pour extraire des données RICOH Predictive Insight et les intégrer dans des outils de veille stratégique, des entrepôts de données, des tableaux de bord et d'autres applications au sein de votre organisation.

Authentification

Vous pouvez créer et gérer des clés API sur RICOH Account Administration. Vous pouvez créer autant de clés que nécessaire : une par application qui télécharge des données ou une seule clé à utiliser à l'échelle de votre entreprise. Définissez une date d'expiration conformément à vos pratiques de sécurité et renouvelez les clés si nécessaire. Vous pouvez définir la période de chevauchement, de sorte que l'ancienne et la nouvelle clé fonctionnent toutes les deux pendant un certain nombre de jours. Si nécessaire, vous pouvez supprimer une clé pour la désactiver immédiatement.

La clé API contient également l'identité de votre locataire ; c'est pourquoi aucun paramètre de locataire ou de compte n'est requis dans aucune requête. Toute personne disposant de cette clé API peut envoyer des requêtes en votre nom ; veillez donc à protéger vos clés API comme vous le feriez pour un mot de passe.

Points de terminaison disponibles

L'API comprend les points de terminaison suivants :

/printers
Renvoie la liste des imprimantes associées à votre compte, comprenant le nom de l'imprimante, son modèle, son fabricant, son numéro de série, ses moteurs et l'état actuel de la connexion.
/jobs
Renvoie les détails relatifs aux travaux d'impression pour une ou plusieurs imprimantes, notamment la durée, le nombre d'exemplaires imprimés, le nombre de pages, le nombre d'impressions, le nombre de feuilles, la longueur du rouleau, ainsi que la consommation d'encre et de vidage par canal de couleur. Par défaut, la réponse porte sur les dernières 24 heures.
/printer-states
Renvoie l'état de fonctionnement de chaque moteur d'impression, soit sous la forme d'un historique agrégé sur une période donnée, soit sous la forme de l'état actuel uniquement. Vous pouvez récupérer les états réels de l'imprimante, tels que : Printing, Preparing, Maintenance ou Sleeping ; ces états peuvent également être regroupés en catégories : up, down, idle ou unknown.

Conseil: Le point de terminaison /printer-states fournit des informations sur l'état de chaque moteur d'impression, et non de chaque imprimante. Une imprimante dotée de plusieurs moteurs renvoie une ligne par moteur.

/printer-interventions
Renvoie les événements ayant provoqué des avertissements ou des erreurs sur une ou plusieurs imprimantes, tels qu'un bourrage papier ou une source de support vide. Chaque événement est consigné pour un seul moteur d'impression, avec l'heure à laquelle il a débuté, l'heure à laquelle il s'est terminé, sa durée, un code identifiant la condition et, le cas échéant, le nom du travail en cours d'impression. Par défaut, la réponse porte sur les dernières 24 heures. Vous pouvez demander les descriptions des événements dans n'importe laquelle des langues prises en charge.
Tester l'API

Une page de documentation interactive est à votre disposition pour vous permettre de consulter chaque point de terminaison, de découvrir les paramètres qu'il accepte et de tester des exemples de requêtes directement depuis votre navigateur. Pour ouvrir la page, rendez-vous sur :

Pour envoyer des requêtes depuis la page de documentation ou depuis vos propres applications, vous devez d'abord créer une clé API. Vous pouvez créer et gérer des clés API sur Account Administration.

1.5.2 Création et gestion des clés API

Une clé API autorise les requêtes adressées à l'API d'exportation de données. Vous créez et gérez vos clés API sur Account Administration, et vous indiquez cette clé lorsque vous envoyez des requêtes depuis la page « Explorateur d'API » ou depuis vos propres applications.

Chaque requête adressée à l'API d'exportation de données doit comporter une clé API valide dans l'en-tête de requête x-api-key. La clé authentifie la requête adressée à votre compte (client).

Pour créer des clés API, vous devez disposer d'un accès Administrateur à Account Administration.

Suivez les procédures décrites dans cette rubrique pour :

  • Créez une nouvelle clé API.
  • Modifiez le nom, la date d'expiration ou la description d'une clé existante.
  • Faites pivoter une clé pour remplacer sa valeur secrète sans modifier l'identité de la clé.
  • Supprimer une clé du système.
Remarque: Lorsque vous créez ou renouvelez une clé API, il s'écoule un court laps de temps avant que la clé ne soit enregistrée et prête à être utilisée. En règle générale, ce délai est inférieur à une minute.
  • Pour créer une nouvelle clé API :
    1. Dans le volet gauche de Account Administration, cliquez sur Clés API.
    2. Cliquez sur Créer une clé API.
    3. Veuillez saisir un nom et une description pour cette clé.
    4. Pour Date d'expiration, choisissez une date située dans les 367 prochains jours.
    5. Pour Licences, choisissez Plan d'utilisation d'exportation de données RPI pour les clés API.
    6. Cliquez sur Suivant.
      La clé est générée et enregistrée.
    7. Cliquez sur Copier pour copier la clé générée dans votre presse-papiers. Conservez-le en lieu sûr.
      Important: La valeur complète de la clé n'est affichée que lors de la création de celle-ci. Vous ne pouvez plus y accéder. Si vous perdez cette valeur, vous devez changer de clé pour en générer une nouvelle.
    1. Cliquez sur J'ai sauvegardé ma clé pour fermer la boîte de dialogue.
  • Pour modifier une clé API existante :
    1. Dans le volet gauche de Account Administration, cliquez sur Clés API.
    2. Repérez la clé que vous souhaitez modifier. Cliquez avec le bouton droit de la souris sur la ligne correspondant à la clé, puis sélectionnez Modifier la clé API.
    3. Modifiez le nom, la date d'expiration ou la description si nécessaire.
      La modification d'une clé n'entraîne pas de changement de sa valeur. Les applications qui utilisent déjà cette clé continuent de fonctionner sans modification.
    4. Cliquez sur OK.
  • Pour renouveler une clé API :
    1. Dans le volet gauche de Account Administration, cliquez sur Clés API.
    2. Repérez la clé que vous souhaitez faire pivoter. Cliquez avec le bouton droit de la souris sur la ligne correspondant à la clé, puis sélectionnez Renouveler la clé API.
    3. Définissez Période de chevauchement en jours sur le nombre de jours pendant lesquels vous souhaitez que la clé existante et la version alternée restent actives simultanément.
    4. Définissez une nouvelle valeur Date d'expiration pour la clé.
    5. Cliquez sur OK.
    6. Cliquez sur Copier pour copier la clé générée dans votre presse-papiers. Conservez-le en lieu sûr.
      Important: La valeur complète de la clé n'est affichée que lors de la création de celle-ci. Vous ne pouvez plus y accéder. Si vous perdez cette valeur, vous devez changer de clé pour en générer une nouvelle.
    7. Mettez à jour toutes les applications, tous les scripts ou toutes les sessions de documentation interactive enregistrées qui utilisent cette clé avant l'expiration de la période de chevauchement.
  • Pour supprimer une clé du système :
    1. Dans le volet gauche de Account Administration, cliquez sur Clés API.
    2. Repérez la clé que vous souhaitez faire pivoter. Cliquez avec le bouton droit de la souris sur la ligne correspondant à la clé, puis sélectionnez Supprimer immédiatement.
    3. Dans la boîte de dialogue, sélectionnez Oui, supprimer la clé.
      Cette étape est obligatoire, car la suppression est définitive. Une fois la clé supprimée, vous ne pourrez plus la récupérer.
    4. Cliquez sur OK.

Vous pouvez utiliser la clé API nouvelle ou mise à jour sur la page de documentation interactive pour tester l'API d'exportation de données, ainsi que dans toute application qui envoie des requêtes à cette API.

Related information:

Utilisation de l'API d'exportation de données
Onglet Clés API
Clés API

1.5.3 Tester l'API d'exportation de données

Suivez cette procédure pour découvrir brièvement l'API, en vous aidant de la page de documentation interactive.

Avant de commencer cette tâche, veuillez créer une clé API à l'adresse RICOH Account Administration.

Cette procédure vous guide à travers les étapes suivantes :

  1. Authentification sur la page de documentation interactive
  2. Récupération de la liste des identifiants des imprimantes associées à votre compte
  3. Récupération de l'état d'une ou plusieurs imprimantes
  4. Demande d'informations concernant les travaux associés à une ou plusieurs de ces imprimantes

Pour utiliser l'API d'exportation de données :

  1. Pour consulter la documentation interactive de l'API d'exportation de données, cliquez ici :
  2. S'authentifier à l'aide d'une clé API :
    1. Cliquez sur Autoriser à droite de la page.
    2. Dans la boîte de dialogue Autorisations disponibles, saisissez votre clé API dans le champ Valeur.
      Boîte de dialogue Autorisations disponibles
    1. Cliquez sur Autoriser pour vous authentifier.
    2. Cliquez sur Fermer.
    Vous pouvez désormais tester les fonctions de l'API disponibles. Utilisez cette interface pour vous familiariser avec la syntaxe avant d'intégrer l'API à vos applications.
  3. Récupérez la liste des identifiants des imprimantes définies dans votre compte.
    Pour récupérer des informations sur l'état des travaux et des imprimantes, vous devez inclure les identifiants des imprimantes dans vos requêtes API. Les identifiants d'imprimante ne changent pas. Si vous les récupérez maintenant et que vous enregistrez les valeurs, vous pourrez utiliser ces identifiants dans d'autres appels d'API.
    1. Ouvrez la section Imprimantes, puis ouvrez le point de terminaison GET /printers.
      Comme vous pouvez le constater, aucun paramètre n'est requis pour ce point de terminaison.
    2. Cliquez sur Essayer, puis sur Exécuter.
    3. Vérifiez le corps de la réponse. Vous pouvez consulter la liste des informations détaillées concernant les imprimantes surveillées par RICOH Predictive Insight. La réponse ressemble à ceci :
      [
  {
    "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"
  }
]

      Notez les valeurs des paramètres printerId pour chacune de vos imprimantes.

  4. Demandez l'historique de l'état d'une ou plusieurs imprimantes de votre système.
    1. Ouvrez le point de terminaison GET /printer-states.
    2. Cliquez sur Essayer.
    3. À côté de printerId, cliquez sur Ajouter un élément de chaîne.
    4. Remplacez le texte figurant dans le champ par l'une des valeurs d'identifiant d'imprimante que vous avez récupérées à l'étape 3.
      Pour récupérer l'historique des états d'autres imprimantes, cliquez à nouveau sur Ajouter un élément de chaîne et ajoutez une autre valeur d'identifiant d'imprimante.
    5. Pour le fuseau horaire, choisissez celui que vous souhaitez utiliser pour les données.
    6. Veuillez indiquer les heures de début et de fin de la période sur laquelle porte le rapport. Ne remplissez pas ces champs pour récupérer les données des dernières 24 heures.
    7. Laissez les trois dernières valeurs sur leur valeur par défaut afin de pouvoir consulter la liste complète des informations que l'API peut renvoyer.
    8. Cliquez sur Exécuter.
    9. Vérifiez le corps de la réponse. Vous voyez une liste des données relatives à l'état de chaque moteur d'impression, avec une ligne pour chaque changement d'état de l'imprimante.
    10. Modifiez les valeurs des paramètres currentState, stateCategoryOnly et stateCategory, puis cliquez à nouveau sur Exécuter pour observer l'évolution de la réponse.
      • Si vous laissez ces paramètres à leur valeur par défaut (non définis), cela revient à les définir sur faux.
      • Vous pouvez les utiliser séparément ou en les combinant entre eux.
  5. Demandez des informations sur les travaux associés à une ou plusieurs de ces imprimantes :
    1. Rendez-vous dans la rubrique Travaux de la page.
    2. Ouvrez le point de terminaison GET /jobs.
    3. Cliquez sur Essayer.
    4. À côté de printerId, cliquez sur Ajouter un élément de chaîne.
    5. Remplacez le texte figurant dans le champ par l'une des valeurs d'identifiant d'imprimante que vous avez récupérées à l'étape 3.
      Pour récupérer les informations sur les travaux pour d'autres imprimantes, cliquez à nouveau sur Ajouter un élément de chaîne et ajoutez une autre valeur d'identifiant d'imprimante.
    6. Pour le fuseau horaire, choisissez celui que vous souhaitez utiliser pour les données.
    7. Veuillez indiquer les heures de début et de fin de la période sur laquelle porte le rapport. Ne remplissez pas ces champs pour récupérer les données des dernières 24 heures.
    8. Pour le paramètre jobState, laissez le champ vide afin de voir l'ensemble des réponses que l'API peut renvoyer.
    9. Cliquez sur Exécuter.
    10. Consultez la réponse pour voir les informations sur les travaux qui vous ont été renvoyées.
    11. Modifiez la valeur de jobState et cliquez à nouveau sur Exécuter pour observer l'évolution de la réponse.

1.5.4 Gestion de la date et de l'heure dans l'API d'exportation de données

L'API d'exportation de données utilise un modèle unique et cohérent pour le traitement des dates et des heures : chaque requête indique un fuseau horaire IANA, chaque valeur de date et d'heure est interprétée selon ce fuseau horaire, et chaque valeur de date et d'heure figurant dans la réponse est formatée selon ce même fuseau horaire. Consultez cette rubrique pour comprendre le fonctionnement du modèle et éviter les erreurs courantes.
Le modèle de date et d'heure

Trois règles définissent la manière dont l'API traite les dates et les heures :

  1. Toute requête adressée aux /jobs, /printer-states et /printer-interventions doit inclure un paramètre timezone contenant un identifiant de fuseau horaire IANA valide, par exemple America/Denver ou Europe/Bucharest.
  2. Toute valeur startDateTime ou endDateTime fournie dans la requête est interprétée comme une heure locale dans le fuseau horaire indiqué. Ces valeurs ne tiennent pas compte du décalage horaire par rapport à l'UTC.
  3. Chaque valeur de date et d'heure contenue dans la réponse est formatée selon l'heure locale du même fuseau horaire, en utilisant le format YYYY-MM-DDTHH:MM:SS.sss.

Le paramètre timezone détermine la signification de la requête et le formatage de la réponse. Deux requêtes portant sur les mêmes données sous-jacentes, envoyées avec des fuseaux horaires différents, génèrent des réponses comportant des chaînes de date et d'heure différentes, même si elles décrivent les mêmes événements.

Format de la date et de l'heure

L'API utilise un format unique pour toutes les valeurs de date et d'heure, tant dans les requêtes que dans les réponses :

YYYY-MM-DDTHH:MM:SS.sss

Par exemple, 2026-03-15T14:30:00.000 correspond à 14 h 30 le 15 mars 2026, selon le fuseau horaire indiqué dans la requête.

Important: Ce format ne comporte ni décalage horaire par rapport à l'UTC (tel que -06:00), ni suffixe Z. N'en ajoutez pas. Les requêtes et les réponses utilisent toutes deux uniquement l'heure locale, le fuseau horaire étant transmis séparément sous forme de paramètre de requête.

Dans les requêtes, la partie en millisecondes (.sss) est facultative. Dans les réponses, il est toujours présent.

Période par défaut

Vous pouvez omettre startDateTime, endDateTime, ou les deux. Ces deux valeurs par défaut s'appliquent indépendamment l'une de l'autre :

  • Si vous n'indiquez pas de startDateTime, l'API considère que la plage commence 24 heures avant l'heure actuelle.
  • Si vous n'indiquez pas de endDateTime, l'API utilise l'heure actuelle comme heure de fin de la plage.

Les valeurs par défaut se combinent comme on peut s'y attendre :

  • Si vous n'indiquez aucune de ces deux valeurs, l'API renvoie les données des dernières 24 heures.
  • Si vous indiquez startDateTime comme étant « il y a une heure » et que vous n'indiquez pas endDateTime, l'API renvoie les données de l'heure précédente.
  • Si vous indiquez endDateTime et que vous n'indiquez pas startDateTime, l'API renvoie les données correspondant à la période commençant 24 heures avant la requête et se terminant à l'heure indiquée par endDateTime.

Les valeurs par défaut sont calculées selon le fuseau horaire indiqué dans la requête.

Conservation des données : les sept derniers jours

L'API d'exportation de données fournit des données opérationnelles en temps réel. Les historiques des travaux, l'historique de l'état de l'imprimante et les événements d'intervention ne sont disponibles que pour les sept derniers jours. Toute demande concernant des données datant de plus de sept jours génère une erreur.

Prévoyez votre intégration de manière à ce que les extractions planifiées s'exécutent suffisamment souvent pour capturer toutes les données avant qu'elles ne deviennent obsolètes :

  • Pour les relevés nocturnes, prévoyez une marge d'au moins un ou deux jours. Si une exécution planifiée échoue, vous disposez de suffisamment de temps pour en déterminer la cause et la relancer avant que les données ne soient plus disponibles.
  • Pour les mises à jour ou les extractions ponctuelles, ne demandez pas de données datant de plus de sept jours.
Règles applicables à la plage demandée
  • startDateTime doit être antérieure à endDateTime. Toute requête qui enfreint une règle génère une erreur ERR_INVALID_DATE_RANGE.
  • Ces deux valeurs doivent respecter le format décrit à l'adresse Format de la date et de l'heure. Une requête contenant une valeur mal formée génère une erreur ERR_INVALID_DATE_FORMAT.
  • La durée comprise entre startDateTime et endDateTime ne doit pas dépasser l'intervalle maximal autorisé. Une requête qui dépasse la limite maximale génère une erreur ERR_DATE_RANGE_EXCEEDED.
Indication du fuseau horaire

Le paramètre timezone accepte les identifiants de fuseau horaire de l'IANA, tels que America/Denver, America/New_York, Europe/Bucharest, Asia/Tokyo ou UTC. La page de documentation interactive présente une liste de toutes les valeurs acceptées par l'API.

Un identifiant non valide ou non reconnu génère une erreur ERR_INVALID_TIMEZONE. Les abréviations à trois lettres telles que MST ou EST ne constituent pas des identifiants IANA et ne sont pas acceptées ; veuillez utiliser à la place l'identifiant de la région correspondant (par exemple, America/Denver ou America/New_York).

Fournir la langue

Le paramètre timezone n'est pas le seul paramètre qui détermine la manière dont l'API formate une réponse. Le point de terminaison /printer-interventions accepte également un paramètre language facultatif, qui détermine la langue du champ description dans la réponse.

Les valeurs autorisées sont : en (anglais), de (allemand), ja (japonais), it (italien), fr (français) et es (espagnol). Une valeur ne figurant pas dans cette liste entraîne une erreur ERR_INVALID_LANGUAGE.

Il convient de prendre en compte deux aspects de ce paramètre :

  • Si vous n'indiquez pas de paramètre, ou si aucune description n'est disponible dans la langue que vous avez demandée, la description s'affiche en anglais. La requête aboutit dans les deux cas ; votre intégration ne peut donc pas partir du principe que la langue d'une description correspond à celle qu'elle a demandée.
  • Ce paramètre n'affecte que le champ description. Le champ interventionCode qui l'accompagne est indépendant de la langue ; utilisez donc ce champ lorsque vous avez besoin de regrouper, de comparer ou de stocker des événements de manière cohérente, quelle que soit la langue demandée.
L'heure d'été et les horaires ambigus

Les requêtes et les réponses étant exprimées en heure locale, les changements d'heure liés à l'heure d'été donnent lieu à deux situations dont il convient de tenir compte :

Heures locales ignorées lors du passage à l'heure d'été
Lorsque les horloges sont avancées d'une heure, une heure de l'heure locale n'existe pas. Par exemple, dans le fuseau horaire America/Denver, le jour du passage à l'heure d'été, 02:30:00 n'est pas une heure locale valide. Évitez d'utiliser des heures comprises dans la plage d'heures exclue comme startDateTime ou endDateTime.
Horaires locaux répétés lors du passage à l'heure d'automne
Lorsque les horloges reculent d'une heure, une heure de l'heure locale se produit deux fois. Une valeur telle que 01:30:00 le jour du passage à l'heure d'hiver est ambiguë. Choisissez des horaires en dehors des heures répétées afin d'éviter toute ambiguïté quant à l'instance que vous demandez.

Si votre intégration s'exécute en mode automatique et risque d'envoyer une requête dont l'heure de début ou de fin se situe pendant une transition, programmez l'exécution de cette requête à quelques heures avant ou après la transition, ou choisissez des horaires qui se situent clairement en dehors de celle-ci.

Recommandations concernant le stockage et la comparaison des horodatages de réponse

Les horodatages des réponses correspondent à l'heure locale, sans décalage horaire. Afin d'éviter toute ambiguïté dans les systèmes en aval, envisagez l'une des approches suivantes :

  • Enregistrez l'horodatage de la réponse ainsi que le fuseau horaire que vous avez indiqué dans la requête. Ces deux éléments, pris ensemble, permettent d'identifier un instant unique dans le temps.
  • Dans votre intégration, convertissez chaque horodatage de réponse en UTC avant de l'enregistrer, en utilisant le fuseau horaire que vous avez indiqué dans la requête. Le stockage des valeurs UTC simplifie les comparaisons entre des données extraites dans différents fuseaux horaires.
  • Veillez à toujours soumettre vos requêtes en utilisant le même fuseau horaire, par exemple UTC, afin que tous les horodatages enregistrés soient directement comparables.
Exemples

Les exemples suivants illustrent comment le fuseau horaire, l'heure de début et l'heure de fin s'articulent entre eux.

Fenêtre par défaut à l'heure des Rocheuses
Une requête soumise à 9 h 00 le 15 mars 2026, dans le fuseau horaire America/Denver, sans heure de début ni de fin indiquée, renvoie les données comprises entre 2026-03-14T09:00:00 et 2026-03-15T09:00:00, toutes deux exprimées en heure des Rocheuses.
Plage horaire spécifique (heure d'Europe de l'Est)
Une requête contenant les paramètres timezone=Europe/Bucharest, startDateTime=2026-03-15T08:00:00, et endDateTime=2026-03-15T16:00:00 renvoie les données relatives à la journée de travail de huit heures à l'heure locale de Bucarest. Les horodatages des réponses sont également exprimés en heure locale de Bucarest.
La même fenêtre vue selon deux fuseaux horaires
Pour récupérer deux fois les mêmes données sous-jacentes, mises en forme pour deux publics différents, envoyez deux requêtes avec des valeurs de fuseau horaire différentes et ajustez les paramètres startDateTime et endDateTime de manière à ce qu'ils correspondent aux mêmes instants dans chaque fuseau horaire. Les données utiles des réponses décrivent les mêmes événements, mais utilisent des chaînes de caractères d'horodatage différentes.

Related information:

Gestion des limites de réponse de l'API d'exportation de données

1.5.5 Champs de réponse de l'API d'exportation de données

Chaque point de terminaison de l'API d'exportation de données renvoie un tableau JSON d'objets. Utilisez les tables figurant dans cette rubrique pour interpréter les champs de chaque réponse.
Conventions utilisées dans le présent document de référence
  • Toutes les durées sont exprimées en millisecondes.
  • Toutes les valeurs de date et d'heure sont formatées selon le fuseau horaire spécifié par le paramètre de requête timezone, en utilisant le format YYYY-MM-DDTHH:MM:SS.sss.
  • Les champs d'identifiant (printerId, jobId) restent inchangés d'une requête à l'autre et peuvent être mis en cache par les applications qui s'y intègrent. Le printerId ne change jamais ; ses valeurs peuvent donc être enregistrées et réutilisées d'une session à l'autre.
Champs de réponse de la requête GET /printers

Le point de terminaison /printers renvoie un objet par imprimante identifiée dans le compte et suivie par un collecteur de données.

Zone Type Description
printerName chaîne Le nom d'affichage attribué à l'imprimante dans RICOH Predictive Insight.
printerId chaîne (UUID) L'identifiant unique de l'imprimante. Utilisez cette valeur comme paramètre printerId lorsque vous appelez /jobs, /printer-states ou /printer-interventions.
engines entier Le nombre de modules d'impression dans l'imprimante. Les imprimantes à alimentation en continu peuvent comporter un ou plusieurs moteurs ; les imprimantes à feuilles sont généralement équipées d'un seul moteur. Chaque moteur fait l'objet d'une ligne distincte dans les réponses /printer-states et /printer-interventions.
manufacturer chaîne Le fabricant de l'imprimante, par exemple Ricoh ou InfoPrint.
modèles chaîne Le modèle d'imprimante tel qu'il est indiqué par l'appareil, par exemple RICOH Pro VC80000.
printerMode chaîne Si l'imprimante fonctionne en mode simplex ou duplex. Ce champ peut être absent pour les types d'imprimantes auxquels cette valeur ne s'applique pas, comme les imprimantes à feuilles individuelles.
printerType chaîne Si l'imprimante prend en charge le papier continuous_feed ou cut_sheet.
serialNumber chaîne Le numéro de série indiqué par l'imprimante. Pour les imprimantes à plusieurs moteurs, ce champ peut contenir les numéros de série de chaque moteur sous la forme d'une seule chaîne de caractères, par exemple Printer 1: 10-11111 and Printer 2: 10-11112.
connectionStatus chaîne Indique si RICOH Predictive Insight peut actuellement accéder à l'imprimante. Les valeurs possibles sont connected et not_connected.
Champs de la réponse GET /jobs

Le point de terminaison /jobs renvoie un objet par travail traité par les imprimantes demandées au cours de la période indiquée.

Zone Type Description
printerId chaîne (UUID) L'identifiant de l'imprimante qui a traité le travail. Fait correspondre un printerId issu de la réponse /printers.
jobId chaîne L'identifiant unique du travail.
jobName chaîne Le nom du travail tel qu'il a été transmis à l'imprimante, généralement le nom du fichier source.
jobPrintingSide chaîne Le ou les côtés imprimés pour ce travail, par exemple simplex ou duplex.
jobAction chaîne L'état des travaux au moment du traitement de la demande. Valeurs possibles :
  • printing: le travail était en cours d'impression au moment où la demande a été émise.
  • printing : l'impression du travail s'est terminée avec succès.
  • aborted: les travaux s'ont arrêtés avant la fin de l'impression.
  • completed: le travail a atteint son état final. Cette valeur correspond à un ensemble plus large qui inclut à la fois les travaux printed et les travaux aborted. Utilisez cette fonction lorsque vous souhaitez récupérer tous les travaux qui ne sont plus actifs, quel que soit leur résultat.
jobStartTime chaîne (date-heure) La date et l'heure locales auxquelles l'impression du travail a commencé, dans le fuseau horaire indiqué dans la requête.
jobEndTime chaîne (date-heure) La date et l'heure locales auxquelles les travaux s'ont terminés, dans le fuseau horaire indiqué dans la requête.
jobDuration entier Le temps d'impression écoulé pour ce travail, en millisecondes.
printedCopies entier Le nombre d'exemplaires des travaux produits.
printedPages entier Le nombre total de pages logiques imprimées pour ce travail, toutes copies comprises.
printedImpressions entier Le nombre total d'exemplaires imprimés. Un travail correspond à une face d'une feuille ; ainsi, un travail en recto-verso produit deux impressions par feuille.
printedSheets entier Le nombre total de feuilles utilisées pour ces travaux.
printedRollFeet number Pour les imprimantes à alimentation en continu, la longueur du support consommé par le travail, en pieds.
printedRollMeters number Pour les imprimantes à alimentation en continu, la longueur du support consommé par le travail, en mètres.
inkC, inkM, inkY, inkK number La quantité d'encre cyan, magenta, jaune et noire consommée par le travail, indiquée par canal de couleur en centimètres cubes (cc).
flushingC, flushingM, flushingY, flushingK number Quantité d'encre cyan, magenta, jaune et noire consommée lors des opérations de vidage de la tête d'impression liées à ce travail, indiquée par canal de couleur en centimètres cubes (cc). Les valeurs de vidage sont suivies séparément de inkC/M/Y/K, afin de pouvoir distinguer l'utilisation productive de l'encre de celle liée à l'entretien.
Champs de réponse de la requête GET /printer-states

Le point de terminaison /printer-states renvoie un objet par moteur d'imprimante et par intervalle d'état. Les champs disponibles dépendent du mode de requête :

  • Historique agrégé (par défaut) : tous les champs sont renvoyés.
  • État actuel uniquement (currentState=true) : les champs printerStateDuration, historyStartTime et historyEndTime sont omis.
  • Catégorie d'état uniquement (stateCategoryOnly=true) : printerState est omis.
Zone Type Description
printerId chaîne (UUID) L'identifiant de l'imprimante à laquelle se rapporte cette ligne. Fait correspondre un printerId issu de la réponse /printers.
engine chaîne Le moteur de l'imprimante auquel cette ligne fait référence, par exemple engine_1, engine_2 ou engine_3. Une imprimante dotée de plusieurs moteurs renvoie une ligne par moteur pour chaque intervalle d'état.
stateCategory chaîne La catégorie de niveau supérieur à laquelle appartient l'état du moteur. Les valeurs possibles sont up, down, idle et unknown. Utilisez ce champ pour les tableaux de bord et les rapports qui nécessitent des catégories homogènes pour l'ensemble des modèles d'imprimantes.
printerState chaîne L'état brut signalé par le moteur d'impression, tel que Printing, Preparing, Maintenance ou Sleeping. Les valeurs brutes varient selon le modèle d'imprimante. Omise lorsque stateCategoryOnly=true.
Remarque: Consultez États de l'imprimante et catégories d'états pour obtenir la liste complète des états et de leurs correspondances.
printerStateDuration entier La durée pendant laquelle le moteur est resté dans cet état, en millisecondes. Omise lorsque currentState=true.
historyStartTime chaîne (date-heure) La date et l'heure locales auxquelles le moteur est entré dans cet état, dans le fuseau horaire indiqué dans la requête. Omise lorsque currentState=true.
historyEndTime chaîne (date-heure) La date et l'heure locales auxquelles le moteur a quitté cet état, dans le fuseau horaire indiqué dans la requête. Pour l'intervalle le plus récent d'une réponse agrégée, cette valeur peut correspondre à la fin de la plage de temps demandée. Omise lorsque currentState=true.
Champs de réponse de la requête GET /printer-interventions

Le point de terminaison /printer-interventions renvoie un objet par événement d'intervention, pour chaque moteur de chaque imprimante demandée, dans la plage de temps demandée.

Zone Type Description
printerId chaîne (UUID) L'identifiant de l'imprimante à laquelle se rapporte cette ligne. Fait correspondre un printerId issu de la réponse /printers.
interventionStartDate chaîne (date-heure) La date et l'heure locales auxquelles l'événement a commencé, dans le fuseau horaire indiqué dans la requête.
interventionEndDate chaîne (date-heure) La date et l'heure locales auxquelles l'événement a été résolu, dans le fuseau horaire indiqué dans la requête.
durée entier La durée de l'événement, en millisecondes.
description chaîne Une brève description de la condition à l'origine de l'avertissement ou de l'erreur, par exemple Media empty ou Media empty. Ce champ dépend de la langue : il est affiché dans la langue demandée par le paramètre language, ou en anglais si ce paramètre est omis ou si la description n'est pas disponible dans la langue demandée.
engine chaîne Le moteur de l'imprimante auquel cette ligne fait référence, par exemple engine_1, engine_2 ou engine_3. Une imprimante dotée de plusieurs moteurs renvoie une ligne par moteur pour chaque événement.
jobName chaîne Le nom du travail d'impression en cours au moment où l'événement s'est produit. Cette valeur correspond à une chaîne vide lorsqu'aucun travail n'était associé à l'événement.
interventionCode chaîne Un code permettant d'identifier cette condition. Contrairement à description, cette valeur est indépendante de la langue ; utilisez-la donc lorsque vous devez regrouper ou comparer des événements dans différentes langues. Le format du code dépend de l'imprimante : les imprimantes à feuilles individuelles renvoient une chaîne descriptive telle que coverOpen, tandis que les imprimantes à alimentation en continu renvoient une valeur telle que CA00 ou 40000006.

1.5.5.1 États de l'imprimante et catégories d'états

Le point de terminaison /printer-states fournit à la fois l'état brut de l'imprimante et une catégorie d'état de haut niveau. Utilisez les tables de cette rubrique pour comprendre quels états bruts relèvent de quelles catégories.
À propos des états et des catégories d'imprimantes

Pour chaque moteur d'impression, l'API d'exportation de données fournit deux valeurs associées :

printerState
L'état de fonctionnement brut signalé par le moteur d'impression, tel que printing, sleeping ou maintenance. L'ensemble des états bruts varie selon le modèle d'imprimante.
stateCategory
Un regroupement de haut niveau qui classe l'état brut en up, down, idle ou unknown. Les catégories sont identiques d'un modèle d'imprimante à l'autre ; elles constituent donc le meilleur choix pour les tableaux de bord et les rapports qui regroupent les données provenant de plusieurs imprimantes.

Les affectations de catégories sont définies par RICOH Predictive Insight et s'appliquent de manière uniforme à toutes les imprimantes transmettant des données via l'API d'exportation de données.

États « up »

Un moteur est considéré comme up lorsqu'il produit effectivement de la puissance ou qu'il se prépare activement à en produire. Utilisez cette catégorie pour mesurer le temps de fonctionnement productif.

État brut de l'imprimante Description
feeding La machine alimente le support en vue de l'impression.
initialisation-en-cours Le moteur est en cours d'initialisation dans le cadre du lancement d'une opération d'impression.
préparation L'imprimante se prépare à imprimer, par exemple en chargeant les données du travail ou en préchauffant ses composants en vue d'un travail imminent.
impression Le moteur est en train d'imprimer.
traitement-en-cours Le moteur traite actuellement les données relatives aux travaux.
réception Le moteur reçoit un travail provenant du serveur d'impression.
États « down »

Un moteur est considéré comme down lorsqu'il ne peut pas imprimer et qu'une intervention de l'opérateur ou du service technique, une opération de maintenance ou une remise en état est nécessaire ou en cours. Utilisez cette catégorie pour évaluer les temps d'arrêt imprévus et prévus.

État brut de l'imprimante Description
adjusting Le moteur effectue actuellement une opération de réglage qui empêche l'impression.
calibrating Le moteur est en cours de étalonnage, par exemple pour la couleur ou l'alignement.
cleaning Le moteur effectue actuellement une opération de nettoyage.
déconnecté Le moteur a perdu sa connexion à RICOH Predictive Insight.
erreur Le moteur a signalé une condition d'erreur qui empêche l'impression.
maintenance Le moteur est en cours d'entretien.
non disponible Le moteur est accessible, mais ne peut pas faire l'objet de travaux pour le moment.
pre/post busy Un périphérique de pré- ou post-traitement connecté au moteur est occupé et bloque l'impression.
pre/post eof Un périphérique de prétraitement ou de post-traitement a atteint une condition de « fin de formulaire » qui bloque l'impression.
pre/post paused Un périphérique de prétraitement ou de post-traitement est en pause et bloque l'impression.
pre/post threading Un dispositif de pré- ou de post-traitement est en train de dérouler un support et bloque l'impression.
rebooting Le moteur est en cours de redémarrage.
recirculation Le moteur assure la recirculation de l'encre.
restart Le moteur est en condition de redémarrage.
restarting Le moteur redémarre.
États inactifs

Un moteur est considéré comme idle lorsqu'il est opérationnel et capable d'imprimer, mais qu'il ne produit pas de sortie pour le moment. Utilisez cette catégorie pour évaluer la capacité disponible.

État brut de l'imprimante Description
vérification Le moteur effectue une vérification de routine qui n'entrave pas le travail.
inactif Le moteur est opérationnel et prêt à fonctionner.
not ready Le moteur fonctionne, mais il n'est pas encore prêt à être imprimé.
pre/post not ready Un dispositif de pré- ou de post-traitement n'est pas prêt, mais le moteur lui-même est opérationnel.
prêt Le moteur est prêt à recevoir et à imprimer un travail.
arrêt Le moteur a été arrêté.
shutting down Le moteur est en train de s'arrêter.
sleeping Le moteur est en mode veille à faible consommation.
start-up Le moteur est en phase de démarrage.
démarré Le moteur a terminé sa séquence de démarrage.
démarrage Le moteur démarre.
arrêt Le moteur est en train de s'arrêter, mais il n'est pas encore à l'arrêt.
warming Le moteur est en train de chauffer.
Inconnu

La catégorie unknown est signalée lorsque RICOH Predictive Insight ne parvient pas à déterminer une catégorie pour l'état brut, par exemple parce que la valeur de l'état brut n'est pas reconnue. Si votre application rencontre régulièrement des catégories unknown, veuillez contacter votre représentant afin de vérifier que votre imprimante transmet bien les valeurs d'état attendues.

1.5.5.2 Gestion des limites de réponse de l'API d'exportation de données

L'API d'exportation de données ne paginera pas les réponses. Si une requête devait renvoyer plus de données que ce que l'API autorise dans une seule réponse, la requête échouerait et générerait une erreur, plutôt que de renvoyer un résultat partiel. Planifiez vos intégrations de manière à respecter les limites en réduisant la plage de dates, en diminuant le nombre d'imprimantes par requête, ou les deux.
Quelles sont les limites ?

Deux types de restrictions s'appliquent aux requêtes comportant une plage de dates :

Plage de dates maximale
Si l'intervalle entre startDateTime et endDateTime dépasse sept jours, l'API renvoie une réponse 400 avec le code d'erreur ERR_DATE_RANGE_EXCEEDED. Réduisez la durée de la plage horaire demandée, puis renvoyez votre demande.
Taille maximale de la réponse
La taille maximale prise en charge pour un fichier de réponse est de 6 Mo, ce qui devrait être suffisant pour contenir les données de près de 10 000 travaux. Si les données appariées à une requête dépassaient la taille maximale de la réponse, l'API renvoie une réponse 413 avec le code d'erreur ERR_RESPONSE_LIMIT_EXCEEDED. Le corps de la réponse comprend une valeur maxJobs qui indique la limite en vigueur. Pour résoudre ce problème, réduisez la plage de dates, demandez un nombre réduit d'imprimantes, ou les deux, puis renvoyez la demande.
Demandes d'aménagement visant à respecter les limites fixées

Pour concevoir une intégration qui respecte de manière fiable les limites de réponse, tenez compte des facteurs suivants :

  • Volume de travaux par imprimante. Une imprimante à haut débit et à alimentation en continu peut produire un nombre bien plus élevé de travaux par heure qu'une imprimante à feuilles individuelles à faible volume. Si vous combinez les deux types d'imprimantes au sein de votre parc, ce sont les imprimantes à haut volume qui déterminent la durée minimale de vos créneaux horaires.
  • Nombre d'imprimantes par demande. Chaque requête peut comporter plusieurs valeurs printerId. Regrouper plusieurs imprimantes dans une seule requête est pratique, mais chaque imprimante supplémentaire augmente la taille de la réponse et le risque de dépasser la limite.
  • Heure de la journée. Si votre entreprise fonctionne par équipes, les travaux et les changements d'état se concentrent sur certaines heures. Une période de 24 heures peut donner lieu à des volumes très différents selon le moment où ces 24 heures commencent et se terminent.
  • Nombre maximal de tentatives autorisées. Si une requête échoue avec le code d'erreur ERR_RESPONSE_LIMIT_EXCEEDED, votre intégration doit fractionner la requête et réessayer. Concevoir dès le départ pour des fenêtres de petite taille est généralement moins complexe que de mettre en œuvre un fractionnement dynamique.
Modèles recommandés

Les modèles suivants conviennent bien aux scénarios d'intégration courants :

Relevé nocturne à des fins de reporting
Exécutez un travail planifié une fois par jour afin de récupérer les données des dernières 24 heures, une imprimante à la fois. Ce modèle est simple à mettre en œuvre, permet de réessayer facilement en cas d'échec et garantit que chaque réponse reste concise. Regroupez les réponses par imprimante dans votre processus en aval.
Extrait horaire pour les tableaux de bord en temps quasi réel
Exécutez un travail planifié une fois par heure afin de récupérer, en un seul appel, les données de l'heure précédente pour toutes les imprimantes. Les intervalles horaires permettent de limiter la taille des réponses, même pour les imprimantes à haut débit. Si votre parc est important, commandez les imprimantes par lots plutôt que toutes en même temps.
Rétroactivité des données historiques
Pour alimenter un entrepôt de données avec des données historiques, parcourez la période concernée par tranches de durée fixe (par exemple, six heures par requête) et traitez vos imprimantes par petits groupes. Traitez une fenêtre à la fois et enregistrez les résultats avant de déplacer la fenêtre vers la suivante. Si une fenêtre génère l'erreur ERR_RESPONSE_LIMIT_EXCEEDED, divisez-la en deux et réessayez avec chacune des deux parties.
État actuel de l'imprimante à des fins de suivi
Pour surveiller l'état actuel de chaque imprimante de votre parc sans récupérer l'historique, appelez /printer-states en spécifiant currentState=true. La réponse comprend une ligne par moteur et n'est pas influencée par la plage de dates ; une seule requête peut donc couvrir l'ensemble de la flotte.
Gestion des erreurs liées à la limite de réponse dans votre intégration

Lorsque vous recevez une réponse 413 accompagnée du code ERR_RESPONSE_LIMIT_EXCEEDED, veuillez effectuer une ou plusieurs des actions suivantes avant de réessayer la requête :

  • Réduisez la plage horaire. Diviser la fenêtre en deux est une stratégie fiable ; si la requête ainsi divisée échoue toujours, divisez-la à nouveau.
  • Réduisez le nombre de valeurs printerId dans la requête. Si une imprimante est utilisée pour la majeure partie du volume d'impression, veuillez en faire la demande séparément.
  • Si la requête porte sur un instantané actuel plutôt que sur l'historique, utilisez currentState=true sur /printer-states afin d'éviter totalement le volume lié à la plage de dates.

Ne réessayez pas d'effectuer la même requête sans modifier les paramètres. L'API ne renvoie pas de résultats partiels ; par conséquent, une nouvelle tentative sans modification échouera à nouveau.

Related information:

Gestion de la date et de l'heure dans l'API d'exportation de données

1.5.6 Exemples de requêtes et de réponses de l'API d'exportation de données

Utilisez les exemples présentés dans cette rubrique comme point de départ pour votre propre intégration. Chaque exemple présente une URL de requête représentative ainsi que le corps de la réponse renvoyée par l'API.
À propos de ces exemples
  • Les exemples utilisent des clés API et des identifiants d'imprimante fictifs. Lorsque vous les adaptez, remplacez les valeurs par celles de votre propre environnement.
  • Les exemples utilisent le nom d'hôte correspondant aux États-Unis et au Japon. Si votre compte est hébergé en Europe, veuillez utiliser plutôt rpi-data-export.app-ricohsoftware.eu.
  • Les valeurs de date et d'heure sont formatées selon l'heure locale du fuseau horaire indiqué dans la requête, selon le format YYYY-MM-DDTHH:MM:SS.sss.
  • Toutes les durées sont exprimées en millisecondes. Toutes les valeurs relatives à l'encre et au vidage sont exprimées en centimètres cubes (cc).
  • Les exemples sont donnés à titre d'illustration. Les valeurs numériques telles que la consommation d'encre, le nombre de pages et les durées correspondent à des données d'exploitation plausibles, et non à des mesures provenant d'une imprimante spécifique.
GET /printers

Récupère les imprimantes disponibles pour la clé API fournie. Le point de terminaison ne prend aucun paramètre.

Requête :

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

Réponse (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

Récupère les travaux traités par une ou plusieurs imprimantes au cours d'une période donnée. Dans cet exemple, on recherche une seule imprimante pour une plage horaire de huit heures, selon l'heure locale America/Denver, en limitant la recherche aux travaux dont l'impression s'est terminée avec succès.

Requête :

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

Réponse (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 tableau vide ([]) constitue une réponse valide et signifie qu'aucun travail n'a été apparié à la requête.

GET /printer-states (historique agrégé)

Le mode de réponse par défaut renvoie une ligne par intervalle d'état et par moteur, avec les champs de durée totale et d'historique. Dans cet exemple, on demande une plage horaire de quatre heures pour une imprimante.

Requête :

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

Réponse (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 (état actuel uniquement)

Lorsque vous définissez currentState=true, la réponse comprend une ligne par moteur indiquant son état actuel. Les champs « Durée » et « Historique » sont omis.

Requête :

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

Réponse (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 (catégorie d'état uniquement)

Lorsque vous définissez stateCategoryOnly=true, la réponse omet le champ printerState brut et ne renvoie que la catégorie de haut niveau. Les champs « Durée » et « Historique » sont conservés.

Requête :

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

Réponse (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

Récupère les événements d'intervention survenus sur une ou plusieurs imprimantes au cours d'une période donnée. Dans cet exemple, on demande une plage horaire de quatre heures pour une imprimante et on souhaite que les descriptions des événements soient en anglais. L'imprimante utilisée dans cet exemple étant un modèle à alimentation en continu, les valeurs interventionCode adoptent le format propre à ce type d'alimentation.

Requête :

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

Réponse (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"
  }
]

Les deux premières entrées comportent un champ jobName vide, ce qui signifie qu'aucun travail n'était concerné par cet événement. La troisième entrée s'est produite alors qu'un travail était en cours d'impression ; c'est pourquoi le nom du travail est indiqué.

Exemples de réponses d'erreur

Chaque réponse d'erreur suit la même structure : un objet JSON comprenant un code, un message et un statusCode numérique. Certains codes d'erreur comportent des champs supplémentaires, comme noté.

400 Erreur de requête — fuseau horaire non valide :

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

400 Erreur de requête — paramètre obligatoire manquant :

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

400 Erreur de requête — la plage de dates dépasse la limite maximale autorisée :

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

400 Erreur de requête — langage non valide :

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

401 Non autorisé — clé API non valide :

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

403 Accès interdit — la requête inclut une imprimante à laquelle la clé API n'a pas accès :

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

413 Charge utile trop volumineuse — la réponse dépasserait la limite de taille :

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

500 Erreur interne du serveur :

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

1.5.7 Dépannage de l'API d'exportation de données

Utilisez cette rubrique pour interpréter les réponses d'erreur courantes de l'API d'exportation de données et pour identifier la cause la plus probable ainsi que la solution à apporter pour chacune d'entre elles. Chaque réponse d'erreur comprend un code, un message et un statusCode numérique ; la valeur code identifie la condition spécifique.
Erreurs d'authentification et d'autorisation
Code d'erreur Cause probable À découvrir
ERR_INVALID_APIKEY (401) L'en-tête x-api-key est manquant, mal formé, périmé ou a été supprimé. Ce phénomène se produit également brièvement (généralement moins d'une minute) immédiatement après la création ou la rotation d'une clé, avant que la nouvelle clé ne soit enregistrée. Vérifiez que la requête comprend l'en-tête x-api-key avec la valeur complète de la clé API. Dans Account Administration, vérifiez que la clé existe toujours et qu'elle n'a pas expiré. Si la clé vient d'être créée ou renouvelée, veuillez patienter une minute, puis réessayez.
ERR_UNAUTHORIZED_PRINTERS (403) La requête contient une ou plusieurs valeurs printerId auxquelles la clé API n'a pas accès. Appelez la fonction /printers en utilisant la même clé API pour voir exactement quelles imprimantes sont disponibles, puis renvoyez la requête en n'indiquant que les identifiants de ces imprimantes.
ERR_TENANT_NOT_FOUND (404) La clé API est reconnue, mais elle n'est pas associée à un compte actif. Cela peut se produire si un compte a été supprimé ou s'il est mal configuré. Veuillez contacter votre chargé de compte Ricoh afin de vérifier que votre tenant est actif et que la clé API y est bien associée.
Erreurs de validation des paramètres (400 Erreur de requête)

Toute erreur de validation d'un paramètre renvoie un code d'état 400. La valeur du code permet d'identifier le problème en question.

Code d'erreur Cause probable À découvrir
ERR_MISSING_PRINTER_ID La requête ne comportait aucune valeur printerId. Au moins un élément est requis pour /jobs, /printer-states et /printer-interventions. Veuillez ajouter au moins un paramètre de requête printerId. Répétez ce paramètre pour inclure plusieurs imprimantes.
ERR_INVALID_PRINTER_ID_FORMAT La valeur printerId n'est pas un UUID valide. Vérifiez cette valeur par rapport à la réponse renvoyée par l'API /printers. Parmi les erreurs courantes, on peut citer les espaces superflus, les caractères manquants ou le fait de coller le nom de l'imprimante à la place de son identifiant.
ERR_INVALID_TIMEZONE La valeur timezone est manquante ou ne correspond pas à un identifiant de fuseau horaire IANA valide. Utilisez un identifiant basé sur une région, tel que America/Denver ou Europe/Bucharest. Les abréviations de trois lettres, telles que MST ou EST, ne sont pas acceptées. La page de documentation interactive présente la liste de toutes les valeurs autorisées.
ERR_INVALID_DATE_FORMAT Une valeur startDateTime ou endDateTime n’est pas appariée au format attendu. Utilisez le format YYYY-MM-DDTHH:MM:SS, éventuellement suivi d'un suffixe .sss pour les millisecondes. N'indiquez pas de décalage UTC ni de suffixe Z; le fuseau horaire est spécifié séparément dans le paramètre timezone.
ERR_INVALID_DATE_RANGE startDateTime est identique à endDateTime ou postérieure à celle-ci. Vérifiez que startDateTime est antérieur à endDateTime dans le fuseau horaire indiqué.
ERR_DATE_RANGE_EXCEEDED La durée comprise entre startDateTime et endDateTime dépasse la plage maximale autorisée. Réduisez la durée de la plage horaire demandée. Pour obtenir des conseils sur le découpage en blocs, consultez Gestion des limites de réponse de l'API d'exportation de données.
ERR_INVALID_JOB_STATE La valeur jobState ne figure pas parmi les valeurs autorisées. Utilisez l'une des expressions suivantes : printing, printed, aborted ou completed. Veuillez noter que la mention completed englobe à la fois les travaux printed et aborted.
ERR_INVALID_STATE_CATEGORY La valeur stateCategory ne figure pas parmi les valeurs autorisées. Utilisez l'une des options suivantes : up, down ou idle.
ERR_INVALID_LANGUAGE La valeur langue fournie à /printer-interventions ne figure pas parmi les valeurs acceptées. Veuillez choisir l'une des langues suivantes : en, de, ja, it, fr ou es. Cette erreur signifie que le code lui-même a été rejeté ; un code qui est accepté mais pour lequel il n'existe aucune traduction d'une description particulière ne génère pas d'erreur, car l'API renvoie alors cette description en anglais à la place.
ERR_INVALID_BOOLEAN_PARAM Le paramètre currentState ou stateCategoryOnly a une valeur autre que true ou false. Utilisez les chaînes de caractères littérales true ou false en minuscules.
ERR_UNKNOWN_PARAMETERS La requête contient un ou plusieurs paramètres que le point de terminaison n'accepte pas. Comparez la requête avec la liste des paramètres pour le point de terminaison dans la documentation interactive. Parmi les causes courantes, on peut citer les fautes de frappe, les paramètres destinés à un autre point de terminaison ou les paramètres de suivi supplémentaires ajoutés par un client HTTP.
ERR_DUPLICATE_PARAMETERS Le même paramètre est fourni plusieurs fois, or le point de terminaison n'accepte pas les doublons pour ce paramètre. Vérifiez la liste des paramètres. Le paramètre printerId peut apparaître plusieurs fois (une fois par imprimante) ; les autres paramètres ne doivent apparaître qu'une seule fois au maximum.
ERR_EMPTY_PARAMETERS Un paramètre obligatoire est présent, mais ne comporte aucune valeur. Vérifiez que chaque paramètre obligatoire possède une valeur non vide.
ERR_INVALID_TENANT_ID L'identifiant de locataire associé à la clé API n'est pas valide. Veuillez contacter votre chargé de compte Ricoh.
Erreurs liées à la taille de la réponse et à la méthode
Code d'erreur Cause probable À découvrir
ERR_RESPONSE_LIMIT_EXCEEDED (413) Les données appariées à la requête dépasseraient la taille maximale de la réponse. Le corps de la réponse comprend un champ maxJobs qui indique la limite en vigueur. Restreignez la plage de dates, demandez moins d'imprimantes, ou les deux, puis renvoyez votre demande. Consultez Gestion des limites de réponse de l'API d'exportation de données pour connaître les modèles de regroupement recommandés.
ERR_UNSUPPORTED_METHOD (405) La requête a utilisé une méthode HTTP autre que GET. L'API d'exportation de données ne prend en charge que la méthode GET. Mettez à jour votre client pour qu'il utilise GET.
Erreurs de serveur (500 Erreur interne du serveur)

500 réponses indiquent une condition imprévue sur le serveur. Les nouvelles tentatives ne présentent aucun risque, car chaque point de terminaison de l'API d'exportation de données est une requête GET et ne produit aucun effet secondaire. Veuillez patienter quelques secondes avant de réessayer, et utilisez un délai d'attente exponentiel si l'erreur persiste.

Code d'erreur Cause probable À découvrir
ERR_INTERNAL_SERVER_ERROR Une condition imprévue s'est produite sur le serveur. Veuillez patienter quelques secondes, puis réessayez. Si l'erreur persiste pendant plus de quelques minutes, veuillez contacter votre chargé de compte Ricoh.
ERR_TENANT_CHECK_FAILED Le serveur n'a pas pu vérifier le locataire associé à la clé API. Veuillez patienter quelques secondes, puis réessayez. Si l'erreur persiste, veuillez contacter votre chargé de compte Ricoh.
ERR_PRINTERS_FETCH_FAILED Le serveur n'a pas pu récupérer la liste des imprimantes pour ce locataire. Veuillez patienter quelques secondes, puis réessayez. Si l'erreur persiste, veuillez contacter votre chargé de compte Ricoh.
ERR_PRINTER_STATES_FETCH_FAILED Le serveur n'a pas pu récupérer les données d'état de l'imprimante correspondant à cette requête. Veuillez patienter quelques secondes, puis réessayez. Si l'erreur persiste, veuillez contacter votre chargé de compte Ricoh.
Autres symptômes
La réponse est vide ([]) alors que vous vous attendiez à recevoir des données
Un tableau vide signifie qu'aucun enregistrement n'a été apparié à la requête. Vérifiez la plage horaire (l'API ne fournit que les données des sept derniers jours), le fuseau horaire, les valeurs printerId et tous les filtres tels que jobState ou stateCategory.
Les valeurs de date et d'heure figurant dans la réponse ne correspondent pas à ce à quoi vous vous attendiez
Les horodatages des réponses correspondent à l'heure locale dans le fuseau horaire indiqué dans la requête. Si vous envoyez la même requête en indiquant une valeur timezone différente, vous obtenez des chaînes de caractères d'horodatage différentes, même si elles décrivent les mêmes événements. Voir Gestion de la date et de l'heure dans l'API d'exportation de données.
Il manque une imprimante dans la réponse /printers
L'API ne renvoie que les imprimantes surveillées par un collecteur de données. Si une imprimante est manquante, vérifiez qu'elle a bien été enregistrée auprès d'un collecteur de données et qu'elle a actuellement une connexion.
Une réponse relative à l'état de l'imprimante comprend des catégories unknown
Une catégorie unknown indique que l'état brut de l'imprimante n'a pas pu être classé. Veuillez consulter États de l'imprimante et catégories d'états pour consulter la correspondance complète entre les états et les catégories.

1.6 RICOH Cloud Connector

RICOH Cloud Connector est une application système locale établissant une connexion sécurisée avec RICOH TotalFlow Cloud. Elle facilite l'enregistrement des produits et, le cas échéant, gère la communication avec les applications RICOH TotalFlow Cloud.
    Remarque:
  • Si vous utilisez un abonnement RICOH InfoPrint Manager, RICOH Cloud Connector est automatiquement installé avec le produit. La désinstallation de RICOH InfoPrint Manager entraîne automatiquement celle de RICOH Cloud Connector.
  • Il n'est pas nécessaire d'installer RICOH Cloud Connector pour utiliser RICOH Predictive Insight.

Vous pouvez installer RICOH Cloud Connector sur les systèmes d'exploitation suivants :

  • Sous Windows :
    • Microsoft Windows 10 Pro/Entreprise
    • Microsoft Windows 11 Pro
    • Microsoft Windows Server 2019 Standard
    • Microsoft Windows Server 2022 Standard
  • Sous 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
    Remarque:
  • Il s'agit des dernières versions testées avec RICOH Cloud Connector, mais vous pouvez également utiliser des versions plus récentes de ces systèmes d'exploitation.
  • Ces systèmes d'exploitation et leurs mises à jour sont pris en charge tant que le fabricant continue à fournir une assistance à ses clients dans le cadre d'accords standard, hors assistance étendue.

L'installation de RICOH Cloud Connector nécessite au moins 1,1 Go d'espace libre.

Related information:

RICOH Cloud Connector
Connecteurs

1.6.1 Téléchargement de RICOH Cloud Connector

Vous pouvez télécharger la dernière version de RICOH Cloud Connector à partir de l'onglet Abonnements ou Connecteurs dans RICOH Account Administration. Téléchargez le package sur le serveur sur lequel vous comptez installer l'application.
Avant de télécharger Cloud Connector, assurez-vous que les conditions suivantes sont remplies :
  • La page de configuration de Cloud Connector s'ouvre dans un navigateur Web. Assurez-vous que les dernières versions de l'un des navigateurs suivants sont installées sur le système :
    • Mozilla Firefox
    • Google Chrome
    • Microsoft Edge
  • Vous disposez d'une autorisation d'écriture sur l'emplacement d'installation par défaut :
    • %ProgramData%\RICOH\Cloud Connector\ pour Windows, ou
    • /opt/RICOH/RCC/ pour Linux.
  • Si vous sélectionnez un chemin d'installation différent, assurez-vous qu'il existe et que vous disposez des autorisations d'écriture. Si le répertoire existe, il doit être vide.
Pour télécharger RICOH Cloud Connector :
  1. Connectez-vous en tant qu'administrateur au serveur sur lequel vous souhaitez installer Cloud Connector.
  2. Connectez-vous à RICOH TotalFlow Cloud en tant qu'utilisateur ayant accès à RICOH Account Administration.
  3. Dans RICOH Account Administration, cliquez sur Abonnements dans le volet de gauche.
    L'onglet Abonnements et les liens permettant de télécharger le package RICOH Cloud Connector s'affichent.
    Téléchargement de RICOH Cloud Connector
  4. Cliquez sur Télécharger pour Windows ou Télécharger pour Linux selon votre système d'exploitation.
  5. Enregistrez le package d'installation dans un emplacement où vous disposez des droits d'écriture et d'exécution. Sous Linux, téléchargez une archive nommée ricoh-cloud-connector-linux.gz et contenant le fichier exécutable.
    Le nom du fichier téléchargé est le suivant :
    • Sous Windows : ricoh-cloud-connector-win.exe
    • Sous Linux : ricoh-cloud-connector-linux.gz

1.6.2 Installation ou mise à jour

Après avoir téléchargé la version actuelle de RICOH Cloud Connector, installez-la sur le serveur que vous avez identifié.
    Remarque:
  • Si vous avez téléchargé les fichiers d'installation sur un autre appareil, copiez les fichiers sur le système sur lequel vous souhaitez installer le programme.
  • Assurez-vous que l'espace disponible sur votre disque est suffisant. L'installation de RICOH Cloud Connector nécessite au moins 1,1 Go d'espace libre.
Pour installer ou mettre à jour RICOH Cloud Connector :
  1. Connectez-vous à l'ordinateur sur lequel vous avez téléchargé le fichier exécutable du programme d'installation de RICOH Cloud Connector en tant qu'administrateur.
    Sur un système Linux, vous devez vous connecter avec un compte utilisateur disposant des droits de lecture et d'écriture sur les répertoires suivants :
    • /var
    • /etc
    • /usr
    • /opt

    Vous devez également disposer de l'autorisation d'exécution pour le fichier exécutable RICOH Cloud Connector que vous avez téléchargé.

  2. Si l'installation se fait sous Linux, recherchez et double-cliquez sur ricoh-cloud-connector-linux.gz pour décompresser les fichiers du programme d'installation.
    Important: Le fichier exécutable du programme d'installation, nommé ricoh-cloud-connector-linux, devrait se trouver parmi les fichiers décompressés. Assurez-vous que ce fichier peut être exécuté en tant que fichier exécutable. Suivez la procédure correspondant à votre version de Linux pour le rendre exécutable.
  3. Recherchez et double-cliquez sur le fichier exécutable du programme d'installation de RICOH Cloud Connector.
    Le nom du fichier exécutable est le suivant :
    • Sous Windows : ricoh-cloud-connector-win.exe
    • Sous Linux : ricoh-cloud-connector-linux

    Si vous installez RICOH Cloud Connector pour la première fois, la page Installation de RICOH Cloud Connector s'ouvre dans le navigateur par défaut.

    Si vous mettez à jour RICOH Cloud Connector, la page Mise à jour de RICOH Cloud Connector s'ouvre dans le navigateur par défaut.

    Remarque: Si la page Installation de RICOH Cloud Connector ne s'ouvre pas, cela signifie qu'il est possible que votre antivirus ou votre navigateur bloque le programme d'installation.

    Vérifiez la barre d'adresse de votre navigateur pour voir si celui-ci a bloqué l'ouverture d'une page. Si la page a été bloquée, accordez l'autorisation d'afficher la page. Si la page ne s'affiche toujours pas, consultez la rubrique Dépannage ci-dessous.

  4. Dans le cas d'une première installation :
    1. Consultez les termes et conditions et sélectionnez J'accepte les termes du contrat de licence..
    2. Vérifiez que vous avez sélectionné le bon emplacement d'installation et que vous disposez des droits d'écriture et d'exécution, puis cliquez sur INSTALLER.
  5. Si vous effectuez une mise à jour de RICOH Cloud Connector :
    Remarque: Les détails concernant l'installation précédente sont importés, y compris l'acceptation de la licence.
    1. Examinez les informations relatives à votre version actuelle de RICOH Cloud Connector et à la version de mise à jour.
    2. Cliquez sur METTRE À JOUR.

L'installation démarre et sa progression apparaît sur l'écran.

Une fois l'installation terminée, la page de Configuration de RICOH Cloud Connector s'affiche automatiquement.

Le service RICOH Cloud Connector démarre automatiquement après chaque installation, mise à jour ou redémarrage du système.

Related information:

Impossible d'installer RICOH Cloud Connector

1.6.3 Configuration

Après avoir installé RICOH Cloud Connector, vous devez le configurer pour qu'il communique avec RICOH TotalFlow Cloud.
Lorsque l'installation de RICOH Cloud Connector est terminée, la page Configuration de RICOH Cloud Connector s'ouvre dans le navigateur par défaut.
Pour configurer RICOH Cloud Connector :
  1. La propriété Nom système est automatiquement remplie avec le nom du système tel qu'il est défini dans le système d'exploitation. Vous pouvez le remplacer par un nom plus pertinent ou plus facile à mémoriser.
  2. Si votre entreprise utilise des serveurs proxy, demandez à votre service informatique l'adresse IP ou le nom d'hôte et le numéro de port corrects à utiliser. Sélectionnez l'option Je vais utiliser un serveur proxy. et saisissez les valeurs correctes dans les champs Paramètres de proxy.
  3. Cliquez sur Test proxy. Si les paramètres du proxy ne sont pas validés, vérifiez-les auprès du service informatique, entrez les valeurs correctes et réessayez.
  4. Cliquez sur Générer un code.

    Si vous n'êtes pas connecté à Account Administration, la boîte de dialogue de connexion s'ouvre. Connectez-vous à Account Administration.

    Une fois la connexion établie, la fenêtre Générer un code ponctuel et un code à usage unique valide pendant 20 minutes s'affichent.
  5. Copiez le code, retournez dans RICOH Cloud Connector et collez le code dans le champ Code à usage unique.
  6. Cliquez sur Soumettre.
    Si votre autorisation est valide, vous recevez un message de confirmation. Cliquez sur Fermer.

    La boîte de dialogue Paramètres de licence s'affiche.

    Il contient tous les détails que vous avez saisis lors de la configuration. Vous pouvez modifier Nom système et Paramètres de proxy, si nécessaire.

  7. Fermez l'onglet ou la fenêtre du navigateur pour quitter la configuration de RICOH Cloud Connector.

1.6.3.1 Nom système

Affiche le nom de l'appareil sur lequel vous configurez RICOH Cloud Connector.

Par défaut, cette valeur est le nom de ce système attribué dans le système d'exploitation. Vous pouvez le remplacer par un nom plus pertinent. RICOH Account Administration affiche ce nom dans l'onglet Connecteurs, dans le tableau des connecteurs enregistrés.

1.6.3.2 Paramètres du proxy

Certaines entreprises utilisent des serveurs proxy pour fournir une couche supplémentaire de protection réseau.

Si votre entreprise utilise des serveurs proxy, demandez à votre service informatique l'adresse IP ou le nom d'hôte et le numéro de port corrects à utiliser.

1.6.3.3 Code à usage unique

Le code à usage unique généré par RICOH Account Administration que vous devez utiliser pour enregistrer RICOH Cloud Connector, afin que les informations puissent être transmises de votre réseau aux applications RICOH TotalFlow Cloud.

Pour vous connecter à RICOH Account Administration, vous avez besoin d'un identifiant RICOH TotalFlow Cloud.

1.6.4 Désinstallation de RICOH Cloud Connector

Cette section décrit comment désinstaller RICOH Cloud Connector à l'aide des outils système de Windows.
    Remarque:
  • Pour désinstaller RICOH Cloud Connector sous Linux, suivez les instructions fournies par votre distribution Linux.
Pour désinstaller RICOH Cloud Connector sous Windows :
  1. Connectez-vous en tant qu'administrateur à l'ordinateur sur lequel RICOH Cloud Connector est installé.
  2. Cliquez sur le bouton de recherche de Windows et recherchez la page Applications et fonctionnalités.
  3. Recherchez et cliquez sur le nom de l'application RICOH Cloud Connector.
  4. Cliquez sur Désinstaller.
  5. Cliquez à nouveau sur Désinstaller pour confirmer que vous comprenez que l'application et ses informations associées seront désinstallées.
    La page Désinstallation de RICOH Cloud Connector s'affiche :
  6. Examinez les informations et sélectionnez Je comprends et confirme vouloir désinstaller RICOH Cloud Connector. Selon la configuration, il est possible que votre appareil redémarre après le processus de désinstallation..
      Remarque:
    • Si vous désinstallez RICOH Cloud Connector, tous les programmes qui utilisaient le Cloud Connector désinstallé dans leurs abonnements cessent de fonctionner.
  7. Cliquez sur DÉSINSTALLER.
  8. Connectez-vous à RICOH Account Administration et assurez-vous que le Cloud Connector désinstallé ne s'affiche plus dans le tableau Connecteurs.
    Vous pouvez le supprimer manuellement s'il n'a pas été supprimé automatiquement.

1.6.5 Dépannage

1.6.5.1 Problèmes courants

1.6.5.1.1 Impossible d'installer RICOH Cloud Connector

Si vous installez RICOH Cloud Connector et que la page d'installation ne s'affiche pas, essayez les actions suivantes.

Causes possibles pour lesquelles la page d'installation ne s'ouvre pas :

  • Vous n'êtes pas connecté en tant qu'administrateur.

    Connectez-vous en tant qu'utilisateur disposant de droits d'administrateur et réessayez.

  • Sous Linux, le fichier d'installation n'est pas défini en tant que fichier exécutable.

    Suivez les instructions correspondant à votre version de Linux pour rendre le fichier exécutable.

  • Un bloqueur de publicité empêche le Installation de RICOH Cloud Connector de s'ouvrir dans une nouvelle fenêtre du navigateur.

    Recherchez les paramètres du bloqueur de pop-up dans votre navigateur et autorisez l'ouverture de la page.

  • Votre logiciel antivirus empêche l'exécution du programme d'installation.

    Autorisez le programme à s'exécuter à l'intérieur de votre antivirus.

  • Vous avez atteint le nombre maximum de connecteurs cloud pris en charge par votre abonnement.

    Connectez-vous à RICOH Account Administration et supprimez les connecteurs cloud déconnectés du tableau Connecteurs. Vous pouvez également contacter votre représentant commercial Ricoh pour passer à un abonnement supérieur.

Si aucune des conditions ci-dessus n'est remplie, utilisez la procédure de ligne de commande pour installer RICOH Cloud Connector :

  1. Connectez-vous à l'ordinateur sur lequel vous avez téléchargé les fichiers d'installation, en tant qu'utilisateur disposant de droits d'administrateur.
  2. Ouvrez une invite de commande avec l'option Exécuter en tant qu'administrateur et localisez le fichier exécutable RICOH Cloud Connector.
    Important: Assurez-vous que vous êtes autorisé à exécuter le fichier. Si vous êtes sous Linux, assurez-vous que le fichier est exécutable. S'il ne l'est pas, suivez la procédure correspondant à votre version de Linux pour le rendre exécutable.
  3. Saisissez la commande d'installation suivante :

    rccInstallerFileName --install

  4. Appuyez sur Entrée.

Related information:

Installation ou mise à jour

1.6.5.1.2 Edge ne se lance pas lors de l'installation de RICOH Cloud Connector

Si Microsoft Edge est votre navigateur par défaut et que vous utilisez le compte d'administrateur intégré, le navigateur ne s'ouvre pas automatiquement lorsque vous installez RICOH Cloud Connector.

Dans ce cas, vous pouvez soit vous connecter avec des identifiants de compte utilisateur différents, soit changer votre navigateur par défaut pour un autre, tel que Chrome ou Firefox. Relancez ensuite le programme d'installation de RICOH Cloud Connector.

1.6.5.1.3 Erreur Cloud Connector : La signature n'est pas encore à jour

Cette erreur peut se produire si l'heure du serveur n'est pas synchronisée avec l'heure locale actuelle.

Assurez-vous que l'heure de votre serveur est synchronisée avec l'heure actuelle avec une précision pouvant aller jusqu'à 5 minutes.

Si vous utilisez Windows, nous vous recommandons de définir l'heure actuelle automatiquement :

  1. Connectez-vous à Windows en tant qu'administrateur.
  2. Cliquez sur l'icône Windows dans la barre des tâches.
  3. Accédez à Paramètres ⇒ Heure et langue ⇒ Date et heure
  4. Activez l'option Définir l'heure automatiquement.
  5. Faites défiler vers le bas jusqu'à Paramètres supplémentaires et cliquez sur Synchroniser maintenant.

1.6.5.2 Téléchargement des journaux RICOH Cloud Connector

Si vous rencontrez des problèmes lors de l'utilisation de RICOH Cloud Connector, vous pouvez facilement télécharger les journaux de l'application, qui peuvent aider à résoudre le problème.
Pour télécharger les journaux :
  1. Ouvrez une fenêtre de navigateur Web.
  2. Entrez l'URL de la page Configuration de RICOH Cloud Connector dans la barre d'adresse :

    http://adresse_serveur:numéro_port/license

    où adresse_serveur est le nom d'hôte ou l'adresse IP de l'ordinateur sur lequel RICOH Cloud Connector est installé et numéro_port est le port de l'application.

    Si vous êtes sur l'ordinateur sur lequel RICOH Cloud Connector est installé et que vous utilisez le port par défaut, vous pouvez accéder à http://localhost:15180/license.
  3. Cliquez sur , l'icône Aide, sur la bannière et sélectionnez Télécharger les journaux.
  4. Enregistrez le package de journaux sur votre système.
    La procédure à appliquer pour l'enregistrement du fichier dépend des paramètres du navigateur Web.

    Les journaux sont enregistrés au format ZIP et le package créé est nommé RCC_logs_aaaa-mm-jjThh_mm_ss.zip, où aaaa-mm-jj et hh_mm_ss représentent la date et l'heure auxquelles les journaux ont été collectés.