컨트롤에 대한 오류 또는 권장 사항 알림을 표시하고 알림에 따라 실행할 작업을 지정할 수 있습니다. 오류 유형의 알림을 지정하면 컨트롤 옆에 빨간색 "X" 아이콘이 나타납니다. 알림의 권장 사항 유형을 지정하면 컨트롤 옆에 "i" 아이콘이 나타납니다. Dynamics 365 모바일 클라이언트에서 아이콘을 탭하면 메시지가 표시되고 적용 단추를 클릭하거나 메시지를 해제하여 구성된 작업을 수행할 수 있습니다.
지원되는 컨트롤 형식
All
Syntax
formContext.getControl(arg).addNotification(notification);
매개 변수
| 이름 | 유형 | 필수 | Description |
|---|---|---|---|
notification |
Object | Yes | 추가할 알림입니다.
매개 변수 참조notification |
notification 매개 변수
매개 변수는 notification 다음 속성을 가진 개체를 허용합니다.
| 이름 | 유형 | 필수 | Description |
|---|---|---|---|
actions |
객체 배열 | 아니오 | 속성 참조 actions |
messages |
문자열 배열 | Yes | 알림에 표시할 메시지입니다. 현재 릴리스에서는 이 배열에 지정된 첫 번째 메시지만 표시됩니다. 여기서 지정한 문자열은 알림에 굵은 텍스트로 표시되며 일반적으로 알림의 제목 또는 제목에 사용됩니다. 최적의 사용자 환경을 위해 메시지를 50자로 제한해야 합니다. |
notificationLevel |
String | Yes | 알림 유형을 정의합니다. 유효한 값은 ERROR 또는 RECOMMENDATION. |
uniqueId |
String | Yes | clearNotification 메서드를 사용할 때 이 알림을 지우는 데 사용할 ID입니다. |
actions 속성
속성에는 actions 다음 속성이 있는 개체의 배열이 포함됩니다.
| 이름 | 유형 | 필수 | Description |
|---|---|---|---|
message |
String | 아니오 | 사용자에게 표시할 알림의 본문 메시지입니다. 최적의 사용자 환경을 위해 메시지를 100자로 제한합니다. |
actions |
함수 배열 | 아니오 | 메시지에 대한 해당 작업입니다. |
반환 값
형식: 부울
설명: 메서드가 성공했는지 여부를 나타냅니다.
비고
웹 클라이언트에서 addNotification 메서드는 지정한 메시지와 적용 및해제라는 두 개의 표준 단추가 있는 알림을 표시합니다. 적용을 클릭하면 정의한 작업이 실행됩니다. 해제를 클릭하면 알림 메시지가 닫힙니다.
통합 인터페이스:
- 해제 단추가 없습니다.
- 적용 단추는 알림 수준이 ERROR가 아닌 RECOMMENDATION로 설정된 경우에만 나타납니다.
Example
다음 샘플 코드는 계정 이름 열에 "Microsoft" 가 포함되어 있고 눈금 기호가 아직 "MSFT"로 설정되지 않은 경우 티커 기호 를 설정하기 위한 계정 양식의 계정 이름 열에 알림을 표시합니다. 알림에서 적용 을 클릭하면 Ticker 기호 열이 "MSFT"로 설정됩니다.
function addTickerSymbolRecommendation(executionContext) {
var formContext = executionContext.getFormContext();
var myControl = formContext.getControl('name');
var accountName = formContext.data.entity.attributes.get('name');
var tickerSymbol = formContext.data.entity.attributes.get('tickersymbol');
if (accountName.getValue() == 'Microsoft' && tickerSymbol.getValue() != 'MSFT') {
var actionCollection = {
message: 'Set the Ticker Symbol to MSFT?',
actions: null
};
actionCollection.actions = [function () {
tickerSymbol.setValue('MSFT');
myControl.clearNotification('my_unique_id');
}];
myControl.addNotification({
messages: ['Set Ticker Symbol'],
notificationLevel: 'RECOMMENDATION',
uniqueId: 'my_unique_id',
actions: [actionCollection]
});
}
else
console.log("Notification not set");
}
모델 기반 앱에 알림이 표시되는 방법은 다음과 같습니다.
