Vai al contenuto

Configurazione Progetto in Visual Studio

1. Creazione del Progetto C

  1. Apri Visual Studio (2019 o 2022).
  2. Seleziona Crea un nuovo progetto.
  3. Seleziona il template App Windows Forms (.NET Framework) oppure App console (.NET Framework) in linguaggio C#.
    • Consiglio: Se usi l'estensione ufficiale SAP Business One Studio for Visual Studio, troverai direttamente il template SAP B1 AddOn. Se crei il progetto manualmente da zero, usa App Windows Forms (.NET Framework).
  4. Assegna un nome al progetto (es. MySAPAddon).
  5. Seleziona come versione di Framework: .NET Framework 4.8 (oppure .NET Framework 4.7.2).

Non usare .NET Core / .NET 6/7/8 nativo

Le librerie COM di SAP Business One e l'assembly SAPbouiCOM.Framework sono nativamente compilate per .NET Framework classico (Windows).

2. Configurazione Piattaforma: x64

Questo è uno degli errori più frequenti che impediscono all'add-on di avviarsi (BadImageFormatException o fallimento silenzioso della connessione).

  1. In Visual Studio, apri le Proprietà del Progetto (tasto destro sul progetto in Esplora Soluzioni → Proprietà).
  2. Vai nella scheda Compilazione (o Build).
  3. Nella voce Piattaforma di destinazione (Platform Target), cambia da Any CPU a x64.
  4. Assicurati che l'opzione Preferisci 32 bit (Prefer 32-bit) non sia spuntata.
Configurazione: Active (Debug)
Piattaforma:    x64  <--- OBBLIGATORIO per SAP Business One 64-bit

Perché x64 è cruciale

A partire da SAP Business One 10.0 FP 2008, il client SAP è esclusivamente a 64 bit. Se l'add-on gira come processo a 32 bit o AnyCPU con "Prefer 32-bit" attivo, non potrà condividere lo spazio di memoria COM o connettersi via socket interprocesso al client SAP a 64 bit.

3. Aggiunta del riferimento all'SDK

Fornisce l'infrastruttura ad oggetti moderna (Application, UserFormBase, SystemFormBase).

  • Tasto destro su Riferimenti (References) → Aggiungi riferimento... → Sfoglia (Browse).
  • Naviga nella cartella di installazione di SAP Business One: 
    C:\Program Files (x86)\SAP\...
    e seleziona il file dll dell'SDK

Ora il progetto è configurato correttamente ed è pronto per ospitare il codice base. Passa alla sezione successiva: Struttura e Codice Base.