From 948937ba7582fa9d3a5e5b634d8edbf63760a2ff Mon Sep 17 00:00:00 2001 From: Davide Grilli Date: Tue, 22 Sep 2026 16:22:39 +0200 Subject: [PATCH] Aggiungi la guida utente e allinea i testi rimasti indietro sulla fase 5 Nuova docs/guida-utente.md: tutti i passi in ordine che deve fare l'utente, dalla distinta esportata da Fata (gestionale) fino all'esportazione STEP con Creo Distributed Batch (passi generali presi da documentazione/community PTC, con avviso che i nomi dei menu variano per versione/configurazione aziendale). Include anche i consigli pratici di impostare la cartella di lavoro e pulire raw/step prima di ripartire con una distinta diversa. GuidaForm.cs e README.md citavano ancora una "Verifica completezza assiemi" e un bottone "Cambia cartella..." rimossi da tempo dal codice, mai allineati nei testi: corretti nello stesso commit. Co-Authored-By: Claude Sonnet 5 --- CLAUDE.md | 1 + PrepStep/GuidaForm.cs | 10 ++-- README.md | 32 ++++++----- docs/guida-utente.md | 125 ++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 151 insertions(+), 17 deletions(-) create mode 100644 docs/guida-utente.md diff --git a/CLAUDE.md b/CLAUDE.md index 913948b..d9eaeec 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -51,6 +51,7 @@ Dove scrivere cosa: |---|---| | `CLAUDE.md` (questo file) | il flusso essenziale e i punti che si sbaglierebbero senza saperli | | [`docs/architettura.md`](docs/architettura.md) | il processo delle 5 fasi e la mappa file-per-file | +| [`docs/guida-utente.md`](docs/guida-utente.md) | cosa clicca l'utente, passo per passo, fino a Creo Distributed Batch | | [`docs/formato-asm-record.md`](docs/formato-asm-record.md) | parser esatto dei record `.asm`, con §7 per i casi limite | | [`docs/formato-asm.md`](docs/formato-asm.md) | euristica testuale di fallback | | [`docs/db-cad-index.md`](docs/db-cad-index.md) | schema e vista di `cad_index.db` | diff --git a/PrepStep/GuidaForm.cs b/PrepStep/GuidaForm.cs index 80dc7d5..d07fa62 100644 --- a/PrepStep/GuidaForm.cs +++ b/PrepStep/GuidaForm.cs @@ -40,10 +40,12 @@ public class GuidaForm : Form feature, datum copiati) inclusi. """), ("5. Verifica completezza", """ - Mostra i file .asm della distinta già in "raw", trascinabili su Creo per - l'esportazione STEP (passo manuale, fuori da quest'app). "Verifica - completezza assiemi" controlla che tutti i sotto-componenti risultino - presenti nell'indice. + Mostra i file .asm della distinta già in "raw", trascinabili su Creo + Distributed Batch per l'esportazione STEP (passo manuale, fuori da + quest'app): esporta in "step", dentro la cartella di lavoro. Se Distributed + Batch fallisce con "[-4] Dati di input non completi", quasi sempre manca un + file nell'albero dei componenti: torna alla fase 4 e controlla i "non + trovati". """), }; diff --git a/README.md b/README.md index 9f68ad3..00aef79 100644 --- a/README.md +++ b/README.md @@ -9,32 +9,38 @@ passaggio, non lo sostituisce. ## Funzionalità -1. **Indice CAD** — all'avvio carica automaticamente `cad_index.db` (se - presente accanto all'eseguibile). Se manca, si può selezionare un DB +1. **Indice CAD** — all'avvio carica automaticamente l'ultimo `cad_index.db` + usato (ricordato tra un avvio e l'altro). Se manca, si può selezionare un DB esistente con **Apri DB...** o generarne uno nuovo con **Aggiorna indice**, che scansiona il disco (di default `X:\`, tutte le cartelle di primo - livello che trova) e indicizza tutti i file. In questa fase si vede/cambia anche - la **cartella di lavoro**: dove finiscono il CSV e la cartella `raw/` (gli STEP - esportati con Creo vanno in `step/`, dentro la stessa cartella). Proposta - automaticamente (ricordata da un avvio all'altro), modificabile con - **Cambia cartella...**. + livello che trova) e indicizza tutti i file. La **cartella di lavoro** (dove + finiscono il CSV e la cartella `raw/`; gli STEP esportati con Creo vanno in + `step/`, dentro la stessa cartella) è proposta automaticamente e ricordata tra + un avvio e l'altro, modificabile in qualunque momento da **File → Scegli + cartella di lavoro...**. 2. **Importa Distinta Base** — trascina (o scegli da file) l'estrazione `.xls`/`.xml` del gestionale (foglio "Distinta Base", colonne Componente/Descrizione): viene generato un CSV nella cartella di lavoro, con anteprima in griglia. Se il file segue la convenzione di nome `DBP__` del gestionale, l'assieme generale dell'estrazione viene aggiunto come riga in più nel CSV (il foglio elenca solo i componenti - sotto l'assieme, non l'assieme stesso). + sotto l'assieme, non l'assieme stesso). Il bottone **Verifica presenza** + (compare solo dopo un import riuscito) cerca i componenti nel database — è + questo passo, non il solo import, a sbloccare la fase successiva. 3. **Crea cartella raw** — cerca nell'indice il percorso CAD di ogni componente importato (assieme generale incluso) e copia i file trovati in una cartella `raw/` dentro la cartella di lavoro. 4. **Trova componenti referenziati** — legge i metadati dei file `.asm` in `raw/` per trovare ricorsivamente i sotto-assiemi/parti che li - compongono, copiandoli a loro volta in `raw/`. -5. **Verifica completezza assiemi** — confronta la distinta con l'indice per - capire se manca qualche sotto-componente, e mostra i file `.asm` della - distinta trascinabili su Creo/Esplora risorse per l'esportazione STEP con - Creo Distributed Batch. + compongono, copiandoli a loro volta in `raw/` (passo opzionale se la + distinta contiene solo parti singole). +5. **Trascina su Creo** — mostra i file `.asm` della distinta già in `raw/`, + trascinabili su Creo Distributed Batch per l'esportazione STEP (passo + manuale, fuori da quest'app): scrive in `step/`, dentro la cartella di + lavoro. + +Guida utente passo-passo completa in [`docs/guida-utente.md`](docs/guida-utente.md) +(stessa sintesi anche in-app da **Aiuto → Guida**, F1). ## Requisiti diff --git a/docs/guida-utente.md b/docs/guida-utente.md new file mode 100644 index 0000000..7eb91fb --- /dev/null +++ b/docs/guida-utente.md @@ -0,0 +1,125 @@ +# Guida utente + +Questa guida descrive, in ordine, tutti i passi da fare in **Cevolani StepPrep** per +arrivare dalla distinta base esportata dal gestionale ai file STEP pronti, passando per +**Creo Distributed Batch**. Per il dettaglio tecnico di come funziona internamente ogni +fase vedi [`architettura.md`](architettura.md); questa guida si ferma a cosa clicca e +cosa vede l'utente. La stessa sintesi è disponibile anche dentro l'app da **Aiuto → Guida** +(F1). + +## Prima di iniziare + +- Serve accesso alla share di rete con i file CAD (di default `X:\`). +- Serve l'estrazione "Distinta Base" dal gestionale (Fata): il file `.xls` così come + Fata lo salva, con le colonne Componente/Descrizione (foglio `"Distinta Base"`) — va + lasciato nel formato/estensione in cui viene esportato, senza risalvarlo o convertirlo + in altri formati prima di usarlo nell'app. Sotto l'estensione `.xls` il contenuto può + essere XML (SpreadsheetML) o Excel binario vero: l'app riconosce da sola quale dei due + è, non serve fare nulla di diverso a seconda del caso. +- Se il file segue la convenzione di nome del gestionale (`DBP__`), + l'app aggiunge da sola l'assieme generale come componente in più — non serve fare + nulla di diverso. +- Conviene definire la **cartella di lavoro** giusta (fase 1, o "File → Scegli cartella + di lavoro...") prima di importare la distinta: è lì che finiscono CSV, `raw/` e, dopo + l'esportazione con Creo, `step/`. +- Se la cartella di lavoro è già stata usata per un'altra distinta, conviene **pulire + `raw/` e `step/`** prima di ripartire ("File → Pulisci raw e step..."): evita di + confondere i file CAD/STEP della copia precedente con quelli della nuova distinta (il + "File → Nuovo" descritto più sotto azzera solo lo stato di CSV/griglie dell'app, non + tocca i file già copiati su disco). + +## 1. Database + +Alla prima apertura, se un database (`cad_index.db`) è già stato creato in precedenza, +l'app lo ricarica da sola: si vede il pallino verde accanto a "Database", il percorso del +file e la data dell'ultimo aggiornamento. + +- **Se il pallino è rosso** (nessun database trovato): premi **Aggiorna indice** per + scansionare la share (`X:\`) e crearne uno nuovo — l'operazione può richiedere qualche + minuto la prima volta, i giri successivi sono più veloci perché aggiornano solo quello + che è cambiato. +- **Se hai già un database da un'altra postazione o cartella**: premi **Apri DB...** e + selezionalo a mano. +- La **cartella di lavoro** (dove l'app scrive il CSV della distinta e la cartella + `raw/`) è scelta automaticamente e ricordata tra un avvio e l'altro; per cambiarla usa + **File → Scegli cartella di lavoro...**. + +Premi **Avanti** quando il database è caricato. + +## 2. Importa Distinta Base + +- **1. Carica la distinta**: trascina il file `.xls` esportato da Fata nella finestra, + oppure premi **Scegli file distinta...** e selezionalo da Esplora risorse. Le righe importate + compaiono nella griglia (Componente/Descrizione) e viene scritto un CSV nella cartella + di lavoro. +- **2. Verifica la presenza dei file sul server**: compare solo dopo un import riuscito. + Premila per cercare ogni componente nel database — le righe della griglia si colorano + di verde (trovato) o rosso (non trovato nell'indice). + +**Avanti** si sblocca solo dopo aver premuto "Verifica la presenza dei file sul server", +non basta il solo import: è il modo per accorgersi subito se il database è disallineato +rispetto alla share (es. indice non aggiornato) prima di andare avanti. + +## 3. Crea cartella raw + +Premi **Crea cartella raw**: per ogni componente della distinta trovato nell'indice, +l'app ne copia il file CAD dalla share nella cartella `raw/` (dentro la cartella di +lavoro). La griglia mostra il percorso CAD copiato per ogni componente. + +## 4. Trova componenti referenziati + +Gli assiemi (`.asm`) referenziano altri file (sotto-assiemi, parti, componenti soppressi, +riferimenti esterni) che Creo deve poter caricare insieme all'assieme principale, anche +se non compaiono nella distinta del gestionale. Premi **Trova componenti referenziati**: +l'app legge i file `.asm` già in `raw/`, risolve ricorsivamente tutto l'albero e copia +anche quei file in `raw/`. + +Si apre una finestra con l'elenco di quanto trovato e copiato (PRT e sotto-assiemi), con +in fondo eventuali codici referenziati che non corrispondono a nessun file indicizzato +(possono essere disegni, componenti davvero mancanti, o falsi positivi della scansione — +non bloccano il lavoro, ma vale la pena controllarli). Da qui puoi anche aprire +direttamente la cartella `raw/` con **Apri cartella raw**. + +Questo passo è opzionale se la distinta contiene solo parti singole senza sotto-assiemi: +in quel caso si può passare direttamente alla fase successiva. + +## 5. Trascina su Creo Distributed Batch + +L'ultima fase mostra l'elenco dei file `.asm` della distinta già presenti in `raw/`, +trascinabili. Da qui il passaggio a Creo è manuale, fuori dall'app: + +1. Apri **Creo Distributed Batch** (dal menu Start di Windows, o dal file + `ptcdbatch.bat` nella cartella `bin` dell'installazione Creo). +2. Crea un nuovo gruppo di attività per l'esportazione STEP (menu **Actions → New Task + Group**), scegliendo il tipo di attività per l'export STEP — se in azienda è già + presente un profilo/gruppo predefinito per l'export STEP, riusa quello invece di + crearne uno nuovo. +3. Aggiungi i file: trascina i `.asm` dalla finestra dell'app (o direttamente da Esplora + risorse, dalla cartella `raw/`) sul gruppo di attività, oppure sfoglia e selezionali a + mano da Distributed Batch. +4. Verifica che il gruppo di attività punti al `config.pro`/profilo di export STEP giusto + (sezione **Configuration Files** del gruppo) — di norma è già impostato una volta sola + per tutti, non richiede modifiche a ogni giro. +5. Avvia l'elaborazione (**Start**/**Run**): Distributed Batch legge ogni `.asm`, con + tutto l'albero di sotto-componenti già raccolto in `raw/` nelle fasi 3-4, ed esporta i + file STEP nella cartella `step/` (dentro la cartella di lavoro, accanto a `raw/`). + +I nomi esatti dei menu possono variare leggermente a seconda della versione di Creo e di +come Distributed Batch è già configurato in azienda — questi passi descrivono il flusso +generale (fonte: [documentazione e community PTC](https://www.ptc.com/en/support/article/CS28241)); +in caso di dubbio su profili/config già pronti, chiedi a chi ha impostato Distributed +Batch la prima volta. + +**Se Distributed Batch fallisce con `[-4] Dati di input non completi`**, quasi sempre +manca un file nell'albero dei componenti — Creo non dice quale. Torna alla fase 4 e +controlla l'elenco dei "non trovati": è il punto di partenza per capire cosa recuperare +prima di riprovare. + +## Ripartire con una nuova distinta + +Quando devi processare un'altra distinta, usa **File → Nuovo** (Ctrl+N): azzera CSV, raw +e verifica delle fasi 2-5 e riporta al passo 2, senza dover ricaricare il database o +la cartella di lavoro (restano quelli già impostati in fase 1). + +Per ripulire le cartelle `raw/` e `step/` della cartella di lavoro prima di un nuovo giro +(senza toccare l'indice), usa **File → Pulisci raw e step...**.