Chapter 5

The Console

The administration surface of your organization. It is where the things the other three applications read are decided: your vocabulary, your people, your rights, your subscription — and where you go to find out what happened, and why.

It speaks your language

The Console is the one place in the product that is fully translated. Its menu and its screens appear in English, French or Spanish according to your account. DFO, AMS and WOM still have English shells, which is why this manual leaves their button names in English and translates the Console's.

You choose your language on the Console's own Preferences screen, and it follows you everywhere.

The organization is always on screen

Top left, under the product name, the tenant label names the organization you are working in. It is never hidden behind a menu. An account that can reach several organizations could otherwise plan for one while believing it is in another — and nothing else on the page would say so.

What the menu holds

EntryWhat it is
📊 DashboardThe organization in figures.
🗺️ MapWork and assets on the map.
📋 Work orders · 🗺️ Routes · 🏢 Assets · 🚚 Fleet · ⚠️ Problems Doors. They open WOM or AMS on the right screen. Nothing is administered here — see below.
🧾 Activity logWho did what.
🔄 IngestionWhat arrived from the field, and what was refused.
📥 ImportsA register brought in from a file, dry run first.
🗂️ ListsYour vocabulary.
👥 UsersYour colleagues and their rights.
🌐 PreferencesYour own settings.
🔑 LicencesWhat you are subscribed to, and until when.

The separator marked “Specific to SCMS-FS” divides the entries that mirror the original product from the four that came with multi-organization operation and the audit trail.

Entries you do not have are entries you did not buy

The menu is built from your licence. An organization that has not licensed work-order management simply has no Work orders, Routes, Fleet or Problems entry — not a greyed-out one. Four of the five doors and the Problems entry depend on it; Assets depends on the asset module.

An entry your role does not open is hidden too. Only a technician's Work orders door survives that filter; the other four need dispatcher, supervisor or administrator. The hiding is a convenience — the real barrier is the server, which refuses the request whatever the menu showed.

What the administrator alone can open

Activity log, Imports, Users and Licences open only for the account administrator, and each says so in a sentence rather than showing you an empty page. Lists is readable by everyone and writable by the administrator alone.

Chapitre 5

La Console

La surface d'administration de votre organisation. C'est là que se décide ce que les trois autres applications lisent : votre vocabulaire, vos gens, vos droits, votre abonnement — et c'est là qu'on va pour savoir ce qui s'est passé, et pourquoi.

Elle parle votre langue

La Console est le seul endroit du produit qui soit entièrement traduit. Son menu et ses écrans s'affichent en anglais, en français ou en espagnol selon votre compte. DFO, AMS et WOM ont encore des coquilles en anglais : c'est pour cela que ce manuel laisse leurs noms de boutons en anglais et traduit ceux de la Console.

Vous choisissez votre langue sur l'écran Preferences de la Console, et elle vous suit partout.

L'organisation est toujours à l'écran

En haut à gauche, sous le nom du produit, l'étiquette de locataire nomme l'organisation dans laquelle vous travaillez. Elle n'est jamais cachée derrière un menu. Un compte qui atteint plusieurs organisations pourrait sinon planifier pour l'une en se croyant dans l'autre — et rien d'autre sur la page ne le dirait.

Ce que contient le menu

EntréeCe que c'est
📊 Tableau de bordL'organisation en chiffres.
🗺️ CarteLe travail et les actifs sur la carte.
📋 Bons de travail · 🗺️ Tournées · 🏢 Actifs · 🚚 Flotte · ⚠️ Problèmes Des portes. Elles ouvrent WOM ou AMS sur le bon écran. Rien ne s'administre ici — voir plus bas.
🧾 Journal des actionsQui a fait quoi.
🔄 IngestionCe qui est arrivé du terrain, et ce qui a été refusé.
📥 ImportsUn registre apporté par un fichier, l'essai à blanc d'abord.
🗂️ ListesVotre vocabulaire.
👥 UtilisateursVos collègues et leurs droits.
🌐 PreferencesVos propres réglages.
🔑 LicencesCe à quoi vous êtes abonné, et jusqu'à quand.

Le séparateur « Propre à SCMS-FS » sépare les entrées qui reprennent le produit d'origine des quatre qui sont venues avec l'exploitation multi-organisation et la trace d'audit.

Une entrée que vous n'avez pas est une entrée que vous n'avez pas achetée

Le menu est bâti d'après votre licence. Une organisation qui n'a pas pris la gestion des bons de travail n'a simplement aucune entrée Bons de travail, Tournées, Flotte ou Problèmes — pas une entrée grisée. Quatre des cinq portes et l'entrée Problèmes en dépendent ; Actifs dépend du module des actifs.

Une entrée que votre rôle n'ouvre pas est cachée elle aussi. Seule la porte Bons de travail d'un technicien survit à ce filtre ; les quatre autres demandent répartiteur, superviseur ou administrateur. Ce masquage est un confort — la vraie barrière est le serveur, qui refuse la demande quoi qu'ait montré le menu.

Ce que l'administrateur seul peut ouvrir

Journal des actions, Imports, Utilisateurs et Licences ne s'ouvrent que pour l'administrateur du compte, et chacun le dit par une phrase au lieu de vous montrer une page vide. Listes est lisible par tous et modifiable par le seul administrateur.

Capítulo 5

La Consola

La superficie de administración de su organización. Es donde se decide lo que las otras tres aplicaciones leen: su vocabulario, su gente, sus derechos, su suscripción — y es adonde se va para saber qué pasó, y por qué.

Habla su idioma

La Consola es el único lugar del producto que está completamente traducido. Su menú y sus pantallas aparecen en inglés, francés o español según su cuenta. DFO, AMS y WOM todavía tienen envolturas en inglés: por eso este manual deja sus nombres de botones en inglés y traduce los de la Consola.

Usted elige su idioma en la pantalla Preferencias de la Consola, y le sigue a todas partes.

La organización está siempre en pantalla

Arriba a la izquierda, bajo el nombre del producto, la etiqueta de inquilino nombra la organización en la que usted trabaja. Nunca está escondida tras un menú. Una cuenta que alcanza varias organizaciones podría si no planificar para una creyéndose en otra — y nada más en la página lo diría.

Qué contiene el menú

EntradaQué es
📊 Panel de controlLa organización en cifras.
🗺️ MapaEl trabajo y los activos sobre el mapa.
📋 Órdenes de trabajo · 🗺️ Rutas · 🏢 Activos · 🚚 Flota · ⚠️ Problemas Puertas. Abren WOM o AMS en la pantalla correcta. Aquí no se administra nada — véase más abajo.
🧾 Registro de accionesQuién hizo qué.
🔄 IngestaLo que llegó del campo, y lo que se rechazó.
📥 ImportacionesUn registro traído desde un archivo, la prueba en blanco primero.
🗂️ ListasSu vocabulario.
👥 UsuariosSus compañeros y sus derechos.
🌐 PreferenciasSus propios ajustes.
🔑 LicenciasA qué está suscrito, y hasta cuándo.

El separador «Propio de SCMS-FS» separa las entradas que reproducen el producto original de las cuatro que llegaron con la explotación multiorganización y la traza de auditoría.

Una entrada que usted no tiene es una entrada que no compró

El menú se construye según su licencia. Una organización que no contrató la gestión de órdenes de trabajo simplemente no tiene entrada Órdenes de trabajo, Rutas, Flota o Problemas — no una entrada en gris. Cuatro de las cinco puertas y la entrada Problemas dependen de ella; Activos depende del módulo de activos.

Una entrada que su rol no abre también queda oculta. Solo la puerta Órdenes de trabajo de un técnico sobrevive a ese filtro; las otras cuatro exigen despachador, supervisor o administrador. Esa ocultación es una comodidad — la barrera real es el servidor, que rechaza la petición muestre lo que muestre el menú.

Lo que solo el administrador puede abrir

Registro de acciones, Importaciones, Usuarios y Licencias solo se abren para el administrador de la cuenta, y cada una lo dice con una frase en lugar de mostrarle una página vacía. Listas es legible por todos y modificable solo por el administrador.

The five doors

Five menu entries keep their place and their name, but no longer hold a screen. Clicking one opens the other application, on the right tab.

EntryOpens
📋 Work ordersWOM → 📋 Work Orders
🗺️ RoutesWOM → 🗺️ Routes
🚚 FleetWOM → 🚚 Equipment Fleet
⚠️ ProblemsWOM → 🚨 Alarms
🏢 AssetsAMS → 🗂️ Assets

Why this is a gain and not a loss

Each of these screens existed twice, and two screens of the same thing always drift — then people believe one of them, usually the wrong one. So each was removed only after the survivor was measured to do more, not the same.

WOM's work-order screen carries ten gestures the Console's never had: moving a card, moving a due date, resolving a parked job, cancelling a carry-forward, pinning, freezing, setting the intervention type, listing the other work orders on the same asset, locating one. AMS's asset screen gained the address and its confidence, the device file and the administrator-only address correction — all of which were ported before the Console screen was emptied, never after.

One thing genuinely has no counterpart, and it is worth saying: the Console's route screen could draw a line that follows the streets between two stops. WOM's map joins the stops differently. That is a drawing, not data and not an action — it is the only measured gap between the two.

If you reach one of these addresses from an old bookmark, you do not get a blank page: the screen names where it went and carries the button to get there. A blank panel reads as a fault, and whoever sees one starts looking for the problem at their end.

Les cinq portes

Cinq entrées de menu gardent leur place et leur nom, mais ne portent plus d'écran. Cliquer dessus ouvre l'autre application, sur le bon onglet.

EntréeOuvre
📋 Bons de travailWOM → 📋 Work Orders
🗺️ TournéesWOM → 🗺️ Routes
🚚 FlotteWOM → 🚚 Equipment Fleet
⚠️ ProblèmesWOM → 🚨 Alarms
🏢 ActifsAMS → 🗂️ Assets

Pourquoi c'est un gain et non une perte

Chacun de ces écrans existait en double, et deux écrans de la même chose finissent toujours par diverger — puis les gens en croient un, généralement le mauvais. Chacun n'a donc été retiré qu'après avoir mesuré que le survivant en fait davantage, et non la même chose.

L'écran des bons de WOM porte dix gestes que celui de la Console n'a jamais eus : déplacer une carte, déplacer l'échéance, résoudre un bon parqué, annuler un report, épingler, geler, poser le type d'intervention, lister les autres bons du même actif, en localiser un. L'écran des actifs d'AMS a gagné l'adresse et sa confiance, le dossier de l'appareil et la correction d'adresse réservée à l'administrateur — le tout porté avant que l'écran de la Console soit vidé, jamais après.

Une chose n'a réellement pas de contrepartie, et il faut le dire : l'écran des tournées de la Console savait tracer une ligne qui suit les rues entre deux arrêts. La carte de WOM relie les arrêts autrement. C'est un dessin, ni une donnée ni une action — c'est le seul écart mesuré entre les deux.

Si vous atteignez une de ces adresses par un ancien signet, vous n'obtenez pas une page blanche : l'écran nomme où il est parti et porte le bouton pour y aller. Un panneau blanc se lit comme une panne, et celui qui en voit un cherche le défaut chez lui.

Las cinco puertas

Cinco entradas del menú conservan su lugar y su nombre, pero ya no contienen una pantalla. Presionarlas abre la otra aplicación, en la pestaña correcta.

