Obter canal

Recupere as propriedades e relacionamentos de um canal especificado do Microsoft Teams usando a atividade Get Channel.

Visão geral

A atividade Get Channel chama a API GetChannel do Microsoft Graph para recuperar as propriedades e relacionamentos de um canal especificado (ChannelId) de uma equipe (TeamId).

Após recuperar o canal, a atividade retorna suas propriedades e relacionamentos em um objeto Channel (Channel) que você pode usar como variáveis de entrada em atividades subsequentes (por exemplo, Channel.Id em Get Messages, Send Message, etc.).

Ao contrário da atividade Get Channels , que pesquisa e retorna uma lista de canais (Channel[]) usando suas OpçõesDeConsulta especificadas, a atividade Get Channel recupera um único canal especificado (Channel) usando o ChannelId e o TeamId fornecidos. Esta atividade não se destina a ser usada para pesquisar um canal como a atividade Get Channels e só pode ser usada quando o valor Channel.Id é conhecido.

Como funciona

As etapas a seguir e o diagrama de sequência de mensagens são um exemplo de como a atividade funciona desde o momento do design (ou seja, as dependências da atividade e propriedades de entrada/saída) até o tempo de execução.

1. Conclua as etapas de Configuração .
2. Adicione a atividade Microsoft Teams Scope ao seu projeto.
3. Adicione uma atividade ou execute um processo externo que gere um valor Team.Id (por exemplo, Obter equipes) E uma atividade ou processo externo que gere um valor Channel.Id (por exemplo, Criar canal).
4. Adicione a atividade Get Channel dentro da atividade Microsoft Teams Scope .
5. Insira valores para as propriedades de Entrada .
6. Crie e insira uma variável Channel para sua propriedade Saída .
7. Execute a atividade.

   • Seus valores de propriedade de entrada são enviados para a API GetChannel .

   • A API retorna o valor Channel para sua variável de propriedade de saída.

     

Propriedades

Os valores para as seguintes propriedades são especificados ao adicionar esta atividade ao seu projeto no UiPath Studio.

Comum

NomeDeExibição

O nome de exibição da atividade.

Atributos	Detalhes
Tipo	String
Required	Sim
Valor padrão	Obter canal
Valores permitidos	Insira uma variável String ou String .
Observações	N/A

Entrada

Id da equipe

O ID do objeto Team do qual você quer recuperar o canal.

Atributos	Detalhes
Tipo	String
Required	Sim
Valor padrão	Vazio
Valores permitidos	Insira uma variável String ou String .
Observações	Para obter o valor Team.Id , use um processo ou atividade externa que inclua o valor Team.Id em sua saída (por exemplo, Create Team ou chamada de API externa)

ID do canal

O ID do objeto Channel que você deseja recuperar.

Atributos	Detalhes
Tipo	String
Required	Sim
Valor padrão	Vazio
Valores permitidos	Insira uma variável String ou String .
Observações	Para obter o valor Channel.Id , use um processo ou atividade externa que inclua o valor Channel.Id em sua saída (por exemplo, Criar canal ou chamada de API externa)

Diversos

Particular

Se selecionado, os valores das variáveis e argumentos não são mais registrados no nível Verbose.

Atributos	Detalhes
Tipo	Caixa de seleção
Required	Não
Valor padrão	não selecionado
Valores permitidos	Selecionado ou Não Selecionado
Observações	N/A

Saída

Canal

O objeto Channel que representa o canal recuperado.

Atributos	Detalhes
Tipo	Channel
Required	Não (necessário se você planejar usar os dados de saída em atividades subsequentes)
Valor padrão	Vazio
Valores permitidos	Insira uma variável Team .
Observações	A variável que você criar para essa propriedade pode ser usada como uma variável de entrada em atividades subsequentes (por exemplo, Channel.Id em Get Messages , Send Message , etc.). O objeto Channel inclui várias propriedades e relacionamentos que você pode usar em outras atividades. A imagem de exemplo abaixo mostra algumas das propriedades que você pode retornar. Observação: algumas propriedades listadas no designer não são aplicáveis ao objeto Channel (por exemplo, Visibility ). Para uma lista das propriedades Team aplicáveis, acesse os links acima.

Exemplo

A imagem a seguir mostra um exemplo do relacionamento de dependência de atividade e valores de propriedade de entrada/saída.

Para obter instruções passo a passo e exemplos, consulte os guias de Início rápido .