Guide d'utilisation de TJLAPP csv

1. Prise en main & Gestion des fichiers (Accès disque direct)

L'application fonctionne comme un logiciel de bureau directement dans votre navigateur web, avec détection automatique des capacités de votre système :

• Ouvrir un fichier (Ctrl+O) : Cliquez sur Ouvrir pour sélectionner un fichier .csv sur votre disque. Sous les navigateurs compatibles (Chrome, Edge, Brave...), le lien direct avec le fichier est conservé en mémoire.
• Enregistrer directement (Ctrl+S) : Réécrit directement vos modifications dans le fichier d'origine sur votre disque, sans créer de doublon dans les téléchargements.
• Menu Enregistrer sous... : Propose d'enregistrer le document en fichier CSV (.csv), en classeur Microsoft Excel (.xlsx) ou en feuille OpenDocument LibreOffice Calc (.ods), directement dans le dossier de votre choix sur votre disque local.
• Menu Affichage : Permet d'alterner entre la vue Tableau (Grille) classique et la vue Texte brut (CSV). Le mode texte permet de visualiser le flux CSV réel avec les séparateurs et de le modifier directement.
• Créer une nouvelle feuille (Ctrl+N) : Réinitialise une grille vierge de 25 lignes et 12 colonnes.
• Glisser-déposer : Vous pouvez à tout moment glisser et déposer un fichier .csv sur la fenêtre.
• Mode de secours universel : Si votre navigateur ne supporte pas l'accès direct (ex. Firefox/Safari), l'application bascule automatiquement et de façon transparente vers le mode téléchargement classique.

2. Navigation au clavier et raccourcis

La grille est optimisée pour une saisie rapide au clavier :

3. Édition et gestion des lignes / colonnes

Alignement automatique du texte : Conformément aux standards des tableurs, les nombres entiers (chiffres uniquement) et les nombres décimaux/flottants (avec un point '.') sont automatiquement alignés à droite. Tout autre contenu textuel est aligné à gauche.

Barre de formule (fx) : En haut de la grille, le champ de saisie reflète le texte de la cellule sélectionnée. Vous pouvez modifier le texte directement dans la cellule ou dans la barre de formule.

Insérer ou supprimer : Les boutons de la barre d'outils permettent d'ajouter une ligne sous la sélection, d'insérer une colonne à droite, ou de supprimer la ligne/colonne courante.

Recherche de texte : Tapez votre mot-clé dans le champ de recherche en haut à droite. Les cellules correspondantes sont mises en évidence en jaune et les flèches ▲ / ▼ (ou Entrée / Shift + Entrée) vous permettent de naviguer directement d'un résultat à l'autre.

3.bis. Robot Callback (Automatisation & Scripts par ligne)

Le bouton Robot dans la barre d'outils ouvre un volet d'automatisation composé de deux onglets. Conformément aux standards de développement, l'environnement de programmation est entièrement en anglais :

• Onglet Code : Éditeur JavaScript avec coloration syntaxique en temps réel. Boutons New, Open et Save (Ctrl + S) via l'API File System Access locale. Raccourci d'exécution Ctrl + Entrée.
• Onglet Console : Terminal sombre capturant en temps réel tous les appels console.log(...), console.warn(...) et les erreurs d'exécution horodatées par ligne (ex. Row 3).

Modèle de fonction : function (row) { return true; }

• Lecture des colonnes : Utilisez row.A, row.B, ou directement le nom d'en-tête de la ligne 1 (ex. row.Name ou row['Nom Client']).
• Recherche de colonne par nom (ligne 1) : La fonction column('Nom') renvoie l'objet colonne (ex. 'B' avec .letter, .num et .index). colNum('Nom') renvoie son numéro 1-based (ex. 2) et colIndex('Nom') son index (ex. 1).
• Dimensions de la table : Les variables totalRows (ou rowCount) et totalCols (ou colCount) donnent le nombre total de lignes et colonnes de la grille.
• Modification de cellule : Affectez une nouvelle valeur (ex : row.B = 'Nouveau' ou row.Ville = 'Paris'). Toute cellule modifiée est surlignée avec un fond bleu ciel issu du Pantone 653 C.
• Numéro de ligne : row.num renvoie le numéro de ligne traité (1, 2, 3...).
• Écriture en console : Utilisez console.log('Message', row.A) pour inspecter vos variables dans l'onglet Console.
• Indicateurs d'état en tête de ligne :
  • ✔ Coche verte : la fonction a retourné true.
  • ✖ Croix rouge : la fonction a retourné false.
  • ⚠ Pastille orange d'erreur : une exception JavaScript a été interceptée (le message d'erreur est affiché au survol).