EntradaAbre
📋 Órdenes de trabajoWOM → 📋 Work Orders
🗺️ RutasWOM → 🗺️ Routes
🚚 FlotaWOM → 🚚 Equipment Fleet
⚠️ ProblemasWOM → 🚨 Alarms
🏢 ActivosAMS → 🗂️ Assets

Por qué esto es una ganancia y no una pérdida

Cada una de estas pantallas existía por duplicado, y dos pantallas de lo mismo siempre acaban divergiendo — y entonces la gente cree a una, normalmente a la equivocada. Así que cada una se retiró solo después de medir que la superviviente hace más, no lo mismo.

La pantalla de órdenes de WOM lleva diez gestos que la de la Consola nunca tuvo: mover una tarjeta, mover el vencimiento, resolver una orden apartada, anular un aplazamiento, fijar, congelar, poner el tipo de intervención, listar las demás órdenes del mismo activo, localizar una. La pantalla de activos de AMS ganó la dirección y su confianza, el expediente del dispositivo y la corrección de dirección reservada al administrador — todo ello portado antes de vaciar la pantalla de la Consola, nunca después.

Una cosa sí carece de contrapartida, y hay que decirlo: la pantalla de rutas de la Consola sabía trazar una línea que sigue las calles entre dos paradas. El mapa de WOM une las paradas de otro modo. Es un dibujo, ni un dato ni una acción — es la única diferencia medida entre ambas.

Si llega a una de estas direcciones por un marcador antiguo, no obtiene una página en blanco: la pantalla nombra adónde se fue y lleva el botón para ir. Un panel en blanco se lee como una avería, y quien ve uno busca el fallo en su lado.

📊 Dashboard

Seven figures for the organization: open work orders, critical, overdue, unplanned, assets on the register, active problems, batches waiting. Critical and overdue turn red above zero; unplanned and waiting batches turn amber.

Then three tables: work orders by status, open work orders by priority, and open work by zone. Rows with no zone are shown as “no zone” rather than being left out.

“Attachment to the register” is a sentence, not a number

A panel of its own says whether every problem received matches an asset on your register. When it does: “Every problem received is attached to an asset on the register. Every work order is therefore addressable.”

When it does not, it says how many, why it matters — those work orders have no address and no zone, so no crew can be sent — names the usual cause (a device serial missing from the imported register), and lists the offenders.

A bare 0 would not have told you what a non-zero meant. This is the difference between a figure and an answer.

This is the same underlying reading as WOM's own dashboard. The Console's is the organization-wide one; WOM's can be narrowed to an Operations Team.

📊 Tableau de bord

Sept chiffres pour l'organisation : bons de travail ouverts, critiques, en retard, non planifiés, actifs au registre, problèmes actifs, lots en attente. Critiques et en retard passent au rouge au-dessus de zéro ; non planifiés et lots en attente passent à l'ambre.

Puis trois tableaux : les bons par état, les bons ouverts par priorité, et le travail ouvert par zone. Les rangées sans zone sont affichées « sans zone » plutôt qu'omises.

« Rattachement au registre » est une phrase, pas un nombre

Un panneau à part dit si chaque problème reçu correspond à un actif de votre registre. Quand c'est le cas : « Tous les problèmes reçus sont rattachés à un actif du registre. Chaque bon de travail est donc adressable. »

Quand ce n'est pas le cas, il dit combien, pourquoi cela compte — ces bons n'ont ni adresse ni zone : aucune équipe ne peut être envoyée — nomme la cause habituelle (un numéro de série absent du registre importé), et liste les fautifs.

Un 0 nu n'aurait pas dit ce qu'un nombre non nul signifie. C'est toute la différence entre un chiffre et une réponse.

C'est la même lecture de fond que le tableau de bord de WOM. Celui de la Console est celui de l'organisation entière ; celui de WOM peut être restreint à une Operations Team.

📊 Panel de control

Siete cifras para la organización: órdenes abiertas, críticas, atrasadas, sin planificar, activos en el registro, problemas activos, lotes en espera. Críticas y atrasadas se ponen rojas por encima de cero; sin planificar y lotes en espera se ponen ámbar.

Después, tres tablas: las órdenes por estado, las abiertas por prioridad, y el trabajo abierto por zona. Las filas sin zona se muestran como «sin zona» en lugar de omitirse.

«Vinculación al registro» es una frase, no un número

Un panel aparte dice si cada problema recibido corresponde a un activo de su registro. Cuando es así: «Todos los problemas recibidos están vinculados a un activo del registro. Cada orden de trabajo es por tanto direccionable.»

Cuando no lo es, dice cuántos, por qué importa — esas órdenes no tienen ni dirección ni zona: no se puede enviar ninguna cuadrilla — nombra la causa habitual (un número de serie ausente del registro importado), y enumera los infractores.

Un 0 desnudo no habría dicho qué significa una cifra distinta de cero. Esa es toda la diferencia entre una cifra y una respuesta.

Es la misma lectura de fondo que el tablero de WOM. El de la Consola es el de la organización entera; el de WOM puede restringirse a una Operations Team.

20-console-tableau
The Console dashboard. It counts across the whole organization, all four applications together — that is what makes it different from the WOM dashboard. Interface shown in English. Le tableau de bord de la Console. Il compte à l'échelle de l'organisation entière, les quatre applications ensemble — c'est ce qui le distingue du tableau de bord de WOM. Interface en anglais à l’écran. El panel de la Consola. Cuenta a escala de toda la organización, las cuatro aplicaciones juntas — eso es lo que lo distingue del panel de WOM. Interfaz en inglés en pantalla.

🗺️ Map

The organization on a real map, with two layers: the work and the asset park.

Work markers are coloured by severity — the higher the severity, the stronger the colour. Clicking one shows the asset's name, its diagnosis and what is known about it.

The asset park can run to thousands of points; it is drawn in a way that stays fluid at that size, which is why its markers look slightly different from the work ones. That is a rendering choice, not a difference in meaning.

🗺️ Carte

L'organisation sur une vraie carte, avec deux couches : le travail et le parc d'actifs.

Les marqueurs de travail sont colorés par gravité — plus la gravité est haute, plus la couleur est forte. Cliquer sur l'un montre le nom de l'actif, son diagnostic et ce qu'on sait de lui.

Le parc peut compter des milliers de points ; il est dessiné d'une façon qui reste fluide à cette taille, d'où des marqueurs légèrement différents de ceux du travail. C'est un choix de rendu, pas une différence de sens.

🗺️ Mapa

La organización sobre un mapa real, con dos capas: el trabajo y el parque de activos.

Los marcadores de trabajo se colorean por gravedad — cuanto mayor la gravedad, más fuerte el color. Al presionar uno se muestra el nombre del activo, su diagnóstico y lo que se sabe de él.

El parque puede llegar a miles de puntos; se dibuja de un modo que sigue siendo fluido a ese tamaño, de ahí que sus marcadores se vean algo distintos de los del trabajo. Es una elección de dibujo, no una diferencia de significado.

🧾 Activity log

Every action recorded for your organization — what your users did, and what the system did on their behalf. Administrator only, because it names who did what.

Platform events are not here: they belong to no organization. This log is yours.

Filtering

  • Actor — a partial identifier is accepted, and the people on the current page are suggested. Nobody memorises a full account identifier and nobody types one.
  • Since a date.
  • Action and entity — two menus built from what your log actually contains, not from a list written into the software. A hard-coded list would offer actions that never happen here and hide the ones added next month.

You are seeing the gesture and one level, not everything

By default a row shows the action, plus one level: the gesture and what the table it touched recorded. Deeper cascades are not shown. “See more” on a row shows everything that gesture produced.

The screen says this at the top rather than leaving you to discover it. A log that hides rows without announcing it reads like a complete log — and that is exactly the complaint people make about a truncated one.

WOM's 🔔 Activity and 🧾 Field Log tabs read this same log, without the filters. See chapter 3.

🧾 Journal des actions

Toutes les actions enregistrées pour votre organisation — celles de vos utilisateurs, et celles du système agissant pour eux. Administrateur seulement, parce qu'il nomme qui a fait quoi.

Les événements techniques de la plateforme n'y sont pas : ils n'appartiennent à aucune organisation. Ce journal est le vôtre.

Filtrer

  • Acteur — un identifiant partiel est accepté, et les personnes de la page courante sont suggérées. Personne ne retient un identifiant de compte complet, et personne ne le tape.
  • Depuis une date.
  • Action et entité — deux menus bâtis d'après ce que votre journal contient réellement, et non d'après une liste écrite dans le logiciel. Une liste figée proposerait des actions qui n'arrivent jamais chez vous et tairait celles qu'on ajoutera le mois prochain.

Vous voyez le geste et un niveau, pas tout

Par défaut une ligne montre l'action, plus un niveau : le geste et ce que la table qu'il a touchée en a enregistré. Les cascades plus profondes ne sont pas montrées. « Voir la suite » sur une ligne montre tout ce que ce geste a produit.

L'écran le dit en haut plutôt que de vous laisser le découvrir. Un journal qui cache des lignes sans l'annoncer se lit comme un journal complet — et c'est exactement le reproche qu'on fait à un journal amputé.

Les onglets 🔔 Activity et 🧾 Field Log de WOM lisent ce même journal, sans les filtres. Voir le chapitre 3.

🧾 Registro de acciones

Todas las acciones registradas para su organización — las de sus usuarios, y las del sistema actuando por ellos. Solo administrador, porque nombra quién hizo qué.

Los eventos técnicos de la plataforma no están aquí: no pertenecen a ninguna organización. Este registro es el suyo.

Filtrar

  • Actor — se acepta un identificador parcial, y se sugieren las personas de la página actual. Nadie memoriza un identificador de cuenta completo, y nadie lo teclea.
  • Desde una fecha.
  • Acción y entidad — dos menús construidos a partir de lo que su registro contiene realmente, y no de una lista escrita en el software. Una lista fija ofrecería acciones que nunca ocurren en su casa y callaría las que se añadan el mes que viene.

Está viendo el gesto y un nivel, no todo

Por defecto una fila muestra la acción, más un nivel: el gesto y lo que la tabla que tocó registró. Las cascadas más profundas no se muestran. «Ver más» en una fila muestra todo lo que ese gesto produjo.

La pantalla lo dice arriba en vez de dejar que usted lo descubra. Un registro que oculta filas sin anunciarlo se lee como un registro completo — y ese es exactamente el reproche que se le hace a un registro amputado.

Las pestañas 🔔 Activity y 🧾 Field Log de WOM leen este mismo registro, sin los filtros. Véase el capítulo 3.

x9-console-journal
The audit journal. Every business action is written here in the same transaction that performs it, so an action that is not in this list did not happen. Interface shown in English. Le journal d'audit. Chaque action d'affaires y est écrite dans la même transaction que l'action elle-même : une action absente de cette liste n'a pas eu lieu. Interface en anglais à l’écran. El diario de auditoría. Cada acción de negocio se escribe aquí en la misma transacción que la ejecuta: una acción ausente de esta lista no ocurrió. Interfaz en inglés en pantalla.

🔄 Ingestion

What arrives from the field, and what was refused on the way in. This is the screen to open when somebody says “the readings are not coming through”.

Three figures at the top: how many sources feed this organization, how many batches are waiting, how many are in quarantine.

One panel per source

FigureMeaning
Batches receivedEverything that arrived.
ProcessedTaken in successfully.
WaitingArrived, not yet processed.
In quarantineRefused on the way in, and kept. Listed below with the reason.
FailedCould not be processed.
Last received / last validTwo different dates. The gap between them is the useful one.

