코드 가독성

명명 규칙

일반 명명 규칙

이 섹션에서는 "카멜 표기법" 및 "파스칼 표기법" 명명 규칙을 설명합니다. 해당 용어에 이미 익숙하다면 건너뛰어도 됩니다.

카멜 표기법

컨트롤과 변수에는 카멜 표기법을 사용해야 합니다. 카멜 표기법은 소문자 접두사로 시작하고, 개체 또는 변수 이름에서 모든 공백을 제거하고, 첫 번째 단어 뒤의 각 단어의 첫 글자를 대문자로 표시합니다. 예를 들어 텍스트 입력 컨트롤의 이름은 txtUserEmailAddress일 수 있습니다.

파스칼 표기법

데이터 원본에는 파스칼 표기법을 사용해야 합니다. 파스칼 표기법은 때때로 "대문자 카멜 표기법"이라고도 합니다. 카멜 표기법과 마찬가지로 모든 공백을 제거하고 단어의 첫 글자를 대문자로 표시합니다. 그러나 카멜 표기법과 달리 파스칼 표기법은 첫 번째 단어도 대문자로 표기합니다. 예를 들어 PowerApps의 일반적인 데이터 원본은 코드에서 Office365Users라는 Microsoft Office 365 사용자 커넥터입니다.

화면 이름

화면 이름은 Power Apps Studio에서 복잡한 앱을 더 쉽게 탐색할 수 있도록 화면의 목적을 반영해야 합니다.

덜 분명한 점은 시각 접근성이 필요한 사용자에게 필요한 화면 판독기가 화면 이름을 소리내어 읽는다는 것입니다. 그러므로, 화면 이름을 지정하려면 일반 언어를 사용해야 하며 이름에는 공백이 포함되고 약어는 없어야 합니다. 또한, 이름을 발표할 때 컨텍스트를 이해할 수 있도록 이름 끝에 "Screen"이라는 단어를 붙이는 것을 권장합니다.

다음 몇 가지 좋은 예를 참조하세요.

Home_Screen 또는 Home Screen
Search_Screen 또는 Search Screen

설명된 패턴을 따르는 화면 이름 목록을 보여주는 스크린샷

다음 예제 화면 이름은 이해하기 어렵습니다.

Home
LoaderScreen
EmpProfDetails
Thrive Help

컨트롤 이름

캔버스의 모든 컨트롤 이름은 카멜 표기법을 사용해야 합니다. 세 문자 형식 설명자로 시작하고 그 뒤에 컨트롤 목적이 와야 합니다. 이 접근 방식은 컨트롤 유형을 식별하는 데 도움이 되며 더 쉽게 수식을 작성하고 검색할 수 있게 해줍니다. 예를 들어 lblUserName은 컨트롤이 레이블임을 나타냅니다.

다음 표에는 일반 컨트롤의 약어가 나와 있습니다.

컨트롤 이름	약어
배지	bdg
Button	btn
카메라 컨트롤	cam
캔버스	can
Card	crd
차트	chr
확인란	chk
컬렉션	col
콤보 상자	cmb
구성 요소	cmp
Container	con
날짜	dte
드롭다운	drp
양식	frm
갤러리	gal
그룹	grp
헤더	hdr
Html 텍스트	htm
Icon	ico
Image	img
정보 버튼	정보
Label	lbl
링크	lnk
목록 상자	lst
마이크	mic
Microsoft Stream	str
페이지 섹션 모양	초
펜 입력	pen
Power BI 타일	pbi
진행률 표시줄	pbar
평점	rtg
서식 있는 텍스트 편집기	rte
도형(직사각형, 원 등)	shp
슬라이더	sld
탭 목록	tbl
테이블	tbl
문자 입력	txt
타이머	tmr
Toggle	tgl
Video	vid

컨트롤 및 해당 속성의 자세한 목록은 컨트롤 참조에 설명되어 있습니다.

참고

