코드 가독성

코드 가독성은 종종 간과되는 앱 개발의 중요한 측면입니다. 읽기 가능한 코드는 더 쉽게 이해하고 유지 관리하며 디버그할 수 있습니다.

명명 규칙

일관된 명명 규칙은 코드의 가독성을 크게 향상시킵니다. 앱에서 각 요소의 용도를 빠르게 식별하고 코드베이스를 보다 쉽게 탐색할 수 있습니다.

일반 명명 규칙

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

카멜 표기법

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

파스칼 표기법

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

화면 이름

화면의 용도를 명확하게 보여 주는 화면 이름을 선택하면 Power Apps Studio에서 복잡한 앱을 보다 쉽게 탐색할 수 있습니다.

화면 읽기 프로그램은 화면 이름을 소리 내어 읽습니다. 시각 접근성 요구 사항이 있는 사용자는 이러한 화면 읽기 프로그램을 사용합니다. 화면 이름에 일반 언어를 사용하고 공백을 포함하며 약어를 사용하지 마세요. 이름이 발표될 때 명확한 컨텍스트를 제공하려면 각 이름을 "Screen"이라는 단어로 종료합니다.

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

Home_Screen 또는 Home Screen
Search_Screen 또는 Search Screen

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

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

Home
LoaderScreen
EmpProfDetails
Thrive Help

컨트롤 이름

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

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

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

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

참고

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

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

zipcode
Next

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

설명된 패턴에 따른 컨트롤 이름을 보여 주는 탐색 보기의 스크린샷.

데이터 원본 이름

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

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

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

캔버스 앱용 커넥터 개요에서 커넥터 및 연결 에 대해 자세히 알아봅니다.

표준 액션 커넥터

LinkedIn 같은 함수를 제공하는 표준 액션 커넥터에서 데이터 원본 이름 및 해당 작업은 Pascal 케이스를 사용합니다. 예를 들어 LinkedIn 데이터 원본의 이름은 LinkedIn이며 ListCompanies이라는 작업이 있습니다.

ClearCollect(
    colCompanies,
    LinkedIn.ListCompanies()
)

사용자 지정 커넥터

사용자 지정 커넥터를 사용하여 회사에서 만드는 서비스 또는 LOB(기간 업무) API와 같은 사용자 지정 API(애플리케이션 프로그래밍 인터페이스)에 연결합니다. 사용자 환경의 모든 제조업체는 사용자 지정 커넥터를 만들 수 있습니다. 데이터 소스 이름과 그 작업에 파스칼 표기법을 사용하십시오. 사용자 지정 커넥터 이름과 Power Apps 표시되는 방식은 다를 수 있습니다.

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

MS 경매 항목 입찰 API라는 커넥터의 스크린샷

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

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

이유를 검색하려면 OpenAPI 파일 내에서 텍스트 Auction Item Bid API가 포함된 타이틀 특성을 확인합니다.

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

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

팁

이 속성의 값을 Pascal 케이스 형태의 이름인 AuctionItemBidAPI로 변경하고, 사용자 지정 연결의 이름으로 사용하세요. 이런 식으로 혼란은 없습니다. OpenAPI 파일을 가져와서 사용자 지정 커넥터를 만들기 전에 이 값을 변경합니다.

참고

기존 OpenAPI 파일을 가져오는 대신 빈 페이지에서 만들기 옵션을 사용하면 Power Apps에서 사용자 지정 커넥터 이름을 입력하라는 메시지가 표시됩니다. 이 이름은 사용자 지정 커넥터의 이름과 OpenAPI 파일 내의 타이틀 특성 값입니다. 파스칼식 구문 이름 AuctionItemBidAPI을 사용하여 일관성과 단순함을 유지하십시오.

Excel 데이터 테이블스

Power Apps는 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을 사용하지 않습니다. EmployeeId를 대신 사용하세요.

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

컬렉션 이름

컬렉션의 내용을 설명하는 이름을 사용합니다. 컬렉션에 포함된 항목과 컬렉션의 사용 방법에 대해 생각하고 이에 따라 이름을 지정합니다.
컬렉션 이름에 col를 접두사로 사용하세요.
접두사 뒤의 이름을 사용하여 컬렉션의 의도 또는 용도를 표시합니다. 각 단어의 첫 글자를 대문자로 사용하는 경우 공백이나 밑줄 없이 여러 단어를 사용할 수 있습니다.
카멜 표기법을 사용하세요. 소문자 접두사 col 로 컬렉션 이름을 시작한 다음 이름에 있는 각 단어의 첫 글자를 대문자로 표시합니다.

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

colMenuItems
colThriveApps

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

orderscoll
tempCollection

팁

앱에 컬렉션이 많은 경우 수식 입력줄에 접두사를 입력하여 사용 가능한 컬렉션 목록을 확인합니다. 컬렉션 이름을 지정하기 위해 이러한 지침을 따르는 경우 앱을 개발할 때 수식 입력줄에서 쉽게 찾을 수 있습니다. 이 방법을 사용하면 앱 개발이 더 빨라질 수 있습니다.

주석 및 설명서

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

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 스튜디오와 모던 앱 디자이너에서 주석 기능을 활용할 수 있습니다.

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

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

댓글에서 동료를 언급할 때는 '@' 기호 뒤에 동료의 이름을 붙입니다. 이 작업은 태그를 지정한 사람에게 알림 이메일을 보냅니다. 태그된 사용자가 앱에 대한 접근 권한이 없는 경우 Power Apps는 해당 사용자에게 앱을 공유하라는 메시지를 표시합니다.

메모에서 @와 함께 언급된 사람을 보여 주는 경비 앱의 스크린샷.

들여쓰기 및 서식 지정

들여쓰기 및 서식 지정은 앱을 명확하고 체계적으로 유지하는 데 도움이 됩니다. 코드 형식이 잘 지정되면 더 쉽게 읽고 이해할 수 있습니다.

들여쓰기

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

줄 바꿈

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

텍스트 서식 명령 사용

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

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

다음 단계:

코드 최적화

피드백

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

Last updated on 2026-03-07