Visão geral da lógica do servidor

A lógica do servidor Power Pages permite que os criadores executem JavaScript com segurança no servidor, adicionando extensibilidade diretamente ao tempo de execução do site.
 
Como a lógica do servidor é executada no servidor, ela fica oculta do navegador e protegida por funções da Web e permissões de tabela. Adiciona-se lógica no Power Pages Design Studio e cria-a usando Visual Studio Code, que fornece IntelliSense e validação em tempo de compilação.

O Dataverse armazena código e configuração, pelo que a lógica de servidor beneficia dos mesmos pipelines de implementação e de gestão do ciclo de vida que outros componentes do Power Pages.

Suporte de idiomas

A lógica do servidor permite aos programadores escrever código JavaScript nativo compatível com o padrão ECMAScript 2023 sem suporte para APIs de navegador (como APIs DOM, fetch ou XMLHttpRequest). Certos padrões inseguros ou restritos também são bloqueados para garantir uma execução segura. Para mais informações, consulte Limitações na autoria da lógica do servidor.

O que você pode fazer com a lógica do servidor

A lógica do servidor no Power Pages permite que criadores e desenvolvedores movam operações críticas do navegador para o servidor para melhorar o controle, a escalabilidade e a segurança. Ele permite que seu site execute tarefas e integrações complexas sem expor lógica ou dados confidenciais no lado do cliente.

Ao usar lógica de servidor, podes:

• Ligue-se a serviços e APIs externos: Integre de forma segura com APIs REST, Funções do Azure ou outros sistemas empresariais para trocar dados, acionar ações ou recuperar informação dinâmica.
• Execute operações de dados seguras: execute operações do Dataverse — como consultar, atualizar ou excluir registros — no servidor, aplicando a lógica de negócios e a validação de forma consistente.
• Executar lógica e transformações personalizadas: processe ou manipule dados antes de devolvê-los ao cliente. Por exemplo, calcular totais, validar regras de negócio ou enriquecer dados usando consultas externas.
• Retornar respostas processadas para páginas: envie apenas os dados necessários e filtrados para as páginas do cliente, garantindo renderização mais rápida e cargas úteis reduzidas.
• Simplifique a autenticação segura: gerencie credenciais de serviço e chaves de API no servidor em vez de no código do cliente, mantendo práticas de integração seguras e compatíveis.

Benefícios do uso da lógica do servidor

A lógica de servidor traz extensibilidade de nível empresarial para o Power Pages, ajudando as organizações a criar experiências na Web mais seguras, escaláveis e fáceis de manter.

Os principais benefícios incluem:

• Segurança reforçada: Execute e armazene lógica de negócio, segredos e chaves API no servidor — nunca os exponha no navegador ou aos utilizadores finais.
• Flexibilidade de integração: Ligue o Power Pages de forma fluida a sistemas externos, incluindo Funções do Azure, APIs REST, ações Dataverse e serviços empresariais.
• Melhor desempenho e eficiência: descarregue cálculos pesados, validações e processamento de dados para o servidor, reduzindo a carga de trabalho do lado do cliente e melhorando a capacidade de resposta da página.
• Consistência entre canais: aplique a mesma lógica em páginas da Web, formulários e integrações, garantindo validação e comportamento de dados uniformes em todo o aplicativo.
• Manutenção centralizada: atualize ou refine a lógica em um só lugar sem reimplantar ou editar vários scripts ou páginas de clientes.

Proteja a lógica do servidor

Para executar código na lógica do servidor, os usuários devem ter as permissões apropriadas configuradas pelo fabricante. O acesso é regido por funções Web e permissões de tabela, que também determinam se a lógica do servidor pode acessar tabelas específicas.

Autenticar a API lógica do servidor

Não é necessário incluir código de autenticação personalizado. A autenticação e a autorização são gerenciadas pela sessão do aplicativo. Todas as chamadas à API da lógica de servidor têm de incluir um token de Falsificação de Pedidos Entre Sites (CSRF).

Definição de governação para chamadas a serviços externos

A lógica do servidor pode ligar-se a APIs REST externas, Funções do Azure e outros sistemas empresariais para realizar integrações do lado do servidor. Para evitar a exfiltração de dados, os administradores de inquilinos podem bloquear as chamadas HTTP de saída que a lógica do servidor faz local a local. Quando este controlo de governação é aplicado, qualquer chamada HTTP de saída que a lógica do servidor tente falha. Para saber mais, consulte Desabilitar chamadas de serviço externo a partir da lógica do servidor.

Definições do site

Use as seguintes definições opcionais do site para ajudar a configurar a lógica do servidor:

URL da API lógica do servidor

Constrói a URL da API usando este formato:

https://<site-url>/_api/serverlogics/<server-logic-name>  
Exemplo:

https://contoso.powerappsportals.com/_api/serverlogics/exchangerate

Métodos HTTP suportados

A lógica do servidor suporta métodos HTTP padrão para executar operações em dados ou interagir com serviços externos. Cada método está associado a uma função que definimos na lógica do servidor.

Próximo passo

Lógica do servidor de autor

Informações relacionadas

Objetos de servidor
Como interagir com tabelas Dataverse usando a lógica do servidor