컨트롤 이름은 애플리케이션 전체에서 고유해야 합니다. 컨트롤이 여러 화면에서 재사용되는 경우 짧은 화면 이름에 접미사가 있어야 합니다. 예: galBottomNavMenuHS 여기서 "HS"는 "홈 화면"을 의미합니다. 이 방법을 사용하면 여러 화면에서 수식의 컨트롤을 더 쉽게 참조할 수 있습니다.

다음은 몇 가지 나쁜 예입니다.

zipcode
Next

컨트롤에 일관되게 이름을 지정하면 탐색 보기에서 앱이 더 깔끔하고 코드도 더 깔끔해집니다.

패턴을 따르는 컨트롤 이름을 보여주는 탐색 보기의 스크린샷

데이터 원본 이름

애플리케이션에 데이터 원본을 추가할 때 Power Apps 앱에서 이름을 변경할 수 없습니다. 이름은 연결에서 파생된 원본 커넥터 또는 데이터 엔터티에서 상속됩니다.

다음 몇 가지 예를 참조하세요.

원본 커넥터에서 상속된 이름: Office 365 사용자 커넥터의 이름은 코드에서 Office365Users입니다.
연결에서 파생된 데이터 엔터티: SharePoint 커넥터에서 Employees라는 Microsoft SharePoint 목록이 반환됩니다. 따라서 코드에서 데이터 원본의 이름은 Employees입니다. 동일한 Power Apps 앱은 동일한 SharePoint 커넥터를 사용하여 Contractors라는 SharePoint 목록에 액세스할 수도 있습니다. 이 경우 코드 내 데이터 원본의 이름은 Contractors입니다.

커넥터 및 연결에 대한 자세한 내용은 Power Apps용 캔버스 앱 커넥터 개요를 참조하세요.

표준 작업 커넥터

LinkedIn과 같은 기능을 노출하는 표준 작업 커넥터에서 데이터 원본 이름과 해당 작업은 파스칼 표기법을 사용합니다. 예를 들어 LinkedIn 데이터 원본의 이름은 LinkedIn이고 ListCompanies라는 작업이 있습니다.

ClearCollect(
    colCompanies,
    LinkedIn.ListCompanies()
)

사용자 지정 커넥터

회사에서 만든 서비스 또는 LOB(기간 업무) API와 같은 사용자 지정 API(애플리케이션 인터페이스)에 연결하는 데 사용되는 사용자 지정 커넥터입니다. 사용자 환경의 모든 제작자가 만들 수 있습니다. 데이터 원본 이름과 해당 작업에는 파스칼 표기법 사용을 권장합니다. 사용자 지정 커넥터 이름과 PowerApps에 표시되는 방식이 다를 수 있습니다.

MS Auction Item Bid API라는 사용자 지정 커넥터의 예를 살펴보세요.

MS Auction Item Bid API라는 커넥터의 스크린샷

그러나 이 커넥터에서 연결을 만들고 PowerApps 앱에 데이터 원본으로 추가하면 AuctionItemBidAPI로 표시됩니다.

이름이 AuctionItemBidAPI임을 보여주는 커넥터의 스크린샷

이유를 확인하려면 OpenAPI 파일 내에서 Auction Item Bid API 텍스트가 포함된 제목 속성을 확인할 수 있습니다.

"info": {
    "version": "v1",
    "title": "Auction Item Bid API"
},

Power Apps는 이 특성 값에서 모든 공백을 제거하고 이를 데이터 원본의 이름으로 사용합니다.

팁

이 속성의 값을 파스칼 표기 이름(예: AuctionItemBidAPI)으로 변경하고 사용자 지정 연결의 이름으로 사용하는 것이 좋습니다. 그래야 혼란이 없을 것입니다. OpenAPI 파일을 가져와서 사용자 지정 커넥터를 만들기 전에 이 값을 변경합니다.

참고

