Compartilhar via

Teams-Spirit (versão prévia)

O Conector Teams-Spirit permite que você conecte sua Assinatura Teams-Spirit aos seus fluxos.

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

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Immanuel Fuchs
URL https://teams-spirit.de/#kontakt
Email info@digitalteamwork.de
Metadados do conector
Publicador D.F.K. Digitalteamwork GmbH
Site da Web https://teams-spirit.de
Política de privacidade https://teams-spirit.de/datenschutz/
Categorias Comunicação; Produtividade

Conector do Teams-Spirit

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

Publicador: D.F.K. Digital Teamwork GmbH

Pré-requisitos

Você precisará do seguinte para continuar:

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

Operações com suporte

O conector fornece os seguintes gatilhos:

Action-Trigger

Pode ser disparado por meio de uma ação Teams-Spirit O conector dá suporte às seguintes operações:

Obter todas as aprovações

Lista todas as aprovações

Aprova

Aprova uma aprovação

Rejeitar

Rejeitar uma aprovação

Equipe de arquivo morto

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

Excluir Equipe

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 o usuário da equipe

Remove um usuário de uma equipe

Alterar valor da marca

Altera o valor de uma marca de Teams-Spirit

Obter valor da marca

Retorna o valor de uma marca de Teams-Spirit

Estender data de validade

Estende uma data de validade das equipes

Obtendo credenciais

O conector Teams-Spirit usa o OAuth2 no Azure Active Directory (AD). Esse é 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 você quiser que um Fluxo seja disparado por uma regra de Teams-Spirit, você poderá criar um novo Fluxo com o Gatilho de Ação. Depois de dar um nome a ele, ele se registrará no Teams-Spirit e estará disponível no Mecanismo de Regras. Você pode enviar todos os parâmetros disponíveis na regra Teams-Spirit para o Fluxo e usá-lo para automatizar ainda mais seus fluxos de trabalho.

Instruções de implantação

Como a API de Teams-Spirit é protegida pelo Azure Active Directory (AD) via OAuth2, primeiro precisamos configurar algumas coisas no Azure AD para que nossos conectores possam acessar com segurança a API. Depois que isso for concluído, você poderá 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 ele possa solicitar permissões para acessar Teams-Spirit dados em nome do usuário final. Você pode seguir as etapas abaixo:

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

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

    • Para o 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ê precisará disso mais tarde e ele será mostrado apenas uma vez.
    • Para permissões de API, adicione a permissão Teams-Spirit access_as_user . Para fazer isso, clique Add a permissionem , navegue até APIs my organization uses, pesquise 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} pela ID do apiProperties.json cliente dos aplicativos do Azure AD.

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

Em seguida, execute os seguintes comandos e siga os prompts:

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

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:
Default 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.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Alterar a função para Membro

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

Promove um usuário na equipe para proprietário
Alterar valor da marca

Altera o valor de uma marca em uma determinada equipe
Aprovar

Aprova a aprovação determinada
Equipe de arquivo morto

Arquiva a equipe
Estender data de validade

Estende a data de validade dos grupos
Excluir Equipe

Exclui a equipe
Obter todas as aprovações

Obter todas as aprovações
Obter valor da marca

Obtém um valor de marcas para um grupo
Rejeitar

Rejeitar
Remover todos os convidados

Remove todos os convidados da equipe
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 usuário da equipe

Alterar a função para Membro

ID da operação:
ChangeRoleToMember

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

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 Group-ID True string

ID do grupo
Identificação de usuário
 userId string

userId

Alterar a função para Proprietário

ID da operação:
ChangeRoleToOwner

Promove um usuário na equipe para proprietário

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 Group-ID True string

ID do grupo
Identificação de usuário
 userId string

userId

Alterar valor da marca

ID da operação:
ChangeTagValue

Altera o valor de uma marca em uma determinada equipe

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 Group-ID True string

ID do grupo
Etiqueta
 id string

id
Value
 value string

value

Aprovar

ID da operação:
Approve

Aprova a aprovação determinada

Parâmetros

Nome Chave Obrigatório Tipo Description
ID de aprovação
 Approval-ID True string

ID de aprovação

Equipe de arquivo morto

ID da operação:
ArchiveTeam

Arquiva a equipe

Parâmetros

Nome Chave Obrigató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 data de validade

ID da operação:
ExtendExpirationDate

Estende a data de validade dos grupos

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 Group-ID True string

ID do grupo
Semanas
 weeks string

semanas

Excluir Equipe

ID da operação:
DeleteTeam

Exclui a equipe

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 Group-ID True string

ID do grupo

Obter todas as aprovações

ID da operação:
GetApprovals

Obter todas as aprovações

Retornos

Nome Caminho Tipo Description
array of object
id
 id string

id
userName
 userName string

userName
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
status
 status integer

status
groupName
 groupName string

groupName
groupDescription
 groupDescription string

groupDescription
reason
 reason string

reason
rejectReason
 rejectReason string

rejectReason
acesso
 access boolean

acesso
reactionTime
 reactionTime string

reactionTime
tipo
 type string

tipo
Tid
 tid string

Tid
id do modelo
 templateId string

id do modelo
attributeSettings
 attributeSettings array of object

attributeSettings
attributeId
 attributeSettings.attributeId string

attributeId
value
 attributeSettings.value string

value
tipo
 attributeSettings.type integer

tipo

Obter valor da marca

ID da operação:
GetTagValue

Obtém um valor de marcas para um grupo

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 Group-ID True string

ID do grupo
ID da marca
 Tag-ID True string

ID da marca

Retornos

Valor da marca
string

Rejeitar

ID da operação:
Reject

Rejeitar

Parâmetros

Nome Chave Obrigatório Tipo Description
ID de aprovação
 Approval-ID True string

ID de aprovação

Remover todos os convidados

ID da operação:
RemoveGuests

Remove todos os convidados da equipe

Parâmetros

Nome Chave Obrigató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

Nome Chave Obrigató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

Nome Chave Obrigatório Tipo Description
ID do grupo
 Group-ID True string

ID do grupo
ID do proprietário
 ownerId string

ID do proprietário

Remover usuário da equipe

ID da operação:
RemoveUser

Remove um usuário da equipe

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do grupo
 Group-ID True string

ID do grupo
Identificação de usuário
 userId string

userId

Gatilhos

Action-Trigger

Action-Trigger

Action-Trigger

ID da operação:
ActionTrigger

Action-Trigger

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome
 name True string

Nome

Retornos

response
object

Definições

objeto

Esse é o tipo 'object'.

cadeia

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