양식 스크립팅 빠른 참조

이름으로 특성 액세스

var nameAttribute = Xrm.Page.getAttribute("name");

거래처 이름 필드의 특성을 nameAttribute 변수에 할당합니다.

모든 특성 액세스

var allAttributes = Xrm.Page.getAttribute();

Xrm.Page.data.entity.attributes 컬렉션의 모든 특성의 배열을 allAttributes 변수에 할당합니다.

특성 값 가져오기

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_getValue

var nameValue = Xrm.Page.getAttribute("name").getValue();

거래처 이름 필드의 값을 nameValue 변수에 할당합니다.

옵션 집합 특성의 현재 선택한 옵션의 텍스트 값을 가져옵니다.

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_getText

var addressType = Xrm.Page.getAttribute("address1_addresstypecode").getText();

주소 유형 필드에서 선택한 옵션의 텍스트를 addressType 변수에 할당합니다.

특성 유형 가져오기

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_getAttributeType

var attributeType = Xrm.Page.getAttribute(0).getAttributeType();

첫 번째 특성의 유형을 나타내는 문자열 값을 attributeType 변수에 할당합니다.

Boolean 또는 optionset 특성의 초기 값 가져오기

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_getInitialValue

var attributeInitialValue = Xrm.Page.getAttribute("address1_addresstypecode").getInitialValue();

주소 유형 필드의 첫 숫자 값을 attributeInitialValue 변수에 할당합니다.

조회 특성이 당사자 목록 조회를 나타내는지 여부를 결정합니다.

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_getIsPartyList

var isPartyList = Xrm.Page.getAttribute("to").getIsPartyList();

전자 메일 엔터티 받는 사람 필드가 당사자 목록 조회를 나타내는지 여부를 나타내는 Boolean 값을 할당합니다.

이 메서드는 41462684-3e5d-4858-8be4-1a7c4fcdeff6#BKMK_UpdatedEntties에만 사용할 수 있습니다.

문자열이 포함된 특성에 대해 허용되는 최대 길이를 가져옵니다.

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_getMaxLength

var newAccountName = "A Store";
var nameTooLong = (newAccountName.length > Xrm.Page.getAttribute("name").getMaxLength())

newAccountName 변수의 값이 거래처 이름 필드에 허용되는 최대 길이를 초과하는지 여부를 나타내는 Boolean 값을 nameTooLong 변수에 할당합니다.

특성의 논리적 이름 가져오기

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_getName

var attributeName = Xrm.Page.getAttribute(0).getName();

페이지에서 첫 번째 특성의 논리적 이름 값을 attributeName 변수에 할당합니다.

숫자 특성에 대한 정밀도 수준을 나타내는 숫자 값 가져오기

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_getPrecision

var creditLimitPrecision = Xrm.Page.getAttribute("creditlimit").getPrecision();

신용 한도액 필드의 정밀도 값을 creditLimitPrecision 변수에 할당합니다.

레코드를 저장하기 위해 필드에 데이터가 필요한지 여부 변경

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_setRequiredLevel

Xrm.Page.getAttribute("creditlimit").setRequiredLevel("required");

신용 한도액 필드를 필수 필드로 만듭니다.

레코드를 저장할 때 특성의 데이터를 저장할지 여부 제어

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_setSubmitMode

Xrm.Page.getAttribute("name").setSubmitMode("always");

예제에서는 거래처 이름 필드 값이 변경되지 않아도 항상 저장하도록 합니다.

레코드가 저장되지 않도록 방지합니다.

function My_PreventSaveFunction(eContext) {
 eContext.getEventArgs().preventDefault();
}

eContext 매개 변수를 사용하여 실행 텍스트를 캡처하고 이벤트 인수에 포함된 preventDefault 메서드를 사용합니다.

데이터가 잘못되었음을 나타내도록 컨트롤 옆에 메시지를 표시합니다.

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_setnotification

Xrm.Page.getAttribute("name").controls.forEach(
function (control, i) {
control.setNotification("'Test' is not a valid name.");
})

거래처 이름 특성의 양식에 있는 모든 컨트롤에 유효성 검사 오류 메시지를 설정합니다.