Silence is the symptom that hides best

“Everything is processed” and “nothing is arriving any more” look identical: both show zero waiting. So when a source has been quiet for over a day, the panel says so in words — “no batch for 37 h. Check the sender.”

Without that line, a broken field transmitter reads as a clean screen.

The quarantine table

Each refused message, with its identifier, the reason and the offending field. That is enough to go back to whoever sends the data and say precisely what to fix — which is the whole point of keeping refused messages instead of dropping them.

🔄 Ingestion

Ce qui arrive du terrain, et ce qui a été refusé à l'entrée. C'est l'écran à ouvrir quand quelqu'un dit « les relevés ne rentrent plus ».

Trois chiffres en haut : combien de sources alimentent cette organisation, combien de lots attendent, combien sont en quarantaine.

Un panneau par source

ChiffreSens
Lots reçusTout ce qui est arrivé.
TraitésAdmis avec succès.
En attenteArrivés, pas encore traités.
En quarantaineRefusés à l'entrée, et conservés. Listés en dessous avec le motif.
En échecN'ont pas pu être traités.
Dernière réception / dernière valideDeux dates différentes. C'est l'écart entre les deux qui est utile.

Le silence est le symptôme qui se cache le mieux

« Tout est traité » et « rien n'arrive plus » se ressemblent : les deux affichent zéro en attente. Quand une source se tait depuis plus d'une journée, le panneau le dit donc en toutes lettres — « aucun lot depuis 37 h. Vérifier l'émetteur. »

Sans cette ligne, un émetteur de terrain en panne se lit comme un écran sain.

Le tableau de quarantaine

Chaque message refusé, avec son identifiant, le motif et le champ fautif. C'est assez pour retourner voir qui envoie la donnée et dire précisément quoi corriger — ce qui est toute la raison de garder les messages refusés au lieu de les jeter.

🔄 Ingesta

Lo que llega del campo, y lo que se rechazó a la entrada. Es la pantalla que hay que abrir cuando alguien dice «las lecturas ya no entran».

Tres cifras arriba: cuántas fuentes alimentan esta organización, cuántos lotes esperan, cuántos están en cuarentena.

Un panel por fuente

CifraSignificado
Lotes recibidosTodo lo que llegó.
ProcesadosAdmitidos con éxito.
En esperaLlegados, aún sin procesar.
En cuarentenaRechazados a la entrada, y conservados. Listados debajo con el motivo.
FallidosNo se pudieron procesar.
Última recepción / última válidaDos fechas distintas. Lo útil es la diferencia entre ambas.

El silencio es el síntoma que mejor se esconde

«Todo está procesado» y «ya no llega nada» se parecen: ambos muestran cero en espera. Por eso, cuando una fuente lleva callada más de un día, el panel lo dice con todas las letras — «ningún lote desde hace 37 h. Verificar el emisor.»

Sin esa línea, un emisor de campo averiado se lee como una pantalla sana.

La tabla de cuarentena

Cada mensaje rechazado, con su identificador, el motivo y el campo culpable. Es suficiente para volver a quien envía el dato y decirle con precisión qué corregir — que es toda la razón de conservar los mensajes rechazados en vez de tirarlos.

21-console-ingestion
Ingestion — the readings arriving from the field. This screen answers one question: is the data still coming in? Interface shown in English. L'ingestion — les relevés qui arrivent du terrain. Cet écran répond à une seule question : la donnée rentre-t-elle encore ? Interface en anglais à l’écran. La ingesta — las lecturas que llegan del terreno. Esta pantalla responde a una sola pregunta: ¿sigue entrando el dato? Interfaz en inglés en pantalla.

📥 Imports

A whole register in one go — categories, asset types, accounts, assets, open work orders — from a file, usually an export of your GIS. The dry run always comes first.

What a file can be

FormWhat it carries
JSON packageAny of the five entities, its header inside.
GeoJSONAssets only, one point each. A line or a polygon is refused, row by row.
CSVOne entity per file. You choose which on screen, with the source system and the mode.

The source system names where the file comes from — arcgis-quebec, for instance. It matters: an external identifier is only unique within its source system. For a CSV, the time of the file is taken as the time it was produced.

The mode: create and update, or create only — which leaves every existing code untouched and reports it as existing.

The dry run, then the real import

Dry run runs the whole import, then cancels it. The report says exactly what would be created, updated or refused — and nothing is written.

Import for real stays greyed out until a dry run of the same file with the same settings has finished. Change the file, the entity, the source system, the mode or the profile, and it greys out again: the report you read must be the report of what you send.

Sending the same file twice is safe

A real import is saved in batches of 500 rows. If it stops half-way, what is done stays done. Send the same file again: the rows already in are recognised and left as they are.

Reading the report

ColumnMeaning
ReceivedRows read in the file for that entity.
Created · UpdatedWhat the import writes.
UnchangedAlready identical. Shown as — for assets: the system does not tell an unchanged asset from an updated one.
ExistingLeft alone: a code already there in create only, or a work order already imported.
Retired · RefusedRows the file retires; rows that could not go in.

Ignored columns are columns that lead nowhere — neither a column of the format nor one the profile maps. Read that line: a column you expected to land, listed there, is a profile to fix.

Each refused row comes with its line in your file, its key, the field at fault and the reason. Download the error file gives back the refused rows only, in the columns of your source: fix them and send that file again, with the same profile.

Mapping profiles

A GIS export does not use the names of the format (ASSET_ID, HYD_TYPE…). A profile says it once, for one entity:

PartWhat it says
ColumnsSource column → column of the format. A source column left out is read under its own name. A custom asset field is written attr.<key>.
ConstantsA value every row takes, whatever the file says — for an export of hydrants only, type_code = hydrant.

Take the columns from a file reads the header of a CSV, or the properties of a GeoJSON, and lists each column. Those already named as in the format are skipped; obvious ones such as LAT and LON are filled in. The format column field proposes only the names the server accepts — a wrong one is refused when you save, not ignored at import time.

A profile is copied into each import

An asset profile is offered for a GeoJSON and for a CSV of assets. A JSON package is already in the format and takes no profile.

Each import keeps a copy of its profile. Editing or deleting a profile later changes neither an import already made nor what its report meant.

ArcGIS sources

Instead of exporting a file, let the server read your GIS itself. An ArcGIS source is a public layer of points that the server reads whole — every night, or when you ask — and imports like a file, through an asset profile.

SettingWhat it says
Layer URLThe address of one layer, ending in …/FeatureServer/0 or …/MapServer/0.
Asset profileHow the columns of the layer become the columns of the format. Only asset profiles are offered: create one first.
Source systemAs for a file — arcgis-burlington, for instance.
ScheduleEvery night, at the hour you choose (your time zone), or on demand only.

The server only reaches the ArcGIS hosts its operator allows; the panel lists them. If it lists none, pulling is off on this server and no source can be created.

Pull now asks the server to read the layer: within seconds it takes the request, and the report appears below the list. View the report shows the last one again. A pull that failed — layer out of reach, profile deleted — says why in the last pull column.

Dry runs until you confirm

A new source only makes dry runs: every pull, nightly ones included, writes nothing. Read the report of one, then Confirm: the next pulls write — the button appears only once a dry run of that source has finished.

Changing the layer, the profile or the source system withdraws the confirmation: pulls become dry runs again. Deleting a source leaves the imports already made.

A GIS layer often has rows without an identifier, or with the same one twice: the dry run lists them as refused — fix them in the GIS, the next pull takes them. Map GlobalID to external_id: the asset stays recognised from one pull to the next. Private layers and lines or polygons are not read in this version.

Latest imports

The fifty latest, dry runs included: when, source system, form, profile, and the counts. Click a line to read its report again.

Only the account administrator opens this screen: an import writes categories and asset types, the referential everything else stands on. An external system can send the same files on its own, through its machine access — its imports appear in this list too.

📥 Imports

Tout un registre d'un coup — catégories, types d'actif, comptes, actifs, bons de travail ouverts — depuis un fichier, le plus souvent un export de votre SIG. L'essai à blanc vient toujours d'abord.

Ce qu'un fichier peut être

FormeCe qu'elle porte
Paquet JSONN'importe laquelle des cinq entités, son en-tête dedans.
GeoJSONDes actifs seulement, un point chacun. Une ligne ou un polygone est refusé, rangée par rangée.
CSVUne entité par fichier. Vous la choisissez à l'écran, avec le système source et le mode.

Le système source nomme d'où vient le fichier — arcgis-quebec, par exemple. Il compte : un identifiant externe n'est unique qu'à l'intérieur de son système source. Pour un CSV, l'heure du fichier est prise comme l'heure où il a été produit.

Le mode : créer et mettre à jour, ou créer seulement — qui laisse intact tout code existant et le signale comme existant.

L'essai à blanc, puis l'import réel

Essai à blanc fait tout l'import, puis l'annule. Le rapport dit exactement ce qui serait créé, mis à jour ou refusé — et rien n'est écrit.

Importer pour de vrai reste grisé tant qu'un essai du même fichier avec les mêmes réglages n'a pas abouti. Changez le fichier, l'entité, le système source, le mode ou le profil, et il se grise de nouveau : le rapport que vous lisez doit être celui de ce que vous envoyez.

Envoyer deux fois le même fichier est sans danger

Un import réel est enregistré par lots de 500 rangées. S'il s'arrête en route, ce qui est fait reste fait. Renvoyez le même fichier : les rangées déjà entrées sont reconnues et laissées telles quelles.

Lire le rapport

ColonneSens
ReçuesRangées lues dans le fichier pour cette entité.
Créées · ModifiéesCe que l'import écrit.
InchangéesDéjà identiques. Affiché — pour les actifs : le système ne distingue pas un actif inchangé d'un actif mis à jour.
ExistantesLaissées telles quelles : un code déjà présent en créer seulement, ou un bon de travail déjà importé.
Retirées · RefuséesLes rangées que le fichier retire ; celles qui n'ont pas pu entrer.

Les colonnes ignorées sont celles qui ne mènent nulle part — ni colonne du format, ni colonne que le profil fait correspondre. Lisez cette ligne : une colonne que vous attendiez à l'arrivée, si elle y figure, c'est un profil à corriger.

Chaque rangée refusée vient avec sa ligne dans votre fichier, sa clé, le champ fautif et le motif. Télécharger le fichier d'erreurs rend les seules rangées refusées, dans les colonnes de votre source : corrigez-les et renvoyez ce fichier, avec le même profil.

Les profils de correspondance

Un export SIG n'emploie pas les noms du format (ASSET_ID, HYD_TYPE…). Un profil le dit une fois, pour une entité :

PartieCe qu'elle dit
ColonnesColonne source → colonne du format. Une colonne source omise est lue sous son propre nom. Un champ personnalisé d'actif s'écrit attr.<clé>.
ConstantesUne valeur que chaque rangée prend, quoi que dise le fichier — pour un export de bornes-fontaines seulement, type_code = hydrant.

Prendre les colonnes d'un fichier lit l'en-tête d'un CSV, ou les propriétés d'un GeoJSON, et liste chaque colonne. Celles qui portent déjà un nom du format sont sautées ; les évidentes comme LAT et LON sont remplies. Le champ « colonne du format » ne propose que les noms que le serveur accepte — un nom faux est refusé à l'enregistrement, pas ignoré à l'import.

