Para obtener más información sobre las relaciones entre objetos, ve a la sección Relaciones entre objetos.
Para obtener más información sobre usuarios, visita la página de ayuda Administración de usuarios y grupos.
Para crear un nuevo registro de usuario, utiliza el punto de conexión POST {baseURL}/v3/users.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
Este punto de conexión no se puede usar para las instancias de Server configuradas con autenticación de Windows.
userContract (cuerpo): para crear un nuevo usuario, se requiere el parámetro userContract. Especifica los siguientes parámetros:
firstName (cadena): obligatorio. Ingresa el nombre de un usuario.
lastName (cadena): obligatorio. Ingresa el apellido de un usuario.
email (cadena): obligatorio. Ingresa la dirección de correo electrónico de un usuario.
role (cadena): opcional. Puedes seleccionar entre estas opciones: Sin acceso, Visualizador, Miembro, Creador, Administrador y Evaluado (el rol predeterminado evaluado en el tiempo de ejecución). Para obtener más información acerca de los roles y permisos, visita la página Roles y permisos de usuarios. Cuando no se selecciona ningún rol, el valor predeterminado es el rol Evaluado.
defaultWorkerTag (cadena): opcional. Especifica la etiqueta de trabajador definida en los trabajadores para ayudar a asignar tareas a determinados nodos de trabajadores. Cuando no se especifica, el valor predeterminado es "". Para obtener más información, visita la página de ayuda Trabajador.
canScheduleJobs (booleano): opcional. Especifica si el usuario puede programar trabajos. Cuando no se especifica, el valor predeterminado es falso. Para obtener más información, visita la página de ayuda Trabajos.
canPrioritizeJobs (booleano): opcional. Especifica si un usuario puede priorizar los trabajos. Cuando no se especifica, el valor predeterminado es falso. Para obtener más información, visita la página de ayuda Trabajos.
canAssignJobs (booleano): opcional. Especifica si un usuario puede asignar trabajos. Cuando no se especifica, el valor predeterminado es falso. Para obtener más información, visita la página de ayuda Trabajos.
canCreateCollections (booleano): opcional. Especifica si un usuario puede crear nuevas colecciones. Cuando no se especifica, el valor predeterminado es falso. Para obtener más información, visita la página de ayuda Colecciones.
isApiEnabled (booleano): opcional. Especifica si la API está habilitada para un usuario. Cuando no se especifica, el valor predeterminado es falso.
defaultCredentialId (cadena): opcional. Este parámetro se refiere al ID único de un flujo de trabajo, asignado al usuario como predeterminado. Cuando no se especifica, el valor predeterminado es "".
isActive (booleano): opcional. Selecciona si un usuario está activo o desactivado. Cuando no se especifica, el valor predeterminado es verdadero.
timeZone (cadena): opcional. Ingresa la zona horaria, por ejemplo, Europa/Kiev. Cuando no se especifica, el valor predeterminado es "".
canCreateAndUpdateDcm (booleano): si se establece en “true” (verdadero), permite al usuario crear o actualizar activos de DCM (fuentes de datos, credenciales y almacenes externos). Sin este permiso, los usuarios no pueden crear, editar ni sincronizar activos de DCM desde Designer.
canShareForExecutionDcm (booleano): si se establece en “true” (verdadero), permite al usuario compartir credenciales de conexión de DCM para realizar la ejecución solo en Server.
canShareForCollaborationDcm (booleano): si se establece en “true” (verdadero), permite al usuario compartir credenciales de conexión de DCM para la colaboración.
canManageGenericVaultsDcm (booleano): si se establece en “true” (verdadero), permite al usuario administrar los almacenes genéricos de DCM.
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'
Para desactivar un usuario en el sistema, utiliza el punto de conexión POST {baseURL}/v3/users/{userId}/deactivate.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
Como respuesta, obtienes una matriz de ID de grupo de usuarios de los que se quita el usuario desactivado.
userId (cadena): obligatorio. Ingresa un ID de usuario para desactivar este usuario.
curl --location --request POST 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b/deactivate' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Para enviar un correo electrónico de restablecimiento de contraseña a un usuario existente, utiliza el punto de conexión POST {baseURL}/v3/users/{userId}/passwordReset .
Nota
Solo los administradores pueden usar este punto de conexión de la API.
Este punto de conexión no se puede usar para las instancias de Server configuradas con autenticación de Windows y SAML.
userId (cadena): obligatorio. Ingresa un ID de usuario para enviar un correo electrónico de restablecimiento al usuario.
curl --location --request POST 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b/passwordReset' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Para recuperar todos los registros de usuario accesibles, utiliza el punto de conexión GET {baseURL}/v3/users. Utiliza varios parámetros como filtro.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
Si searchContract.Verbose se establece como falso, entonces se devolverá un objeto de vista reducida.
view (cadena): opcional. Se puede dejar sin un valor. Puedes elegir entre los siguientes valores: “Default” (predeterminado) y “Full” (completo). Si este parámetro se define como “Default" (predeterminado), entonces se devolverá un objeto de vista reducida. Cuando no se especifica, se utiliza el valor “Default" (predeterminado).
active (booleano): opcional. Selecciona si un usuario está activo o desactivado.
email (cadena): opcional. Ingresa la dirección de correo electrónico del usuario.
role (cadena): opcional. Selecciona el rol de usuario para limitar la búsqueda. Selecciona entre estas opciones: Sin acceso, Visualizador, Miembro, Creador, Administrador y Evaluado. El rol predeterminado (Evaluado) se evalúa en el tiempo de ejecución. Para obtener más información acerca de los roles y permisos, visita la página Roles y permisos de usuarios.
firstName (cadena): opcional. Ingresa el nombre del usuario.
lastName (cadena): opcional. Ingresa el apellido del usuario.
createdAfter (fecha y hora): opcional. Ingresa la fecha y la hora después de la cual se creó el usuario. Ingresa la fecha y la hora en formato ISO8601.
createdBefore (fecha y hora): opcional. Ingresa la fecha y la hora antes de la cual se creó el usuario. Ingresa la fecha y la hora en formato ISO8601.
curl --location --request GET 'http://localhost/webapi/v3/users?view=Full&active=true&lastName=Doe' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Para recuperar detalles sobre un usuario existente, utiliza el punto de conexión GET {baseURL}/v3/users/{userId}.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
userId (cadena): obligatorio. Ingresa un ID de usuario para recuperar detalles sobre este usuario.
curl --location --request GET 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Para obtener una lista completa de los activos accesibles que posee un usuario existente, utiliza el punto de conexión GET {baseURL}/v3/users/{userId}/assets.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
userId (cadena): obligatorio. Ingresa un ID de usuario para recuperar la lista de activos de este usuario.
assetType (cadena): opcional. Selecciona los tipos de activos que deseas devolver. De forma predeterminada, se establece en “Todos”.
curl --location --request GET 'http://localhost/webapi/v3/users/61d564361d6d5da7ad461a32/assets?assetType=Workflows' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Para transferir todos los activos (flujos de trabajo, programaciones y colecciones) propiedad de un usuario a otro, utiliza el punto de conexión PUT {baseURL}/v3/users/{userId}/assetTransfer.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
Si alguno de los flujos de trabajo requiere conexiones de DCM, conexiones de Server o credenciales específicas para ejecutarse, estos elementos deben actualizarse antes de que se pueda ejecutar el flujo de trabajo.
Si los usuarios no están en el mismo estudio, cuando se transfiere un flujo de trabajo al nuevo estudio, todos los demás usuarios del estudio del nuevo propietario también recibirán acceso al flujo de trabajo, y todos los usuarios del estudio antiguo perderán el acceso.
Los flujos de trabajo solo se pueden transferir a un usuario con el rol de Creador o Administrador.
Si se transfieren programaciones, el nuevo propietario debe tener acceso al flujo de trabajo programado; de lo contrario, no podrás transferir ese flujo de trabajo al nuevo propietario.
Si transfieres programaciones, el nuevo propietario debe tener permiso para programar flujos de trabajo.
Si se elimina el usuario, devuelve una lista de IDs de programación que se romperán o deshabilitarán después de la transferencia.
userId (cadena): obligatorio. ID del usuario desde el que se transferirán los activos.
contract (cuerpo):
ownerId (cadena): especifica el ID del usuario al que se transferirán los activos (nuevo propietario).
transferWorkflows (Booleano): especifica si los flujos de trabajo deben transferirse al nuevo propietario.
transferSchedules (Booleano): especifica si las programaciones deben transferirse al nuevo propietario.
transferCollections (Booleano): especifica si las colecciones deben transferirse al nuevo propietario.
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'
Para actualizar los detalles de un usuario existente, utiliza el punto de conexión PUT {baseURL}/v3/users/{userId}.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
El ID de updateContract se sobrescribirá por el valor de ID en la URL.
userId (cadena): obligatorio. Ingresa un ID de usuario para que este usuario se actualice.
updateContract (cuerpo): obligatorio. Para actualizar un usuario, se requiere el parámetro updateContract. Especifica lo siguiente:
id (cadena): opcional. Ingresa un ID de usuario para actualizarlo.
firstName (cadena): obligatorio. Ingresa el nombre de un usuario.
lastName (cadena): obligatorio. Ingresa el apellido de un usuario.
email (cadena): obligatorio. Ingresa la dirección de correo electrónico de un usuario.
role (cadena): obligatorio. Puedes seleccionar entre estas opciones: Sin acceso, Visualizador, Miembro, Creador, Administrador y Evaluado. Para obtener más información acerca de los roles y permisos, visita la página Roles y permisos de usuarios.
defaultWorkerTag (cadena): obligatorio. Especifica la etiqueta de trabajador definida en los trabajadores para ayudar a asignar tareas a determinados nodos de trabajadores. Para obtener más información sobre trabajadores, visita la página de ayuda Trabajador.
canScheduleJobs (booleano): obligatorio. Especifica si un usuario puede programar trabajos. Para obtener más información, visita la página de ayuda Trabajos.
canPrioritizeJobs (booleano): obligatorio. Especifica si un usuario puede priorizar los trabajos. Para obtener más información, visita la página de ayuda Trabajos.
canAssignJobs (booleano): obligatorio. Especifica si un usuario puede asignar trabajos. Para obtener más información, visita la página de ayuda Trabajos.
canCreateCollections (booleano): opcional. Especifica si un usuario puede crear colecciones. Cuando no se especifica, el valor permanece igual que antes. Para obtener más información, visita la página de ayuda Colecciones.
isApiEnabled (booleano): obligatorio. Especifica si la API está habilitada para un usuario.
defaultCredentialId (cadena): obligatorio. Este parámetro se refiere al ID único de un flujo de trabajo, asignado al usuario como predeterminado.
isAccountLocked (booleano): obligatorio. Selecciona si deseas bloquear esta cuenta de usuario.
isActive (booleano): obligatorio. Selecciona si un usuario está activo o desactivado.
isValidated (booleano): obligatorio. Especifica si la dirección de correo electrónico de un usuario está validada.
timeZone (cadena): obligatorio. Ingresa la zona horaria, por ejemplo, Europa/Kiev, etc.
language (cadena): obligatorio. Los valores de idioma compatibles son “de-de”, “en-us”, “es-es”, “fr-fr”, “it-it”, “ja-jp”, “pt-br”, “zh-cn”.
canCreateAndUpdateDcm (booleano): si se establece en “true” (verdadero), permite al usuario crear o actualizar activos de DCM (fuentes de datos, credenciales y almacenes externos). Sin este permiso, los usuarios no pueden crear, editar ni sincronizar activos de DCM desde Designer.
canShareForExecutionDcm (booleano): si se establece en “true” (verdadero), permite al usuario compartir credenciales de conexión de DCM para realizar la ejecución solo en Server.
canShareForCollaborationDcm (booleano): si se establece en “true” (verdadero), permite al usuario compartir credenciales de conexión de DCM para la colaboración.
canManageGenericVaultsDcm (booleano): si se establece en “true” (verdadero), permite al usuario administrar los almacenes genéricos de DCM.
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'
Para eliminar un usuario existente del sistema, utiliza el punto de conexión DELETE {baseURL}/v3/users/{userId}.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
Si el usuario que deseas eliminar tiene algún activo (flujos de trabajo, programaciones, colecciones) o grupos de usuarios asignados, entonces este usuario no se puede eliminar.
userId (cadena): obligatorio. Ingresa el ID de usuario que deseas eliminar.
curl --location --request DELETE 'http://localhost/webapi/v3/users/61d57bea3c15317e1a48205b' \ --header 'Authorization: Bearer BearerTokenGoesHere'
Si creas un usuario, puedes utilizar los objetos creados de la siguiente manera:
Objeto creado: “id” (por ejemplo, “id”: “619158e57e607d0011ac3009”)
Puedes usarlo como:
userId si vas a agregar usuarios a un grupo de usuarios.
userId si vas a eliminar usuarios de un grupo de usuarios.
userId si vas a buscar un usuario específico.
ownerId si vas a cargar un flujo de trabajo.
userId si vas a agregar un usuario de una colección.
userId si vas a eliminar un usuario de una colección.
userId si vas a actualizar los permisos de usuario de una colección.
ownerId si vas a buscar una programación.
userId si deseas compartir una credencial con un usuario.
userId si deseas quitar un usuario de una credencial.
userId si deseas agregar un usuario a una conexión de datos existente.
userId si deseas quitar un usuario de una conexión de datos existente.
GET /v3/users
GET /v3/users/{id}/assets
Para obtener más información sobre las solicitudes de Postman, visita la página de ayuda Cómo usar Postman.