Métodos de página para páginas gerativas

Use os métodos de página do dataApi objeto para controlar a página generativa em si, como retornar um valor quando a página é usada como uma caixa de diálogo. Neste momento, há apenas um método de página.

método setPageOutput

Define o valor retornado para o script de chamada quando uma página generativa é aberta quando uma caixa de diálogo é fechada. Esse método só está disponível em hosts que dão suporte ao retorno de valores de caixas de diálogo de página gerativa. Ele não faz parte do contrato compartilhado dataApi , portanto, verifique se ele existe antes de chamá-lo.

Parameters

Name	Tipo	Description
value	desconhecido	O valor a ser retornado para o script que abriu a caixa de diálogo. O valor pode ser primitivo, objeto ou matriz.

Returns

Nenhum valor.

Exemplo de setPageOutput

dataApi.setPageOutput?.({
    action: "selected",
    recordId: selectedRecordId
});

const xrm = (window as any).Xrm;
await xrm.Navigation.navigateBack();

A chamada setPageOutput não fecha a caixa de diálogo nem atualiza a página de chamada. Feche a caixa de diálogo com Xrm.Navigation.navigateBack(). A promessa retornada então Xrm.Navigation.navigateTo é resolvida com um objeto cuja returnValue propriedade contém o valor armazenado mais recentemente. O script de chamada deve aplicar explicitamente o valor retornado ao formulário, à grade ou a outro estado.

Esse método se aplica a páginas generativas abertas como caixas de diálogo. Páginas generativas abertas embutidas ou em um painel lateral do aplicativo não retornam um valor para o script de chamada.