Trabalhar no editor de scripts do SAP Analytics Cloud

Objective

After completing this lesson, you will be able to acessar e executar tarefas básicas no Editor de scripts no Modo avançado.

Introdução ao editor de scripts

Linguagem de script

O SAP Analytics Cloud usa um subconjunto de JavaScript para aprimorar histórias usando scripting.

Por que o JavaScript é usado?

  • Ele pode ser executado no browser e no servidor
  • É relativamente fácil de aprender
  • É suficientemente poderoso

Por que o SAP Analytics Cloud usa um subconjunto de JavaScript?

  • JavaScript completo é bastante complexo
  • JavaScript não oferece suporte de tipo
  • Algumas construções em JavaScript podem ser perigosas (por exemplo, loops infinitos)
  • O SAP Analytics Cloud pode validar todos os scripts

Como o scripting no SAP Analytics Cloud difere do uso geral de JavaScript?

  • O script deve ser fortemente digitado
  • O tipo de fundição automática não é oferecido

Devido aos recursos de rich code completion disponíveis no SAP Analytics Cloud, o subconjunto JavaScript deve ser fortemente tipificado. Se você quiser usar um número inteiro como uma string, deve convertê-lo explicitamente. O que isso significa é que, uma vez que você tem um pato, ele continua sendo um pato. Uma consequência da digitação forte é que você não pode esperar conversões automáticas. Com a digitação forte, você não pode reciclar nomes de variáveis como novos tipos. Então, se você quiser outra coisa, você precisa de outra variável.

Em geral, a utilização de JavaScript oferece tipagem fraca e tipagem dinâmica:

  • Com a digitação fraca, a escritora de script pode implicitamente coagir variáveis para agir como diferentes tipos. Por exemplo, você pode ter um valor inteiro e tratá-lo como se fosse uma string: "Caro inteiro, você é uma string". Para obter mais informações sobre digitação fraca, acesse Fundamentos do código
  • Com a digitação dinâmica, o tempo de execução tenta adivinhar o tipo do contexto nesse momento. Você pode até mesmo alterar o tipo depois que a variável já estiver em uso. Por exemplo, você pode alterar o valor do inteiro mencionado anteriormente para outro tipo de objeto: "Caro inteiro, agora você é um pato".

Embora o SAP Analytics Cloud use como subconjunto de JavaScript como linguagem de script, ele ainda é JavaScript. Você pode escrever JavaScript válido enquanto trata a linguagem como se fosse fortemente e estaticamente tipificada.

Saber que alguns recursos mais avançados de JavaScript estão desativados no SAP Analytics Cloud, ser um verdadeiro subconjunto de JavaScript ainda permite a execução nativa em um navegador. Os scripts usados no subconjunto de JavaScript do SAP Analytics Cloud estão vinculados a eventos ou objetos de script globais e são executados e validados em relação a "modo estrito".

Para obter mais informações sobre o modo estrito, você pode ir para: Modo estrito - JavaScript

Tipos de dados no SAP Analytics Cloud

Todas as linguagens de programação têm o conceito de Tipos de Dados.

No SAP Analytics Cloud, temos:

  1. Tipos de dados primitivos (como em JavaScript)
    • Número inteiro: 2, 8, 6+4
    • String: "Olá", "Eu estou" + "aqui"
    • Booleano: verdadeiro, falso, verdadeiro && falso, "a" == "a", 1 !=2
  2. Tipos de dados específicos de BI:
    • Widget
    • Dimensão
    • Membro
    • Filtro, etc.

Não há fundição automática.

O editor de scripts

O editor de scripts do SAP Analytics Cloud permite que você escreva scripts para cada widget, criando histórias interativas e altamente personalizadas.

O scripting oferece várias opções para escrever código para ampliar uma história no SAP Analytics Cloud. Por exemplo, você pode:

  • Coloque um widget Botão na história e atribua um script ao evento onClick do botão,
  • Atribuir script a um gráfico usando o evento onSelect,
  • Escrever scripts com base em outros eventos do sistema, como o evento onInitialization da história, ou
  • Adicione scripts que são executados sempre que os dados são modificados utilizando onResultChanged.
Editor de scripts aberto para Button_2018.

A conclusão de código e a funcionalidade de entradas possíveis no SAP Analytics Cloud permitem:

  • Conclusão de código no sentido tradicional, como completar identificadores locais ou globais
  • Conclusão de código semântico sugerindo funções de membro ou similares
  • Entradas possíveis na forma de propostas de valor sensíveis ao contexto, como medidas de uma fonte de dados para parâmetros de função

Por exemplo, ao chamar um método API em uma consulta do SAP Business Warehouse, o code completion pode propor medidas como opções de code completion ou valores para especificar um filtro.

Para abrir o code completion no editor de scripts, use o atalho do teclado Crtl + Space.

Conclusão de código no editor de scripts do SAP Analytics Cloud. Lembre-se, o Atalho mais Importante no Teclado é Crtl + Espaço.

Assista a este vídeo curto para saber mais sobre o editor de scripts, a verificação automática de sintaxe, a conclusão do código e as entradas possíveis.

Tipos de comentário

Exemplos de comentários de várias linhas de linha única. Exemplos de ambos os tipos de comentários são fornecidos abaixo.

Você pode ampliar seu script com comentários. Os comentários ajudam você ou outros a criar documentação sobre o script ou partes individuais do script. A sintaxe JavaScript oferece os dois tipos de comentários a seguir:

  1. Comentários de uma linha
  2. Comentários de várias linhas

Os comentários de uma linha começam com//.

Qualquer texto entre // e o final da linha de código é interpretado como um comentário e não é executado como um comando. Você pode usá-lo para gerar uma linha inteira como um comentário, mas também pode adicioná-la a uma linha de código existente.

Por exemplo:

var counter = 1; // declare counter and assign value 1

ou

var counter = 1;

// declare counter and assign value 1

Os comentários de várias linhas começam com/*e terminam com*/.

O texto entre /* e */ é interpretado como um comentário e não é executado como um comando.

Por exemplo:

var counter = 1;

/* declare counter and

assign value 1 */

Tipos de extrato

Diagrama com Tipos de instrução no topo com setas levando a cada uma das caixas abaixo. Da esquerda para a direita: Instruções de chamada, Instruções de execução condicional, Loops e Instruções de atribuição. Exemplos de cada uma das caixas inferiores são fornecidos na tabela abaixo.
Instruções de chamadaInstruções de execução condicionalLoopsDeclarações de atribuição
Por exemplo, modifique o Tipo de gráfico de um gráfico ou defina um filtro para uma dimensãoIF xxx THEN xxx ELSEPARA…Defina uma nova variável ou atribua um valor a uma existente.
Sintaxe básica: <Widget>.<Method>(<Arguments>);CASO DE COMÉRCIOQUANDO…var <variable> = <expression>;
Para/IN...ou

<variable> = <expression>;

O SAP Analytics Cloud pode usar APIs fornecidas e opções comuns de JavaScript para diferentes tipos de declaração. Esses tipos de declaração são abordados mais detalhadamente nas lições a seguir deste curso.