이 메시지가 표시되는 동안에는 레코드를 저장할 수 없습니다.

이 메서드는 41462684-3e5d-4858-8be4-1a7c4fcdeff6#BKMK_UpdatedEntties에만 사용할 수 있습니다.

양식 수준 알림을 표시합니다.

0375b206-d2bf-4034-a41d-fb476ecb4438#BKMK_setFormNotification

Xrm.Page.ui.setFormNotification(
"Hello",
"INFO",
"helloMsg"
);

시스템 정보 아이콘으로 양식 맨 위에 “Hello” 메시지를 표시합니다.

이 메서드는 41462684-3e5d-4858-8be4-1a7c4fcdeff6#BKMK_UpdatedEntties에만 사용할 수 있습니다.

콜백 함수를 사용하여 비차단 경고 대화 상자를 표시합니다.

72a66f93-92df-42b9-a8fd-b6125c7fe83b#BKMK_alertDialog

var alertDisplayed = false;
Xrm.Utility.alertDialog(
"Showing Alert",
function () { alertDisplayed = true; }
)

경고를 표시하고 닫히면 alertDisplayed 변수의 값을 설정합니다.

이 메서드는 41462684-3e5d-4858-8be4-1a7c4fcdeff6#BKMK_UpdatedEntties에만 사용할 수 있습니다.

특정 특성에 대한 모든 컨트롤 액세스

var nameControls = Xrm.Page.getAttribute("name").controls.get();

name 특성의 모든 컨트롤에 대한 배열을 nameControls 변수에 할당합니다.

인덱스로 컨트롤 액세스

var firstControl = Xrm.Page.getControl(0);

Xrm.Page.ui.controls 컬렉션의 첫 번째 컨트롤을 firstControl 변수에 할당합니다.

특정 조건을 만족하는 모든 컨트롤 액세스

var optionsetControls = Xrm.Page.getControl(function (control, index) {
return control.getControlType() == "optionset";
});

컨트롤 유형이 “옵션 집합”인 경우 true를 반환하는 익명 함수에 설정된 조건을 만족하는 Xrm.Page.ui.controls 컬렉션의 모든 특성의 배열을 optionsetControls 변수에 할당합니다.

컨트롤이 표시되는지 여부 확인

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getVisible

var isNameVisible = Xrm.Page.getControl("name").getVisible();

Boolean 값을 거래처 이름 필드가 표시되는지 여부를 나타내는 isNameVisible 변수에 할당합니다.

컨트롤의 특성에 대한 참조 가져오기

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getAttribute

var nameAttribute = Xrm.Page.getControl("name").getAttribute();

거래처 이름 필드의 컨트롤에 대한 특성을 nameAttribute 변수에 할당합니다.

컨트롤이 활성화되는지 여부 확인

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getDisabled

var disabledControls = Xrm.Page.getControl(function(control, index) { return control.getDisabled(); });

비활성화된 컨트롤의 배열을 disabledControls 변수에 할당합니다.

컨트롤의 레이블 가져오기

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getLabel

var nameControlLabel = Xrm.Page.getControl("name").getLabel();

거래처 이름 필드의 컨트롤 값을 nameControlLabel 변수에 할당합니다.

컨트롤의 이름 가져오기

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getName

var firstControlName = Xrm.Page.getControl(0).getName();

Xrm.Page.ui.controls 컬렉션의 첫 번째 컨트롤의 이름을 firstControlName 변수에 할당합니다.

컨트롤에 포커스 설정

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_setFocus

Xrm.Page.getControl("name").setFocus();

거래처 이름 필드에서 포커스를 설정합니다.

옵션 집합 컨트롤에 옵션 추가

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_addOption

var addressTypeCodeControl = Xrm.Page.getControl("address1_addresstypecode");
var billToAddressOption = addressTypeCodeControl.getAttribute().getOption(1);
addressTypeCodeControl.clearOptions();
addressTypeCodeControl.addOption(billToAddressOption);

