Criar Ações de Dados HTTP

Você pode usar uma ação de dados da API HTTP em uma pasta de trabalho para que, quando selecionar uma coluna, ela envie o valor a uma API REST que retorne uma resposta.

Você deve configurar o domínio com o qual está tentando se conectar como um domínio seguro antes de criar uma ação de dados da API HTTP. Consulte Registrar Domínios Seguros.

  1. Na Home page, passe o cursor do mouse sobre uma pasta de trabalho, clique em Ações e, em seguida, selecione Abrir.
  2. Clique no Menu da pasta de trabalho e selecione Ações de Dados.
  3. Clique em Adicionar Ação e digite um nome para a nova ação de dados da API HTTP. Por exemplo, digite Exemplo de API HTTP.
  4. Clique no campo Tipo e selecione API HTTP.
  5. Clique no campo Ancorar em e selecione as colunas às quais deseja que a ação de dados da API HTTP seja aplicada. Não selecione colunas de medida ou colunas ocultas. Se você não especificar um valor para o campo Ancorar em, a ação de dados se aplicará a todos os elementos de dados das visualizações.
  6. Na lista Método HTTP, selecione um método.
  7. Digite o URL da API REST que começa com http ou https e pode incluir tokens de substituição.
  8. Se você tiver selecionado o método POST:
    • Quando você selecionar o valor Dados do Form do Tipo de Payload, digite cada parâmetro em uma linha separada.
    • Quando você selecionar o valor Dados Brutos do Tipo de Payload, digite os dados brutos.
  9. Informe um cabeçalho HTTP personalizado caso queira adicionar ou substituir o cabeçalho HTTP para adequá-lo à API com a qual está fazendo interface.
  10. Clique em Suporta Diversas Seleções para definir o valor.
    • Ativado - A ação de dados pode ser chamada quando um ou diversos pontos de dados são selecionados.
    • Desativado - A ação de dados só pode ser chamada quando um único ponto de dados é selecionado.

      Essa definição é particularmente útil quando a seleção de diversos pontos de dados poderia resultar em erro (por exemplo, com algumas APIs REST de terceiros).

  11. Clique em OK para salvar.
  12. Clique em um ponto de dados na visualização.

    Por exemplo, você pode selecionar "Books" em uma coluna de Categoria de token para exibir uma API REST em particular.

  13. Clique com o botão direito do mouse e selecione Exemplo de API HTTP para exibir o resultado.

    Os pontos de dados selecionados determinam quais valores transmitir aos tokens de URL.

    Uma mensagem de sucesso ou falha é exibida confirmando que a API REST foi chamada com sucesso usando o valor selecionado.