• Bouton Reset run : Réinitialise les coches, croix, erreurs et surbrillances pour retrouver l'état initial.

4. Configuration des fichiers CSV (⚙️ Paramètres)

En cliquant sur le bouton ⚙️ Paramètres, vous pouvez régler les options d'import et d'export. Vos préférences sont automatiquement conservées dans votre navigateur :

1. Getting Started & File Management (Direct Disk Access)

The application works like desktop software directly in your web browser, with automatic capability detection:

• Open a file (Ctrl+O): Click Open to pick a .csv file on your computer. In compatible browsers (Chrome, Edge, Brave...), direct file linkage is preserved in memory.
• Direct Save (Ctrl+S): Writes your modifications directly to the original file on your drive, without creating duplicates in your Downloads folder.
• Save as...: Lets you choose a new location or a new name on your disk.
• Export Menu: Instantly export the sheet to a Microsoft Excel workbook (.xlsx), an OpenDocument LibreOffice Calc spreadsheet (.ods), or a text .csv file. Numbers are automatically typed for immediate formula calculations.
• Create a new sheet (Ctrl+N): Resets a blank grid with 25 rows and 12 columns.
• Drag and Drop: You can drag and drop any .csv file directly onto the window at any time.
• Universal fallback mode: If your browser does not support direct disk access (e.g. Firefox/Safari), the app smoothly and automatically falls back to standard web download.

2. Keyboard Navigation and Shortcuts

The grid is optimized for high-speed keyboard input:

3. Editing and Row / Column Management

Automatic Text Alignment: Following spreadsheet standards, integer numbers (digits only) and decimal/floating-point numbers (with a single dot '.') are automatically aligned to the right. Any other text content is aligned to the left.

Formula bar (fx): At the top of the grid, the input reflects the text of the selected cell. You can edit text directly in the cell or in the formula bar.

Insert or Delete: Toolbar buttons allow you to add a row below the selection, add a column to the right, or delete the current row/column.

Text Search: Enter your keyword in the search box in the top-right toolbar. Matching cells are highlighted in yellow and ▲ / ▼ buttons (or Enter / Shift + Enter) let you navigate occurrence by occurrence.

3.bis. Robot Callback (Row Automation & Scripts)

The Robot button in the toolbar opens an automation panel featuring two tabs:

• Code Tab: JavaScript editor with live syntax highlighting. Buttons New, Open, and Save (Ctrl + S) via the local File System Access API. Shortcut Ctrl + Enter to run.
• Console Tab: Real-time display for all console.log(...), console.warn(...) calls and execution exceptions timestamped per row (e.g. Row 3).

Function template: function (row) { return true; }

• Read columns: Use row.A, row.B, or directly the header name from row 1 (e.g. row.Name or row['Customer Name']).
• Column lookup by name (row 1): The function column('Name') returns a column reference object (e.g. 'B' with .letter, .num and .index). colNum('Name') returns its 1-based number (e.g. 2) and colIndex('Name') its index (e.g. 1).
• Table dimensions: The variables totalRows (or rowCount) and totalCols (or colCount) provide the total grid dimensions.
• Update cells: Assign a new value (e.g. row.B = 'New' or row.City = 'Paris'). Updated cells are highlighted with a soft Pantone 653 C blue background.
• Row number: row.num gives the 1-based row number (1, 2, 3...).
• Console output: Use console.log('Value', row.A) to inspect data inside the Console tab.
• Row status indicators:
  • ✔ Green checkmark: function returned true.
  • ✖ Red cross: function returned false.
  • ⚠ Orange error badge: a JavaScript exception was caught (hover to view the error message).
