Functoid database

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

Informazioni generali

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

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

    • Valore di ricerca

    • Stringa di connessione del database

    • Un nome di tabella

    • Nome di colonna per il valore di ricerca.

  • Errore restituito. 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 .

  • Formattare il messaggio. Restituisce una stringa formattata e localizzata utilizzando la sostituzione degli argomenti e, potenzialmente, l'ID e il riferimento tra valori.

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

  • Ottiene il valore dell'applicazione. Recupera un valore dell'applicazione.

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

  • Ottiene un 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.

  • Estrattore di valori. 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 dei 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 convertono ID e valori da 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 informazioni di riferimento sugli spazi dei nomi delle API per sviluppatori e indicazioni sull'interfaccia utente.

Esempio

Nell'esempio seguente vengono utilizzati alcuni functoid database . Si consideri un grande produttore di vendita al dettaglio con negozi distribuiti in una grande 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 regolarmente ai partner commerciali. Per il produttore, tutti gli acquisti vengono effettuati dalla sede centrale, non dai negozi. Quando la sede centrale invia un ordine di acquisto ai partner commerciali, è comune che più negozi ricevano merci ordinate 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 le informazioni sul nome e l'indirizzo nella notifica di spedizione avanzata, il partner commerciale utilizza i functoid Database per inserire automaticamente queste informazioni nel messaggio di istanza di output. La figura seguente mostra come un partner commerciale può implementare la sostituzione di StoreID in una mappa.

    Mappa che mostra functoid di database diversi.

    Nella figura lo schema di origine rappresenta un ordine di acquisto in ingresso; lo schema di destinazione rappresenta un avviso di spedizione avanzato. Il functoid Ricerca database trova il record appropriato dalla tabella di database appropriata. I functoid Value Extractor 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 ricavato 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 . È possibile creare collegamenti dallo schema di origine per fornire valori per tutti e quattro i parametri di input.

Annotazioni

  • 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 Estrattore valore estrae i dati solo dal primo record.

  • Usare l'autenticazione NT nelle stringhe di connessione per proteggere le password con crittografia.

Functoid disponibili

I functoid database sono:

  • Ricerca database
  • Errore restituito
  • Formato messaggio
  • Ottenere l'ID applicazione
  • Ottenere il valore dell'applicazione
  • Ottenere l'ID comune
  • Ottenere un valore comune
  • Rimuovere l'ID applicazione
  • Impostare l'ID comune
  • Estrattore di valori

Per altri dettagli su questi functiods, vedere le informazioni di riferimento sul functoid nelle informazioni di riferimento sullo spazio dei nomi delle API per sviluppatori e indicazioni sull'interfaccia utente.

Vedere anche

  • Last updated on