Modifications de l'API SOAP par version

Cette rubrique identifie les modifications apportées à l'API SOAP de Unica Campaign pour les clients qui l'utilisent. Si vous avez effectué la mise à niveau depuis une version antérieure, vérifiez les informations suivantes pour déterminer si vous devez modifier le code de l'application.

Gestion des versions et compatibilité amont

Les prochaines versions de l'API Campaign Services sont compatibles avec les versions antérieures, avec toutes les éditions mineures et de maintenance qui partagent un numéro de version majeure. Cependant, se réserve le droit de rompre la compatibilité avec la version antérieure pour les éditions majeures x.0.

Le numéro de version majeure de l'API est incrémenté si les modifications suivantes sont effectuées :
  • changement de l'interprétation des données ;
  • changement de la logique applicative, c'est-à-dire la fonctionnalité de la méthode service ;
  • changement des paramètres de méthode et/ou des types de retour.
Le numéro d'édition de cette API est incrémenté si l'une des modifications ci-après est apportée.
  • ajout d'une nouvelle méthode ;
  • nouveau type de données ajouté, et son utilisation limitée aux nouvelles méthodes ;
  • ajout d'un nouveau type à un type énuméré ;
  • définition d'une nouvelle version d'interface.

continue de prendre en charge le fichier WSDL publié, le client SOAP et la version d'Apache Axis utilisée pour implémenter l'offre SOAP au moins jusqu'à la prochaine édition majeure de . D'un point de vue pratique, cela est réalisé en prenant en charge simultanément plusieurs services Web de version. ( prend déjà en charge plusieurs versions de ce service en interne.)

Modification dans v9.1.2

Aucune modification de l'API dans la version 9.1.2.

Remarque : Une API REST a été introduite dans la version 9.1.2, en plus de l'API SOAP décrite dans ce guide. L'API REST est décrite séparément.

Modification dans v9.1.1

stopFlowchart contient un nouveau paramètre d'entrée, runId, pour prendre en charge un environnement de programmes d'écoute en grappe.

Modification dans v9.1

Aucune modification d'API dans la version 9.1.

Modification dans v9.0

Aucune modification d'API dans la version 9.0.

Modification dans v8.6

Modifications d'API dans v8.6 :

  • Le moteur SOAP a été mis à niveau de la version AXIS 1.4.1 vers la version AXIS2 1.5.2.
  • Le fichier WSDL a été restructuré pour traiter les problèmes de gestion des paramètres requis et facultatifs.
  • Le fichier .jar d'API Client a été modifié suite aux modifications WSDL. Ainsi, les modules de remplacement et les classes générés sont modifiés. Les paramètres de la méthode API Client n'ont pas été modifiés, mais les constructeurs des objets de valeur pris en charge ont été modifiés pour l'utilisation du convertisseur AXIS2 WSDL2Java.
  • L'URL de service Web pointe vers :

    http://<host>:<port>/Campaign/services/CampaignServices30Service

    et le fichier WSDL correspondant est récupéré à l'adresse :

    http://<host>:<port>/Campaign/services/CampaignServices30Service?wsdl

Si vous effectuez une mise à niveau vers Unica Campaign version 8.6 ou une version suivante et que vous utilisez l'API Unica Campaign Services, vous devez modifier le code de l'application.

Selon que vous utilisez l'API client ou le fichier WSDL, voir les sections suivantes pour plus d'informations :