Leggere in inglese

Condividi tramite


Metodo DeleteOnly

Consente di eliminare elementi in un insieme.

Sintassi

DeleteOnly(key1, key2, ..., keyn, correctionMode, interactiveMode,  
    properties)  

Parametri

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.

Commenti

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

Vedere anche

Appendice A: Metodi dell'interfaccia componente