기존 OpenAPI 파일을 가져오는 대신 공백에서 만들기 옵션을 사용하는 경우 PowerApps에서는 사용자 지정 커넥터 이름을 묻는 메시지를 표시합니다. 이 이름은 사용자 지정 커넥터의 이름과 OpenAPI 파일 내의 제목 특성 값으로 모두 사용됩니다. 일관되고 단순하게 유지하려면 AuctionItemBidAPI과 같이 파스칼 표기 이름을 사용하세요.

Excel DataTable

PowerApps는 Microsoft Excel의 DataTable을 사용하여 Excel 워크시트의 데이터에 연결합니다. Excel 문서를 데이터 원본으로 만들 때 다음 사항에 유의하세요.

DataTable에 설명이 포함된 이름을 지정하세요. 이름은 연결하기 위한 코드를 작성할 때 Power Apps 앱에 있습니다.
워크시트당 하나의 DataTable을 사용합니다.
DataTable과 워크시트에 동일한 이름을 지정합니다.
DataTables에 설명적인 열 이름을 사용하십시오.
파스칼 표기법을 사용하세요. DataTable 이름의 각 단어는 EmployeeLeaveRequests와 같이 대문자로 시작해야 합니다.

변수 이름

캔버스 앱의 변수에 대한 명명 규칙은 Power Apps 프로젝트에서 가독성, 일관성 및 명확성을 유지하는 데 중요합니다. 엄격한 표준이 적용되지는 않지만 캔버스 앱 전체에 일관된 명명 규칙을 채택하면 사용자와 다른 공동 작업자가 변수를 더 쉽게 이해하고, 사용하고, 관리할 수 있습니다.

첫 번째 단어를 제외하고 각 단어의 첫 글자를 대문자로 사용하는 카멜 표기법을 사용합니다.
변수의 목적이나 내용을 명확하게 설명하는 의미 있고 설명적인 이름을 선택하십시오. Temp 또는 var1과 같이 지나치게 일반적인 이름은 피하세요. 대신 userEmail 또는 totalAmount와 같은 설명이 포함된 이름을 사용하세요.
변수 유형을 나타내려면 접두사 또는 접미사를 사용하는 것이 좋습니다. 예:
- 텍스트/문자열 변수의 경우 strUserName
- 숫자 변수의 경우 numTotalAmount
- 부울 변수의 경우 boolIsEnabled
- 지역 변수/컨텍스트 변수의 경우 locVarName
- 전역 변수의 경우 gblVarLoginUser
변수 이름을 단수형으로 지정해야 할지, 복수형으로 지정해야 할지 결정하고 해당 규칙을 따르세요. 예를 들어 userCount 또는 users를 일관되게 사용합니다.
Power Apps 함수나 키워드와 충돌할 수 있는 예약어나 이름을 사용하지 마세요. 예약어 목록은 Power Apps 설명서를 확인하세요.
변수의 사용법이나 범위에 대한 컨텍스트를 제공하는 접두사 사용을 고려하세요. 예:
- 양식 변수의 경우 frm
- 컬렉션의 경우 col
- 범용 변수의 경우 var
특수 문자를 사용하지 마십시오. 이름은 영숫자로 유지하고 특수 문자나 공백은 사용하지 마세요. 문자와 숫자만 사용하십시오.

Power Apps를 사용하면 컨텍스트 변수와 전역 변수가 동일한 이름을 공유할 수 있습니다. 명확성 연산자를 사용하지 않는 한 수식에서 기본적으로 컨텍스트 변수를 사용하므로 이로 인해 혼란이 발생할 수 있습니다.

다음 규칙을 따르면 이러한 상황을 방지할 수 있습니다.

컨텍스트 변수 앞에 loc를 붙입니다.
전역 변수 앞에 gbl를 붙입니다.
접두사 뒤의 이름은 변수의 의도/목적을 나타내야 합니다. 여러 단어를 사용할 수 있으며 각 단어의 첫 글자가 대문자인 경우 공백이나 밑줄과 같은 특수 문자로 구분할 필요가 없습니다.
카멜 표기법을 사용하세요. 변수 이름은 소문자로 된 접두사로 시작하고 이름에 있는 각 단어의 첫 글자를 대문자로 시작합니다.

