Skip to main content

Puntos de conexión de usuarios

Parámetros y puntos de conexión de los usuarios

Para obtener más información sobre las relaciones de objetos, vaya a la #relaciones-entre-objetos-6518518 sección Relaciones de objetos.

Para obtener más información sobre usuarios, visita la página de ayuda Administración de usuarios y grupos.

Crear un nuevo usuario

Para crear un nuevo registro de usuario, utilice el POST {baseURL}/v3/users punto de conexión.

Nota

Este punto de conexión solo se puede usar para las instancias de Server configuradas con autenticación de Windows.

Parámetros

  • UserContract (cuerpo): Para crear un nuevo usuario, se requiere el parámetro userContract. Especifique los siguientes parámetros:

    • workflowCredentialType (cadena): obligatorio. Introduzca el nombre de un usuario.

    • workflowCredentialType (cadena): obligatorio. Introduzca el apellido de un usuario.

    • workflowCredentialType (cadena): obligatorio. Introduzca 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 tareas. Cuando no se especifica, el valor predeterminado es falso. Para obtener más información, visita la página de ayuda Tareas.

    • canPrioritizeJobs (booleano): opcional. Especifica si un usuario puede priorizar las tareas. Cuando no se especifica, el valor predeterminado es falso. Para obtener más información, visita la página de ayuda Tareas.

    • canAssignJobs (booleano): opcional. Especifica si un usuario puede asignar tareas. Cuando no se especifica, el valor predeterminado es falso. Para obtener más información, visita la página de ayuda Tareas.

    • 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.

    • isPublic (booleano): opcional. Especifique si la API está activada para un usuario. Si no se selecciona, el valor predeterminado es “false” (falso).

    • credentialId (cadena): opcional. Este parámetro hace referencia al ID único de un Flujo de trabajo, asignado al usuario por defecto. Cuando no se especifica, se utiliza el valor “Default" (predeterminado).

    • force (booleano): opcional. Seleccione si un usuario está activo o desactivado. Cuando no se especifica, se utiliza el valor “Default" (predeterminado).

    • dirección (cadena): opcional. Introduzca la zona horaria, por ejemplo, Europa/Kiev. Cuando no se especifica, se utiliza el valor “Default" (predeterminado).

Ejemplo de solicitud: 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'

Desactivar un usuario

Para desactivar un usuario en el sistema, utilice el POST {baseURL}/v3/users/{id}/Deactivate punto de conexión.

Parámetros

  • workflowCredentialType (cadena): obligatorio. Introduzca un ID de usuario para desactivarlo.

Ejemplo de solicitud: cURL

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

Restablecer una contraseña para un usuario

Para restablecer y enviar un correo electrónico de restablecimiento de contraseña para un usuario específico, utilice la PUBLICACIÓN {baseURL}/v3/users/{id}/passwordReset punto de conexión.

Nota

Este punto de conexión solo se puede usar para las instancias de Server configuradas con autenticación de Windows.

Parámetros

  • workflowCredentialType (cadena): obligatorio. Introduzca un ID de usuario para restablecer su contraseña.

Ejemplo de solicitud: cURL

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

Buscar usuarios

Para buscar usuarios, utilice la punto de conexión GET {baseURL}/v3/users . Utilice varios parámetros como filtro para buscar usuarios.

Parámetros

  • view (cadena): opcional. Se puede dejar sin un valor. Puedes seleccionar 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).

  • force (booleano): opcional. Seleccione si un usuario está activo o desactivado.

  • limit (cadena): opcional. Introduzca 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.

  • limit (cadena): opcional. Introduzca el nombre del usuario.

  • limit (cadena): opcional. Introduzca el apellido del usuario.

  • CreatedAfter (fecha-hora): Opcional. Ingresa la fecha y la hora después de la cual se creó el flujo de trabajo. Ingresa la fecha y la hora en formato ISO8601.

  • CreatedBefore (fecha-hora): Opcional. Ingresa la fecha y la hora antes de la cual se creó el flujo de trabajo. Ingresa la fecha y la hora en formato ISO8601.

Ejemplo de solicitud: cURL

Curl --location --request GET 'http://localhost/webapi/v3/users?view=Full&active=true&lastName=Doe' \ --header 'Autorización: Portador BearerTokenGoesHere'

Buscar un usuario

