DeleteOnly, méthode

Vous permet de supprimer des éléments d’une collection.

Syntaxe

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

Paramètres

Paramètre	Description
key	Ensemble de paramètres qui doivent être fournis. Cet ensemble de clés doit exister dans la base de données du serveur ou une erreur se produit. Ces clés correspondent à l’ensemble de clés Get tel que défini pour l’interface de composant spécifique.
correctionMode	Indicateur booléen. Lorsque la valeur est true, autorise la suppression d’éléments obsolètes antérieurs dans une collection. Plus précisément, il permet la suppression d’éléments qui ont EFFDT avant la date d’effet actuelle. Sans cet indicateur défini sur TRUE, toute modification apportée à ces éléments entraîne une erreur retournée par le serveur PeopleSoft. Note: L’argument correctionMode n’est exposé que pour ces interfaces de composant qui contiennent des éléments obsolètes effectifs. Sinon, il n’est pas affiché dans le cadre de l’argument.
interactiveMode	Utilisé pour la gestion des erreurs. Lors de l’accès aux propriétés d’une interface de composant, l’adaptateur BizTalk pour PeopleSoft Enterprise utilise des API fournies par PeopleSoft, qui lisent et écrivent des champs individuels dans l’interface du composant ; toutefois, ces modifications ne sont pas propagées au serveur PeopleSoft un par un. Au lieu de cela, le psjoa.jar (avec lequel l’adaptateur BizTalk pour PeopleSoft Enterprise interagit) empaquete toutes les modifications et envoie les modifications au serveur dans un seul package. Si l’une des mises à jour individuelles échoue, une erreur générique est retournée, ce qui n’identifie pas l’erreur réelle. Avec le mode interactif défini sur TRUE, chaque mise à jour de champ est envoyée individuellement au serveur. Cela a un impact considérable sur les performances, mais il fournit des informations d’erreur spécifiques si la mise à jour échoue (par exemple, si une valeur non valide est utilisée pour définir un champ). Le interactiveMode paramètre fournit des performances maximales et fournit des rapports d’erreurs au niveau de la mise à jour de champ. Pour utiliser cette fonctionnalité correctement, il est recommandé d’effectuer des appels normaux avec interactiveMode la valeur FALSE. Il ne doit pas y avoir d’impact sur les performances. Si une erreur est retournée, le même appel peut être retenté avec l’indicateur interactiveMode défini sur TRUE. Lorsque l’appel échoue, le serveur retourne un message d’erreur plus précis.
properties	Contient un sous-ensemble de la structure qui existe sur le serveur. Tous les éléments qui sont feuilles sont supprimés.

Remarques

Les propriétés ont le même type de données que les méthodes ou UpdateEx les CreateEx méthodes de cette interface de composant . Toutefois, seules les valeurs de clé sont importantes. Les valeurs non clés sont ignorées. Les valeurs de clé doivent correspondre à celles du serveur, sinon une exception est levée.

L’exemple suivant illustre l’utilisation des valeurs de clé. Si une collection contient les éléments :

• item0

• item1

• item2

• item3

  Vous pouvez supprimer l’élément1 et l’élément3 en fournissant les clés d’élément1 et d’élément3 dans les propriétés :

• item1

• item3

  Après l’appel, le serveur dispose des éléments restants dans la collection :

• item0

• item2

  Le deuxième exemple montre les éléments contenant d’autres collections :

• item0

  • item0a

• item1

  • item1a

  • item1b

  • item1c

• item2

  • item2a

  • item2b

  Vous pouvez supprimer l’élément1b et l’ensemble de l’élément2 en donnant les clés à item1b et élément2 :

• item1

  • item1b

• item2

  En fournissant une sous-collection vide pour l’élément2, vous la transformez en feuille et que toute la sous-branche est supprimée. Après l’appel, le serveur a les éléments restants :

• item0

  • item0a

• item1

  • item1a

  • item1c

Voir aussi

Annexe A : Méthodes d’interface de composant