다음 예는 표준과 규칙을 따릅니다.

전역 변수:gblFocusedBorderColor
컨텍스트 변수:locSuccessMessage
범위 변수scpRadius

이러한 예는 표준을 따르지 않으며 이해하기 어렵습니다.

dSub
rstFlds
hideNxtBtn
ttlOppCt
cFV
cQId

EID와 같은 짧고 비밀스러운 변수 이름은 피하세요. 대신 Use EmployeeId를 사용합니다.

앱에 변수가 많은 경우 수식 입력줄에 접두사를 입력하면 사용 가능한 변수 목록을 볼 수 있습니다. 다음 지침에 따라 변수 이름을 지정하면 앱을 개발할 때 수식 입력줄에서 쉽게 찾을 수 있습니다. 궁극적으로 이 접근 방식은 더 빠른 앱 개발로 이어집니다.

컬렉션 이름

컬렉션의 내용을 설명하세요. 컬렉션에 포함된 내용 및/또는 컬렉션이 어떻게 사용되는지 생각해보고 그에 따라 이름을 지정하세요.
컬렉션에는 col 접두사가 붙어야 합니다.
접두사 뒤의 이름은 컬렉션의 의도 또는 목적을 나타내야 합니다. 여러 단어를 사용할 수 있으며 각 단어의 첫 글자가 대문자인 경우 공백이나 밑줄로 구분할 필요가 없습니다.
카멜 표기법을 사용하세요. 컬렉션 이름을 소문자 col 접두사로 시작한 다음, 이름에 있는 각 단어의 첫 글자를 대문자로 표시합니다.

다음 예는 컬렉션 이름 규칙을 따릅니다.

colMenuItems
colThriveApps

다음 예제는 컬렉션 이름 규칙을 따르지 않습니다.

orderscoll
tempCollection

팁

앱에 컬렉션이 많은 경우 수식 입력줄에 접두사를 입력하면 사용 가능한 컬렉션 목록을 볼 수 있습니다. 변수의 경우 이러한 지침에 따라 컬렉션의 이름을 지정하면 앱을 개발할 때 수식 입력줄에서 쉽게 찾을 수 있습니다. 궁극적으로 이 접근 방식은 더 빠른 앱 개발로 이어집니다.

주석 및 설명서

응용 프로그램에 대한 코드를 작성할 때는 명확한 주석을 추가하는 데 중점을 둡니다. 주석은 나중에 코드를 이해하는 데 도움이 되며 다음 개발자가 프로젝트에서 더 쉽게 작업할 수 있도록 합니다.