Chaque import garde une copie de son profil

Un profil d'actifs est proposé pour un GeoJSON et pour un CSV d'actifs. Un paquet JSON est déjà au format et ne prend pas de profil.

Chaque import garde une copie de son profil. Modifier ou supprimer un profil ensuite ne change ni un import déjà fait, ni ce que son rapport voulait dire.

Les sources ArcGIS

Au lieu d'exporter un fichier, laissez le serveur lire votre SIG lui-même. Une source ArcGIS est une couche publique de points que le serveur lit en entier — chaque nuit, ou quand vous le demandez — et importe comme un fichier, à travers un profil d'actifs.

RéglageCe qu'il dit
URL de la coucheL'adresse d'une couche, qui se termine par …/FeatureServer/0 ou …/MapServer/0.
Profil d'actifsComment les colonnes de la couche deviennent celles du format. Seuls les profils d'actifs sont offerts : créez-en un d'abord.
Système sourceComme pour un fichier — arcgis-burlington, par exemple.
HoraireChaque nuit, à l'heure choisie (votre fuseau), ou à la demande seulement.

Le serveur ne joint que les hôtes ArcGIS que son exploitant permet ; le panneau les liste. S'il n'en liste aucun, le tirage est éteint sur ce serveur et aucune source ne se crée.

Tirer maintenant demande au serveur de lire la couche : il prend la demande en quelques secondes, et le rapport paraît sous la liste. Voir le rapport remontre le dernier. Un tirage qui a échoué — couche injoignable, profil supprimé — dit pourquoi dans la colonne dernier tirage.

Des essais jusqu'à ce que vous confirmiez

Une source neuve ne fait que des essais à blanc : chaque tirage, ceux de la nuit compris, n'écrit rien. Lisez le rapport de l'un d'eux, puis Confirmer : les prochains tirages écrivent — le bouton ne paraît qu'une fois un essai de cette source achevé.

Changer la couche, le profil ou le système source retire la confirmation : les tirages redeviennent des essais. Supprimer une source laisse les imports déjà faits.

Une couche SIG a souvent des lignes sans identifiant, ou avec le même deux fois : l'essai les liste comme refusées — corrigez-les dans le SIG, le tirage suivant les prend. Faites correspondre GlobalID à external_id : l'actif reste reconnu d'un tirage à l'autre. Les couches privées, les lignes et les polygones ne sont pas lus dans cette version.

Derniers imports

Les cinquante derniers, essais compris : l'heure, le système source, la forme, le profil et les comptes. Un clic sur une ligne relit son rapport.

Seul l'administrateur du compte ouvre cet écran : un import écrit des catégories et des types d'actif, le référentiel sur lequel tout le reste repose. Un système externe peut envoyer les mêmes fichiers de lui-même, par son accès machine — ses imports figurent aussi dans cette liste.

📥 Importaciones

Todo un registro de una vez — categorías, tipos de activo, cuentas, activos, órdenes de trabajo abiertas — desde un archivo, casi siempre una exportación de su SIG. La prueba en blanco va siempre primero.

Lo que puede ser un archivo

FormaLo que contiene
Paquete JSONCualquiera de las cinco entidades, con su encabezado dentro.
GeoJSONSolo activos, un punto cada uno. Una línea o un polígono se rechaza, fila por fila.
CSVUna entidad por archivo. Usted la elige en pantalla, con el sistema de origen y el modo.

El sistema de origen nombra de dónde viene el archivo — arcgis-quebec, por ejemplo. Importa: un identificador externo solo es único dentro de su sistema de origen. Para un CSV, la hora del archivo se toma como la hora en que se produjo.

El modo: crear y actualizar, o solo crear — que deja intacto todo código existente y lo indica como existente.

La prueba en blanco, y luego la importación real

Prueba en blanco hace toda la importación y luego la anula. El informe dice exactamente qué se crearía, actualizaría o rechazaría — y no se escribe nada.

Importar de verdad queda en gris mientras una prueba del mismo archivo con los mismos ajustes no haya terminado. Cambie el archivo, la entidad, el sistema de origen, el modo o el perfil, y vuelve a ponerse en gris: el informe que lee debe ser el de lo que envía.

Enviar dos veces el mismo archivo no tiene riesgo

Una importación real se guarda por lotes de 500 filas. Si se detiene a medio camino, lo hecho queda hecho. Vuelva a enviar el mismo archivo: las filas ya entradas se reconocen y se dejan como están.

Leer el informe

ColumnaSignificado
RecibidasFilas leídas en el archivo para esa entidad.
Creadas · ModificadasLo que la importación escribe.
Sin cambiosYa idénticas. Se muestra — para los activos: el sistema no distingue un activo sin cambios de uno actualizado.
ExistentesDejadas como están: un código ya presente en solo crear, o una orden de trabajo ya importada.
Retiradas · RechazadasLas filas que el archivo retira; las que no pudieron entrar.

Las columnas ignoradas son las que no llevan a ninguna parte — ni columna del formato, ni columna que el perfil haga corresponder. Lea esa línea: una columna que esperaba ver llegar, si figura ahí, es un perfil que corregir.

Cada fila rechazada viene con su línea en su archivo, su clave, el campo en falta y el motivo. Descargar el archivo de errores devuelve solo las filas rechazadas, en las columnas de su origen: corríjalas y vuelva a enviar ese archivo, con el mismo perfil.

Los perfiles de correspondencia

Una exportación SIG no usa los nombres del formato (ASSET_ID, HYD_TYPE…). Un perfil lo dice una vez, para una entidad:

ParteLo que dice
ColumnasColumna de origen → columna del formato. Una columna de origen omitida se lee con su propio nombre. Un campo personalizado de activo se escribe attr.<clave>.
ConstantesUn valor que toma cada fila, diga lo que diga el archivo — para una exportación solo de hidrantes, type_code = hydrant.

Tomar las columnas de un archivo lee el encabezado de un CSV, o las propiedades de un GeoJSON, y enumera cada columna. Las que ya llevan un nombre del formato se omiten; las evidentes como LAT y LON se rellenan. El campo «columna del formato» solo propone los nombres que el servidor acepta — un nombre erróneo se rechaza al guardar, no se ignora al importar.

Cada importación guarda una copia de su perfil

Un perfil de activos se ofrece para un GeoJSON y para un CSV de activos. Un paquete JSON ya está en el formato y no lleva perfil.

Cada importación guarda una copia de su perfil. Modificar o eliminar un perfil después no cambia ni una importación ya hecha, ni lo que su informe quería decir.

Las fuentes ArcGIS

En lugar de exportar un archivo, deje que el servidor lea su SIG por sí mismo. Una fuente ArcGIS es una capa pública de puntos que el servidor lee entera — cada noche, o cuando usted lo pide — e importa como un archivo, a través de un perfil de activos.

AjusteLo que dice
URL de la capaLa dirección de una capa, que termina en …/FeatureServer/0 o …/MapServer/0.
Perfil de activosCómo las columnas de la capa se vuelven las del formato. Solo se ofrecen perfiles de activos: cree uno primero.
Sistema de origenComo para un archivo — arcgis-burlington, por ejemplo.
HorarioCada noche, a la hora elegida (su huso horario), o solo a demanda.

El servidor solo alcanza los hosts ArcGIS que su operador permite; el panel los lista. Si no lista ninguno, la extracción está desactivada en este servidor y no se crea ninguna fuente.

Extraer ahora pide al servidor que lea la capa: toma la solicitud en unos segundos, y el informe aparece bajo la lista. Ver el informe vuelve a mostrar el último. Una extracción fallida — capa inalcanzable, perfil eliminado — dice por qué en la columna última extracción.

Pruebas hasta que usted confirme

Una fuente nueva solo hace pruebas en blanco: cada extracción, incluidas las de la noche, no escribe nada. Lea el informe de una, y luego Confirmar: las próximas extracciones escriben — el botón solo aparece cuando una prueba de esa fuente ha finalizado.

Cambiar la capa, el perfil o el sistema de origen retira la confirmación: las extracciones vuelven a ser pruebas. Eliminar una fuente deja las importaciones ya hechas.

Una capa SIG tiene a menudo filas sin identificador, o con el mismo dos veces: la prueba las lista como rechazadas — corríjalas en el SIG, la siguiente extracción las toma. Haga corresponder GlobalID con external_id: el activo sigue reconocido de una extracción a otra. Las capas privadas, las líneas y los polígonos no se leen en esta versión.

Últimas importaciones

Las cincuenta últimas, pruebas incluidas: la hora, el sistema de origen, la forma, el perfil y los recuentos. Un clic en una línea vuelve a mostrar su informe.

Solo el administrador de la cuenta abre esta pantalla: una importación escribe categorías y tipos de activo, el referencial sobre el que descansa todo lo demás. Un sistema externo puede enviar los mismos archivos por sí solo, mediante su acceso de máquina — sus importaciones también figuran en esta lista.

🔁 Maximo

One IBM Maximo site, connected to this account in both directions. Maximo stays the master of the assets; SCMS-FS is the only system that schedules and routes the work.

What travels, and which way

MessageDirectionWhat it carries
AssetMaximo → SCMS-FSAsset number, type, position, address, serial number, installation date. A status listed as retired retires the asset here.
Work order receivedMaximo → SCMS-FSAn approved work order of the site: asset, work type, priority, description, target date, estimated duration. It is created New here and scheduled like any other.
Work order created hereSCMS-FS → MaximoA work order opened in SCMS-FS on a Maximo asset — by hand, from an alarm or from an import — is created in Maximo, already approved, with its SCMS-FS code as its external reference.
Work order completedSCMS-FS → MaximoWhen the work order becomes Fixed or Cancelled: the status, the actual start (arrival on site), the actual finish, and the parts used, as real material issues.

Who owns which field

Maximo owns the content: asset, work type, priority, description, target date — and the cancellation. SCMS-FS owns the planning: planned date, crew, route, and the progress of the status.

A priority, description or target date changed in Maximo follows here, and the planning stays. A cancellation in Maximo cancels the work order here and takes it out of the coming routes — unless it is already Fixed. A work order closed in Maximo while still open here is ignored: progress is reported by the field, not by Maximo. A change of asset or of work type on an existing work order is not applied: the inbox says so.

The connection — every setting

Configure the connection (then Change the connection) opens the form. Statuses are separated by commas; mappings are written one per line — the Maximo value, the = sign, then the SCMS-FS value.

SettingWhat it says
Stateactive or disabled. Disabled, Maximo's messages are refused, nothing is sent and the site cannot be pulled. Keep a new connection disabled until the checks of Annex D are done.
Source systemThe name written on every asset and work order that comes from this Maximo — maximo-quebec, for instance. It must be the name the server operator gave the webhook token.
Base URLThe address of the Maximo server. Its host must be one of the allowed hosts the screen lists — a list kept by the server operator. If it lists none, the screen says that Maximo is off on this server.
site (siteid) · organization (orgid)One connection = one Maximo site. A message from another site is refused (other_site).
default accountThe SCMS-FS account given to every asset received: a Maximo asset has no SCMS-FS account of its own.
default storeroomThe storeroom of every part that has none of its own in items.
work order object structure · asset object structureThe Maximo object structures read and written — mxwo and mxasset unless the city uses a copy of its own.
sign of issued quantitiespositive (default) or negative, as the city's Maximo records an issue. A wrong sign puts the parts back in the storeroom instead of taking them out: this is checked before the connection goes live.
received statusesThe work order statuses taken in. Proposed: APPR, WSCH, WMATL, WPCOND, INPRG. WAPPR is left out — it still waits for the city's approval. Any other status is ignored (status_not_received).
retired asset statusesAsset statuses that retire the asset here — DECOMMISSIONED, for instance.
status synonymsThe city's own status names → Maximo's internal value, e.g. APPROVED = APPR. A status not listed is its own internal value.
prioritiesMaximo priority → Low, Normal, High or Critical, e.g. 1 = Critical.
asset typesMaximo asset type → SCMS-FS asset type code.
job typesMaximo work type → SCMS-FS job type code.
itemsOne part per line: material code = Maximo item number, then @ storeroom if it is not the default storeroom — VALVE_6 = 100234 @ CENTRAL.

