Condividi tramite

Functoid di database

  • Articolo

I functoid del database estraggono dati da un database da usare in un messaggio di istanza di output.

Panoramica

Di seguito è riportato un elenco dei functoid del database e di come usarli:

  • Ricerca nel database. Usare il functoid Ricerca database per estrarre informazioni da un database e archiviarlo come recordset di Microsoft ActiveX Data Objects .NET (ADO.NET). Questo functoid richiede quattro parametri di input nel seguente ordine:

    • Un valore di ricerca

    • Una stringa di connessione al database

    • Un nome di tabella

    • Un nome di colonna per il valore di ricerca.

  • Restituzione errore. Usare il functoid Error Return per acquisire informazioni sugli errori, ad esempio errori di connessione al database, che si verificano durante l'esecuzione. Questo functoid richiede un parametro di input: un collegamento dal functoid Ricerca database .

  • Formatta messaggio. Questo functoid consente di restituire una stringa formattata e localizzata utilizzando la sostituzione degli argomenti e, potenzialmente, il riferimento incrociato all'ID e al valore.

  • Ottenere l'ID applicazione. Recupera un identificatore per un oggetto applicazione.

  • Ottieni valore applicazione. Recupera il valore di un'applicazione.

  • Ottieni ID comune. Recupera un identificatore per un oggetto comune.

  • Ottieni valore comune. Recupera un valore comune.

  • Rimuovere l'ID applicazione. Rimuove un valore dell'applicazione.

  • Impostare l'ID comune. Imposta e restituisce un identificatore per un oggetto comune.

  • Estrazione del valore. Usare il functoid Estrattore valore per estrarre dati dalla colonna specificata in un recordset restituito dal functoid Ricerca database . Questo functoid richiede due parametri di input: un collegamento al functoid Ricerca database e un nome di colonna.

    Sette functoid del database , ovvero Format Message, Get Application ID, Get Application Value, Get Common ID, Get Common Value, Remove Application ID e Set Common ID, sono functoid crossReferencing . Questi functoid consentono di convertire gli ID e i valori di un messaggio di input negli ID e nei valori necessari nel messaggio di output. Per altre informazioni, vedere Informazioni di riferimento sui functoid del database nelle linee guida dell'interfaccia utente e nelle informazioni di riferimento sullo spazio dei nomi delle API per sviluppatori.

Esempio

Nell'esempio seguente vengono usati alcuni functoid database . Si consideri un produttore al dettaglio che dispone di diversi punti vendita distribuiti su una vasta area geografica. Per tenere traccia dei negozi, la sede centrale assegna a ogni negozio un codice univoco denominato StoreID. Inoltre, la sede centrale associa le informazioni seguenti a ogni StoreID:

  • StoreName

  • StoreAddress

  • Città

  • Codice postale

  • StorePhoneNumber

  • StoreManager

    Queste informazioni vengono archiviate in un database e distribuite ai partner commerciali a intervalli regolari. Per il produttore, tutto il processo di acquisto viene eseguito dalla sede centrale, non dai punti vendita. Quando la sede centrale invia un ordine di acquisto ai partner commerciali, accade in genere che più punti vendita ricevono la merce ordinata tramite il singolo ordine di acquisto. Invece di inviare informazioni sul nome e sull'indirizzo per ogni negozio che deve ricevere merce, la sede centrale invia semplicemente il StoreID. Per inserire il nome e le informazioni sull'indirizzo nell'avviso di spedizione avanzato, il partner commerciale utilizza i functoid Database per inserire automaticamente queste informazioni nel messaggio dell'istanza di output. Nella figura seguente viene illustrato in che modo un partner commerciale è in grado di implementare la sostituzione dello StoreID in una mappa.

    Mappa che mostra functoid di database diversi.

    Nella figura lo schema di origine rappresenta un ordine di acquisto in ingresso, mentre lo schema di destinazione rappresenta un avviso di spedizione avanzata. Il functoid Ricerca database trova il record appropriato dalla tabella di database appropriata. I functoid Dell'estrattore valore estraggono la colonna appropriata dal record di ricerca. Il functoid Error Return restituisce una stringa contenente informazioni sull'errore in caso di errori ,ad esempio errori di connessione, in fase di esecuzione.

    Nell'esempio precedente il primo parametro di input viene tratto dal campo StoreID dell'ordine di acquisto in ingresso e i tre parametri di input rimanenti sono costanti configurate nella finestra di dialogo Configura <functoid Functoid> per il functoid Ricerca database. Per fornire valori per tutti e quattro i parametri di input è possibile creare collegamenti dallo schema di origine.

Nota

  • Non è possibile usare alcuni tipi di dati di Microsoft SQL Server, ad esempio text, ntext e image, come valori di ricerca per il functoid Ricerca database. Il functoid richiede tipi di dati che possono essere rappresentati come stringa di testo.

  • Se sono presenti più record corrispondenti ai parametri di input del functoid Ricerca database , il functoid Estrazione valore estrae i dati solo dal primo record.

  • Per proteggere le password mediante crittografia, utilizzare l'autenticazione NT nelle stringhe di connessione.

Functoid disponibili

I functoid database sono:

  • Ricerca nel database
  • Restituzione errore
  • Formatta messaggio
  • Ottieni ID applicazione
  • Ottieni valore applicazione
  • Ottieni ID comune
  • Ottieni valore comune
  • Rimuovi ID applicazione
  • Imposta ID comune
  • Estrazione del valore

Per altri dettagli su questi functiods, vedere Il riferimento functoid nelle linee guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi dell'API per sviluppatori.

Vedere anche