규칙 표현식

내장된 표현식

다른 표현식 문서의 필드에 여러 표현식 문서를 포함하여 복잡한 평가 로직을 처리할 수 있습니다. App Services는 후순으로 표현식을 깊이 우선적 으로 평가합니다.

{
  "%%args.someNumber": {
     "%and": [
        { "$gt": 0 },
        { "$lte": 42 }
     ]
  }
}

다중 필드 표현식

표현식에 둘 이상의 필드가 있는 경우 표현식의 모든 필드가 true로 평가되는 경우에만 해당 표현식은 true 로 평가됩니다. 즉, App Services는 단일 표현식의 여러 필드를 "AND" 연산으로 취급합니다.

{
  "%%args.url": { "$exists": true },
  "%%args.body.userId": "%%user.id"
}

논리적 확장

%%true

Type: boolean

Usable In: Any Expression

true 으로 평가합니다. 중첩된 표현식이 true 로 평가되어야 한다고 어설션하려면 이를 사용합니다.

%%false

Type: boolean

Usable In: Any Expression

false 으로 평가합니다. 중첩된 표현식이 false 로 평가되어야 한다고 어설션하려면 이를 사용합니다.

값 확장

%%values

Type: object

Usable In: Any Expression

애플리케이션의 값 을 나타냅니다. 객체의 각 필드는 값 이름을 해당 JSON 값 또는 시크릿에 매핑합니다.

예시

admin_ids 값이 사용자의 계정 ID를 포함하는 목록인 경우 다음 표현식은 true 으)로 평가됩니다.

{
  "%%user.id": { "$in": "%%values.admin_ids" }
}

환경 확장

%%environment

Type: object

Usable In: Any Expression

현재 앱 환경 을 나타냅니다. 환경 이름(tag)을 읽고 환경 값에 액세스할 수 있습니다.

객체의 각 속성은 환경 값의 이름을 현재 환경의 값에 매핑합니다.

{
  "tag": "<Environment Name>"
  "values": {
    "<ValueName>": <Value>
  }
}

예시

다음은 현재 환경이 "production" 이고 "baseUrl" 환경 값이 정의된 경우 true 로 평가되는 규칙 표현식입니다.

{
  "%%environment.tag": "production",
  "%%environment.values.baseUrl": { "%exists": true }
}

확장 요청

%%request

Type: object

Usable In: Any Expression

들어오는 요청을 나타냅니다.

{
  "httpMethod": "<HTTP Method>",
  "httpReferrer": "<HTTP Referer Header>",
  "httpUserAgent": "<HTTP User Agent>",
  "rawQueryString": "<URL Query String>",
  "remoteIPAddress": "<IP Address>",
  "requestHeaders": {
    "<Header Name>": ["<Header Value>", ...]
  },
  "service": "<Service Name>",
  "action": "<Endpoint Function or Service Action Name>",
  "webhookUrl": "<HTTPS Endpoint Route>"
}

사용자 확장

%%user

Type: object

Usable In: Any Expression

요청을 시작한 사용자를 나타냅니다. 사용자 객체 에는 계정 정보, 인증 제공자의 메타데이터, 앱의 사용자 지정 데이터가 포함되어 있습니다.

{
  "id": "<User Account ID>",
  "type": "<normal | server>",
  "data": {
    "<Field Name>": <Value>,
    ...
  }
  "custom_data": {
    "<Field Name>": <Value>,
    ...
  }
  "identities": [
    {
      "providerType": "<Auth Provider Name>",
      "id": "<Provider User ID"
    }
    ...
  ]
}

%%user.id

Type: string

Usable In: Any Expression

인증된 사용자의 ID입니다.

%%user.type

Type: "normal" | "server"

Usable In: Any Expression

요청을 시작한 사용자 유형입니다. API 키 사용자는 "server" (으)로, 다른 모든 사용자는 "normal" 으)로 평가합니다.

%%user.custom_data

Type: object

Usable In: Any Expression

사용자의 사용자 지정 데이터입니다. 정확한 내용은 사용자 지정 사용자 데이터 구성에 따라 달라집니다.

예시

"custom_data": {
  "primaryLanguage": "English",
}

%%user.data

Type: object

Usable In: Any Expression

사용자의 메타데이터입니다. 정확한 내용은 사용자와 연결된 인증 제공자 ID에 따라 달라집니다.

예시

"data": {
  "name": "Joe Mango",
  "email": "joe.mango@example.com"
}

%%user.identities

Type: object[]

Usable In: Any Expression

사용자와 연결된 모든 인증 제공자 ID 목록입니다. ID는 권한 부여 제공자가 사용자에게 부여한 고유 식별자와 제공자의 유형으로 구성됩니다.

예시

"identities": [
  {
    "id": "5bce299457c70db9bd73b8-aajddbkuvomsvcrjjfoxs",
    "providerType": "local-userpass"
  }
]

