navigateTo (referência da API do cliente)

Navega até a lista de tabelas especificada, o registro de tabela, o recurso da Web HTML ou a página personalizada.

Sintaxe

Xrm.Navigation.navigateTo(pageInput,navigationOptions).then(successCallback,errorCallback);

Parâmetros

parâmetro pageInput

A definição de objeto muda dependendo do tipo de página para a qual navegar: lista de entidades, registro de entidade, painel, recurso da Web HTML ou página personalizada.

Lista de entidades

O objeto entity list contém os seguintes valores.

Registo de entidade

O objeto de registro de entidade contém os seguintes valores.

Objeto de relacionamento

O objeto relationship, usado no registro Entity, contém os seguintes valores.

Dashboard

O objeto dashboard contém os seguintes valores.

Recurso da Web HTML

O objeto de recurso da Web HTML contém os seguintes valores.

Página personalizada

O objeto de página personalizada contém os seguintes valores.

parâmetro navigationOptions

O objeto navigationOptions contém os seguintes valores.

Valor de retorno

Devolve uma promessa. O valor passado quando a promessa é resolvida depende do destino:

• inline: Promise resolve imediatamente e não retorna nenhum valor.

• diálogo : Promessa é resolvido quando a caixa de diálogo é fechada. Um objeto é passado somente se o pageType = entityRecord e você abriu o formulário no modo de criação. O objeto tem uma savedEntityReference matriz com as seguintes propriedades para identificar o registro de tabela criado:

  • entityType: O nome lógico da tabela.
  • id: uma representação de cadeia de caracteres de um valor GUID para o registro.
  • name: O valor da coluna primária do registro exibido ou criado.

Example

Exemplo 1: Abrir lista de contas

var pageInput = {
    pageType: "entitylist",
    entityName: "account"
};
Xrm.Navigation.navigateTo(pageInput).then(
    function success() {
            // Run code on success
    },
    function error() {
            // Handle errors
    }
);

Exemplo 2: Abrir um registo de conta existente numa caixa de diálogo

var pageInput = {
    pageType: "entityrecord",
    entityName: "account",
    entityId: "00aa00aa-bb11-cc22-dd33-44ee44ee44ee" //replace with actual ID
};
var navigationOptions = {
    target: 2,
    height: {value: 80, unit:"%"},
    width: {value: 70, unit:"%"},
    position: 1
};
Xrm.Navigation.navigateTo(pageInput, navigationOptions).then(
    function success() {
            // Run code on success
    },
    function error() {
            // Handle errors
    }
);

Exemplo 3: Abrir um formulário de conta no modo de criação dentro de uma caixa de diálogo

var pageInput = {
    pageType: "entityrecord",
    entityName: "account"    
};
var navigationOptions = {
    target: 2,
    height: {value: 80, unit:"%"},
    width: {value: 70, unit:"%"},
    position: 1
};
Xrm.Navigation.navigateTo(pageInput, navigationOptions).then(
    function success(result) {
            console.log("Record created with ID: " + result.savedEntityReference[0].id + 
            " Name: " + result.savedEntityReference[0].name)
            // Handle dialog closed
    },
    function error() {
            // Handle errors
    }
);

Exemplo 4: Abrir um recurso da Web HTML em uma caixa de diálogo

var pageInput = {
    pageType: "webresource",
    webresourceName: "new_sample_webresource.htm"
};
var navigationOptions = {
    target: 2,
    width: 500, // value specified in pixel
    height: 400, // value specified in pixel
    position: 1
};
Xrm.Navigation.navigateTo(pageInput, navigationOptions).then(
    function success() {
            // Run code on success
    },
    function error() {
            // Handle errors
    }
);

Artigos relacionados

Xrm.Navegação
Navegar de e para uma página personalizada (pré-visualização)