API da Aplicação

A AppAPI permite aos utilizadores carregar metadados do sistema a partir da aplicação usando diferentes métodos no FormEngine e DMView. Fornece acesso a várias chaves de dados para recuperar informação específica da aplicação.

No xlsform, pode usar a função pulldata() com a seguinte sintaxe:

• 'app-api': Esta palavra-chave informa o FormEngine para carregar os dados da API da Aplicação.
• 'data-key': Esta é a chave dos dados que pretende carregar da API da Aplicação.
• Se a chave de dados for inválida ou não suportada, o cálculo retornará “n/a”.

Aqui estão as chaves de dados suportadas que pode usar com a App-API:

osPlatform: Retorna o nome atual do SO (Android ou iOS) e a versão do SO. As plataformas web retornarão um valor vazio.

appPlatform: Retorna o nome da plataforma da aplicação, que é rtSurvey.

appVersion: Retorna o nome da versão da aplicação.

getDisplayWidth: Retorna a largura do ecrã do dispositivo em píxeis.

getDisplayHeight: Retorna a altura do ecrã do dispositivo em píxeis.

getScreenSize: Retorna o tamanho do ecrã do dispositivo em polegadas.

projectCode: Retorna o código de projeto atual do site em que o utilizador está a iniciar sessão.

projectURL: Retorna o URL de projeto atual do site em que o utilizador está a iniciar sessão. O valor predefinido/fallback é um texto vazio ("").

startingPoint: Retorna o caminho do ponto que inicia o formulário. Consulte o “Ponto de partida do formulário” para mais detalhes.

serverTime: Retorna a melhor aproximação disponível da data e hora no servidor.

user.[attribute]: Retorna os atributos do utilizador atual com base na chave de atributo especificada. Consulte a tabela “Atributos de utilizador” para as chaves de atributo disponíveis.

Combine as chaves de atributo abaixo com “user.” nos parâmetros pulldata() para recuperar as informações do utilizador atual. Por exemplo, use user.username, user.email, etc.