MongoDB 문서 확장

%%this

Type: any

Usable In: MongoDB Atlas Data Sources

데이터베이스 작업이 끝날 때 존재하는 특정 필드의 값입니다.

%%prev

Type: any

Usable In: MongoDB Atlas Data Sources

쓰기 작업에 의해 변경되기 전의 특정 필드 값입니다.

%%root

Type: object

Usable In: MongoDB Atlas Data Sources

데이터베이스 작업이 끝날 때 존재하는 전체 문서입니다.

%%prevRoot

Type: object

Usable In: MongoDB Atlas Data Sources

쓰기 작업에 의해 변경되기 전의 전체 문서입니다.

{
  "%or": [
    { "%%prevRoot": { "%exists": %%true } },
    { "%%root.status": "new" }
  ]
}

서비스 확장

%%args

Type: object

Usable In: Third-Party Services

서비스 조치 에 인수로 전달된 값이 포함된 문서입니다. 매개 변수 이름으로 각 인수에 액세스할 수 있습니다.

예시

다음은 발신자의 전화번호( from 인수)가 특정 값과 일치하는 경우 true (으)로 평가하는 Twilio 서비스 규칙입니다.

{
  "%%args.from": "+15558675309"
}

%%partition

Type: string | number | BSON.ObjectId

Usable In: Partion-based Sync

(파티션 기반 동기화 만 해당) 평가 중인 현재 파티션의 파티션 키 값입니다.

EJSON 값 변환

다음 연산자를 사용하면 EJSON과 JSON 표현 간에 값을 변환할 수 있습니다.

%stringToOid

12바이트 또는 24바이트 문자열을 EJSON objectId 객체로 변환합니다.

예시

{
  "_id": {
    "%stringToOid": "%%user.id"
  }
}

%oidToString

EJSON objectId 객체를 문자열로 변환합니다.

예시

{
  "string_id": {
    "%oidToString": "%%root._id"
  }
}

%stringToUuid

36바이트 문자열을 EJSON UUID 객체로 변환합니다.

예시

{
  "_id": {
    "%stringToUuid": "%%user.id"
  }
}

%uuidToString

EJSON UUID 객체를 문자열로 변환합니다.

예시

{
  "string_id": {
    "%uuidToString": "%%root._id"
  }
}

함수 호출

다음 연산자를 사용하면 App Services 애플리케이션에서 함수를 호출할 수 있습니다.

%function

지정된 이름과 인수를 사용하여 함수 를 호출합니다. 함수가 반환하는 값으로 평가합니다.

예시

{
  "%%true": {
    "%function": {
      "name": "isEven",
      "arguments": [42]
    }
  }
}

존재 확인

다음 연산자를 사용하면 값이 객체에 있는지 배열에 있는지 확인할 수 있습니다.

$exists

할당된 필드에 값이 있는지 확인합니다. 결과를 나타내는 부울로 평가합니다.

예시

{
  "url": { "$exists": true }
}

$in

지정된 값 배열을 확인하여 배열에 이 연산자가 할당된 필드의 값이 포함되어 있는지 확인합니다. 결과를 나타내는 부울로 평가합니다.

예시

{
  "url": {
    "$in": [
      "https://www.example.com",
      "https://www.mongodb.com"
    ]
  }
}

$nin

지정된 값 배열을 확인하여 배열에 이 연산자가 할당된 필드의 값이 포함되어 있지 않은지 확인합니다. 결과를 나타내는 부울로 평가합니다.

예시

{
  "url": {
    "$nin": [
      "https://www.example.com",
      "https://www.mongodb.com"
    ]
  }
}

Compare Values

다음 연산자를 사용하면 확장된 값을 포함한 값을 비교할 수 있습니다.

$eq

할당된 필드가 지정된 값과 같은지 확인합니다. 결과를 나타내는 부울로 평가합니다.

예시

{ "score": { "$eq": 42 } }

$ne

할당된 필드가 지정된 값과 같지 않은지 확인합니다. 결과를 나타내는 부울로 평가합니다.

예시

{ "numPosts": { "$ne": 0 } }

$gt

할당된 필드가 지정된 값보다 엄밀히 큰지 확인합니다. 결과를 나타내는 부울로 평가합니다.

예시

{ "score": { "$gt": 0 } }

$gte

할당된 필드가 지정된 값보다 크거나 같은지 확인합니다. 결과를 나타내는 부울로 평가합니다.

예시

{ "score": { "$gte": 0 } }

$lt

할당된 필드가 지정된 값보다 작은지 확인합니다. 결과를 나타내는 부울로 평가합니다.

예시

{ "score": { "$lt": 0 } }

$lte

할당된 필드가 지정된 값보다 작거나 같은지 확인합니다. 결과를 나타내는 부울로 평가합니다.

예시

{ "score": { "$lte": 0 } }