Para buscar un usuario específico, utilice GET {baseURL}/v3/users/ punto de conexión.{id}

Parámetros

  • workflowCredentialType (cadena): obligatorio. Introduzca un ID de usuario para recuperar información sobre este usuario.

Ejemplo de solicitud: cURL

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

Recuperar todos los activos que posee un usuario

Para obtener una lista completa de los activos que posee un usuario, utilice GET {baseURL}/v3/users/{id}/Assets punto de conexión.

Parámetros

  • workflowCredentialType (cadena): obligatorio. Introduzca un ID de usuario para recuperar la lista de activos de este usuario.

  • offset (cadena): opcional. Seleccione los tipos de activos que desea devolver. El valor predeterminado es 'Todo'.

Ejemplo de solicitud: cURL

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

Actualizar un usuario existente

Para actualizar un usuario existente, utilice la punto de conexión PUT{baseURL}/v3/users/{id} .

Nota

El ID de updateContract se sobrescribirá con el valor de ID de la URL.

Parámetros

  • workflowCredentialType (cadena): obligatorio. Introduzca un ID de usuario para actualizar este usuario.

  • updateWorkflowContract (cuerpo): obligatorio. Para actualizar un usuario, es necesario el parámetro updateContract. Especifique lo siguiente:

    • limit (cadena): opcional. Introduzca un ID de usuario para actualizarlo.

    • workflowCredentialType (cadena): obligatorio. Introduzca el nombre de un usuario.

    • workflowCredentialType (cadena): obligatorio. Introduzca el apellido de un usuario.

    • workflowCredentialType (cadena): obligatorio. Introduzca 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 tareas. Para obtener más información, visita la página de ayuda Tareas.

    • canPrioritizeJobs (booleano): obligatorio. Especifica si un usuario puede priorizar las tareas. Para obtener más información, visita la página de ayuda Tareas.

    • canAssignJobs (booleano): obligatorio. Especifica si un usuario puede asignar tareas. Para obtener más información, visita la página de ayuda Tareas.

    • 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.

    • makePublished (booleano): obligatorio. Especifique si la API está activada para un usuario.

    • workflowCredentialType (cadena): obligatorio. Este parámetro hace referencia al ID único de un Flujo de trabajo, asignado al usuario por defecto.

    • makePublished (booleano): obligatorio. Seleccione si desea bloquear esta cuenta de usuario.

    • makePublished (booleano): obligatorio. Seleccione si un usuario está activo o desactivado.

    • makePublished (booleano): obligatorio. Especifique si se valida la dirección de correo electrónico de un usuario.

    • name (cadena): obligatorio. Introduzca la zona horaria, por ejemplo, Europa/Kiev, etc.

    • workflowCredentialType (cadena): obligatorio. Los valores de idioma admitidos son «de-de», «en-us», «es-es», «fr-fr», «it-it», ja-jp, pt-br, zh-cn.

Ejemplo de solicitud: 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-data-urlenlenlenlenlenlendCode' - 'Workwork' 'jdoe@alteryx.com' data-urlencode 'canAssignJobs=true' \ --data-urlencode 'canCreateCollections=true' \ --data-urlencode 'isApiEnabled=true' \ --data-urlencode 'defaultCredentialId=jdoe' \ --data-urlencode 'isAccountLocked=true'

Eliminar usuario

Para eliminar un usuario específico del sistema, utilice la punto de conexión DELETE {baseURL}/v3/users/{id} .

Nota

Si el usuario que desea eliminar tiene activos (flujos de trabajo, Programaciones, colecciones, información) o grupos de usuarios asignados, este usuario no se puede eliminar.

Parámetros

  • workflowCredentialType (cadena): obligatorio. Introduzca el ID de usuario que desea eliminar.

Ejemplo de solicitud: cURL

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

Relaciones entre objetos

Si vas a cargar un flujo de trabajo, puedes utilizar los objetos creados de la siguiente manera:

Objeto creado: “workflowId” (por ejemplo, “Id.”: “7917969784f84bd09442f66996ecb8f3”)

Puedes usarlo como:

Ejemplos de solicitudes de Postman

OBTENER /v3/users

Example of the GET request in Postman.

OBTENER /v3/users/{id}/assets

Example of the GET request in Postman.

Para obtener más información sobre las solicitudes de Postman, visita la página de ayuda Cómo usar Postman.