Metodo CreateEx
Crea un nuovo record utilizzando un insieme di chiavi univoche e proprietà specificate.
CreateEx
(key1, key2, ..., keyn, interactiveMode, properties)
Parametro | Descrizione |
---|---|
Key in/out parameter |
Singoli parametri di chiave (chiave1, chiave2, ... chiaven) che devono essere specificati. Questo insieme di chiavi non deve esistere nel database server, ovvero le chiavi devono essere univoche. Queste chiavi corrispondono al set di chiavi CreateEx definito per la particolare interfaccia componente. |
interactiveMode |
Gestione errori. Quando si accede alle proprietà in un'interfaccia componente, l'adapter Microsoft BizTalk per PeopleSoft Enterprise utilizza le API fornite da PeopleSoft, che leggono e scrivono singoli campi nell'interfaccia componente. Tali modifiche, tuttavia, non vengono propagate al server PeopleSoft una alla volta. Al contrario, psjoa.jar (con cui interagisce l'adapter BizTalk per PeopleSoft Enterprise) crea un pacchetto con tutte le modifiche e le invia al server in un pacchetto. Se un singolo aggiornamento non riesce, viene restituito un errore generico in cui non è indicato l'errore effettivo. Quando la modalità interattiva è impostata su TRUE, ogni aggiornamento dei campi viene inviato al server singolarmente. Tale operazione influisce notevolmente sulle prestazioni, tuttavia fornisce informazioni specifiche sull'errore in caso di mancato aggiornamento, ad esempio se viene utilizzato un valore non valido per impostare un campo. Il parametro interactiveMode garantisce prestazioni ottimali e fornisce la segnalazione errori a livello di aggiornamento di campo. Per utilizzare questa funzionalità in modo appropriato, è consigliabile effettuare le chiamate normali con il parametro interactiveMode impostato su FALSE. Tale impostazione non influisce sulle prestazioni. Se viene restituito un errore, è possibile riprovare la stessa chiamata con il flag interactiveMode impostato su TRUE. Quando la chiamata ha esito negativo, il server restituisce un messaggio di errore più preciso. |
properties |
Struttura che contiene tutte le proprietà dell'interfaccia del componente. Quando viene chiamato il CreateEx metodo, queste proprietà vengono inserite nel record creato con le chiavi specificate. |
In alcune situazioni, è comune chiamare CreateEx()
senza un set di chiavi esplicite, ma la CreateEx
funzione restituisce le chiavi. Questo comportamento è supportato da PeopleCode, che viene attivato sul server. Per creare ad esempio un ordine d'acquisto, è possibile che il client non conosca il successivo numero di ordine d'acquisto disponibile. Specificando NEXT come chiave per il numero di ordine d'acquisto, la chiamata attiva PeopleCode, che determina il successivo numero di ordine d'acquisto disponibile. Queste informazioni devono essere restituite al client chiamante mediante parametri delle chiavi di input/output.
Nota
Per il funzionamento di questo meccanismo, la chiave deve essere anche una proprietà a livello 0. In caso contrario, viene restituita la chiave originale.
Il metodo BizTalk Adapter for PeopleSoft Enterprise CreateEx()
viene fornito se le funzioni PeopleSoft Create e Save nell'interfaccia del componente sono abilitate.