davideandClaude Sonnet 5.5
ccfa00ff52
Nuovi doc: tutorial-primo-giro, risoluzione-problemi, sviluppo, rilascio, glossario e registro delle decisioni (docs/decisioni, 6 ADR). docs/README.md e' l'indice per categoria e la tabella delle fonti uniche; il README di root rimanda a sviluppo/rilascio invece di duplicarli. scripts/CheckDocs.cs verifica link e ancore, <Version> contro CHANGELOG, copertura di architettura.md e presenza di ogni doc nell'indice; .markdownlint-cli2.jsonc configura il lint Markdown. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2.9 KiB
Tutorial: il tuo primo giro con PrepStep
Questo tutorial ti porta, con una distinta vera, dall'app appena installata ai file raw/ pronti
per Creo. Alla fine saprai cosa produce ogni fase e come capire se è andata bene. Per il
dettaglio di ogni schermata e per l'esportazione in Creo vedi guida-utente.md.
Ti serve: il programma installato (setup in rilascio.md), la share X:\
raggiungibile e un'estrazione "Distinta Base" .xls del gestionale, meglio se piccola (poche
decine di righe) per il primo giro.
1. Avvia e carica l'indice
Apri PrepStep - Cevolani. Accanto a "Database" c'è un pallino.
- Verde: l'indice c'è già, vai al passo 2.
- Rosso: premi Aggiorna indice. La prima volta scansiona tutta la share e richiede qualche minuto; vedi una barra di avanzamento con i conteggi.
Risultato atteso: pallino verde, percorso di cad_index.db e data dell'aggiornamento.
Premi Avanti.
2. Importa la distinta
Trascina il .xls nella finestra. Risultato atteso: la griglia si riempie con
Componente/Descrizione e nella cartella di lavoro compare un CSV con lo stesso nome base.
Poi premi Verifica presenza: le righe diventano verdi (trovato nell'indice) o rosse (non
trovato). Solo ora Avanti si sblocca.
Se vedi righe rosse non fermarti: nel primo giro è normale scoprire che l'indice è vecchio o
che un componente non è sulla share. Vedi risoluzione-problemi.md.
3. Crea la cartella raw
Premi Crea cartella raw. Risultato atteso: nella cartella di lavoro nasce raw/ con i file
.prt/.asm dei componenti trovati, e la griglia mostra il percorso CAD di ciascuno.
4. Trova i componenti referenziati
Premi Trova componenti referenziati. L'app legge i .asm in raw/ e copia anche tutto
quello che serve a Creo per aprirli (sotto-assiemi, componenti soppressi, riferimenti esterni).
Risultato atteso: una finestra con l'elenco di quanto copiato e, in fondo, i codici "non
trovati". raw/ ora contiene più file di prima: è giusto così, perché la lista dei file
necessari è più lunga di quella della distinta (il perché, in
decisioni/0003-parser-esatto-con-fallback.md).
5. Porta i .asm a Creo
La fase 5 mostra i .asm della distinta come icone trascinabili. Trascinali su Creo
Distributed Batch (passi in
guida-utente.md):
i file STEP finiscono in step/.
Cosa hai imparato
| Fase | Entra | Esce |
|---|---|---|
| 1 | share X:\ |
cad_index.db |
| 2 | .xls del gestionale |
CSV + verifica sull'indice |
| 3 | CSV + indice | raw/ con i componenti della distinta |
| 4 | .asm in raw/ |
raw/ completa dell'albero |
| 5 | raw/ |
.asm da trascinare su Creo |
Per un secondo giro con un'altra distinta usa File → Nuovo (Ctrl+N), e prima ripulisci
raw//step/ da File → Pulisci raw e step....