navigateTo (referencia de la API de cliente)

Navega a la lista de tabla, registro de tabla, recurso web HTML o página personalizada especificados.

Syntax

Use la sintaxis siguiente para llamar a Xrm.Navigation.navigateTo().

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

Parámetros

El método acepta los parámetros siguientes.

Parámetro pageInput

La definición de objeto cambia en función del tipo de página para navegar a: lista de entidades, registro de entidad, panel, recurso web HTML, página personalizada o página generativa.

Lista de entidades

El objeto lista de entidades contiene los siguientes valores.

Registro de entidad

El objeto registro de entidades contiene los siguientes valores.

Objeto de relación

El objeto de relación, utilizado en el registro de entidades, contiene los siguientes valores.

Panel de información

Use este objeto como pageInput parámetro cuando desee abrir un panel.

El objeto del panel contiene los siguientes valores.

Recurso web HTML

Use este objeto como pageInput parámetro cuando desee abrir un recurso web HTML.

El objeto del recurso web HTML contiene los siguientes valores.

Página personalizada

Use este objeto como parámetro pageInput cuando desee abrir una página personalizada.

El objeto de página personalizado contiene los valores siguientes.

Página generativa

Use este objeto como pageInput parámetro cuando desee abrir una página generativa.

Para usar recordId, entityNameo data, la página generativa de destino debe configurarse para aceptar parámetros de entrada.

El objeto de página generativa contiene los siguientes valores.

Consulte ejemplos que muestran cómo navegar a una página generativa y desde ella mediante la API de cliente.

Parámetro navigationOptions

El navigationOptions objeto contiene los valores siguientes.

Valor devuelto

Devuelve una promesa. El valor pasado cuando la promesa se resuelve depende del destino:

• inline: Promise se resuelve inmediatamente y no devuelve ningún valor.

• dialog: Promise se resuelve cuando se cierra el cuadro de diálogo. Un objeto se pasa solo si pageType = entityRecord y abrió el formulario en modo de creación. El objeto tiene una matriz savedEntityReference con las siguientes propiedades para identificar el registro de tabla creado:

  • entityType: el nombre lógico de la tabla.
  • id: Representación en cadena de un valor GUID del registro.
  • name: El valor de la columna principal del registro mostrado o creado.

Ejemplo

En los ejemplos siguientes se muestra cómo navegar a diferentes tipos de página insertados y en un cuadro de diálogo.

Ejemplo 1: lista de cuentas abiertas

Abre la lista de cuentas principal insertada.

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

Ejemplo 2: abrir un registro de cuenta existente dentro de un cuadro de diálogo

Abre un formulario de cuenta existente dentro de un cuadro 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
    }
);

Ejemplo 3: abrir un formulario de cuenta en modo de creación dentro de un cuadro de diálogo

Abre un formulario de cuenta en modo de creación dentro de un cuadro de diálogo y devuelve la referencia de registro creada cuando se guarda.

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
    }
);

Ejemplo 4: abrir un recurso web HTML en un cuadro de diálogo

Abre un recurso web HTML en un cuadro 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
    }
);

Ejemplo 5: Abrir una página generativa con parámetros de entrada en un cuadro de diálogo

Abre una página generativa como un cuadro de diálogo centrado, pasando un identificador de registro, un nombre de entidad y parámetros de datos personalizados. La página generativa debe configurarse para aceptar estos parámetros.

var pageInput = {
    pageType: "generative",
    pageId: "<genPageID>", // replace with the ID of your generative page
    recordId: "00aa00aa-bb11-cc22-dd33-44ee44ee44ee", // replace with actual record GUID
    entityName: "account",
    data: { status: "active", category: "premium" }
};
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
    }
);

Artículos relacionados

Xrm.Navigation
Navegar a y desde una página generativa
Navegar hacia y desde una página personalizada (versión preliminar)