aplicación

Uso

Nota:
Jerarquía
application
Valor predeterminado
Ninguna

Acepta
Es un nombre para la aplicación y los subparámetros que desea definir.

Reglas especiales
El elemento application debe tener un parámetro url o file, pero no ambos

Definición

El parámetro application define una aplicación para el framework de extensión de Looker. Una vez que se agrega una extensión a un proyecto, los usuarios de Looker con los permisos adecuados pueden ver la extensión en el menú Explorar de Looker. Cuando un usuario seleccione la extensión en el menú Explorar, la aplicación se abrirá en Looker.

Si su administrador habilitó la función de Labs de Navegación mejorada, las extensiones aparecerán en la sección Aplicaciones del nuevo panel de navegación izquierdo mejorado.

El parámetro application tiene los siguientes subparámetros:

La aplicación debe tener un parámetro url o file, pero no ambos.

label

Especifica el nombre de la aplicación que se muestra al usuario en el menú Explorar. El label se puede localizar si localizas tu modelo de LookML.

url

El parámetro url se usa solo para fines de desarrollo y debe apuntar a un servidor de desarrollo que se ejecute en la máquina del desarrollador. Por ejemplo:

url: "http://localhost:8080/bundle.js"

Después del desarrollo, puedes arrastrar el archivo al IDE de Looker y, luego, usar el parámetro file para apuntar al archivo.

file

Especifica la ruta a un archivo JavaScript (con una extensión .js) que define la aplicación. La ruta de acceso se relaciona con la raíz del proyecto. Por ejemplo, este parámetro file apunta al archivo bundle.js en el directorio apps del proyecto de LookML:

file: "apps/bundle.js"

sri_hash

Especifica un hash de Integridad del subrecurso (SRI) para fines de verificación de JavaScript. Se puede usar con el parámetro file o url. El valor sri_hash no debe incluir el prefijo sha384-.

sri_hash se ignora si url especifica un servidor de desarrollo.

entitlements

El parámetro entitlements especifica los recursos a los que puede acceder la extensión. La extensión no podrá acceder a los recursos, a menos que se muestre en entitlements.

Una aplicación de extensión debe especificar las autorizaciones; la aplicación no se ejecutará sin ellas.

El parámetro entitlements incluye los siguientes subparámetros. Si no se incluye un subparámetro, de forma predeterminada, la extensión no tiene acceso a ese derecho.

Parámetro Descripción Ejemplo
local_storage Especifica si la extensión tiene permiso para acceder al almacenamiento local. local_storage: yes
navigation Especifica si la extensión puede navegar a una página diferente en Looker. navigation: yes
new_window Especifica si la extensión puede abrir una nueva ventana o pestaña del navegador. new_window: yes
new_window_external_urls Es una lista separada por comas de URL o URL parciales para las que una extensión puede abrir una ventana nueva. Este derecho requiere el derecho new_window. Puedes incluir caracteres comodín, como * para los subdominios y las rutas de acceso. new_window_external_urls: ["https://www.gmail.com"]
use_form_submit Especifica si la extensión tiene permiso para enviar formularios. Los componentes de Looker que usen formularios HTML requerirán que use_form_submit: yes funcione correctamente. use_form_submit: yes
use_embeds Especifica si la extensión puede usar el SDK de incorporación de Looker. use_embeds: yes
use_downloads ADDED 21.6 Especifica si la extensión puede descargar archivos. use_downloads: yes
use_iframes ADDED 21.6 Especifica si la extensión puede crear un iframe. use_iframes: yes
use_clipboard ADDED 21.8 Especifica si la extensión tiene permiso para escribir en el portapapeles del sistema. Por razones de seguridad, las extensiones no pueden leer el contenido del portapapeles del sistema. use_clipboard: yes
core_api_methods Es una lista separada por comas de los métodos de la API de Looker que usa la extensión. core_api_methods: ["run_inline_query", "lookml_model_explore", "all_lookml_models"]
external_api_urls Una lista de URL separadas por comas para API externas que usa la extensión. Como se muestra en el ejemplo, puedes incluir caracteres comodín, como *.

A partir de Looker 21.6, las extensiones que hacen uso directo de llamadas a JavaScript fetch o XHR.open (en lugar de usar las llamadas a la API extensionSDK.fetchProxy o extensionSDK.serverProxy) deben incluir las URL en la lista. 		external_api_urls: ["http://example.com:3000", "https://*.googleapis.com"]
oauth2_urls Una lista de URL separadas por comas para la autenticación y el intercambio de código OAuth 2.0 que utiliza la extensión. oauth2_urls: ["https://accounts.google.com/o/oauth2/v2/auth"]
global_user_attributes Es una lista separada por comas de los atributos de usuario de todo el sistema que usa la extensión. global_user_attributes: ["company", "department"]
scoped_user_attributes Una lista separada por comas de los atributos de usuario específicos de la extensión que esta usa. scoped_user_attributes: ["first_name", "last_name"]

Ejemplo

A continuación, se muestra el parámetro application del archivo de manifiesto del proyecto para el ejemplo de la extensión de receptor de la cocina de Looker:

application: kitchensink {
  label: "Kitchen sink"
  url: "http://localhost:8080/bundle.js"
  entitlements: {
    local_storage: yes
    navigation: yes
    new_window: yes
    use_form_submit: yes
    use_embeds: yes
    core_api_methods: ["all_connections","search_folders", "run_inline_query", "me", "all_looks", "run_look"]
    external_api_urls: ["http://127.0.0.1:3000", "http://localhost:3000", "https://∗.googleapis.com", "https://∗.github.com", "https://REPLACE_ME.auth0.com"]
    oauth2_urls: ["https://accounts.google.com/o/oauth2/v2/auth", "https://github.com/login/oauth/authorize", "https://dev-5eqts7im.auth0.com/authorize", "https://dev-5eqts7im.auth0.com/login/oauth/token", "https://github.com/login/oauth/access_token"]
    scoped_user_attributes: ["user_value"]
    global_user_attributes: ["locale"]
  }
}

Para ver ejemplos adicionales, consulta el repositorio de ejemplos de extensiones de Looker.