Going out, the first line wins

Several Maximo values may lead to the same SCMS-FS value — 1 = Critical and 2 = Critical. Going back to Maximo, the first line that leads there is written: put the value you want Maximo to receive first. Number-like values are read in numeric order.

The same Maximo value twice in one table, or the same material twice, is refused when you save, line by line, under Some mappings are refused. If somebody else saved the connection meanwhile, the screen asks you to reload the page rather than overwrite their change.

Webhooks — how Maximo sends

The Webhooks panel gives two addresses, one for assets (…/api/v1/integrations/maximo/actifs) and one for work orders (…/bons-de-travail). A Maximo administrator points an HTTP endpoint at each — a publish channel with a JSON mapping, or an automation script — that sends the JSON representation of the record, with the source token in the Authorization: Bearer header.

The token is created on the server by its operator and shown once; only its fingerprint is kept. It never appears on this screen.

AnswerMeaning
202Received and queued — or already waiting, then kept once.
401Unknown token.
400Not a JSON object, larger than 16 KB, or no resource in it.
403 · 404 · 409The token belongs to another source system · no Maximo connection on this account · the connection is disabled.

On a refusal nothing is kept here: Maximo keeps the message in its own error queue and can send it again.

Pull the site now

Reads every asset of the site, then every open work order (neither history nor tasks), page by page, and puts each one in the inbox — the same path, and the same rules, as a webhook. There is no dry run. Use it once when the connection starts, and after a long interruption of the webhooks.

The result reads “N assets, M work orders read; K queued”, or the cause of the failure. The button stays greyed out while the connection is disabled or a pull is already asked. Volume: the inbox takes 50 records every 10 seconds — 10 000 assets take about half an hour.

Received from Maximo — the inbox

Every record received, by webhook or by pull, and what SCMS-FS did with it.

StateReasons you may read
processedWritten. For a known work order, the line says which fields were applied and which were not.
refusedother_site · missing_field · unmapped_asset_type · unmapped_work_type · unmapped_priority · position_invalid · unknown_asset (the work order arrived before its asset) · unknown_scms_code · and the refusals of an import, such as identity_conflict.
ignoredstatus_not_received · closed_in_maximo · cancelled_unknown (cancellation of a work order never received) · order_closed (already closed here).
failedAn unexpected error, retried after 1, 2, 4 and 8 minutes first.

Replay sends a refused, ignored or failed record through again — after you added the missing mapping, or once the asset has arrived. A record whose identical copy is already waiting is not replayed twice.

Sent to Maximo — the outbox

One line per work order creation and per work order completion, each sent once per work order, in order: a completion waits for its creation. Columns: work order, send, state, attempts, Maximo number, error.

StateMeaning
sentDone. A creation first looks the work order up in Maximo by its external reference: an answer lost on the way never creates it twice. A completion is one single request — status, times and parts together — so a retry never issues parts twice. Parts with no Maximo item are not sent; the line lists them (Parts with no Maximo item).
failedNothing could be sent: connection_disabled, connection_invalid, base_url_invalid, host_not_allowed, key_missing (the Maximo API key, a file the server operator installs) — or a network error, a server error or a refused key, retried after 1, 2, 4 and 8 minutes first.
refusedMaximo said no for good — its message is kept in error — or asset_not_in_maximo, order_not_in_maximo, closed_in_maximo (closed there in another way), or a work type or priority with no mapping.

Replay puts a failed or refused line back in the queue — once the key is installed, the host allowed, or the mapping added.

Export waiting completions (CSV) — the fallback

If Maximo's API is down, the completions still waiting (or failed) leave in a file that a Maximo administrator loads by hand: one line per part issued — siteid, wonum, scms_code, status, actstart, actfinish, material_code, itemnum, storeloc, quantity, note. A work order without parts, or a cancellation, takes one line; a part with no Maximo item is listed with note = unmapped.

Exported means sent

The exported completions are marked sent — by manual export in the same step, and will no longer go out through the API. Load the file into Maximo: nothing else will deliver them.

Only the account administrator opens this screen. Every action of the three automatic workers is written to the activity log, under system:maximo-inbox, system:maximo-outbox and system:maximo-pull. Not in this version: labour transactions, work logs, several sites per connection, XML messages, assets created in Maximo by SCMS-FS, and content changed in SCMS-FS sent back to Maximo. An asset born in SCMS-FS — commissioned in DFO, for instance — is therefore never sent to Maximo, nor are the work orders opened on it; to give Maximo those assets, export them from AMS (Assets › ⬇ Inventory per zone).

🔁 Maximo

Un site IBM Maximo, relié à ce compte dans les deux sens. Maximo reste maître des actifs ; SCMS-FS est le seul système qui planifie et route le travail.

Ce qui circule, et dans quel sens

