Dépanner le connecteur Workiva

info

Bêta

Cette fonctionnalité est en version bêta. Les administrateurs de Workspace peuvent contrôler l’accès à cette fonctionnalité depuis la page Aperçus . Consultez Gérer les aperçus Databricks.

Cette page décrit les erreurs courantes que vous pourriez rencontrer avec le connecteur Workiva géré et comment les résoudre.

Il manque une portée requise aux identifiants Workiva

Cause : Workiva a renvoyé une réponse HTTP 403 car l'application OAuth2 n'est pas autorisée pour la ressource demandée. Le connecteur traite ceci comme une erreur de configuration et fait échouer le pipeline. Une cause fréquente est une application à laquelle il manque l’étendue activity:read (requise pour activities) ou l’étendue organization:read (requise pour users et roles).

Solutions:

1. Dans votre organisation Workiva, confirmez que l’application OAuth2 dispose des deux portées activity:read et organization:read.
2. Si vous ajoutez un scope, générez des identifiants mis à jour si nécessaire, puis mettez à jour la connexion au Unity Catalog avec les nouveaux Client ID et Client Secret .
3. Exécutez à nouveau le pipeline.

Pour plus de détails, consultez Configurer l'authentification auprès de Workiva.

Jeton d’accès Workiva rejeté

Cause : Workiva a renvoyé une réponse HTTP 401. Le jeton d'accès a expiré ou les identifiants client sont incorrects. Le connecteur effectue automatiquement un refresh du jeton et réessaie une fois ; si la nouvelle tentative échoue toujours, le pipeline échoue avec une erreur d'identifiants non valides.

Solutions:

1. Confirmez que l’ ID client et le secret client dans la connexion Unity Catalog correspondent à une application OAuth2 Workiva actuelle et active.
2. Confirmez que l' Organization ID dans la connexion Unity Catalog correspond à votre organisation Workiva.
3. Si les identifiants sont incorrects ou révoqués, créez de nouveaux identifiants dans Workiva, mettez à jour la connexion et exécutez à nouveau le pipeline.

Pour plus de détails, consultez Configurer l'authentification auprès de Workiva.

Limite de débit de l’API Workiva dépassée

Cause : Workiva a renvoyé une réponse HTTP 429 car le taux de requêtes a dépassé la limite de l'API.

Solutions:

Le connecteur respecte l’en-tête de réponse Retry-After, puis revient à une interruption exponentielle et effectue des tentatives automatiquement. Si cela se produit de manière répétée, réduisez la fréquence de planification du pipeline ou le nombre de pipelines simultanés qui partagent la même application Workiva OAuth2.

API Workiva temporairement indisponible

Cause : Workiva a renvoyé une erreur de serveur temporaire (HTTP 500, 502, 503 ou 504).

Solutions:

Le connecteur effectue automatiquement des tentatives avec un intervalle exponentiel. Si le problème persiste, patientez, puis exécutez à nouveau le pipeline.