• Reset run: Clears all checkmarks, crosses, errors, and cell highlights back to normal.

4. CSV File Settings (⚙️ Settings)

By clicking the ⚙️ Settings button, you can adjust import and export options. Your preferences are automatically saved in your browser:

1. Erste Schritte & Dateiverwaltung (Direkter Festplattenzugriff)

Die Anwendung funktioniert wie eine Desktop-Software direkt in Ihrem Webbrowser mit automatischer Systemerkennung:

• Datei öffnen (Strg+O): Klicken Sie auf Öffnen, um eine .csv-Datei auf Ihrer Festplatte auszuwählen. In kompatiblen Browsern (Chrome, Edge, Brave...) bleibt die Dateiverknüpfung im Speicher erhalten.
• Direkt speichern (Strg+S): Schreibt Ihre Änderungen direkt in die Originaldatei auf Ihrer Festplatte, ohne Duplikate im Download-Ordner zu erzeugen.
• Speichern unter...: Ermöglicht die Auswahl eines neuen Speicherorts oder Namens.
• Export-Menü: Exportieren Sie die Tabelle direkt als Microsoft Excel-Arbeitsmappe (.xlsx), OpenDocument LibreOffice Calc-Tabelle (.ods) oder .csv-Textdatei. Zahlen werden automatisch formatiert, um sofortige Formelberechnungen zu ermöglichen.
• Neues Blatt erstellen (Strg+N): Erstellt ein neues leeres Raster mit 25 Zeilen und 12 Spalten.
• Drag & Drop: Sie können jederzeit eine .csv-Datei per Drag-and-Drop auf das Fenster ziehen.
• Universeller Fallback-Modus: Wenn Ihr Browser keinen direkten Festplattenzugriff unterstützt (z. B. Firefox/Safari), schaltet die App automatisch und nahtlos auf den klassischen Download-Modus um.

2. Tastaturnavigation und Tastenkombinationen

Das Raster ist für eine schnelle Tastatureingabe optimiert:

3. Rasterbearbeitung, Bearbeitungsleiste und Formatierung

Bearbeitungsleiste (fx): Zeigt die Koordinaten der ausgewählten Zelle an (z. B. A1, B3, AA12). Die Eingabe ist synchronisiert mit der Inline-Bearbeitung.

Zeilen & Spalten: Über die Symbolleiste können Sie Zeilen und Spalten mit den Schaltflächen + Zeile, - Zeile, + Spalte und - Spalte hinzufügen oder entfernen.

Automatische Zellenausrichtung: Nach Tabellenkalkulationsstandard werden ganze Zahlen und Dezimalzahlen (mit einem Punkt '.') automatisch rechtsbündig ausgerichtet. Jeder andere Textinhalt wird linksbündig ausgerichtet. Diese Einstellung kann in den Optionen angepasst werden.

3.bis. Roboter-Callback (Zeilenautomatisierung & Skripte)

Über die Schaltfläche Roboter in der Symbolleiste öffnen Sie ein Automatisierungsfenster mit zwei Reitern:

• Reiter Code: JavaScript-Editor mit Echtzeit-Syntaxhervorhebung. Tastenkürzel Strg + Eingabe zum Ausführen.
• Reiter Konsole: Zeigt alle Ausgaben von console.log(...), console.warn(...) sowie Laufzeitfehler mit Zeilenbezug an.

Funktionsvorlage: function (ligne) { return true; }

• Spaltenzugriff: Verwenden Sie ligne.A, ligne.B, ligne.C zum Lesen von Zellwerten.
• Zelländerung: Weisen Sie einen neuen Wert zu (z. B. ligne.B = 'Neu'). Geänderte Zellen werden mit einem zarten Pantone 653 C Blauton hervorgehoben.
• Zeilennummer: ligne.num liefert die 1-basierte Zeilennummer (1, 2, 3...).
• Konsolenausgabe: Verwenden Sie console.log('Wert', ligne.A) zur Inspektion von Werten.
• Statusanzeige im Zeilenkopf:
  • ✔ Grünes Häkchen: Funktion hat true zurückgegeben.
  • ✖ Rotes Kreuz: Funktion hat false zurückgegeben.
  • ⚠ Orangenes Warnsymbol: JavaScript-Ausnahme abgefangen (Fehlermeldung beim Überfahren sichtbar).