MessageSensCe qu'il porte
ActifMaximo → SCMS-FSNuméro d'actif, type, position, adresse, numéro de série, date d'installation. Un statut déclaré retiré retire l'actif ici.
Bon reçuMaximo → SCMS-FSUn bon approuvé du site : actif, type de travail, priorité, description, date cible, durée estimée. Il est créé New ici et se planifie comme les autres.
Bon créé iciSCMS-FS → MaximoUn bon ouvert dans SCMS-FS sur un actif Maximo — à la main, depuis une alarme ou par un import — est créé dans Maximo, déjà approuvé, avec son code SCMS-FS comme référence externe.
Bon terminéSCMS-FS → MaximoQuand le bon passe Fixed ou Cancelled : le statut, le début réel (l'arrivée sur place), la fin réelle, et les pièces utilisées, en vraies sorties de magasin.

Qui est maître de quel champ

Maximo est maître du contenu : actif, type de travail, priorité, description, date cible — et de l'annulation. SCMS-FS est maître de la planification : date planifiée, équipage, tournée, et progression du statut.

Une priorité, une description ou une date cible changée dans Maximo suit ici, et la planification reste. Une annulation dans Maximo annule le bon ici et le retire des tournées à venir — sauf s'il est déjà Fixed. Un bon fermé dans Maximo alors qu'il est encore ouvert ici est ignoré : la progression vient du terrain, pas de Maximo. Un changement d'actif ou de type de travail sur un bon existant n'est pas appliqué : la boîte d'entrée le dit.

La connexion — chaque réglage

Configurer la connexion (puis Modifier la connexion) ouvre le formulaire. Les statuts se séparent par des virgules ; les correspondances s'écrivent une par ligne — la valeur Maximo, le signe =, puis la valeur SCMS-FS.

RéglageCe qu'il dit
Étatactive ou désactivée. Désactivée, les messages de Maximo sont refusés, rien ne part et le site ne peut pas être tiré. Gardez une connexion neuve désactivée tant que les vérifications de l'annexe D ne sont pas faites.
Système sourceLe nom écrit sur chaque actif et chaque bon venu de ce Maximo — maximo-quebec, par exemple. Ce doit être le nom que l'exploitant du serveur a donné au jeton du webhook.
URL de baseL'adresse du serveur Maximo. Son hôte doit être l'un des hôtes permis que l'écran affiche — une liste tenue par l'exploitant du serveur. Si elle est vide, l'écran dit que Maximo est éteint sur ce serveur.
site (siteid) · organisation (orgid)Une connexion = un site Maximo. Un message d'un autre site est refusé (other_site).
compte par défautLe compte SCMS-FS donné à chaque actif reçu : un actif Maximo n'a pas de compte SCMS-FS à lui.
magasin par défautLe magasin de toute pièce qui n'en a pas dans articles.
structure des bons · structure des actifsLes structures d'objet Maximo lues et écrites — mxwo et mxasset, sauf si la ville utilise sa propre copie.
signe des quantités sortiespositif (défaut) ou négatif, selon la façon dont le Maximo de la ville inscrit une sortie. Un mauvais signe remet les pièces en magasin au lieu de les sortir : on le vérifie avant la mise en service.
statuts reçusLes statuts de bon admis. Proposés : APPR, WSCH, WMATL, WPCOND, INPRG. WAPPR est laissé de côté — il attend encore l'approbation de la ville. Tout autre statut est ignoré (status_not_received).
statuts d'actif retiréLes statuts d'actif qui retirent l'actif ici — DECOMMISSIONED, par exemple.
synonymes de statutLes noms de statut propres à la ville → la valeur interne de Maximo, ex. APPROVED = APPR. Un statut absent est sa propre valeur interne.
prioritésPriorité Maximo → Low, Normal, High ou Critical, ex. 1 = Critical.
types d'actifType d'actif Maximo → code de type d'actif SCMS-FS.
types de travailType de travail Maximo → code de type d'intervention SCMS-FS.
articlesUne pièce par ligne : code du matériel = numéro d'article Maximo, puis @ magasin si ce n'est pas le magasin par défaut — VALVE_6 = 100234 @ CENTRAL.

À l'envoi, la première ligne gagne

Plusieurs valeurs Maximo peuvent mener à la même valeur SCMS-FS — 1 = Critical et 2 = Critical. Au retour vers Maximo, c'est la première ligne qui y mène qui s'écrit : mettez en tête la valeur que Maximo doit recevoir. Les valeurs en forme de nombre se lisent dans l'ordre numérique.

Une même valeur Maximo deux fois dans une table, ou un même matériel deux fois, est refusé à l'enregistrement, ligne par ligne, sous Des correspondances sont refusées. Si quelqu'un d'autre a enregistré la connexion entre-temps, l'écran vous demande de recharger la page plutôt que d'écraser son changement.

Webhooks — comment Maximo envoie

Le panneau Webhooks donne deux adresses, une pour les actifs (…/api/v1/integrations/maximo/actifs) et une pour les bons (…/bons-de-travail). Un administrateur Maximo y dirige un point de terminaison HTTP — un canal de publication avec une correspondance JSON, ou un script d'automatisation — qui envoie la représentation JSON de l'enregistrement, avec le jeton de source dans l'en-tête Authorization: Bearer.

Le jeton est créé sur le serveur par son exploitant et affiché une seule fois ; seule son empreinte est gardée. Il n'apparaît jamais sur cet écran.

RéponseSens
202Reçu et mis en file — ou déjà en attente, alors gardé une seule fois.
401Jeton inconnu.
400Pas un objet JSON, plus de 16 Ko, ou aucune ressource dedans.
403 · 404 · 409Le jeton appartient à un autre système source · aucune connexion Maximo sur ce compte · la connexion est désactivée.

Sur un refus, rien n'est gardé ici : Maximo garde le message dans sa propre file d'erreurs et peut le renvoyer.

Tirer le site maintenant

Lit chaque actif du site, puis chaque bon ouvert (ni l'historique ni les tâches), page par page, et dépose chacun dans la boîte d'entrée — le même chemin, et les mêmes règles, qu'un webhook. Il n'y a pas d'essai à blanc. À faire une fois au démarrage de la connexion, et après une longue interruption des webhooks.

Le résultat se lit « N actifs, M bons lus ; K mis en file », ou la cause de l'échec. Le bouton reste grisé tant que la connexion est désactivée ou qu'un tirage est déjà demandé. Volume : la boîte d'entrée prend 50 enregistrements toutes les 10 secondes — 10 000 actifs prennent environ une demi-heure.

Reçu de Maximo — la boîte d'entrée

Chaque enregistrement reçu, par webhook ou par tirage, et ce que SCMS-FS en a fait.

ÉtatMotifs que vous pouvez lire
traitéÉcrit. Pour un bon connu, la ligne dit quels champs ont été appliqués et lesquels ne l'ont pas été.
refuséother_site · missing_field · unmapped_asset_type · unmapped_work_type · unmapped_priority · position_invalid · unknown_asset (le bon est arrivé avant son actif) · unknown_scms_code · et les refus d'un import, comme identity_conflict.
ignoréstatus_not_received · closed_in_maximo · cancelled_unknown (annulation d'un bon jamais reçu) · order_closed (déjà fermé ici).
en échecUne erreur imprévue, reprise d'abord après 1, 2, 4 et 8 minutes.

Rejouer refait passer un enregistrement refusé, ignoré ou en échec — après avoir ajouté la correspondance manquante, ou une fois l'actif arrivé. Un enregistrement dont une copie identique attend déjà n'est pas rejoué deux fois.

Envoyé à Maximo — la boîte d'envoi

Une ligne par création du bon et par fin du bon, chacune envoyée une fois par bon, dans l'ordre : une fin attend sa création. Colonnes : bon de travail, envoi, état, essais, numéro Maximo, erreur.

ÉtatSens
envoyéFait. Une création cherche d'abord le bon dans Maximo par sa référence externe : une réponse perdue en route ne le crée jamais deux fois. Une fin est une seule requête — statut, temps et pièces ensemble —, une reprise ne sort donc jamais les pièces deux fois. Les pièces sans article Maximo ne partent pas ; la ligne les nomme (Pièces sans article Maximo).
en échecRien n'a pu partir : connection_disabled, connection_invalid, base_url_invalid, host_not_allowed, key_missing (la clé d'API Maximo, un fichier que l'exploitant du serveur pose) — ou une erreur réseau, une erreur du serveur ou une clé refusée, reprises d'abord après 1, 2, 4 et 8 minutes.
refuséMaximo a dit non pour de bon — son message est gardé dans erreur — ou asset_not_in_maximo, order_not_in_maximo, closed_in_maximo (fermé là-bas d'une autre façon), ou un type de travail ou une priorité sans correspondance.

Rejouer remet en file une ligne en échec ou refusée — une fois la clé posée, l'hôte permis ou la correspondance ajoutée.

Exporter les fins en attente (CSV) — le recours

Si l'API de Maximo est hors service, les fins encore en attente (ou en échec) partent dans un fichier qu'un administrateur Maximo charge à la main : une ligne par pièce sortie — siteid, wonum, scms_code, status, actstart, actfinish, material_code, itemnum, storeloc, quantity, note. Un bon sans pièce, ou une annulation, tient en une ligne ; une pièce sans article Maximo est listée avec note = unmapped.

Exporté veut dire envoyé

Les fins exportées sont marquées envoyé — par export manuel dans le même geste, et ne repartiront plus par l'API. Chargez le fichier dans Maximo : rien d'autre ne les livrera.

Seul l'administrateur du compte ouvre cet écran. Chaque action des trois travailleurs automatiques est écrite au journal des actions, sous system:maximo-inbox, system:maximo-outbox et system:maximo-pull. Pas dans cette version : les transactions de main-d'œuvre, les journaux de travail, plusieurs sites par connexion, les messages XML, la création d'actifs dans Maximo par SCMS-FS, et le renvoi à Maximo d'un contenu changé dans SCMS-FS. Un actif né dans SCMS-FS — mis en service dans DFO, par exemple — n'est donc jamais envoyé à Maximo, ni les bons ouverts sur lui ; pour donner ces actifs à Maximo, exportez-les depuis AMS (Assets › ⬇ Inventory per zone).

🔁 Maximo

Un sitio IBM Maximo, conectado a esta cuenta en ambos sentidos. Maximo sigue siendo el dueño de los activos; SCMS-FS es el único sistema que planifica y enruta el trabajo.

Qué circula, y en qué sentido

MensajeSentidoQué lleva
ActivoMaximo → SCMS-FSNúmero de activo, tipo, posición, dirección, número de serie, fecha de instalación. Un estado declarado retirado retira el activo aquí.
Orden recibidaMaximo → SCMS-FSUna orden aprobada del sitio: activo, tipo de trabajo, prioridad, descripción, fecha objetivo, duración estimada. Se crea New aquí y se planifica como las demás.
Orden creada aquíSCMS-FS → MaximoUna orden abierta en SCMS-FS sobre un activo de Maximo — a mano, desde una alarma o por una importación — se crea en Maximo, ya aprobada, con su código SCMS-FS como referencia externa.
Orden terminadaSCMS-FS → MaximoCuando la orden pasa a Fixed o Cancelled: el estado, el inicio real (la llegada al sitio), el fin real, y las piezas usadas, como salidas de almacén reales.

Quién es dueño de qué campo

Maximo es dueño del contenido: activo, tipo de trabajo, prioridad, descripción, fecha objetivo — y de la cancelación. SCMS-FS es dueño de la planificación: fecha planificada, cuadrilla, ruta, y avance del estado.

Una prioridad, una descripción o una fecha objetivo cambiada en Maximo se sigue aquí, y la planificación se queda. Una cancelación en Maximo cancela la orden aquí y la quita de las rutas por venir — salvo que ya esté Fixed. Una orden cerrada en Maximo mientras sigue abierta aquí se ignora: el avance lo da el terreno, no Maximo. Un cambio de activo o de tipo de trabajo en una orden existente no se aplica: la bandeja de entrada lo dice.

La conexión — cada ajuste

Configurar la conexión (luego Modificar la conexión) abre el formulario. Los estados se separan con comas; las correspondencias se escriben una por línea — el valor de Maximo, el signo =, y luego el valor de SCMS-FS.

AjusteQué dice
Estadoactivo o desactivada. Desactivada, los mensajes de Maximo se rechazan, no sale nada y el sitio no se puede extraer. Mantenga una conexión nueva desactivada hasta terminar las verificaciones del anexo D.
Sistema de origenEl nombre escrito en cada activo y cada orden que viene de este Maximo — maximo-quebec, por ejemplo. Debe ser el nombre que el operador del servidor dio al token del webhook.
URL baseLa dirección del servidor Maximo. Su host debe ser uno de los hosts permitidos que muestra la pantalla — una lista que mantiene el operador del servidor. Si está vacía, la pantalla dice que Maximo está desactivado en este servidor.
sitio (siteid) · organización (orgid)Una conexión = un sitio Maximo. Un mensaje de otro sitio se rechaza (other_site).
cuenta predeterminadaLa cuenta SCMS-FS que recibe cada activo: un activo de Maximo no tiene cuenta SCMS-FS propia.
almacén predeterminadoEl almacén de toda pieza que no tiene uno propio en artículos.
estructura de órdenes · estructura de activosLas estructuras de objeto de Maximo que se leen y escriben — mxwo y mxasset, salvo que la ciudad use su propia copia.
signo de las cantidades emitidaspositivo (predeterminado) o negativo, según cómo el Maximo de la ciudad registra una salida. Un signo equivocado devuelve las piezas al almacén en vez de sacarlas: se verifica antes de la puesta en servicio.
estados recibidosLos estados de orden admitidos. Propuestos: APPR, WSCH, WMATL, WPCOND, INPRG. WAPPR queda fuera — aún espera la aprobación de la ciudad. Cualquier otro estado se ignora (status_not_received).
estados de activo retiradoLos estados de activo que retiran el activo aquí — DECOMMISSIONED, por ejemplo.
sinónimos de estadoLos nombres de estado propios de la ciudad → el valor interno de Maximo, p. ej. APPROVED = APPR. Un estado ausente es su propio valor interno.
prioridadesPrioridad de Maximo → Low, Normal, High o Critical, p. ej. 1 = Critical.
tipos de activoTipo de activo de Maximo → código de tipo de activo SCMS-FS.
tipos de trabajoTipo de trabajo de Maximo → código de tipo de intervención SCMS-FS.
artículosUna pieza por línea: código del material = número de artículo de Maximo, luego @ almacén si no es el almacén predeterminado — VALVE_6 = 100234 @ CENTRAL.

Al enviar, gana la primera línea

Varios valores de Maximo pueden llevar al mismo valor de SCMS-FS — 1 = Critical y 2 = Critical. De vuelta hacia Maximo, se escribe la primera línea que lleva ahí: ponga primero el valor que Maximo debe recibir. Los valores con forma de número se leen en orden numérico.

Un mismo valor de Maximo dos veces en una tabla, o un mismo material dos veces, se rechaza al guardar, línea por línea, bajo Algunas correspondencias se rechazan. Si otra persona guardó la conexión mientras tanto, la pantalla le pide recargar la página en vez de sobrescribir su cambio.

Webhooks — cómo envía Maximo

El panel Webhooks da dos direcciones, una para los activos (…/api/v1/integrations/maximo/actifs) y una para las órdenes (…/bons-de-travail). Un administrador de Maximo dirige ahí un punto de terminación HTTP — un canal de publicación con una correspondencia JSON, o un script de automatización — que envía la representación JSON del registro, con el token de origen en el encabezado Authorization: Bearer.

El token lo crea en el servidor su operador y se muestra una sola vez; solo se guarda su huella. Nunca aparece en esta pantalla.

RespuestaSignificado
202Recibido y en cola — o ya en espera, y entonces se guarda una sola vez.
401Token desconocido.
400No es un objeto JSON, pesa más de 16 KB, o no contiene ningún recurso.
403 · 404 · 409El token pertenece a otro sistema de origen · ninguna conexión Maximo en esta cuenta · la conexión está desactivada.

En un rechazo no se guarda nada aquí: Maximo conserva el mensaje en su propia cola de errores y puede reenviarlo.

Extraer el sitio ahora

Lee cada activo del sitio, luego cada orden abierta (ni el historial ni las tareas), página por página, y deja cada una en la bandeja de entrada — el mismo camino, y las mismas reglas, que un webhook. No hay prueba en seco. Úselo una vez al arrancar la conexión, y después de una larga interrupción de los webhooks.

El resultado se lee «N activos, M órdenes leídos; K en cola», o la causa del fallo. El botón sigue gris mientras la conexión está desactivada o ya se pidió una extracción. Volumen: la bandeja de entrada toma 50 registros cada 10 segundos — 10 000 activos tardan cerca de media hora.

Recibido de Maximo — la bandeja de entrada

Cada registro recibido, por webhook o por extracción, y lo que SCMS-FS hizo con él.

EstadoMotivos que puede leer
procesadoEscrito. Para una orden conocida, la línea dice qué campos se aplicaron y cuáles no.
rechazadoother_site · missing_field · unmapped_asset_type · unmapped_work_type · unmapped_priority · position_invalid · unknown_asset (la orden llegó antes que su activo) · unknown_scms_code · y los rechazos de una importación, como identity_conflict.
ignoradostatus_not_received · closed_in_maximo · cancelled_unknown (cancelación de una orden nunca recibida) · order_closed (ya cerrada aquí).
fallidoUn error imprevisto, reintentado antes tras 1, 2, 4 y 8 minutos.

Reprocesar vuelve a pasar un registro rechazado, ignorado o fallido — después de añadir la correspondencia que faltaba, o una vez llegado el activo. Un registro cuya copia idéntica ya espera no se reprocesa dos veces.

Enviado a Maximo — la bandeja de salida

Una línea por creación de la orden y por cierre de la orden, cada una enviada una vez por orden, en orden: un cierre espera a su creación. Columnas: orden de trabajo, envío, estado, intentos, número Maximo, error.

EstadoSignificado
enviadoHecho. Una creación busca primero la orden en Maximo por su referencia externa: una respuesta perdida en el camino nunca la crea dos veces. Un cierre es una sola solicitud — estado, tiempos y piezas juntos —, así que un reintento nunca saca las piezas dos veces. Las piezas sin artículo de Maximo no salen; la línea las nombra (Piezas sin artículo Maximo).
fallidoNo pudo salir nada: connection_disabled, connection_invalid, base_url_invalid, host_not_allowed, key_missing (la clave de API de Maximo, un archivo que instala el operador del servidor) — o un error de red, un error del servidor o una clave rechazada, reintentados antes tras 1, 2, 4 y 8 minutos.
rechazadoMaximo dijo que no de forma definitiva — su mensaje se guarda en error — o asset_not_in_maximo, order_not_in_maximo, closed_in_maximo (cerrada allá de otra forma), o un tipo de trabajo o una prioridad sin correspondencia.

Reprocesar vuelve a poner en cola una línea fallida o rechazada — una vez instalada la clave, permitido el host o añadida la correspondencia.

Exportar los cierres pendientes (CSV) — el recurso

Si la API de Maximo está fuera de servicio, los cierres aún pendientes (o fallidos) salen en un archivo que un administrador de Maximo carga a mano: una línea por pieza emitida — siteid, wonum, scms_code, status, actstart, actfinish, material_code, itemnum, storeloc, quantity, note. Una orden sin piezas, o una cancelación, ocupa una línea; una pieza sin artículo de Maximo se lista con note = unmapped.

Exportado quiere decir enviado

Los cierres exportados se marcan enviado — por exportación manual en el mismo paso, y ya no saldrán por la API. Cargue el archivo en Maximo: nada más los entregará.

Solo el administrador de la cuenta abre esta pantalla. Cada acción de los tres trabajadores automáticos se escribe en el registro de acciones, bajo system:maximo-inbox, system:maximo-outbox y system:maximo-pull. No están en esta versión: las transacciones de mano de obra, los diarios de trabajo, varios sitios por conexión, los mensajes XML, la creación de activos en Maximo por SCMS-FS, y el reenvío a Maximo de un contenido cambiado en SCMS-FS. Un activo nacido en SCMS-FS — puesto en servicio en DFO, por ejemplo — nunca se envía por lo tanto a Maximo, ni las órdenes abiertas sobre él; para dar esos activos a Maximo, expórtelos desde AMS (Assets › ⬇ Inventory per zone).

23-console-maximo
Configuring the Maximo connection: the site, the default account and storeroom, the received statuses, and one mapping per line — priorities, asset types, job types, items. Shown on the demonstration account, the connection still disabled and pointing at a placeholder Maximo host. Interface shown in English. La configuration de la connexion Maximo : le site, le compte et le magasin par défaut, les statuts reçus, et une correspondance par ligne — priorités, types d'actif, types de travail, articles. Montrée sur le compte de démonstration, la connexion encore désactivée et dirigée vers un hôte Maximo fictif. Interface en anglais à l’écran. La configuración de la conexión Maximo: el sitio, la cuenta y el almacén predeterminados, los estados recibidos, y una correspondencia por línea — prioridades, tipos de activo, tipos de trabajo, artículos. Mostrada en la cuenta de demostración, con la conexión aún desactivada y apuntando a un host Maximo ficticio. Interfaz en inglés en pantalla.

🗂️ Lists

Your organisation's vocabulary. What you name here appears in the forms of the other applications — in each person's own language.

Each list opens to show its code, how many active values it has, whether a form lets you pick one value or several, and — for lists that come with the product — a note saying its code is read by the software.

Values load when you open a list, not before. A list can carry hundreds of values, and loading them all on arrival would make everyone pay for the one list they opened.

Reading is open to everyone. Writing is the administrator's. A non-administrator is told so in a sentence.

⚠️ Why statuses, priorities and actions are not here

This question is asked about every three months, so the screen answers it permanently, in a panel you can open.

Those values are not words. They are codes the software reads. A work order's status governs which transitions are allowed and the colour of its badge; its priority governs the order of the routes. A value added here would produce a work order that no action can move forward, with no error message — a job stuck for ever, silently.

Seven of the nine lists in this Console are of that kind. To add one of those values, ask us.

The screen says this rather than simply omitting the lists. An absence that is explained is understood; an absence that says nothing reads as an oversight.

Some of these lists are what Fleet and Crews read in WOM — a technician's trade, a truck's kind. See chapter 3.

🗂️ Listes

Le vocabulaire de votre organisation. Ce que vous nommez ici apparaît dans les formulaires des autres applications — dans la langue de chacun.

Chaque liste s'ouvre pour montrer son code, combien de valeurs actives elle porte, si un formulaire en laisse choisir une ou plusieurs, et — pour les listes livrées avec le produit — une mention disant que son code est lu par le logiciel.

Les valeurs se chargent à l'ouverture d'une liste, pas avant. Une liste peut porter des centaines de valeurs, et toutes les charger à l'arrivée ferait payer à chacun la seule liste qu'il a ouverte.

La lecture est ouverte à tous. L'écriture est celle de l'administrateur. On le dit par une phrase à qui ne l'est pas.

⚠️ Pourquoi les états, les priorités et les actions ne sont pas ici

La question revient tous les trois mois environ : l'écran y répond donc en permanence, dans un panneau qu'on peut déplier.

Ces valeurs ne sont pas des mots. Ce sont des codes que le logiciel lit. L'état d'un bon commande les transitions permises et la couleur de sa pastille ; sa priorité commande l'ordre des tournées. Une valeur ajoutée ici produirait un bon qu'aucune action ne peut faire avancer, sans message d'erreur — un travail bloqué pour toujours, en silence.

Sept des neuf listes de cette Console sont de cette sorte. Pour en ajouter une valeur, demandez-nous.

L'écran le dit au lieu d'omettre simplement ces listes. Une absence expliquée se comprend ; une absence muette se lit comme un oubli.

Certaines de ces listes sont ce que lisent Flotte et Équipages dans WOM — le métier d'un technicien, le genre d'un camion. Voir le chapitre 3.

🗂️ Listas

El vocabulario de su organización. Lo que usted nombra aquí aparece en los formularios de las otras aplicaciones — en el idioma de cada persona.

Cada lista se abre para mostrar su código, cuántos valores activos tiene, si un formulario deja elegir uno o varios, y — para las listas que vienen con el producto — una nota que dice que su código lo lee el software.

Los valores se cargan al abrir una lista, no antes. Una lista puede llevar cientos de valores, y cargarlos todos al llegar haría que cada cual pagara por la única lista que abrió.

La lectura está abierta a todos. La escritura es del administrador. A quien no lo sea se le dice con una frase.

⚠️ Por qué los estados, las prioridades y las acciones no están aquí

La pregunta vuelve cada tres meses aproximadamente: la pantalla responde por tanto de forma permanente, en un panel que se puede desplegar.

Esos valores no son palabras. Son códigos que el software lee. El estado de una orden gobierna qué transiciones se permiten y el color de su etiqueta; su prioridad gobierna el orden de las rutas. Un valor añadido aquí produciría una orden que ninguna acción puede hacer avanzar, sin mensaje de error — un trabajo bloqueado para siempre, en silencio.

Siete de las nueve listas de esta Consola son de esa clase. Para añadir uno de esos valores, pídanoslo.

La pantalla lo dice en lugar de omitir sin más esas listas. Una ausencia explicada se entiende; una ausencia muda se lee como un olvido.

Algunas de estas listas son lo que leen Flota y Cuadrillas en WOM — el oficio de un técnico, la clase de un camión. Véase el capítulo 3.

22-console-listes
The reference lists. These are the drop-downs the other applications offer you; changing one here changes it everywhere. Interface shown in English. Les listes de référence. Ce sont les menus déroulants que les autres applications vous proposent ; en changer un ici le change partout. Interface en anglais à l’écran. Las listas de referencia. Son los desplegables que le ofrecen las otras aplicaciones; cambiar uno aquí lo cambia en todas partes. Interfaz en inglés en pantalla.

👥 Users

Your colleagues and their rights. Administrator only — it shows names, e-mail addresses and access.

Three sub-tabs, three different questions

  • Users — who exists.
  • Roles, and who holds them — which role each person holds, and how many entry points each role opens. A role with nobody holding it still appears, with a dash.
  • What each role opens, by module — the matrix, as the server applies it.

All three are here on purpose. An administrator sent to a screen that shows only who exists has to go back out and find the other two answers somewhere else — and the place they used to find them was a browser-side grid that did not actually enforce anything.

Three gestures — and one that deliberately does not exist

GestureWhat happens
Add an accountBehind a panel at the top. No password is typed here. The identity service sets the first sign-in itself, then requires a change and a second factor on first use.
Edit a profileFirst name, last name, e-mail — line by line.
Deactivate an accountCuts off access. This is what stands in for deletion.
DeleteDoes not exist, and that is a decision.

Why you cannot delete someone

A deleted account takes with it the name that appears in the activity log. Nobody would know, six months later, who closed which work order. Deactivation cuts off the access and keeps the name.

The screen says this above the table. A button that is simply missing sends people looking for a right they do not have — which is exactly what happened once.

If the add form is not there, the screen tells you why

When the server knows it cannot create accounts, the form is not shown and its reason is. Offering a form the system already knows it will refuse is the same lie the other way round — and it costs more, because you only find out after typing everything.

Likewise, “user management is not enabled on this server yet” is not a refusal of your rights. It is a different message on purpose, so that nobody spends an hour hunting for a missing role.

WOM's 👤 Users & Roles tab is a second door on this same data. Roles are shown as the server enforces them; no screen anywhere edits what a role means.

👥 Utilisateurs

Vos collègues et leurs droits. Administrateur seulement — l'écran montre des noms, des courriels et des accès.

Trois sous-onglets, trois questions différentes

  • Utilisateurs — qui existe.
  • Rôles, et qui les détient — quel rôle chacun porte, et combien de points d'entrée chaque rôle ouvre. Un rôle sans détenteur apparaît quand même, avec un tiret.
  • Ce que chaque rôle ouvre, par module — la matrice, telle que le serveur l'applique.

Les trois sont ici à dessein. Un administrateur envoyé vers un écran qui ne montre que qui existe doit ressortir chercher ailleurs les deux autres réponses — et l'endroit où il allait les chercher était une grille de navigateur qui, elle, n'appliquait rien.

Trois gestes — et un qui n'existe volontairement pas

GesteCe qui se passe
Ajouter un compteDerrière un dépliant en haut. Aucun mot de passe ne se saisit ici. Le service d'identité pose lui-même la première authentification, puis exige un changement et un second facteur à la première connexion.
Modifier un profilPrénom, nom, courriel — ligne par ligne.
Désactiver un compteCoupe l'accès. C'est ce qui tient lieu de suppression.
SupprimerN'existe pas, et c'est une décision.

Pourquoi on ne peut pas supprimer quelqu'un

Un compte supprimé emporte le nom qui figure dans le journal des actions. Plus personne ne saurait, six mois plus tard, qui a fermé quel bon de travail. La désactivation coupe l'accès et garde le nom.

L'écran le dit au-dessus du tableau. Un bouton simplement absent envoie chercher un droit qu'on n'a pas — et c'est exactement ce qui est arrivé une fois.

Si le formulaire d'ajout n'est pas là, l'écran dit pourquoi

Quand le serveur sait qu'il ne peut pas créer de compte, le formulaire n'est pas montré, et sa cause l'est. Proposer un formulaire dont le système sait déjà qu'il le refusera, c'est le même mensonge à l'envers — et il coûte plus cher, parce qu'on ne s'en aperçoit qu'après avoir tout saisi.

De même, « la gestion des utilisateurs n'est pas encore activée sur ce serveur » n'est pas un refus de vos droits. C'est un message différent à dessein, pour que personne ne passe une heure à chercher un rôle manquant.

L'onglet 👤 Users & Roles de WOM est une seconde porte sur ces mêmes données. Les rôles sont montrés tels que le serveur les applique ; aucun écran, nulle part, ne modifie ce qu'un rôle veut dire.

👥 Usuarios

Sus compañeros y sus derechos. Solo administrador — la pantalla muestra nombres, correos y accesos.

Tres subpestañas, tres preguntas distintas

  • Usuarios — quién existe.
  • Roles, y quién los tiene — qué rol tiene cada persona, y cuántos puntos de entrada abre cada rol. Un rol sin titular aparece igualmente, con un guion.
  • Qué abre cada rol, por módulo — la matriz, tal como el servidor la aplica.

Las tres están aquí a propósito. Un administrador enviado a una pantalla que solo muestra quién existe tiene que salir a buscar en otro sitio las otras dos respuestas — y el sitio donde las buscaba era una rejilla de navegador que no aplicaba nada.

Tres gestos — y uno que deliberadamente no existe

GestoQué ocurre
Añadir una cuentaTras un desplegable arriba. Aquí no se teclea ninguna contraseña. El servicio de identidad establece él mismo la primera autenticación, y luego exige un cambio y un segundo factor en el primer uso.
Modificar un perfilNombre, apellido, correo — línea a línea.
Desactivar una cuentaCorta el acceso. Es lo que hace las veces de borrado.
BorrarNo existe, y es una decisión.

Por qué no se puede borrar a alguien

Una cuenta borrada se lleva el nombre que figura en el registro de acciones. Nadie sabría, seis meses después, quién cerró qué orden de trabajo. La desactivación corta el acceso y conserva el nombre.

La pantalla lo dice encima de la tabla. Un botón simplemente ausente envía a buscar un derecho que no se tiene — y es exactamente lo que ocurrió una vez.

Si el formulario de alta no está, la pantalla dice por qué

Cuando el servidor sabe que no puede crear cuentas, el formulario no se muestra, y su causa sí. Ofrecer un formulario que el sistema ya sabe que rechazará es la misma mentira al revés — y cuesta más, porque uno se entera después de teclearlo todo.

Del mismo modo, «la gestión de usuarios aún no está activada en este servidor» no es un rechazo de sus derechos. Es un mensaje distinto a propósito, para que nadie pase una hora buscando un rol que falta.

La pestaña 👤 Users & Roles de WOM es una segunda puerta sobre estos mismos datos. Los roles se muestran tal como el servidor los aplica; ninguna pantalla, en ningún sitio, modifica lo que un rol significa.

x7-console-users
Users and their rights. This screen is the only place where access is granted — the equivalent screen in AMS is dead and grants nothing. Interface shown in English. Les utilisateurs et leurs droits. Cet écran est le seul endroit où un accès est accordé — l'écran équivalent dans AMS est mort et n'accorde rien. Interface en anglais à l’écran. Los usuarios y sus derechos. Esta pantalla es el único lugar donde se concede un acceso — la pantalla equivalente en AMS está muerta y no concede nada. Interfaz en inglés en pantalla.

🌐 Preferences

Your own settings — and only yours.

Not the same screen as Users

Users is administration: an administrator changes somebody else's account. Preferences acts only on you — the system resolves whose settings these are from who is signed in, never from the request. That is what lets a technician set their own language without having the right to touch an account.

So this screen is open to every role.

There is one preference today: your language. It follows your account, so it follows you from one workstation to another and from one application to another. The four field applications have the same panel, writing the same setting.

Three states are distinguished, and the middle one is the one people forget:

  • Set on your account — you chose it.
  • No preference — the software is following what your browser asks for. That is a default, not a decision.
  • A language this Console does not serve — said plainly rather than silently falling back.

Since 2026-09-10 this is the only place the language is set. It used to also live in a top bar, and two copies of one setting means one of them loses without saying so.

🌐 Preferences

Vos propres réglages — et seulement les vôtres.

Ce n'est pas le même écran qu'Utilisateurs

Utilisateurs, c'est l'administration : un administrateur y modifie le compte de quelqu'un d'autre. Preferences n'agit que sur vous — le système déduit à qui sont ces réglages de qui est connecté, jamais de la demande. C'est ce qui permet à un technicien de régler SA langue sans avoir le droit de toucher à un compte.

Cet écran est donc ouvert à tous les rôles.

Il y a une préférence aujourd'hui : votre langue. Elle suit votre compte, donc elle vous suit d'un poste à l'autre et d'une application à l'autre. Les quatre applications de terrain ont le même panneau, qui écrit le même réglage.

Trois états sont distingués, et c'est le deuxième qu'on oublie :

  • Réglée sur le compte — vous l'avez choisie.
  • Aucune préférence — le logiciel suit ce que votre navigateur demande. C'est un défaut, pas une décision.
  • Une langue que cette Console ne sert pas — dit en toutes lettres plutôt que replié en silence.

Depuis le 2026-09-10, c'est le seul endroit où la langue se règle. Elle vivait aussi dans une barre du haut, et deux copies d'un même réglage veut dire que l'une des deux perd sans le dire.

🌐 Preferencias

Sus propios ajustes — y solo los suyos.

No es la misma pantalla que Usuarios

Usuarios es la administración: un administrador modifica allí la cuenta de otra persona. Preferencias actúa solo sobre usted — el sistema deduce de quién son estos ajustes a partir de quién ha iniciado sesión, nunca de la petición. Eso es lo que permite a un técnico ajustar SU idioma sin tener derecho a tocar una cuenta.

Esta pantalla está por tanto abierta a todos los roles.

Hoy hay una preferencia: su idioma. Sigue a su cuenta, así que le sigue de un puesto a otro y de una aplicación a otra. Las cuatro aplicaciones de campo tienen el mismo panel, que escribe el mismo ajuste.

Se distinguen tres estados, y el segundo es el que se olvida:

  • Fijado en la cuenta — usted lo eligió.
  • Sin preferencia — el software sigue lo que pide su navegador. Es un valor por defecto, no una decisión.
  • Un idioma que esta Consola no sirve — dicho con todas las letras en lugar de recurrir a otro en silencio.

Desde el 2026-09-10 este es el único sitio donde se fija el idioma. Antes también vivía en una barra superior, y dos copias de un mismo ajuste significa que una de las dos pierde sin decirlo.

🔑 Licences

What your organization is subscribed to, and until when. Read-only, and administrator only.

This screen exists because of one bad morning

The licence is checked on every request. A sign-in that is otherwise perfectly valid is refused once the licence has expired. Until this screen existed, nobody could see their own expiry date — an administrator discovered it on the day their whole team was refused at the same time.

Three situations are distinguished, because confusing them would be expensive:

  • No licence — access is open, as an assumed default.
  • Active licence — the screen says how many days remain, not just a date.
  • Access refused — you never reach this screen; nothing loads at all.

There is no write button, and the screen says so. A licence is the commercial relationship between two organisations; it is not changed from the interface of one of them. A greyed-out button with no explanation would send you looking for a missing right.

Your licence is also what builds your menu: see the start of this chapter.

🔑 Licences

Ce à quoi votre organisation est abonnée, et jusqu'à quand. En lecture seule, et administrateur seulement.

Cet écran existe à cause d'un mauvais matin

La licence est vérifiée à chaque requête. Une connexion par ailleurs parfaitement valide est refusée dès que la licence a expiré. Tant que cet écran n'existait pas, personne ne pouvait voir sa propre échéance — un administrateur la découvrait le jour où toute son équipe se faisait refuser en même temps.

Trois situations sont distinguées, parce que les confondre coûterait cher :

  • Aucune licence — l'accès est ouvert, par défaut assumé.
  • Licence active — l'écran dit combien de jours restent, et pas seulement une date.
  • Accès refusé — vous n'atteignez jamais cet écran ; rien ne se charge du tout.

Il n'y a aucun bouton d'écriture, et l'écran le dit. Une licence engage la relation commerciale entre deux organisations ; elle ne se modifie pas depuis l'interface de l'une d'elles. Un bouton grisé sans explication ferait chercher un droit manquant.

Votre licence est aussi ce qui bâtit votre menu : voir le début de ce chapitre.

🔑 Licencias

A qué está suscrita su organización, y hasta cuándo. Solo lectura, y solo administrador.

Esta pantalla existe por una mala mañana

La licencia se comprueba en cada petición. Un inicio de sesión por lo demás perfectamente válido se rechaza en cuanto la licencia ha caducado. Mientras esta pantalla no existió, nadie podía ver su propio vencimiento — un administrador lo descubría el día en que todo su equipo era rechazado a la vez.

Se distinguen tres situaciones, porque confundirlas saldría caro:

  • Sin licencia — el acceso está abierto, por defecto asumido.
  • Licencia activa — la pantalla dice cuántos días quedan, y no solo una fecha.
  • Acceso denegado — usted nunca llega a esta pantalla; no se carga nada.

No hay ningún botón de escritura, y la pantalla lo dice. Una licencia compromete la relación comercial entre dos organizaciones; no se modifica desde la interfaz de una de ellas. Un botón en gris sin explicación enviaría a buscar un derecho que falta.

Su licencia es también lo que construye su menú: véase el principio de este capítulo.

x8-console-licences
Licences — how long this account’s access stays valid. The check runs on every authenticated request: a token that is otherwise valid, but whose licence has expired, is refused. The screen is read-only — a licence binds two organisations, so it is not changed from one side’s interface. Interface shown in English. Les licences — combien de temps l’accès de ce compte reste valide. Le contrôle tourne à chaque requête authentifiée : un jeton par ailleurs valide, mais dont la licence a expiré, est refusé. L’écran est en lecture seule — une licence lie deux organisations, elle ne se modifie pas depuis l’interface de l’une d’elles. Interface en anglais à l’écran. Las licencias — cuánto tiempo sigue siendo válido el acceso de esta cuenta. El control se ejecuta en cada solicitud autenticada: un token por lo demás válido, pero cuya licencia ha caducado, es rechazado. La pantalla es de solo lectura — una licencia vincula a dos organizaciones, así que no se modifica desde la interfaz de una de ellas. Interfaz en inglés en pantalla.