Archivos de configuración de funciones

Atlas App Services ha llegado al final de su ciclo de vida y MongoDB ya no ofrece soporte activo. Los activadores siguen disponibles en la interfaz de usuario de Atlas. Consulte Página de desuso para más detalles.

app/
└── functions/
    ├── config.json
    └── <function>.js

Manifiesto de función

Cada función de su aplicación tiene una entrada de metadatos correspondiente en el archivo de manifiesto de la función: /functions/config.json.

Tip

Atlas App Services añade automáticamente funciones al manifiesto al importarlas si aún no tienen una configuración definida. Si la configuración predeterminada no le preocupa, puede omitir la configuración de una función y dejar que App Services lo haga automáticamente. El manifiesto incluirá las configuraciones generadas la próxima vez que exporte o extraiga su aplicación.

functions/config.json

[
  {
    "name": "<Function Name>",
    "private": <Boolean>,
    "can_evaluate": { <JSON Expression> },
    "disable_arg_logs": <Boolean>,
    "run_as_system": <Boolean>,
    "run_as_user_id": "<App Services User ID>",
    "run_as_user_id_script_source": "<Function Source Code>"
  },
  ...
]

Campo	Descripción
`name` `string`	El nombre de la función. Debe coincidir con el nombre del archivo de código fuente y ser único entre todas las funciones de la aplicación.
`private` `boolean`	Si `true` es, esta función solo se puede llamar desde otras funciones o en expresiones de regla. No se puede llamar a una función privada directamente desde una aplicación cliente ni con un `%function` SDK.
`can_evaluate` `object`	Una expresión JSON que evalúa `true` como si se permite la ejecución de la función. App Services evalúa esta expresión para cada solicitud entrante.
`disable_arg_logs` `boolean`	Si `true`, App Services omite los argumentos proporcionados a la función en la entrada del registro de ejecución de la función.
`run_as_system` `boolean`	Si `true`, esta función se ejecuta como el usuario del sistema. Esto reemplaza cualquier valor definido para `run_as_user_id` y `run_as_user_id_script_source`.
`run_as_user_id` `string`	El ID único de un usuario de App Services con el que siempre se ejecuta la función. No se puede usar `run_as_user_id_script_source` con.
`run_as_user_id_script_source` `string`	Una función convertida en cadena que se ejecuta al llamarse y devuelve el ID único del usuario de App Services que la ejecuta. No se puede usar `run_as_user_id` con.

Código fuente de la función

El código fuente de una función se define en un archivo .js dentro del directorio /functions que utiliza el nombre de la función como nombre de archivo. Cada archivo debe exportar la función principal que se ejecuta cuando una solicitud la llama.

Importante

Todos los archivos de código fuente de sus funciones deben estar en el directorio /functions.

/funciones/<nombre de la<function name> función>.js

exports = function addOne(input) {
  if(typeof input !== "number") {
    throw new Error("You must call addOne() with a number");
  }
  return input + 1;
};

Volver

Valores ambientales

GraphQL