Criar Ações de Dados de HTTP

Pode utilizar uma ação de dados da API HTTP num livro de modo a que, quando seleciona uma coluna, o valor é enviado para uma API REST que devolve uma resposta.

Deve configurar o domínio ao qual está a tentar ligar como um domínio seguro antes de criar uma ação de dados da API HTTP. Consulte Registar Domínios Seguros.

  1. Na Página Principal, coloque o cursor sobre um livro, clique em Ações e, em seguida, selecione Abrir.
  2. Clique no Menu do livro e, em seguida, selecione Ações de Dados.
  3. Clique em Acrescentar Ação e introduza um nome para a nova ação de dados da API HTTP. Por exemplo, introduza HTTP API Example.
  4. Clique no campo Tipo e selecione API HTTP.
  5. Clique no campo Ancorar em e selecione as colunas às quais pretende que a ação de dados da API HTTP se aplique. Não selecione colunas de medidas nem colunas ocultas. Se não especificar um valor para o campo Ancorar em, a ação de dados aplica-se a todos os elementos de dados nas visualizações.
  6. Na lista Método de HTTP selecione um método.
  7. Introduza o URL da API REST que começa por http ou https e, opcionalmente, inclui tokens de substituição.
  8. Se tiver selecionado o método POST:
    • Quando selecionar o valor de Tipo de Payload Dados do Formulário, introduza cada parâmetro numa linha separada.
    • Quando selecionar o valor de Tipo de Payload Dados Não Processados, introduza os dados não processados.
  9. Introduza um cabeçalho de HTTP customizado se pretender acrescentar ou substituir o cabeçalho de HTTP para se adequar à API com a qual está a fazer interface.
  10. Clique em Suporta Seleção Múltipla para definir o valor.
    • Ativado - A ação de dados pode ser invocada quando um ou vários pontos de dados são selecionados.
    • Desativado - A ação de dados só pode ser invocada quando é selecionado um único ponto de dados.

      Esta definição é particularmente útil quando a seleção de vários pontos de dados pode resultar num erro (por exemplo, com algumas APIs REST de terceiros).

  11. Clique em OK para gravar.
  12. Clique num ponto de dados na visualização.

    Por exemplo, poderá selecionar "Books" a partir de uma coluna Category de token para apresentar uma API REST específica.

  13. Clique com o botão direito do rato e selecione HTTP API Example para apresentar o resultado.

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

    É apresentada uma mensagem de êxito ou falha a confirmar que a API REST foi invocada com êxito utilizando o valor selecionado.