Metodo UpdateEx
Viene utilizzato per aggiornare le proprietà basate sui parametri delle chiavi di input (key1, key2, … keyn). Quando si usa UpdateEx
, non è possibile eliminare elementi in una raccolta. Un metodo distinto facilita l'eliminazione. Per altre informazioni, vedere Metodo DeleteOnly.
UpdateEx (key1, key2, ... keyn, correctionMode, interactiveMode,
properties)
Parametro | Descrizione |
---|---|
key |
Set di parametri che deve essere presente nel database del server. In caso contrario si verifica un errore. Queste chiavi corrispondono al set di chiavi Get definito per la particolare interfaccia componente. |
correctionMode |
Flag booleano. Quando è impostato su true, consente modifiche alle interfacce componenti contenenti elementi con data di validità mediante l'aggiornamento dei valori dei campi oppure mediante l'inserimento di nuovi elementi in un insieme. In particolare, consente di modificare gli elementi con EFFDT precedente rispetto alla data di validità corrente. Se questo flag non è impostato su TRUE, qualunque modifica a questi elementi determina la restituzione di un errore dal server PeopleSoft. L'argomento correctionMode è esposto solo per tali interfacce componente che contengono elementi datati effettivi. In caso contrario non viene visualizzato come parte dell'argomento.È consigliabile evitare l'impostazione correctionMode su TRUE in un ambiente di produzione. Questo è anche il consiglio di PeopleSoft. Gli eventi già verificatisi come determinato dalla chiave EFFDT precedente non devono essere modificati. Questo approccio consente la creazione di un itinerario di controllo. Il correctionMode flag in UpdateEx consente di ignorare questo meccanismo di sicurezza. La procedura ottimale consiste nel disattivare gli eventi trascorsi mediante l'impostazione di un campo nell'elemento e l'aggiunta (anziché l'eliminazione) dell'elemento aggiornato. |
interactiveMode |
Flag utilizzato per la gestione degli errori. Quando si accede alle proprietà in un'interfaccia componente, l'adapter 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. Fornisce interactiveMode prestazioni massime e fornisce report di errori a livello di aggiornamento del campo. Per usare correttamente questa funzionalità, è consigliabile effettuare chiamate normali con interactiveMode impostato su FALSE. Tale impostazione non influisce sulle prestazioni. Se viene restituito un errore, la stessa chiamata può essere riprovata con il interactiveMode flag impostato su TRUE. Quando la chiamata ha esito negativo, il server restituisce un messaggio di errore più preciso. |
Quando si chiama questa funzione, le proprietà del record corrispondenti alle chiavi vengono sostituite dalle proprietà del parametro di input. Tutti gli insiemi con i record originali vengono eliminati e sostituiti con quelli del parametro di input. Le dimensioni di queste raccolte non devono corrispondere alla procedura all'interno consiste nell'eliminare UpdateEx
tutti gli elementi della raccolta esistenti e quindi inserire quelli specificati.
Se nelle proprietà dell'interfaccia componente sono presenti elementi con data di validità, è necessario che il parametro relativo alle proprietà contenga tutti gli elementi con data di validità futuri, in quanto l'elenco originale viene sostituito. Questa impostazione fornisce un meccanismo per aggiungere ed eliminare gli elementi con data di validità futuri, tuttavia se nelle proprietà sono presenti anche elementi con data di validità passati, verrà restituito un errore poiché questi ultimi elementi non possono essere modificati. Se viene incluso anche l'elemento con data di validità corrente, verrà ignorato. In questo modo il client può chiamare Get()
con il getHistoryItems
parametro impostato su False e modificare eventuali elementi datati effettivi futuri o aggiungere nuovi elementi datati effettivi futuri e passare la struttura come parametro per la UpdateEx()
funzione.
Se l'interfaccia del componente non dispone di una chiave, come nel caso in cui esista solo un'istanza, il UpdateEx()
metodo ha il modulo:
UpdateEx(correctionMode, interactiveMode, properties)
Nota
Il metodo BizTalk Adapter for PeopleSoft Enterprise UpdateEx()
viene fornito se sono abilitate le funzioni PeopleSoft Get
e Save
le funzioni nell'interfaccia del componente.