Questions générales
Question : Où puis-je trouver toutes les informations relatives aux services web ?
Réponse:
- Documentation sur les services web
- Documentation des modules universels (liste des types de services Web et autres)
- Page générale du développeur (si le service Web doit accéder à notre API ou créer des URL DocuWare)
- Page du développeur pour les services Web SOAP
Question : Comment enregistrer un service Web dans DocuWare ?
Réponse : Consultez le document KBA-36514.
Question : Quelles sont les conditions requises pour connecter un service Web à DocuWare Cloud ?
Réponse : Le service Web doit disposer d'une adresse IP publique. Il doit également disposer d'un FQDN public et d'un protocole HTTPS (TLS 1.2).
DocuWare Cloud doit être déverrouillé dans le pare-feu du service Web.
Pour plus d'informations, consultez le document KBA-36612.
Question : Comment puis-je déverrouiller DocuWare Cloud à partir du pare-feu du service Web ?
Réponse : Consultez KBA-36612.
Question : Comment activer une connexion HTTPS fonctionnelle ?
Réponse : Consultez le document KBA-36222.
Question : Comment puis-je tester l'accès à l'API sans rendre le service web public ?
Réponse : Veuillez utiliser nos VM de présentation, disponibles pour les partenaires, et expédier un système DocuWare sur site (démo).
Question : Comment puis-je envoyer un fichier dans le service Web ?
Réponse : Modifiez le service Web de manière à ce qu'il comporte un paramètre pour l'ID du document. Une fois qu'il a reçu l'ID du document, il doit accéder à l'API DocuWare et télécharger le document. Il n'est pas possible de télécharger un fichier dans le service Web directement via le flux de travail.
Si vous n'avez besoin que du document sous forme de fichier, vous pouvez envisager de l'envoyer par le biais d'une activité de courrier électronique.
Question : Quels types de services web le Workflow supporte-t-il ?
Réponse : Il supporte les services web de type REST et SOAP. Pour les deux, vous devez répondre à certaines exigences, afin que le service web soit compatible.
Pour plus d'informations, consultez le KBA-36669.
Questions relatives à REST
Question : Comment créer un service Web REST?
Réponse : Tout d'abord, il vous faut au moins DocuWare 7.5. Il existe différents cadres et modèles pour cela. Il n'y a pas d'exemple de DocuWare, mais assurez-vous que DocuWare prend en charge toutes les fonctionnalités obligatoires du service (voir ci-dessous).
Question : Quelles sont les fonctionnalités du service Web REST pris en charge ?
Réponse : Il peut envoyer une requête HTTP avec JSON ou XML, vous pouvez modifier les méthodes HTTP GET, PUT, POST et DELETE.
Vous pouvez également définir l'itinéraire URL, les paramètres de requête, les en-têtes HTTP, remplir le corps de la requête HTTP avec des variables et des champs d'index, affecter le corps de la réponse HTTP à des variables et des champs d'index.
Il dispose d'une option permettant de choisir librement les codes HTTP (outre 200/OK) qui constituent une réponse OK et de les affecter également à des variables.
Il ne peut pas enregistrer les cookies et autres en-têtes de réponse, il n'est donc pas possible d'appeler l'API DocuWare directement via l'activité.
Si vous souhaitez utiliser REST pour accéder à l'API DocuWare, vous devez créer votre propre service Web et appeler l'API dans son code ou utiliser les connecteurs iPaaS.
Pour plus d'informations, consultez KBA-36968.
Questions relatives à SOAP
Question : Quel type ou exemple dois-je utiliser pour SOAP?
Réponse : Nous recommandons fortement d'utiliser le même type de projet que nos exemples, car tous les services SOAP ne sont pas compatibles.
Si vous souhaitez créer un tel service dans Visual Studio, créez un nouveau projet de type "ASP.NET Web Application", ajoutez > new element (choisissez web service (ASMX)). Dans le fichier ...asmx.cs, chaque méthode web doit avoir la balise [WebMethod].
Pour plus d'informations, consultez la page du développeur sur les services web SOAP.
Question : Quelle est la différence entre les services Web SOAP et les services Web REST dans DocuWare ?
Réponse : Au lieu de formater et de coder vous-même la charge utile XML ou JSON du service Web, vous pouvez affecter des variables à chaque paramètre à l'aide de listes déroulantes.
Cette solution n'est pas aussi souple que REST, mais elle est plus facile à mettre en œuvre dans le flux de travail, car elle offre moins d'options à configurer. Pour plus d'informations, consultez la page Développeur pour les services web SOAP.
Question : Quels types de variables sont autorisés pour les servicesweb SOAP ?
Réponse : Utilisez uniquement les types de variables pris en charge en tant que paramètres : bool, int, string, DateTime et decimal.
Pour le retour, utilisez une variable avec des types pris en charge ou une classe avec des propriétés de types pris en charge. Ici, il peut être utile de vérifier le retour de la méthode [WebMethod] CurrentDocuWareVersion() de notre exemple de service web. Pour plus d'informations, consultez KBA-36451.
Question : Comment publier un service web SOAP dans IIS ?
Réponse : Consultez KBA-36232 et la page du développeur pour les services web SOAP (recherchez les instructions de publication des services web).
Question : Comment utiliser l'authentification pour mon service web SOAP?
Réponse : Consultez le document KBA-36262.
Le KBA s'applique aussi bien aux organisations en nuage qu'aux organisations sur site.
Veuillez noter : Cet article est une traduction de l'anglais. Les informations contenues dans cet article sont basées sur la ou les versions originales des produits en langue anglaise. Il peut y avoir des erreurs mineures, notamment dans la grammaire utilisée dans la version traduite de nos articles. Bien que nous ne puissions pas garantir l'exactitude complète de la traduction, dans la plupart des cas, vous la trouverez suffisamment informative. En cas de doute, veuillez revenir à la version anglaise de cet article.
