Utilisation d'un fichier d'options lors de l'importation d'un service WSDL

Modifier en ligne

Lorsque vous créez une définition d'API ou que vous ajoutez un service WSDL cible à une définition d'API en important un fichier .zip, vous pouvez spécifier des instructions supplémentaires en incluant le fichier d'options dans le fichier .zip.

Vous pouvez utiliser un fichier d'options lors de l'importation d'un fichier .zip quand vous effectuez l'une des tâches suivantes :

Création d'une API proxy REST; voir Création d'une API proxy REST à partir d'un service WSDL existant.
Création d'une API proxy SOAP; voir Création d'une API proxy SOAP à partir d'un service WSDL existant.
Ajout d'un service WSDL cible à une définition d'API ; voir Edition d'une définition d'API.

Le fichier d'options est un fichier YAML, qui doit s'appeler apiconnect.yaml.

Vous pouvez inclure les zones suivantes dans le fichier :

Tableau 1. Champs pouvant être inclus dans le apiconnect.yaml fichier
Nom de zone	Valeur	Par défaut	Descriptif
`suppressExamples`	`true` ou `false`	`false`	Supprime la génération automatique des exemples.
`wssecurity`	`true` ou `false`	`true`	Permet la génération de définitions pour les en-têtes WS-Security.
`implicitHeaderFiles`	Tableau des emplacements de fichier XSD		Fichiers de schéma supplémentaires, non référencés dans le WSDL, qui sont utilisés pour définir des en-têtes SOAP supplémentaires.
`port`	Attribut `name` pour un `wsdl:port` dans une définition `wsdl:service` .		Crée l'API à l'aide des informations relatives au port indiqué. Si le port indiqué n'existe pas ou fait référence à un port REST/XML plutôt qu'à un port SOAP, la création de l'API échoue. Si aucun `port` champ n'est présent dans le fichier d'options, API Connect le programme crée l'API en utilisant le premier port SOAP qu'il trouve dans la `wsdl:service` définition.

Exemple

suppressExamples: true
wssecurity: false
implicitHeaderFiles:
  - xsdDir/schema1.xsd
  - xsdDir/schema2.xsd