Aller au contenu
Nexus TéléchargerDémarrer

Rapports de maintenance

9 outils. Chacun rejoue une route de l’API avec vos droits.

nexus_list_reports Les rapports de maintenance lecture

Les rapports de maintenance rendus aux clients, les plus récents d’abord. Avec un identifiant : le rapport entier — ses chiffres figés, sa page rendue, ses destinataires et l’adresse consultable sans compte. Un rapport est FIGÉ à sa génération : il ne se recalcule jamais, et deux lectures du même rapport disent la même chose.

  • id texte, facultatif
  • clientId texte, facultatif — Se limiter à un client (nexus_list_clients)
  • limit nombre, facultatif — Nombre d’éléments (défaut selon la route, 50 au plus)
nexus_create_report Rendre un rapport écrit

Rend un rapport de maintenance à la demande, SANS l’envoyer : les chiffres sont figés et la page devient consultable. Sans dates, la dernière période CLOSE de la cadence demandée — le même choix que le planificateur. L’envoi est un second geste, délibéré : nexus_send_report. Réservé aux administrateurs.

  • clientId texte — Client destinataire, donné par nexus_list_clients
  • scheduleId texte, facultatif — Abonnement dont ce rapport reprend les réglages
  • period DAILY | WEEKLY | MONTHLY | QUARTERLY, facultatif — Cadence ; sans dates, la dernière période close de cette nature
  • periodStart texte, facultatif — Début de la période (ISO 8601)
  • periodEnd texte, facultatif
  • siteIds liste de texte, facultatif — Sites du rapport ; absent, tous ceux du client
  • intro texte, facultatif — Le mot de l’agence, en tête du rapport
  • showAvailability booléen, facultatif — Bloc disponibilité des sites
  • showBackups booléen, facultatif — Bloc sauvegardes
  • showServer booléen, facultatif — Bloc charge des machines
  • showWork booléen, facultatif — Bloc interventions de l’agence
  • showUpdates booléen, facultatif — Bloc mises à jour appliquées
nexus_send_report Envoyer un rapport écrit agit hors de Nexus

Envoie ou renvoie un rapport à ses destinataires — des gens qui ne sont PAS de l’agence, avec le domaine de l’agence en expéditeur. `apercu: true` envoie le même message à soi seul et ne marque rien : c’est ce qu’on fait avant un premier envoi réel. Un courriel parti ne se rappelle pas : fais confirmer l’envoi réel par l’utilisateur, la liste des destinataires sous les yeux. Réservé aux administrateurs.

  • id texte
  • apercu booléen, facultatif — Envoi d’essai à soi seul — ne marque rien
  • to liste de texte, facultatif — Remplace les destinataires du rapport
  • cc liste de texte, facultatif
  • bcc liste de texte, facultatif
nexus_delete_report Supprimer un rapport écrit destructif

Supprime un rapport rendu et rend son adresse publique injoignable : un client qui avait le lien ne verra plus rien. Réservé aux administrateurs.

  • id texte
nexus_list_report_schedules Les abonnements aux rapports lecture

Les abonnements aux rapports de maintenance : quel client reçoit quoi, à quelle cadence, à quelles adresses, avec quels blocs, et la date du prochain envoi. Ce prochain envoi est CALCULÉ à la lecture, jamais stocké — il ne dérive pas.

  • clientId texte, facultatif — Se limiter à un client
nexus_create_report_schedule Abonner un client à un rapport écrit agit hors de Nexus

Abonne un client à un rapport périodique : à partir de là, Nexus le rend et l’envoie tout seul à la cadence choisie. Sans `to`, l’adresse de la fiche client sert de destinataire. La copie à l’agence part en copie CACHÉE — un « cc » afficherait l’adresse interne du prestataire au client. Fais relire les destinataires et la cadence avant de créer. Réservé aux administrateurs.

  • clientId texte — Client, donné par nexus_list_clients
  • label texte, facultatif
  • enabled booléen, facultatif — Faux suspend les envois sans rien perdre
  • period DAILY | WEEKLY | MONTHLY | QUARTERLY, facultatif
  • anchorDay nombre, facultatif — 1 (lundi) à 7 en hebdomadaire, 1 à 28 sinon ; ignoré en quotidien
  • hourLocal nombre, facultatif — Heure d’envoi, heure locale
  • timezone texte, facultatif — Fuseau, ex. « Europe/Paris »
  • to liste de texte, facultatif — Destinataires ; absent, l’adresse de la fiche client
  • cc liste de texte, facultatif
  • bcc liste de texte, facultatif
  • copyToOwner booléen, facultatif — Copie CACHÉE à l’auteur de l’abonnement, résolue à chaque envoi
  • replyTo texte, facultatif — Adresse de réponse ; vide pour la défaire
  • intro texte, facultatif — Le mot de l’agence, en tête de chaque rapport
  • siteIds liste de texte, facultatif — Sites du rapport ; vide, tous ceux du client au moment de l’envoi
  • showAvailability booléen, facultatif — Bloc disponibilité des sites
  • showBackups booléen, facultatif — Bloc sauvegardes
  • showServer booléen, facultatif — Bloc charge des machines
  • showWork booléen, facultatif — Bloc interventions de l’agence
  • showUpdates booléen, facultatif — Bloc mises à jour appliquées
nexus_update_report_schedule Modifier un abonnement écrit

Modifie un abonnement aux rapports : cadence, destinataires, blocs, mot d’introduction. Seuls les champs nommés changent. `enabled: false` suspend les envois sans rien perdre. Réservé aux administrateurs.

  • id texte
  • label texte, facultatif
  • enabled booléen, facultatif — Faux suspend les envois sans rien perdre
  • period DAILY | WEEKLY | MONTHLY | QUARTERLY, facultatif
  • anchorDay nombre, facultatif — 1 (lundi) à 7 en hebdomadaire, 1 à 28 sinon ; ignoré en quotidien
  • hourLocal nombre, facultatif — Heure d’envoi, heure locale
  • timezone texte, facultatif — Fuseau, ex. « Europe/Paris »
  • to liste de texte, facultatif — Destinataires ; absent, l’adresse de la fiche client
  • cc liste de texte, facultatif
  • bcc liste de texte, facultatif
  • copyToOwner booléen, facultatif — Copie CACHÉE à l’auteur de l’abonnement, résolue à chaque envoi
  • replyTo texte, facultatif — Adresse de réponse ; vide pour la défaire
  • intro texte, facultatif — Le mot de l’agence, en tête de chaque rapport
  • siteIds liste de texte, facultatif — Sites du rapport ; vide, tous ceux du client au moment de l’envoi
  • showAvailability booléen, facultatif — Bloc disponibilité des sites
  • showBackups booléen, facultatif — Bloc sauvegardes
  • showServer booléen, facultatif — Bloc charge des machines
  • showWork booléen, facultatif — Bloc interventions de l’agence
  • showUpdates booléen, facultatif — Bloc mises à jour appliquées
nexus_delete_report_schedule Supprimer un abonnement écrit destructif

Supprime un abonnement aux rapports : plus aucun envoi automatique pour ce client. Les rapports déjà rendus restent consultables. Réservé aux administrateurs.

  • id texte
nexus_usage_report Adoption et consommation lecture

Le pilotage de l’entreprise : adoption de Nexus (sessions par projet et par semaine, membres inactifs) et consommation par projet (sessions, prompts, tokens, coût théorique). Avec projectId : le détail session par session d’un projet. Réservé aux administrateurs.

  • projectId texte, facultatif
  • from texte, facultatif — ISO 8601 ; défaut 8 semaines
  • to texte, facultatif