Skip to main content

Points de terminaison de l'utilisateur

Points de terminaison et paramètres d'utilisateurs

Pour en savoir plus sur les relations d'objets, consultez la section Relations d'objets .

Pour plus d'informations sur les utilisateurs, consultez la page d'aide Gestion des utilisateurs et des groupes .

Créer un utilisateur

Pour créer un nouvel enregistrement d'utilisateur, utilisez le point de terminaison POST {baseURL}/v3/users .

Note

Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.

Ce point de terminaison ne peut pas être utilisé pour les instances de Server configurées pour l'authentification Windows.

Paramètres

  • userContract (corps) : pour créer un nouvel utilisateur, le paramètre « userContract » est obligatoire. Indiquez les paramètres suivants :

    • firstName (chaîne) : obligatoire. Saisissez le prénom d'un utilisateur.

    • lastName (chaîne) : obligatoire. Saisissez le nom de famille d'un utilisateur.

    • email (chaîne) : obligatoire. Saisissez l'adresse e-mail d'un utilisateur.

    • role (chaîne) : facultatif. Vous pouvez choisir parmi ces options : NoAccess, Viewer, Member, Artisan, Curator et Evaluated (rôle par défaut évalué à l'exécution). Pour plus d'informations sur les rôles et les autorisations, consultez la page Rôles et autorisations des utilisateurs . Lorsqu'aucun rôle n'est sélectionné, le rôle Evaluated est utilisé par défaut.

    • defaultWorkerTag (chaîne) : facultatif. Indiquez la balise worker définie dans les workers pour attribuer des tâches à certains nœuds worker. Si elle n'est pas précisée, la valeur par défaut est définie sur "". Pour plus d'informations, consultez la page d'aide Worker.

    • canScheduleJobs (booléen) : facultatif. Indiquez si l'utilisateur peut planifier des tâches. Lorsque cela n'est pas précisé, la valeur par défaut est définie sur « faux ». Pour plus d'informations, consultez la page d'aide Tâches .

    • canPrioritizeJobs (booléen) : facultatif. Indiquez si un utilisateur peut hiérarchiser des tâches. Lorsque cela n'est pas précisé, la valeur par défaut est définie sur « faux ». Pour plus d'informations, consultez la page d'aide Tâches .

    • canAssignJobs (booléen) : facultatif. Indiquez si un utilisateur peut affecter des tâches. Lorsque cela n'est pas précisé, la valeur par défaut est définie sur « faux ». Pour plus d'informations, consultez la page d'aide Tâches .

    • canCreateCollections (booléen) : facultatif. Indiquez si un utilisateur peut créer de nouvelles collections. Lorsque cela n'est pas précisé, la valeur par défaut est définie sur « faux ». Pour plus d'informations, consultez la page d'aide Collections .

    • isApiEnabled (booléen) : facultatif. Indiquez si l'API est activée pour un utilisateur. Lorsque cela n'est pas précisé, la valeur par défaut est définie sur « faux ».

    • defaultCredentialId (chaîne) : facultatif. Ce paramètre fait référence à l'ID unique d'un workflow, attribué par défaut à l'utilisateur. Si elle n'est pas précisée, la valeur par défaut est définie sur "".

    • isActive (booléen) : facultatif. Choisissez d'activer ou non un utilisateur. Lorsqu'elle n'est pas précisée, la valeur par défaut est définie sur « vrai ».

    • timeZone (chaîne) : facultatif. Saisissez le fuseau horaire, par exemple Europe/Kiev. Si elle n'est pas précisée, la valeur par défaut est définie sur "".

Exemple de demande : cURL

curl --location --request POST 'http://localhost/webapi/v3/users' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'firstName=John' \ --data-urlencode 'lastName=Doe' \ --data-urlencode 'email=John.Doe@emailexample.com'

Désactiver un utilisateur

Pour désactiver un utilisateur dans le système, utilisez le point de terminaison POST {baseURL}/v3/users/{userId}/deactivate .

Note

Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.

En réponse, vous obtenez un tableau d'ID de groupe d'utilisateurs desquels l'utilisateur désactivé est retiré.

Paramètres

  • userId (chaîne) : obligatoire. Saisissez un ID d'utilisateur pour désactiver cet utilisateur.

Exemple de demande : cURL

curl --location --request POST 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b/deactivate' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Envoyer un e-mail de réinitialisation du mot de passe à un utilisateur

Pour envoyer un e-mail de réinitialisation du mot de passe à un utilisateur existant, utilisez le point de terminaison POST {baseURL}/v3/users/{userId}/passwordReset .

Note

Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.

Ce point de terminaison ne peut pas être utilisé pour les instances de Server configurées pour les authentifications Windows et SAML.

Paramètres

  • userId (chaîne) : obligatoire. Saisissez un ID d'utilisateur pour envoyer un e-mail de réinitialisation à l'utilisateur.

Exemple de demande : cURL

curl --location --request POST 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b/passwordReset' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Récupérer tous les enregistrements d'utilisateurs

Pour récupérer tous les enregistrements d'utilisateurs accessibles, utilisez le point de terminaison GET {baseURL}/v3/users . Filtrez avec plusieurs paramètres.

Note

Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.

Si le paramètre « searchContract.Verbose » est défini sur « faux », un objet de vue réduite est renvoyé.

Paramètres

  • view (chaîne) : facultatif. Peut être laissé sans valeur. Vous pouvez choisir parmi les valeurs suivantes : « Default » et « Full ». Si ce paramètre est défini sur « Default », un objet de vue réduite est renvoyé. Lorsqu'elle n'est pas spécifiée, la valeur « Default » est utilisée.

  • active (booléen) : facultatif. Choisissez d'activer ou non un utilisateur.

  • email (chaîne) : facultatif. Saisissez l'adresse e-mail de l'utilisateur.

  • role (chaîne) : facultatif. Sélectionnez le rôle d'utilisateur pour affiner la recherche. Choisissez parmi ces options : NoAccess, Viewer, Member, Artisan, Curator et Evaluated. Le rôle par défaut (Evaluated) est évalué lors de l'exécution. Pour plus d'informations sur les rôles et les autorisations, consultez la page Rôles et autorisations des utilisateurs .

  • firstName (chaîne) : facultatif. Saisissez le prénom de l'utilisateur.

  • lastName (chaîne) : facultatif. Saisissez le nom de famille de l'utilisateur.

  • createdAfter (date-heure) : facultatif. Saisissez la date et l'heure après lesquelles l'utilisateur a été créé. Saisissez la date et l'heure au format ISO8601.

  • createdBefore (date-heure) : facultatif. Saisissez la date et l'heure avant lesquelles l'utilisateur a été créé. Saisissez la date et l'heure au format ISO8601.

Exemple de demande : cURL

curl --location --request GET 'http://localhost/webapi/v3/users?view=Full&active=true&lastName=Doe' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Récupérer les détails d'un utilisateur spécifique

Pour récupérer des détails sur un utilisateur existant, utilisez le point de terminaison GET {baseURL}/v3/users/{userId} .

Note

Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.

Paramètres

  • userId (chaîne) : obligatoire. Saisissez un ID d'utilisateur pour récupérer les détails de cet utilisateur.

Exemple de demande : cURL

curl --location --request GET 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Récupérer toutes les ressources dont un utilisateur est propriétaire

Pour obtenir une liste complète des ressources accessibles dont un utilisateur existant est propriétaire, utilisez le point de terminaison GET {baseURL}/v3/users/{userId}/assets .

Note

Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.

Paramètres

  • userId (chaîne) : obligatoire. Saisissez un ID d'utilisateur pour récupérer la liste des ressources de cet utilisateur.

  • assetType (chaîne) : facultatif. Sélectionnez les types de ressources que vous souhaitez renvoyer. La valeur par défaut est définie sur « Toutes ».

Exemple de demande : cURL

curl --location --request GET 'http://localhost/webapi/v3/users/61d564361d6d5da7ad461a32/assets?assetType=Workflows' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Transfer All Assets a User Owns to Another

To transfer all assets (workflows, schedules, and collections) owned by one user to another, use the PUT {baseURL}/v3/users/{userId}/assetTransfer endpoint.

Note

  • Only Curators can use this API endpoint.

  • If any of the workflows require DCM connections, Server connections, or specific run as credentials to run, these items need to be updated before the workflow can run.

  • If users are not in the same studio and when a workflow is transferred to the new studio, all other users in the new owner's studio will also receive access to the workflow, and all users from the old studio will lose access.

  • Workflows can only be transferred to a user with the Artisan or Curator role.

  • If transferring schedules, the new owner must have access to the scheduled workflow, otherwise you won’t be able to transfer that workflow to the new owner.

  • If transferring schedules, the new owner must have permission to schedule workflows.

  • If the user is deleted, it returns a list of schedule Ids that will be broken or disabled after transfer.

Parameters

  • userId (string): Required. Id of the user to transfer assets from.

  • contract (body):

    • ownerId (string): Specify the Id of the user to transfer assets to (new owner).

    • transferWorkflows (Boolean): Specify whether the workflows should be transferred to the new owner.

    • transferSchedules (Boolean): Specify whether the schedules should be transferred to the new owner.

    • transferCollections (Boolean): Specify whether the collections should be transferred to the new owner.

Request Example: cURL

curl -X PUT --header 'Content-Type: application/json' --header 'Accept: application/json' -d '{ \ "ownerId": "63d17f6cb049da66d0afd4e2", \ "transferWorkflows": true, \ "transferSchedules": true, \ "transferCollections": true \ }' 'http://localhost/webapi/v3/users/613a523df9199abfc446d19d/assetTransfer'

Mettre à jour un utilisateur existant

Pour mettre à jour les détails d'un utilisateur existant, utilisez le point de terminaison PUT {baseURL}/v3/users/{userId} .

Note

Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.

L'ID du paramètre « updateContract » sera remplacé par la valeur d'ID dans l'URL.

Paramètres

  • userId (chaîne) : obligatoire. Saisissez un ID d'utilisateur pour mettre cet utilisateur à jour.

  • updateContract (corps) : obligatoire. Pour mettre à jour un utilisateur, le paramètre « updateContract » est obligatoire. Indiquez les éléments suivants :

    • id (chaîne) : facultatif. Saisissez un ID d'utilisateur pour le mettre à jour.

    • firstName (chaîne) : obligatoire. Saisissez le prénom d'un utilisateur.

    • lastName (chaîne) : obligatoire. Saisissez le nom de famille d'un utilisateur.

    • email (chaîne) : obligatoire. Saisissez l'adresse e-mail d'un utilisateur.

    • role (chaîne) : obligatoire. Vous pouvez choisir parmi ces options : NoAccess, Viewer, Member, Artisan, Curator et Evaluated. Pour plus d'informations sur les rôles et les autorisations, consultez la page Rôles et autorisations des utilisateurs .

    • defaultWorkerTag (chaîne) : obligatoire. Indiquez la balise worker définie dans les workers pour attribuer des tâches à certains nœuds worker. Pour plus d'informations à propos des workers, consultez la page d'aide Worker .

    • canScheduleJobs (booléen) : obligatoire. Indiquez si un utilisateur peut planifier des tâches. Pour plus d'informations, consultez la page d'aide Tâches .

    • canPrioritizeJobs (booléen) : obligatoire. Indiquez si un utilisateur peut hiérarchiser des tâches. Pour plus d'informations, consultez la page d'aide Tâches .

    • canAssignJobs (booléen) : obligatoire. Indiquez si un utilisateur peut affecter des tâches. Pour plus d'informations, consultez la page d'aide Tâches .

    • canCreateCollections (booléen) : facultatif. Indiquez si un utilisateur peut créer des collections. Lorsqu'elle n'est pas spécifiée, la valeur reste la même qu'avant. Pour plus d'informations, consultez la page d'aide Collections .

    • isApiEnabled (booléen) : obligatoire. Indiquez si l'API est activée pour un utilisateur.

    • defaultCredentialId (chaîne) : obligatoire. Ce paramètre fait référence à l'ID unique d'un workflow, attribué par défaut à l'utilisateur.

    • isAccountLocked (booléen) : obligatoire. Indiquez si vous souhaitez verrouiller ce compte utilisateur.

    • isActive (booléen) : obligatoire. Choisissez d'activer ou non un utilisateur.

    • isValidated (booléen) : obligatoire. Indiquez si l'adresse e-mail d'un utilisateur est validée.

    • timeZone (chaîne) : obligatoire. Indiquez le fuseau horaire, par exemple Europe/Kiev, etc.

    • language (chaîne) : obligatoire. Les valeurs de langue prises en charge sont les suivantes : « de-de », « en-us », « es-es », « fr-fr », « it-it », « ja-jp », « pt-br » et « zh-cn ».

Exemple de demande : cURL

curl --location --request PUT 'http://localhost/webapi/v3/users/61d564361d6d5da7ad461a32' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --header 'Authorization: Bearer BearerTokenGoesHere' \ --data-urlencode 'firstName=Doe' \ --data-urlencode 'lastName=Jane' \ --data-urlencode 'email=jdoe@alteryx.com' \ --data-urlencode 'role=Artisan' \ --data-urlencode 'defaultWorkerTag=worker' \ --data-urlencode 'canScheduleJobs=true' \ --data-urlencode 'canPrioritizeJobs=true' \ --data-urlencode 'canAssignJobs=true' \ --data-urlencode 'canCreateCollections=true' \ --data-urlencode 'isApiEnabled=true' \ --data-urlencode 'defaultCredentialId=jdoe' \ --data-urlencode 'isAccountLocked=true' \ --data-urlencode 'isActive=true' \ --data-urlencode 'isValidated=true' \ --data-urlencode 'timeZone=Europe/Prague' \ --data-urlencode 'language=en-us' \ --data-urlencode 'id=61d564361d6d5da7ad461a32'

Supprimer un utilisateur

Pour supprimer un utilisateur existant du système, utilisez le point de terminaison DELETE {baseURL}/v3/users/{userId} .

Note

Seuls les administrateurs peuvent utiliser ce point de terminaison d'API.

Si l'utilisateur à supprimer possède des ressources (workflows, planifications, collections ou analyses) ou des groupes d'utilisateurs y sont affectés, vous ne pouvez pas supprimer cet utilisateur.

Paramètres

  • userId (chaîne) : obligatoire. Saisissez l'ID d'utilisateur à supprimer.

Exemple de demande : cURL

curl --location --request DELETE 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b' \ --header 'Authorization: Bearer BearerTokenGoesHere'

Relations d'objets

Si vous créez un utilisateur , vous pouvez utiliser les objets créés comme suit :

Objet créé : «  id  » (par exemple, « id » : « 619158e57e607d0011ac3009 »)

Vous pouvez l'utiliser comme :

Exemples de demandes Postman

GET /v3/users

Example of the GET request in Postman.

GET /v3/users/{id}/assets

Example of the GET request in Postman.

Pour en savoir plus sur les demandes Postman, consultez la page d'aide Comment utiliser Postman .