# Guida utente Questa guida descrive, in ordine, tutti i passi da fare in **PrepStep - Cevolani** 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). ## Installazione 1. Lancia `PrepStep-Setup-.exe` (non servono i diritti di amministratore). 2. Alla fine lascia spuntato "Avvia PrepStep - Cevolani", oppure aprilo dal menu Start. Il programma si installa in `%LOCALAPPDATA%\Programs\PrepStep`. Il database `cad_index.db` sta sempre in questa cartella. Se il programma è già installato, il setup chiede cosa fare: - **Sì** — lo aggiorna (o reinstalla): database e cartella di lavoro restano quelli di prima; - **No** — lo disinstalla; - **Annulla** — esce senza fare nulla. Per **disinstallarlo** si può anche usare menu Start → "Disinstalla PrepStep - Cevolani", oppure Impostazioni → App installate → PrepStep - Cevolani → Disinstalla (il database `cad_index.db` e le impostazioni non vengono cancellati, vedi sotto). ## 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. Vale solo finché non chiudi il programma: al prossimo avvio si riparte dal database nella cartella di installazione. Per usarlo sempre, copialo in `%LOCALAPPDATA%\Programs\PrepStep` come `cad_index.db`. - La **cartella di lavoro** (dove l'app scrive il CSV della distinta e la cartella `raw/`) è ricordata tra un avvio e l'altro; la prima volta è la cartella di installazione (`%LOCALAPPDATA%\Programs\PrepStep`); 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...**.