Compartir a través de

Teams-Spirit (versión preliminar)

El conector Teams-Spirit permite conectar la suscripción de Teams-Spirit a los flujos.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Immanuel Fuchs
URL https://teams-spirit.de/#kontakt
Correo Electrónico info@digitalteamwork.de
Metadatos del conector
Publicador D.F.K. Digitalteamwork GmbH
Sitio web https://teams-spirit.de
Directiva de privacidad https://teams-spirit.de/datenschutz/
Categorías Comunicación; Productividad

conector de Teams-Spirit

Teams-Spirit proporciona una API REST extensa. Con esta API, puede administrar las aprobaciones, los equipos y los usuarios a través de Teams-Spirit.

Publicador: D.F.K. Digital Teamwork GmbH

Prerrequisitos

Necesitará lo siguiente para continuar:

  • Un plan de Microsoft Power Apps o Power Automate con una característica de conector personalizada
  • Una Teams-Spirit aplicación empresarial de Azure AD (normalmente estará presente si usa Teams-Spirit)
  • Una suscripción de Teams-Spirit
  • Herramientas de la CLI de Power Platform

Operaciones admitidas

El conector proporciona los siguientes desencadenadores:

Action-Trigger

Se puede desencadenar a través de una acción de Teams-Spirit El conector admite las siguientes operaciones:

Obtener todas las aprobaciones

Enumera todas las aprobaciones

Aprueba

Aprueba una aprobación

Rechazar

Rechazar una aprobación

Equipo de archivo

Archiva un equipo y, opcionalmente, marca el sitio de SharePoint de grupos como de solo lectura

Eliminar equipo

Elimina un equipo

Cambiar rol a miembro

Cambia un rol de usuario a miembro

Cambiar rol a propietario

Cambia un rol de usuario al propietario

Quitar todos los invitados

Quita todos los invitados de un equipo

Quitar todos los usuarios excepto el propietario

Quita todos los miembros del equipo, excepto para un propietario determinado.

Quitar usuario del equipo

Quita un usuario de un equipo

Cambiar valor de etiqueta

Cambia el valor de una etiqueta de Teams-Spirit

Obtener valor de etiqueta

Devuelve el valor de una etiqueta de Teams-Spirit

Extender fecha de expiración

Extiende una fecha de expiración de teams

Obtención de credenciales

El conector de Teams-Spirit usa OAuth2 en Azure Active Directory (AD). Este es el mismo método de autenticación que usa la propia aplicación de Teams-Spirit y, por tanto, el usuario tendrá los mismos permisos tanto en el conector como en la aplicación.

Introducción

Si desea que un flujo se desencadene mediante una regla de Teams-Spirit, puede crear un nuevo flujo con el desencadenador de acción. Una vez que le haya dado un nombre, se registrará en Teams-Spirit y estará disponible en el motor de reglas. Puede enviar todos los parámetros disponibles en la regla de Teams-Spirit al flujo y usarlo para automatizar aún más los flujos de trabajo.

Instrucciones de implementación

Dado que la API de Teams-Spirit está protegida por Azure Active Directory (AD) a través de OAuth2, primero es necesario configurar algunas cosas en Azure AD para que nuestros conectores puedan acceder de forma segura a la API. Una vez completado, puede crear y probar el conector.

Configuración de una aplicación de Azure AD para el conector personalizado

