Partilhar via

Teams-Spirit (Pré-visualização)

O Teams-Spirit Connector permite-lhe ligar a sua Subscrição Teams-Spirit aos seus fluxos.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Emanuel Fuchs
URL https://teams-spirit.de/#kontakt
Email info@digitalteamwork.de
Metadados do conector
Editora D.F.K. Digitalteamwork GmbH
Sítio Web https://teams-spirit.de
Política de privacidade https://teams-spirit.de/datenschutz/
Categorias Comunicação; Produtividade

Conector Teams-Spirit

Teams-Spirit fornece uma API REST extensa. Usando essa API, você pode gerenciar suas aprovações, equipes e usuários por meio do Teams-Spirit.

Editora: D.F.K. Digital Teamwork GmbH

Pré-requisitos

Você precisará do seguinte para prosseguir:

  • Um plano Microsoft Power Apps ou Power Automate com recurso de conector personalizado
  • Um Aplicativo Empresarial do Azure AD Teams-Spirit (geralmente estará presente se você estiver usando Teams-Spirit)
  • Uma subscrição Teams-Spirit
  • As ferramentas da CLI da plataforma Power

Operações suportadas

O conector fornece os seguintes gatilhos:

Action-Trigger

Pode ser acionado através de uma ação Teams-Spirit O conector suporta as seguintes operações:

Obter todas as aprovações

Lista todas as aprovações

Aprova

Aprova uma aprovação

Rejeitar

Rejeitar uma aprovação

Equipa de Arquivo

Arquiva uma equipe e, opcionalmente, marca o site do SharePoint de grupos como somente leitura

Eliminar Equipa

Exclui uma equipe

Alterar função para membro

Altera uma função de usuário para membro

Alterar função para proprietário

Altera uma função de usuário para proprietário

Remover todos os convidados

Remove todos os convidados de uma equipe

Remover todos os usuários, exceto o proprietário

Remove todos os membros da equipe, exceto um determinado proprietário

Remover usuário da equipe

Remove um usuário de uma equipe

Alterar valor da tag

Altera o valor de uma Teams-Spirit Tag

Obter valor da tag

Devolve o valor de uma etiqueta Teams-Spirit

Estender a data de validade

Estende a data de expiração de uma equipe

Obtenção de credenciais

O Teams-Spirit Connector usa OAuth2 no Azure Ative Directory (AD). Este é o mesmo método de autenticação usado pelo próprio aplicativo Teams-Spirit e, portanto, o usuário terá as mesmas permissões no conector e no aplicativo.

Introdução

Se quiser que um Fluxo seja acionado por uma Regra de Teams-Spirit, você pode criar um novo Fluxo com o Action-Trigger. Depois de lhe ter dado um nome, este registar-se-á no Teams-Spirit e estará disponível no Rule-Engine. Você pode enviar todos os parâmetros disponíveis na Regra de Teams-Spirit para o Flow e usá-los para automatizar ainda mais seus fluxos de trabalho.

Instruções de implantação

Como a API do Teams-Spirit é protegida pelo Azure Ative Directory (AD) via OAuth2, primeiro precisamos configurar algumas coisas no Azure AD para que nossos conectores possam acessar a API com segurança. Depois disso, você pode criar e testar o conector.

Configurar um aplicativo do Azure AD para seu conector personalizado

