Obter canais

Recupere canais do Microsoft Teams correspondentes aos parâmetros de consulta usando a atividade Get Channels e a API ListChannels do Microsoft Graph.

Visão geral

Usando seus parâmetros de pesquisa (QueryOptions) e a equipe especificada (TeamId), a atividade Get Channels chama a API ListChannels do Microsoft Graph para recuperar os canais que correspondem à sua consulta.

Após recuperar os canais, a atividade retorna suas propriedades e relacionamentos em um objeto Channel[] (Canais) que você pode usar como variáveis de entrada em atividades subsequentes (por exemplo, Channel(0).Id em Get Messages, Send Message e assim por diante).

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 Teams).
4. Adicione a atividade Get Channels 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 ListChannels .

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

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, Get Teams 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

Opções

OpçõesDeConsulta

Os parâmetros de pesquisa que você deseja aplicar ao recuperar sua lista de canais.

Atributos	Detalhes
Tipo	QueryOption[] (Sintaxe do OData)
Required	Não
Valor padrão	Vazio
Valores permitidos	Insira uma variável QueryOption[] ou QueryOption .
Observações	Insira seu valor usando uma opção de consulta do sistema OData ; o formato é o seguinte: _{New QueryOption("Option", "OptionParameter")} . Por exemplo, se você quiser aplicar a opção $filter , você digitaria "filtro" como a primeira string e, em seguida, inseriria um parâmetro de filtro como a segunda string (por exemplo, {New QueryOption("filter", "displayName ne 'General'")} .

Saída

Canais

Uma matriz de canais (objeto Channel[] ) que corresponde ao valor de OpçõesDeConsulta .

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 Channel[] .
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, Get Messages , Send Message , etc.). * Ao usar essa variável como um valor da propriedade de entrada, especifique o item na matriz que você deseja usar (por exemplo, CreatedChannels(0) ). 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 .