주소 유형 필드의 컨트롤에 대한 참조를 사용하면 컨트롤에 대한 특성에 액세스하고 6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_getOption 메서드를 사용하여 청구지 옵션을 나타내는 옵션으로 billToAddressOption 변수를 설정합니다.

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_clearOptions을 사용하여 기존 옵션을 제거하고 addOption을 사용하여 billToAddressOption을 이 컨트롤에 사용할 수 있는 유일한 옵션으로 설정합니다.

옵션 집합 컨트롤에서 하나의 옵션을 제거합니다.

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_removeOption

Xrm.Page.getControl("address1_addresstypecode").removeOption(1);

주소 유형 필드에 대한 컨트롤에서 청구지 옵션을 제거합니다.

Silverlight 웹 리소스에 전달되는 데이터 쿼리 문자열 매개 변수의 값을 가져옵니다.

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getData

var dataValue = Xrm.Page.getControl("WebResource_SilverLightControl").getData();

데이터 쿼리 문자열 매개 변수를 통해 전달된 값을 dataValue 변수에 할당합니다.

IFRAME에 표시되는 콘텐츠에 대한 URL을 설정합니다.

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_setSrc

Xrm.Page.getControl("IFRAME_targetPage").setSrc("http://www.bing.com");

컨트롤에 대한 IFRAME.src가 되도록 URL를 설정합니다.

웹 리소스 또는 IFRAME을 나타내는 양식의 개체를 가져옵니다.

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_getObject

var obj = Xrm.Page.getControl("IFRAME_bing").getObject();

개체 참조를 obj 변수에 할당합니다.IFRAME의 경우 IFRAME DOM(문서 개체 모델) 요소입니다.Silverlight 웹 리소스의 경우 포함된 Silverlight 플러그 인을 나타내는 개체 요소입니다.

조회할 사용자 지정 보기를 추가합니다.

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_addCustomView

var viewId = "{C7034F4F-6F92-4DD7-BD9D-9B9C1E996380}";
var viewDisplayName = "SDK Sample View";
var fetchXml = "<fetch version='1.0' " +
"output-format='xml-platform' " +
"mapping='logical'>" +
"<entity name='account'>" +
"<attribute name='name' />" +
"<attribute name='address1_city' />" +
"<order attribute='name' " +
"descending='false' />" +
"<filter type='and'>" +
"<condition attribute='ownerid' " +
"operator='eq-userid' />" +
"<condition attribute='statecode' " +
"operator='eq' " +
"value='0' />" +
"</filter>" +
"<attribute name='primarycontactid' />" +
"<attribute name='telephone1' />" +
"<attribute name='accountid' />" +
"<link-entity "+
"alias='accountprimarycontactidcontactcontactid' " +
"name='contact' " +
"from='contactid' " +
"to='primarycontactid' " +
"link-type='outer' " +
"visible='false'>" +
"<attribute name='emailaddress1' />" +
"</link-entity>" +
"</entity>" +
"</fetch>";
var layoutXml = "<grid name='resultset' " +
"object='1' " +
"jump='name' " +
"select='1' " +
"icon='1' " +
"preview='1'>" +
"<row name='result' " +
"id='accountid'>" +
"<cell name='name' " +
"width='300' />" +
"<cell name='telephone1' " +
"width='100' />" +
"<cell name='address1_city' " +
"width='100' />" +
"<cell name='primarycontactid' " +
"width='150' />" +
"<cell name='accountprimarycontactidcontactcontactid.emailaddress1' " +
"width='150' " +
"disableSorting='1' />" +
"</row>" +
"</grid>";
Xrm.Page.getControl("parentaccountid").addCustomView(viewId, "account", viewDisplayName, fetchXml, layoutXml, true);

사용자 지정 보기가 상위 거래처 조회 필드의 컨트롤에 대한 기본 보기로 추가되도록 viewId, viewDisplayName, fetchXml 및 layoutXml 변수를 설정하여 인수로 전달합니다.

조회할 기본 보기 설정

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_setDefaultView

var viewId = "{C7034F4F-6F92-4DD7-BD9D-9B9C1E996380}";
Xrm.Page.getControl("parentaccountid").setDefaultView(viewId);

상위 거래처 필드의 컨트롤에 대한 기본 보기를 viewId 변수의 id 값으로 설정합니다.

하위 표에 표시되는 데이터 새로 고침

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_refresh

