Partilhar via

Funções definidas pelo utilizador no livro-razão confidencial do Azure (pré-visualização)

O livro-razão confidencial do Azure fornece funções definidas pelo usuário (UDFs) para executar a lógica personalizada dentro do livro-razão. Esse recurso permite que você estenda a funcionalidade do livro-razão escrevendo código personalizado que pode ser executado dentro de um ambiente confidencial e interagir com os dados do livro-razão.

Os novos recursos de programação permitem que os usuários criem UDFs simples e UDFs avançados para executar várias operações com um nível diferente de personalização. Uma vez definidas, as UDFs podem ser invocadas a partir dos clientes de livro-razão confidencial do Azure para serem executadas diretamente dentro do mecanismo de contabilidade.

Importante

As funções definidas pelo utilizador estão atualmente em fase de testes. Pode solicitar acesso a esta pré-visualização através deste formulário de inscrição. Consulte os Termos de Utilização Suplementares das Pré-visualizações do Microsoft Azure para obter os termos legais que se aplicam às funcionalidades do Azure que estão em versão beta, pré-visualização ou ainda não disponibilizadas para disponibilidade geral.

UDFs simples e avançadas

O Azure Confidential Ledger oferece dois tipos de funcionalidades UDF:

  • UDFs simples: UDFs simples são funções simples personalizadas que podem ser definidas e executadas dentro do registo. Eles permitem que você execute operações simples usando a API JavaScript e podem ser integrados com a API de escrita contábil existente. Saiba mais sobre UDFs simples aqui.

  • UDFs avançadas: UDFs avançadas são pontos de extremidade personalizados que podem ser definidos e expostos numa aplicação de contabilidade. Esses pontos de extremidade podem ser utilizados para expor APIs mais sofisticadas com parâmetros personalizáveis, formatos de dados e sistemas de autenticação. Saiba mais sobre UDFs avançadas aqui.

Aqui está uma comparação dos principais recursos e capacidades de UDFs simples e avançados:

Capacidade UDFs simples UDFs avançadas
Executar lógica de negócios personalizada Sim Sim
Personalização de argumentos/parâmetros de tempo de execução Sim Sim
Disponibilizar novas APIs/pontos finais Não Sim
Executar funções individuais Sim Não
Executar rotinas antes/depois de uma operação de gravação de entrada contábil Sim Não
Criação e atualização de código personalizado Sim (atualização/eliminação granular de cada função) Sim (atualização de pacote de aplicativo único para todos os endpoints)
Opções personalizadas de tempo de execução do JavaScript Sim (por cada execução) Sim (globalmente)
Execução em nós de backup Não Sim
Suporte a vários formatos de dados para entrada e saída Não Sim
Autenticação e autorização personalizadas Não Sim
Cenários-alvo Execução de lógica personalizada simples e integração com a API do livro-razão Casos de uso avançados que exigem APIs personalizadas e controle sobre parâmetros JavaScript avançados

Alternar entre UDFs simples e avançadas

As UDFs simples e avançadas são recursos mutuamente exclusivos. Não é possível criar ou executar UDFs simples se UDFs avançadas estiverem definidas e vice-versa. É possível alternar entre os dois recursos usando as etapas a seguir.

Importante

Alternar entre UDFs simples e avançados é uma operação destrutiva. Todas as UDFs simples ou avançadas existentes são excluídas ao alternar para o outro recurso. Certifique-se de fazer backup de todos os dados importantes antes de prosseguir.

De UDFs simples a avançados

Para mudar de UDFs simples para UDFs avançadas, você precisa excluir todas as UDFs existentes:

  1. Liste todas as UDFs armazenadas no livro-razão usando a GET /app/userDefinedFunctions API.

  2. Exclua cada UDF, uma a uma, usando a DELETE /app/userDefinedFunctions/{functionId} API.

De UDFs avançadas a simples

Para alternar de UDFs avançadas para simples, é necessário definir UDFs avançadas com módulos e pontos de extremidade vazios.

  1. Crie um novo pacote de aplicativos com a seguinte estrutura:

    {
    "metadata": {
        "endpoints": {}
    }, 
   "modules": []
}

  2. Implante o pacote de aplicativos com o corpo da solicitação definido na etapa 1 usando a PUT /app/userDefinedEndpoints API.

Próximos passos

Consulte os seguintes artigos para começar a usar as Funções Definidas pelo Utilizador (UDFs) no Azure Confidential Ledger:

Conteúdo relacionado

  • Last updated on