• Reset run: Setzt Häkchen, Kreuze, Fehler und Hervorhebungen auf den Ursprungszustand zurück.

4. CSV-Dateieinstellungen (⚙️ Einstellungen)

Über die Schaltfläche ⚙️ Einstellungen können Sie Import- und Exportoptionen anpassen. Ihre Einstellungen werden automatisch im Browser gespeichert:

1. Primeros pasos y gestión de archivos (Acceso directo al disco)

La aplicación funciona como un programa de escritorio directamente en su navegador web, con detección automática del sistema:

• Abrir un archivo (Ctrl+O): Haga clic en Abrir para seleccionar un archivo .csv en su disco. En navegadores compatibles (Chrome, Edge, Brave...), el enlace directo se conserva en memoria.
• Guardar directamente (Ctrl+S): Guarda sus cambios directamente en el archivo original de su disco, sin duplicados en Descargas.
• Guardar como...: Permite elegir una nueva ubicación o un nuevo nombre en su disco.
• Menú Exportar: Exporte instantáneamente la hoja a un libro de Microsoft Excel (.xlsx), una hoja de cálculo OpenDocument LibreOffice Calc (.ods) o un archivo de texto .csv. Los números se reconocen automáticamente para permitir cálculos de fórmulas inmediatos.
• Crear una nueva hoja (Ctrl+N): Crea una cuadrícula en blanco de 25 filas y 12 columnas.
• Arrastrar y soltar: Puede arrastrar y soltar un archivo .csv sobre la ventana en cualquier momento.
• Modo de respaldo universal: Si su navegador no admite acceso directo al disco (ej. Firefox/Safari), la app cambia automáticamente al modo de descarga tradicional.

2. Navegación con teclado y atajos

La cuadrícula está optimizada para la entrada rápida con teclado:

3. Edición en la cuadrícula y barra de fórmulas

Barra de fórmulas (fx): Muestra las coordenadas de la celda activa (ej. A1, B3, AA12). La entrada se sincroniza con la edición en celda.

Filas y Columnas: Mediante la barra de herramientas, puede agregar o eliminar filas y columnas con + Fila, - Fila, + Columna y - Columna.

Alineación automática de celdas: Conforme al estándar de hojas de cálculo, los números enteros y decimales (con punto '.') se alinean automáticamente a la derecha. Cualquier otro texto se alinea a la izquierda. Esto se puede configurar en los ajustes.

3.bis. Robot Callback (Automatización & Scripts por fila)

El botón Robot en la barra de herramientas abre un panel de automatización compuesto por dos pestañas :

• Pestaña Código : Editor JavaScript con resaltado sintáctico en tiempo real. Atajo Ctrl + Enter para ejecutar.
• Pestaña Consola : Muestra en tiempo real todas las llamadas a console.log(...), console.warn(...) y los errores de ejecución por fila.

Plantilla de función: function (ligne) { return true; }

• Lectura de columnas: Utilice ligne.A, ligne.B, ligne.C para leer los valores de las celdas.
• Modificación de celda: Asigne un nuevo valor (ej: ligne.B = 'Nuevo'). Las celdas modificadas se resaltan con un fondo azul cielo derivado del Pantone 653 C.
• Número de fila: ligne.num devuelve el número de fila procesado (1, 2, 3...).
• Salida de consola: Utilice console.log('Mensaje', ligne.A) para inspeccionar datos en la pestaña Consola.
• Indicadores de estado en el encabezado de fila :
  • ✔ Marca verde: la función devolvió true.
  • ✖ Cruz roja: la función devolvió false.
  • ⚠ Icono naranja de error: se interceptó una excepción JavaScript (pase el cursor para ver el error).
• Botón Reset run: Restablece marcas, cruces, errores y resaltados para volver al estado inicial.

4. Configuración de archivos CSV (⚙️ Configuración)

Al hacer clic en el botón ⚙️ Configuración, puede ajustar las opciones de importación y exportación. Sus preferencias se guardan automáticamente: