Convalida della configurazione dell'adapter
Durante l'aggiunta del percorso di ricezione e della porta di trasmissione, verrà chiesto di configurare le proprietà personalizzate nella < finestra di dialogo Proprietà trasporto nome>adapter . Queste proprietà sono definite nei file di schema XSD del progetto AdapterHarness.
La convalida dello schema di configurazione si svolge in tre parti:
Quando si visualizza una configurazione salvata, prima di caricare il documento nella pagina delle proprietà, Adapter Framework convalida il documento XML salvato a fronte dello schema. Il framework presuppone che un documento non valido indichi un cambiamento della definizione dello schema di configurazione. Solo i documenti validi vengono caricati nella pagina delle proprietà.
Quando si salva una configurazione, se l'adattatore implementa l'interfaccia IAdapterConfigValidation , il framework passa all'adattatore il documento XML costruito dalla serializzazione dei dati della pagina delle proprietà. L'adapter elabora quindi il documento. Eventuali errori generano eccezioni che vengono intercettate dal framework e visualizzate all'utente. I valori mancanti o generati vengono generati durane la convalida. L'uso della <decorazione show="false"> esplorabile elimina la visualizzazione di una voce nella griglia delle proprietà, anche se il valore viene visualizzato nell'istanza XML.
Quando si salva una configurazione prima di inserire il valore nel database, il framework convalida nuovamente il documento XML a fronte dello schema. In questo modo viene garantito il salvataggio in modo permanente solo dei dati validi.