Power Apps는 코드를 더 명확하게 만들어 주는 두 가지 주석 스타일을 지원합니다. 줄 주석은 단일 줄 주석에 이중 슬래시(//)를 사용하고, 블록 주석은 여러 줄 주석에 /* 및 */를 사용합니다.

줄 주석

Power Apps의 코드 줄에 이중 슬래시(//)를 추가하여 나머지 줄을 주석으로 만듭니다.

줄 주석을 사용하여 코드의 다음 줄이 수행하는 기능을 설명합니다. 테스트를 위해 코드 줄을 일시적으로 비활성화하는 데 사용할 수도 있습니다.

다음은 줄 주석의 예입니다.

// ClearCollect function populates the Expenses2 collection with sample data
ClearCollect(
    Expenses2,
    // Entry 1: Client hosted meet and greet
    {
        Title: "Client hosted meet and greet:",
        ID: "4"
        // additional properties  
    }
)

블록 주석

/*과 */ 사이의 텍스트는 블록 주석입니다. 블록 주석은 한 줄만 포함하는 줄 주석과 달리 여러 줄을 포함할 수 있습니다.

코드 모듈 헤더를 문서화하는 것과 같은 더 긴 설명에는 블록 주석을 사용합니다. 테스트 또는 디버깅 중에 여러 줄의 코드를 일시적으로 비활성화하는 데 사용할 수도 있습니다.

더 나은 코드 구성을 위해 텍스트 서식 지정 기능을 사용한 후 주석을 추가합니다. 이렇게 하면 주석이 코드 블록 앞에 오는 경우에 도움이 됩니다.

/*
    Patch Operation to Insert Data:
    - Inserts a new employee record into the 'Employee' entity.
    - Adds corresponding department details to the 'Department' entity.
    Note: Ensure that foreign key relationships and dependencies are maintained for data integrity.
*/
Patch(
    Employee,
    Defaults(Employee),
    {
        FirstName: "John",
        LastName: "Doe",
        Position: "Software Developer"
    }
)

텍스트 서식 지정 기능은 주석에 대해 다음 규칙을 따릅니다.

속성이 블록 주석으로 시작하면 다음 코드 줄이 추가됩니다.
속성이 줄 주석으로 시작하는 경우 다음 코드 줄이 추가되지 않습니다. 그렇지 않으면 코드가 주석 처리됩니다.
속성의 다른 위치에 있는 줄 및 블록 주석은 이전 코드 줄에 추가됩니다.

너무 많거나 너무 긴 주석을 추가하는 것에 대해 걱정하지 마십시오. Power Apps는 클라이언트 앱 패키지를 생성할 때 모든 주석을 제거하므로 주석은 패키지 크기에 영향을 미치지 않으며 앱 다운로드나 로딩 시간을 늦추지 않습니다.

댓글이 포함된 최신 앱 디자이너

Power Apps에서는 Power Apps Studio와 최신 앱 디자이너 모두에서 주석 달기 기능을 사용하는 것이 가장 좋습니다.

Power Apps Studio에서 주석을 추가하려면 다음 방법을 사용합니다.

트리 보기에서 항목의 줄임표("...")를 마우스 오른쪽 버튼으로 클릭합니다.
캔버스 영역에서 구성 요소를 마우스 오른쪽 버튼으로 클릭합니다.
화면 오른쪽 상단의 명령 모음에 있는 "주석" 버튼을 선택합니다.

댓글에서 동료를 언급할 때는 '@' 기호 뒤에 동료의 이름을 붙입니다. 이렇게 하면 태그한 사람에게 알림 이메일이 전송됩니다. 태그가 지정된 사용자에게 앱에 대한 액세스 권한이 없는 경우 Power Apps에서 해당 사용자에게 앱을 공유하라는 메시지가 표시됩니다.

댓글에서 @로 언급된 사람을 보여주는 경비 앱의 스크린샷.

들여쓰기 및 서식 지정

Power Apps에서는 들여쓰기와 서식을 통해 앱을 명확하고 체계적으로 유지할 수 있습니다. 모범 사례를 따르면 수식과 컨트롤을 더 쉽게 읽을 수 있습니다.

수식 입력줄

들여쓰기

Power Apps에서는 엄격한 들여쓰기를 적용하지 않지만, 공백을 사용하여 수식의 여러 섹션을 구분할 수 있습니다. 스페이스바를 여러 번 눌러 들여쓰기를 만듭니다.

줄 바꿈

긴 수식을 읽기 쉽도록 여러 줄로 나눕니다. Enter 키를 눌러 수식 입력줄에 줄 바꿈을 추가합니다.

텍스트 서식 명령 사용

수식 입력줄의 "텍스트 서식" 명령은 Power Apps 코드에 들여쓰기, 간격 및 줄 바꿈을 추가합니다. "텍스트 서식" 명령을 사용하여 캔버스 앱에서 일관된 코딩 스타일을 유지하고 오류를 방지할 수 있습니다.

텍스트 서식 명령이 강조 표시된 Power Apps Studio의 스크린샷.

다음 단계:

코드 최적화

피드백

이 페이지가 도움이 되었나요?

Last updated on 2025-07-01