En primer lugar, es necesario registrar nuestro conector como una aplicación en Azure AD. Esto permitirá que el conector se identifique en Azure AD para que pueda solicitar permisos para acceder a los datos Teams-Spirit en nombre del usuario final. Puede seguir los pasos siguientes:

  1. Cree una aplicación de Azure AD Esta aplicación de Azure AD se usará para identificar el conector a Teams-Spirit. Esto se puede hacer mediante [Azure Portal] (https://portal.azure.com), siguiendo estos pasos. Una vez creado, anote el valor de Id. de aplicación (cliente). Lo necesitará más adelante.

  2. Configurar (actualizar) la aplicación de Azure AD para acceder a la API de Teams-Spirit Este paso garantizará que la aplicación pueda recuperar correctamente un token de acceso para invocar Teams-Spirit en nombre de los usuarios. Para ello, siga estos pasos.

    • Para el URI de redirección, use "https://global.consent.azure-apim.net/redirect"
    • Para las credenciales, use un secreto de cliente (y no certificados). Recuerde anotar el secreto hacia abajo, necesitará esto más adelante y solo se muestra una vez.
    • En el caso de los permisos de API, agregue el permiso Teams-Spirit access_as_user . Para ello, haga clic en Add a permission, vaya a APIs my organization uses, busque Teams-Spirit y agregue el access_as_user permiso.

En este momento, ahora tenemos una aplicación válida de Azure AD que se puede usar para obtener permisos de los usuarios finales y acceder a Teams-Spirit.

Implementación del conector

{clientId} Reemplace primero por el apiProperties.json identificador de cliente de las aplicaciones de Azure AD.

{resourceId} Se reemplazará por api://app.teams-spirit.com/3a57026a-cf3f-4295-93f5-ca245af3d2df/access_as_user en caso de implementación del conector personalizado.

A continuación, ejecute los siguientes comandos y siga las indicaciones:

paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <client_secret>

Creación de una conexión

El conector admite los siguientes tipos de autenticación:
Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Aprobar

Aprueba la aprobación dada.
Cambiar rol a miembro

Cambia el rol de los usuarios a un miembro del equipo
Cambiar valor de etiqueta

Cambia el valor de una etiqueta en un equipo determinado
Cambio del rol al propietario

Promueve a un usuario del equipo al propietario
Eliminar equipo

Elimina el equipo
Equipo de archivo

Archiva el equipo
Extender fecha de expiración

Extiende la fecha de expiración de grupos
Obtener todas las aprobaciones

Obtener todas las aprobaciones
Obtener valor de etiqueta

Obtiene un valor tags para un grupo.
Quitar todos los invitados

Quita todos los invitados del equipo
Quitar todos los no propietarios del equipo

Quita todos los miembros exept para propietarios del equipo
Quitar todos los usuarios excepto propietario

Quita todos los usuarios excepto un propietario seleccionado.
Quitar usuario del equipo

Quita un usuario del equipo
Rechazar

Rechazar

Aprobar

Id. de la operación:
Approve

Aprueba la aprobación dada.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de aprobación
 Approval-ID True string

Identificador de aprobación

Cambiar rol a miembro

Id. de la operación:
ChangeRoleToMember

Cambia el rol de los usuarios a un miembro del equipo

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del grupo
 Group-ID True string

Identificador del grupo
ID de usuario
 userId string

userId

Cambiar valor de etiqueta

Id. de la operación:
ChangeTagValue

Cambia el valor de una etiqueta en un equipo determinado

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del grupo
 Group-ID True string

Identificador del grupo
Etiqueta
 id string

id
Importancia
 value string

value

Cambio del rol al propietario

Id. de la operación:
ChangeRoleToOwner

Promueve a un usuario del equipo al propietario

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del grupo
 Group-ID True string

Identificador del grupo
ID de usuario
 userId string

userId

Eliminar equipo

Id. de la operación:
DeleteTeam

Elimina el equipo

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del grupo
 Group-ID True string

Identificador del grupo

Equipo de archivo

Id. de la operación:
ArchiveTeam

Archiva el equipo

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del grupo
 Group-ID True string

Identificador del grupo
Hacer que el sitio de SharePoint sea de solo lectura para los miembros del equipo
 sharePointReadOnly True boolean

sharePointReadOnly

Extender fecha de expiración

Id. de la operación:
ExtendExpirationDate

Extiende la fecha de expiración de grupos

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del grupo
 Group-ID True string

Identificador del grupo
Semanas
 weeks string

semanas

Obtener todas las aprobaciones

Id. de la operación:
GetApprovals

Obtener todas las aprobaciones

Devoluciones

Nombre Ruta de acceso Tipo Description
array of object
id
 id string

id
nombre de usuario
 userName string

nombre de usuario
userId
 userId string

userId
createForExternalUser
 createForExternalUser boolean

createForExternalUser
externalUserId
 externalUserId string

externalUserId
reactingUserId
 reactingUserId string

reactingUserId
reactingUserName
 reactingUserName string

reactingUserName
requestTime
 requestTime string

requestTime
expirationDateTime
 expirationDateTime string

expirationDateTime
estado
 status integer

estado
groupName
 groupName string

groupName
groupDescription
 groupDescription string

groupDescription
reason
 reason string

reason
rejectReason
 rejectReason string

rejectReason
acceso
 access boolean

acceso
reactionTime
 reactionTime string

reactionTime
type
 type string

type
tid
 tid string

tid
ID de plantilla
 templateId string

ID de plantilla
attributeSettings
 attributeSettings array of object

attributeSettings
attributeId
 attributeSettings.attributeId string

attributeId
value
 attributeSettings.value string

value
type
 attributeSettings.type integer

type

Obtener valor de etiqueta

Id. de la operación:
GetTagValue

Obtiene un valor tags para un grupo.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del grupo
 Group-ID True string

Identificador del grupo
Identificador de etiqueta
 Tag-ID True string

Identificador de etiqueta

Devoluciones

Valor de etiqueta
string

Quitar todos los invitados

Id. de la operación:
RemoveGuests

Quita todos los invitados del equipo

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del grupo
 Group-ID True string

Identificador del grupo

Quitar todos los no propietarios del equipo

Id. de la operación:
RemoveAllUsersExeptOwners

Quita todos los miembros exept para propietarios del equipo

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del grupo
 Group-ID True string

Identificador del grupo

Quitar todos los usuarios excepto propietario

Id. de la operación:
RemoveAllUsersExceptOneOwner

Quita todos los usuarios excepto un propietario seleccionado.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del grupo
 Group-ID True string

Identificador del grupo
ID del propietario
 ownerId string

ownerId

Quitar usuario del equipo

Id. de la operación:
RemoveUser

Quita un usuario del equipo

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del grupo
 Group-ID True string

Identificador del grupo
ID de usuario
 userId string

userId

Rechazar

Id. de la operación:
Reject

Rechazar

Parámetros

Nombre Clave Requerido Tipo Description
Identificador de aprobación
 Approval-ID True string

Identificador de aprobación

Desencadenadores

Action-Trigger

Action-Trigger

Action-Trigger

Id. de la operación:
ActionTrigger

Action-Trigger

Parámetros

Nombre Clave Requerido Tipo Description
Nombre
 name True string

Nombre

Devoluciones

response
object

Definiciones

objeto

Este es el tipo 'object'.

cuerda / cadena

Este es el tipo de datos básico "string".