Docs Menu
Docs Home
/
MongoDB Atlas
/
Atlas App Services
/
参照
/
アプリ構成ファイル

関数構成ファイル

項目一覧

  • 関数マニフェスト
  • 関数ソースコード
app/
└── functions/
    ├── config.json
    └── <function>.js

関数マニフェスト

アプリ内のすべての関数には、関数マニフェスト ファイルに対応するメタデータ エントリがあります: /functions/config.json 。

Tip

Atlas App Services は、構成がまだ定義されていない場合、インポート時にマニフェストに関数を自動的に追加します。 デフォルト設定で問題がなければ、関数の構成の定義をスキップして、Atlas App Services がそれを行うことができます。 次回 アプリをエクスポートまたはプルするときに、マニフェストには生成された構成が含まれます。

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>"
  },
  ...
]
フィールド
説明
name
string
関数の名前。 名前はソースコード ファイルのファイル名と一致し、アプリケーション内のすべての関数間で一意である必要があります。
private
boolean
trueの場合、この関数は他の関数または%functionルール式でのみ呼び出されます。 クライアント アプリケーションから、または SDK を使用してプライベート関数を直接呼び出すことはできません。
can_evaluate
object
関数の実行が許可されている場合はtrueと評価されるJSON 式。 App Services は受信リクエストごとにこの式を評価します。
disable_arg_logs
boolean
run_as_system
boolean
trueの場合、この関数は システムユーザー として実行されます。 これにより、 run_as_user_idとrun_as_user_id_script_sourceに定義された値がすべて上書きされます。
run_as_user_id
string
関数が常に実行されるApp Services ユーザーの一意の ID。 run_as_user_id_script_sourceとは併用できません。
run_as_user_id_script_source
string
関数が呼び出されるたびに実行され、関数が実行されるApp Services ユーザーの一意の ID を返す文字列化された関数。 run_as_user_idとは併用できません。

関数ソースコード

関数のソースコードは、ファイル名として関数名を使用する/functionsディレクトリ内の.jsファイルで定義します。 各ファイルは、リクエストで関数が呼び出されるたびに実行されるメイン関数をエクスポートする必要があります。

重要

すべての関数ソースコード ファイルは/functionsディレクトリにある必要があります。

<function name>/functions/[関数名]>.js
exports = function addOne(input) {
  if(typeof input !== "number") {
    throw new Error("You must call addOne() with a number");
  }
  return input + 1;
};

戻る

環境値