navigateTo (referência da API do cliente)

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

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 navegar até: lista de entidades, registro de entidade, painel, recurso web HTML ou página personalizada.

Lista de entidades

O objeto de lista de entidades contém os valores a seguir.

Registro da entidade

O objeto de registro de entidade contém os valores a seguir.

Objeto Relationship

O objeto de relação, usado no registro Entity, contém os valores a seguir.

Dashboard

O objeto dashboard contém os valores a seguir.

Recurso da Web HTML

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

Página personalizada

O objeto de página personalizado contém os valores a seguir.

Parâmetro navigationOptions

O objeto navigationOptions contém os valores a seguir.

Valor de retorno

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

• embutido: a promessa é resolvida imediatamente e não retorna nenhum valor.

• caixa de diálogo: a promessa é resolvida quando a caixa de diálogo é fechada. Um objeto será passado somente se você pageType = entityRecord 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.
  • nome: 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 registro de conta existente em uma 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 em 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.Navigation
Navegando de e para uma página personalizada (versão prévia)