Vues :

Questions générales

Question : Où puis-je trouver toutes les informations relatives aux services web ?
Réponse :

Question : Comment enregistrer un Web Services dans DocuWare ?
Réponse : Consultez le document KBA-36514.

Question : Quelles sont les conditions obligatoires pour connecter un service Web à DocuWare Cloud ?
Réponse : Le service Web doit disposer d'une adresse IP accessible au public. Il doit également disposer d'un nom de domaine public et d'un protocole HTTPS (TLS 1.2).
Le 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 ?
Answer : Veuillez utiliser nos VM de présentation, elles sont disponibles pour les partenaires et expédient un système DocuWare sur site (Démonstration).

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 workflow.
Si vous n'avez besoin que du document sous forme de fichier, vous pouvez envisager de l'envoyer par courrier électronique.

Question : Quels types de Web Services sont supportés par Workflow ?
Réponse : Il supporte les Web Services 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 supporté ?
Réponse : Il peut envoyer une Request 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, et n'est donc pas Supporté pour 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 quel exemple dois-je utiliser pour SOAP?
Réponse : Nous recommandons vivement 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 pour 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 attribuer des variables à l'aide de listes déroulantes pour chaque paramètre.
Ce n'est pas aussi flexible que REST, mais plus facile à mettre en œuvre dans le flux de travail car il affiche 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 des types de variables Supportés en tant que paramètres : bool, int, string, DateTime et decimal.
Pour le retour, utilisez une variable avec des types Supportés ou une classe avec des propriétés de types Supportés. 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.

Cet article est valable pour les versions DocuWare: 7.5 7.6 7.7 7.8 7.9 | #FAQID_3704 workflow manager web service webservice REST SOAP