Documentos de API

URL de generación de página

URL de Generar Página - kintone.buildPageUrl(page, params)

Genera la URL de la página.

Función

Escritorio

kintone.buildPageUrl(page, params)

Parámetros

Parámetro Tipo Obligatorio Descripción
página String Sí Una cadena que representa la página.
Especifica uno de los siguientes valores:
  • Páginas de la app
    • APP_INDEX: Lista de registros (escritorio)
      params.appId es obligatorio. params.viewId se puede especificar.
    • APP_CREATE: Crear registro (escritorio)
      params.appId es obligatorio.
    • APP_DETAIL: Detalles de registro (escritorio)
      params.appId y params.recordId son obligatorios.
    • APP_EDIT: Edición de registros (escritorio)
      params.appId y params.recordId son obligatorios.
    • APP_PRINT: Impresión de registros (escritorio)
      params.appId y params.recordId son obligatorios.
    • APP_REPORT: Graph (escritorio)
      params.appId y params.reportId son obligatorios.
    • APP_INDEX_MOBILE: Lista de Registros (móvil)
      params.appId es obligatorio. params.viewId se puede especificar.
    • APP_CREATE_MOBILE: Crear registros (móvil)
      params.appId es obligatorio.
    • APP_DETAIL_MOBILE: Detalles del registro (móvil)
      params.appId y params.recordId son obligatorios.
    • APP_EDIT_MOBILE: Record Edit (móvil)
      params.appId y params.recordId son obligatorios.
    • APP_REPORT_MOBILE: Graph (móvil)
      params.appId y params.reportId son obligatorios.
  • Páginas del portal
    • PORTAL_TOP: Página principal del portal (escritorio)
      No se requieren parámetros.
    • PORTAL_TOP_MOBILE: Página principal del portal (móvil)
      No se requieren parámetros.
  • Páginas de espacio
    • SPACE_PORTAL: Space Portal (escritorio)
      params.spaceId es obligatorio.
    • SPACE_PORTAL_MOBILE: Space Portal (móvil)
      params.spaceId es obligatorio.
    • SPACE_THREAD: Hilo (escritorio)
      params.spaceId y params.threadId son obligatorios.
    • SPACE_THREAD_MOBILE: Thread (móvil)
      params.spaceId y params.threadId son obligatorios.
    Para las páginas del Portal Espacial, si el ID de espacio especificado pertenece a un Espacio de hilo único, se generará la URL del hilo predeterminado.
  • Páginas de People
    • PEOPLE_TOP: Top (escritorio)
      params.userCode es obligatorio.
    • PEOPLE_TOP_MOBILE: Top (móvil)
      params.userCode es obligatorio.
  • Páginas de mensajes
    • MESSAGE_TOP: Top (escritorio)
      params.userCode es obligatorio.
    • MESSAGE_TOP_MOBILE: Top (móvil)
      params.userCode es obligatorio.
  • Páginas de búsqueda
    • SEARCH_TOP: Búsqueda (escritorio)
      No se requieren parámetros.
    • SEARCH_TOP_MOBILE: Búsqueda (móvil)
      No se requieren parámetros.
  • Páginas de notificaciones
    • NOTIFICATION_TOP: Notificación (escritorio)
      No se requieren parámetros.
  • Páginas del App Marketplace
    • APP_MARKETPLACE_TOP: App Marketplace (escritorio)
      No se requieren parámetros.
params Objeto Sí Los parámetros usados para construir la URL.
params.appId String Requerido condicionalmente El identificador de la aplicación.
Obligatorio para las páginas de la App.
params.recordId String Requerido condicionalmente El ID de registro.
Es necesario para los detalles de los registros, edición de registros e impresión de los registros.
params.viewId String Opcional El ID de Visualización
params.reportId String Requerido condicionalmente El ID del informe.
Obligatorio para páginas de gráficos.
params.spaceId String Requerido condicionalmente El ID del espacio.
Obligatorio para páginas espacio.
params.threadId String Requerido condicionalmente El identificador del subproceso.
Obligatorio para páginas de hilos.
params.userCode String Requerido condicionalmente El código de usuario.
Obligatorio para personas y páginas de mensajes.

Devuelve

Un Promise objeto.
Los siguientes valores se pueden recuperar cuando el Promise objeto se cumple:

Tipo Descripción
String URL de la página

Páginas disponibles

Sin embargo, no se puede utilizar en las siguientes páginas:

  • Resultados de la búsqueda
  • Marketplace
  • Configuración del plug-in

Notas

Esta API recupera datos del servidor en tiempo de ejecución. Los datos recuperados se almacenan en caché hasta que ocurre una transición de página.
Si los datos se recuperan del servidor más de 50 veces por minuto por usuario, el retorno Promise El objeto será rechazado.

La URL del espacio de invitados se generará en los siguientes casos:

  • Si se especifica un espacio de invitados, la aplicación es la siguiente.
  • El usuario que ejecutará la API es un usuario invitado.
  • Si se especifica un ID de espacio de invitado.