Xrm.Page.getControl("accountcontactsgrid").refresh();

연락처subgrid를 새로 고칩니다.

날짜 컨트롤에 날짜의 시간 부분을 표시할지 여부를 지정합니다.

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_setShowTime

Xrm.Page.getControl("createdon").setShowTime(false);

시간이 표시되지 않도록 만든 날짜 필드를 설정합니다.

이 메서드는 41462684-3e5d-4858-8be4-1a7c4fcdeff6#BKMK_UpdatedEntties에만 사용할 수 있습니다.

탐색 항목의 이름 가져오기

bcf7210d-df71-43a5-8052-a76de0d4763d#BKMK_getId

var navItemIds = [];
Xrm.Page.ui.navigation.items.forEach(
function (item, index)
{ navItemIds.push(item.getId()) }
);

Xrm.Page.ui.navigation.items 컬렉션에 있는 각 탐색 항목의 id 값이 포함된 navItemIds 배열을 만듭니다.

탐색 항목의 레이블 설정

bcf7210d-df71-43a5-8052-a76de0d4763d#BKMK_setLabel

Xrm.Page.ui.navigation.items.get("navAddresses").setLabel("Other Addresses");

추가 주소 탐색 항목 레이블을 기타 주소로 변경합니다.

탐색 항목이 표시되는지 여부 확인

bcf7210d-df71-43a5-8052-a76de0d4763d#BKMK_getVisible

var moreAddressesVisible = Xrm.Page.ui.navigation.items.get("navAddresses").getVisible()

Boolean 값을 moreAddressesVisible 변수에 할당하여 추가 주소 탐색 항목이 표시되는지 여부를 나타냅니다.

탭을 확장할지 축소할지 확인

205390b9-3eda-4a2b-87cb-2a8f83f953da#BKMK_getDisplayState

var isGeneralTabExpanded = (Xrm.Page.ui.tabs.get("general").getDisplayState() == "expanded")

Boolean 값을 일반 탭을 확장할지 여부를 나타내는 isGeneralTabExpanded 변수에 할당합니다.

탭이 표시되는지 여부 확인

205390b9-3eda-4a2b-87cb-2a8f83f953da#BKMK_tabgetVisible

var isGeneralTabVisible = Xrm.Page.ui.tabs.get("general").getVisible();

Boolean 값을 일반 탭을 표시할지 여부를 나타내는 isGeneralTabVisible 변수에 할당합니다.

탭의 레이블 가져오기

205390b9-3eda-4a2b-87cb-2a8f83f953da#BKMK_tabgetLabel

var generalTabLabel = Xrm.Page.ui.tabs.get("general").getLabel();

일반 탭 레이블을 generalTabLabel 변수에 할당합니다.

탭에 포커스 설정

205390b9-3eda-4a2b-87cb-2a8f83f953da#BKMK_tabsetFocus

Xrm.Page.ui.tabs.get("general").setFocus();

일반 탭에서 포커스를 설정합니다.

섹션의 상위 탭 가져오기

a90df20b-42a6-444e-9912-e0ffab11daec#BKMK_sectionGetParent

Xrm.Page.getControl("industrycode").getParent().getParent().setFocus();

산업 필드가 포함된 탭에 포커스를 설정합니다.

섹션 표시 또는 숨기기

a90df20b-42a6-444e-9912-e0ffab11daec#BKMK_sectionSetVisible

Xrm.Page.getControl("industrycode").getParent().setVisible(false);

산업 필드가 들어 있는 섹션을 숨깁니다.

섹션의 레이블 변경

a90df20b-42a6-444e-9912-e0ffab11daec#BKMK_sectionSetLabel

Xrm.Page.getControl("industrycode").getParent().setLabel("Detailed Information");

산업 필드가 포함된 섹션의 레이블을 자세한 정보로 변경합니다.

OnSave 이벤트에 함수 추가

fbaf2e7a-db2f-448f-bd24-6b3ca1ccb28e#BKMK_addOnSave

Xrm.Page.data.entity.addOnSave(myFunction);

myFunction 함수를 OnSave 이벤트에 추가합니다.

특성의 OnChange 이벤트에 함수를 추가합니다.