Primeiro, precisamos registrar nosso conector como um aplicativo no Azure AD. Isso permitirá que o conector se identifique com o Azure AD para que possa solicitar permissões para acessar Teams-Spirit dados em nome do usuário final. Você pode seguir os passos abaixo:

  1. Criar um aplicativo do Azure AD Este aplicativo do Azure AD será usado para identificar o conector para o Teams-Spirit. Isso pode ser feito usando o [Portal do Azure] (https://portal.azure.com), seguindo as etapas aqui. Uma vez criado, anote o valor do ID do aplicativo (cliente). Você vai precisar disso mais tarde.

  2. Configurar (Atualizar) seu aplicativo do Azure AD para acessar a API do Teams-Spirit Esta etapa garantirá que seu aplicativo possa recuperar com êxito um token de acesso para invocáTeams-Spirit em nome de seus usuários. Para fazer isso, siga as etapas aqui.

    • Para URI de redirecionamento, use "https://global.consent.azure-apim.net/redirect"
    • Para as credenciais, use um segredo do cliente (e não certificados). Lembre-se de anotar o segredo, você vai precisar disso mais tarde e é mostrado apenas uma vez.
    • Para permissões de API, adicione a permissão Teams-Spirit access_as_user . Para fazer isso, clique em Add a permission, navegue até APIs my organization uses, procure Teams-Spirit e adicione a access_as_user permissão.

Neste ponto, agora temos um aplicativo válido do Azure AD que pode ser usado para obter permissões de usuários finais e acessar o Teams-Spirit.

Implantando o conector

Primeiro, substitua {clientId} a ID do cliente dos apiProperties.json aplicativos do Azure AD.

O {resourceId} deve ser substituído por api://app.teams-spirit.com/3a57026a-cf3f-4295-93f5-ca245af3d2df/access_as_user em caso de implantação de conector personalizado.

Em seguida, execute os seguintes comandos e siga as instruções:

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

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:
Predefinição Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Alterar função para Membro

Altera uma função de usuário para membro na Equipe
Alterar função para Proprietário

Promove um Utilizador na Equipa a Proprietário
Alterar valor da tag

Altera o valor de uma tag em uma determinada equipe
Approve

Aprova a aprovação concedida
Eliminar Equipa

Elimina a Equipa
Equipa de Arquivo

Arquivos da Equipa
Estender a data de validade

Estende a data de expiração dos grupos
Obter todas as aprovações

Obter todas as aprovações
Obter valor da tag

Obtém um valor Tags para um grupo
Rejeitar

Rejeitar
Remover todos os convidados

Remove todos os Convidados da Equipa
Remover todos os não-proprietários da equipe

Remove todos os Membros exept para Proprietários da Equipe
Remover todos os usuários, exceto o proprietário

Remove todos os usuários, exceto um proprietário selecionado
Remover usuário da equipe

Remove um Utilizador da Equipa

Alterar função para Membro

ID da Operação:
ChangeRoleToMember

Altera uma função de usuário para membro na Equipe

Parâmetros

Name Chave Necessário Tipo Description
Id do grupo
 Group-ID True string

Id do grupo
ID do Utilizador
 userId string

userId

Alterar função para Proprietário

ID da Operação:
ChangeRoleToOwner

Promove um Utilizador na Equipa a Proprietário

Parâmetros

Name Chave Necessário Tipo Description
Id do grupo
 Group-ID True string

Id do grupo
ID do Utilizador
 userId string

userId

Alterar valor da tag

ID da Operação:
ChangeTagValue

Altera o valor de uma tag em uma determinada equipe

Parâmetros

Name Chave Necessário Tipo Description
Id do grupo
 Group-ID True string

Id do grupo
Tag
 id string

id
Valor
 value string

valor

Approve

ID da Operação:
Approve

Aprova a aprovação concedida

Parâmetros

Name Chave Necessário Tipo Description
ID da aprovação
 Approval-ID True string

ID da aprovação

Eliminar Equipa

ID da Operação:
DeleteTeam

Elimina a Equipa

Parâmetros

Name Chave Necessário Tipo Description
Id do grupo
 Group-ID True string

Id do grupo

Equipa de Arquivo

ID da Operação:
ArchiveTeam

Arquivos da Equipa

Parâmetros

Name Chave Necessário Tipo Description
Id do grupo
 Group-ID True string

Id do grupo
Tornar o site do SharePoint somente leitura para membros da equipe
 sharePointReadOnly True boolean

sharePointReadOnly

Estender a data de validade

ID da Operação:
ExtendExpirationDate

Estende a data de expiração dos grupos

Parâmetros

Name Chave Necessário Tipo Description
Id do grupo
 Group-ID True string

Id do grupo
Semanas
 weeks string

semanas

Obter todas as aprovações

ID da Operação:
GetApprovals

Obter todas as aprovações

Devoluções

Name Caminho Tipo Description
array of object
id
 id string

id
nome de utilizador
 userName string

nome de utilizador
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
grupoDescrição
 groupDescription string

grupoDescrição
razão
 reason string

razão
rejectReason
 rejectReason string

rejectReason
acesso
 access boolean

acesso
Tempo de reação
 reactionTime string

Tempo de reação
tipo
 type string

tipo
TID
 tid string

TID
templateId
 templateId string

templateId
attributeSettings
 attributeSettings array of object

attributeSettings
attributeId
 attributeSettings.attributeId string

attributeId
valor
 attributeSettings.value string

valor
tipo
 attributeSettings.type integer

tipo

Obter valor da tag

ID da Operação:
GetTagValue

Obtém um valor Tags para um grupo

Parâmetros

Name Chave Necessário Tipo Description
Id do grupo
 Group-ID True string

Id do grupo
Id da tag
 Tag-ID True string

Id da tag

Devoluções

Valor da tag
string

Rejeitar

ID da Operação:
Reject

Rejeitar

Parâmetros

Name Chave Necessário Tipo Description
ID da aprovação
 Approval-ID True string

ID da aprovação

Remover todos os convidados

ID da Operação:
RemoveGuests

Remove todos os Convidados da Equipa

Parâmetros

Name Chave Necessário Tipo Description
Id do grupo
 Group-ID True string

Id do grupo

Remover todos os não-proprietários da equipe

ID da Operação:
RemoveAllUsersExeptOwners

Remove todos os Membros exept para Proprietários da Equipe

Parâmetros

Name Chave Necessário Tipo Description
Id do grupo
 Group-ID True string

Id do grupo

Remover todos os usuários, exceto o proprietário

ID da Operação:
RemoveAllUsersExceptOneOwner

Remove todos os usuários, exceto um proprietário selecionado

Parâmetros

Name Chave Necessário Tipo Description
Id do grupo
 Group-ID True string

Id do grupo
ID do proprietário
 ownerId string

ownerId

Remover usuário da equipe

ID da Operação:
RemoveUser

Remove um Utilizador da Equipa

Parâmetros

Name Chave Necessário Tipo Description
Id do grupo
 Group-ID True string

Id do grupo
ID do Utilizador
 userId string

userId

Acionadores

Action-Trigger

Action-Trigger

Action-Trigger

ID da Operação:
ActionTrigger

Action-Trigger

Parâmetros

Name Chave Necessário Tipo Description
Nome
 name True string

Nome

Devoluções

response
object

Definições

objecto

Este é o tipo 'objeto'.

cadeia (de caracteres)

Este é o tipo de dados básico 'string'.