Metodo DeleteOnly
Consente di eliminare elementi in un insieme.
DeleteOnly(key1, key2, ..., keyn, correctionMode, interactiveMode,
properties)
Parametro | Descrizione |
---|---|
key |
Insieme di parametri che devono essere forniti. Questo set di chiavi deve essere presente nel database del server, altrimenti si verifica un errore. Queste chiavi corrispondono al set di chiavi Get definito per la particolare interfaccia componente. |
correctionMode |
Flag booleano. Se è impostato su true, consente l'eliminazione di elementi con data di validità trascorsa in un insieme. In particolare, consente di eliminare 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. Nota: L'argomento correctionMode viene esposto solo per le interfacce componente che contengono elementi datati effettivi. In caso contrario non viene visualizzato come parte dell'argomento. |
interactiveMode |
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. Il interactiveMode parametro fornisce prestazioni massime e fornisce la segnalazione degli 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, è 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 |
Contiene un sottoinsieme della struttura esistente sul server. Vengono eliminati tutti gli elementi foglia. |
Le proprietà hanno lo stesso tipo di dati dei CreateEx
metodi o UpdateEx
di questa interfaccia componente, ma solo i valori chiave sono importanti. I valori non chiave vengono ignorati. I valori di chiave devono corrispondere a quelli sul server. In caso contrario viene generata un'eccezione.
Di seguito viene illustrato l'utilizzo dei valori di chiave. Se un insieme contiene gli elementi:
item0
item1
item2
item3
Per eliminare item1 e item3, è possibile specificare le chiavi di item1 e item3 nelle proprietà:
item1
item3
Dopo la chiamata, il server dispone degli elementi rimanenti nell'insieme:
item0
item2
Nel secondo esempio vengono visualizzati gli elementi contenenti altri insiemi:
item0
- item0a
item1
item1a
item1b
item1c
item2
item2a
item2b
Per eliminare item1b e tutto item2, è possibile specificare le chiavi per item1b e item2:
item1
- item1b
item2
Fornendo un sottoinsieme vuoto per item2, lo si trasforma in una foglia e l'intero ramo secondario viene eliminato. Dopo la chiamata, il server dispone degli elementi rimanenti:
item0
- item0a
item1
item1a
item1c