6881e99b-45e4-4552-8355-2eef296f2cd8#BKMK_addOnChange

Xrm.Page.getAttribute("name").addOnChange(myFunction);

myFunction 함수를 거래처 이름 필드의 OnChange 이벤트에 추가합니다.

조회 컨트롤의 PreSearch 이벤트에 함수를 추가합니다.

51828fe3-f6ff-4f97-80ed-b06b3a354955#BKMK_addPreSearch

다음 코드 샘플은 영업 기회 양식 거래처(parentaccountid) 조회용입니다.Sdk.setParentAccountIdFilter 함수가 양식 Onload 이벤트 처리기에 설정되면 Sdk.filterCustomAccounts 함수는 해당 조회를 위해 PreSearch 이벤트에 추가됩니다. 결과적으로 선호 고객 (1)의 범주(accountcategorycode) 값을 갖는 거래처만 반환됩니다.

var Sdk = window.Sdk || {};

Sdk.filterCustomerAccounts = function () {
    //Only show accounts with the type 'Preferred Customer'
    var customerAccountFilter = "<filter type='and'><condition attribute='accountcategorycode' operator='eq' value='1'/></filter>";
    Xrm.Page.getControl("parentaccountid").addCustomFilter(customerAccountFilter, "account");
}
//set 'Sdk.setParentAccountIdFilter' in the Opportunity form Onload event handler
Sdk.setParentAccountIdFilter = function () {
    Xrm.Page.getControl("parentaccountid").addPreSearch(Sdk.filterCustomerAccounts);
}

조직에 연결할 URL을 가져옵니다.

getClientUrl

var serverUrl = Xrm.Page.context.getClientUrl();

URL을 나타내는 문자열을 serverUrl 변수에 할당합니다.

현재 사용자의 이름을 가져옵니다.

getUserName

var userName = Xrm.Page.context.getUserName();

사용자의 이름을 나타내는 문자열을 userName 변수에 할당합니다.

이 메서드는 41462684-3e5d-4858-8be4-1a7c4fcdeff6#BKMK_UpdatedEntties에만 사용할 수 있습니다.

현재 사용자 및 사용자가 연결된 팀에 할당된 각 보안 역할에 대한 GUID를 나타내는 문자열 배열을 가져옵니다.

getUserRoles

var userRoles = Xrm.Page.context.getUserRoles();

사용자의 보안 역할을 나타내는 문자열 배열을 userRoles 변수에 할당합니다.

사용자가 Microsoft Office Outlook용 Microsoft Dynamics 365(오프라인 액세스 가능) 클라이언트에서 오프라인으로 작업하고 있는지 여부를 결정합니다.

클라이언트.getClientState

var IsOffline = (Xrm.Page.context.client.getClientState() == "Offline");

사용자가 현재 오프라인으로 작업하고 있는 여부를 나타내는 Boolean 값을 IsOffline 변수에 할당합니다.

현재 엔터티의 논리적 이름 가져오기

fbaf2e7a-db2f-448f-bd24-6b3ca1ccb28e#BKMK_getEntityName

var entityName = Xrm.Page.data.entity.getEntityName();

논리 엔터티 이름을 entityName 변수에 할당합니다.

현재 레코드의 Id 가져오기

fbaf2e7a-db2f-448f-bd24-6b3ca1ccb28e#BKMK_getId

var recordId = Xrm.Page.data.entity.getId();

레코드의 id를 recordId 변수에 할당합니다.

현재 레코드 저장

Xrm.Page.data.entity.fbaf2e7a-db2f-448f-bd24-6b3ca1ccb28e#BKMK_save

Xrm.Page.data.entity.save();

레코드를 저장합니다. 선택적 인수가 있습니다.saveandclose 또는 saveandnew를 사용하여 동일한 작업을 수행합니다.

현재 레코드의 데이터가 변경되는지 여부를 결정합니다.

fbaf2e7a-db2f-448f-bd24-6b3ca1ccb28e#BKMK_getIsDirty

var isDirty = Xrm.Page.data.entity.getIsDirty();

레코드의 데이터가 변경되었는지 여부를 나타내는 Boolean 값을 isDirty 변수에 할당합니다.