다음을 통해 공유


Power Apps의 첨부 파일 컨트롤

사용자가 디바이스에 파일을 다운로드하고 Microsoft 목록 또는 Microsoft Dataverse 테이블을 사용하여 만든 목록에서 파일을 업로드 및 삭제할 수 있는 컨트롤입니다.

Description

첨부 파일 컨트롤을 사용하면 목록 또는 Dataverse 테이블에서 파일을 열고, 추가하고, 삭제할 수 있습니다.

제한점

첨부 파일 컨트롤에는 다음과 같은 제한 사항이 있습니다.

  1. 첨부 파일 컨트롤은 목록 및 Dataverse 테이블만 데이터 원본으로 지원합니다. 이러한 데이터 원본을 테이블로 변환하는 식(예: ForAll 함수 사용)은 지원되지 않습니다.

  2. 업로드 및 삭제 기능은 양식 내에서만 작동합니다. 첨부 파일 컨트롤은 편집 모드일 때 사용하지 않도록 표시되고 양식 안에는 표시되지 않습니다. 파일 추가 및 삭제를 저장하려면 앱 사용자가 양식을 저장해야 합니다. 이 제한으로 인해 첨부 파일 컨트롤은 삽입 탭에서 사용할 수 없지만 SharePoint 또는 Dataverse 양식에서 첨부 파일 양식 필드를 사용하도록 설정하면 양식에 표시됩니다.

  3. 웹 브라우저에서 첨부 파일 컨트롤을 사용하면 여러 파일을 선택할 수 있으며 끌어서 놓기 기능을 사용할 수 있습니다. 그러나 Power Apps Mobile에서 첨부 파일 컨트롤을 사용하는 경우 파일을 한 번에 하나씩만 추가할 수 있습니다.

  4. OneDrive 또는 다른 클라우드 저장소에 저장된 파일이 제대로 연결되지 않을 수 있습니다. 디바이스의 파일 선택기를 사용하여 첨부하기 전에 이러한 파일을 디바이스에 다운로드해 보세요.

  5. Power Apps 모바일 앱은 첨부 파일 컨트롤을 사용할 때 카메라에서 직접 비디오를 캡처하거나 사진 라이브러리에서 비디오를 선택하는 것을 지원하지 않습니다. 비디오를 추가하려면 사용자가 찾아보기 옵션을 사용해야 합니다.

    • Android: 찾아보기 옵션에는 비디오를 비롯한 모든 파일 형식이 표시되므로 비디오 파일을 선택하고 첨부할 수 있습니다.
    • iOS: 찾아보기 옵션은 파일 앱에 저장된 파일만 표시합니다. 비디오가 아직 저장되지 않은 경우 첨부하기 전에 파일 앱으로 이동해야 합니다.

    비디오가 첨부 옵션으로 표시되지 않는 경우 먼저 디바이스의 파일 앱에 비디오를 저장한 다음 다시 시도합니다.

키 속성

항목 – 목록 또는 Dataverse 테이블의 첨부 파일 열입니다. 컬렉션 및테이블 은 지원되지 않습니다.

MaxAttachments – 컨트롤이 수락할 최대 파일 수입니다.

MaxAttachmentSize – 허용되는 최대 파일 크기(각 새 첨부 파일의 MB)입니다. 여기서 1MB는 1,000,000바이트(106B ) 또는 1,000KB입니다.

OnAddFile – 사용자가 새 파일 첨부 파일을 추가할 때 수행할 작업입니다.

OnRemoveFile – 사용자가 기존 첨부 파일을 삭제할 때 수행할 작업입니다.

OnUndoRemoveFile – 사용자가 삭제된 첨부 파일을 복원할 때 수행할 작업입니다.

추가 속성

AccessibleLabel – 화면 읽기 프로그램에 대한 레이블입니다. 첨부 파일의 용도를 설명해야 합니다.

AddAttachmentText – 새 첨부 파일을 추가하는 데 사용되는 링크의 레이블 텍스트입니다.

BorderColor – 컨트롤 테두리의 색입니다.

BorderStyle – 컨트롤의 테두리가 Solid, Dashed, Dotted 또는 None인지 여부입니다.

BorderThickness – 컨트롤 테두리의 두께입니다.

– 컨트롤 텍스트의 색입니다.

DisabledBorderColor – 컨트롤의 DisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 테두리 색입니다.

DisabledColorDisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 텍스트 색입니다.

DisabledFillDisplayMode 속성이 Disabled 로 설정된 경우 컨트롤의 배경색입니다.

DisplayMode – 컨트롤에서 파일 추가 및 삭제(편집)를 허용하는지 여부, 데이터만 표시(보기) 또는 비활성화(사용 안 함)입니다.

[DropTargetBackgroundColor] – 컨트롤의 놓기 대상 배경 색입니다.

[DropTargetBorderColor] – 컨트롤의 놓기 대상 테두리 색입니다.

[DropTargetBorderStyle] – 컨트롤의 놓기 대상 테두리가 Solid, Dashed, Dotted 또는 None인지 여부입니다.

[DropTargetBorderThickness] – 컨트롤의 놓기 대상 테두리 두께입니다.

[DropTargetTextColor] – 컨트롤의 놓기 대상 텍스트 색입니다.

Fill – 컨트롤의 배경색입니다.

FocusedBorderColor – 컨트롤에 포커스가 있을 때 컨트롤의 테두리 색입니다.

FocusedBorderThickness – 컨트롤에 포커스가 있을 때 컨트롤의 테두리 두께입니다.

높이 – 컨트롤의 위쪽 가장자리와 아래쪽 가장자리 사이의 거리입니다.

글꼴 – 텍스트가 표시되는 글꼴 패밀리의 이름입니다.

FontWeight – 컨트롤에 있는 텍스트의 가중치: 굵게, 세미볼드, 노멀 또는 라이터.

HoverBorderColor – 사용자가 해당 컨트롤에 마우스 포인터를 유지할 때 컨트롤의 테두리 색입니다.

HoverColor – 사용자가 마우스 포인터를 유지할 때 컨트롤의 텍스트 색입니다.

HoverFill – 사용자가 마우스 포인터를 유지할 때 컨트롤의 배경색입니다.

기울임꼴 – 컨트롤의 텍스트가 기울임꼴인지 여부입니다.

MaxAttachmentsText – 컨트롤에 허용되는 최대 파일 수가 포함될 때 "파일 첨부" 링크를 대체하는 텍스트입니다.

NoAttachmentsText – 첨부된 파일이 없는 경우 사용자에게 표시되는 정보 텍스트입니다.

안쪽 여백 – 가져오기 또는 내보내기 단추의 텍스트와 해당 단추의 가장자리 사이의 거리입니다.

PressedBorderColor – 사용자가 해당 컨트롤을 선택할 때 컨트롤의 테두리 색입니다.

PressedColor – 사용자가 해당 컨트롤을 선택할 때 컨트롤의 텍스트 색입니다.

PressedFill – 사용자가 해당 컨트롤을 선택할 때 컨트롤의 배경색입니다.

다시 설정 – 첨부 파일 컨트롤의 모든 변경 내용을 이전에 저장된 상태로 되돌려 놓습니다.

크기 – 컨트롤에 표시되는 텍스트의 글꼴 크기입니다.

취소선 – 컨트롤에 나타나는 텍스트를 통해 선이 표시되는지 여부입니다.

TabIndex – 다른 컨트롤과 관련된 키보드 탐색 순서입니다.

도구 설명 – 사용자가 컨트롤을 마우스로 가리킬 때 표시되는 설명 텍스트입니다.

밑줄 – 컨트롤에 표시되는 텍스트 아래에 줄이 표시되는지 여부입니다.

표시 – 컨트롤이 표시되는지 숨겨지는지 여부입니다.

너비 – 컨트롤의 왼쪽 가장자리와 오른쪽 가장자리 사이의 거리입니다.

X – 컨트롤의 왼쪽 가장자리와 부모 컨테이너의 왼쪽 가장자리 사이의 거리(또는 부모 컨테이너가 없는 경우 화면)입니다.

Y – 컨트롤의 위쪽 가장자리와 부모 컨테이너의 위쪽 가장자리 사이의 거리(또는 부모 컨테이너가 없는 경우 화면)입니다.

Example

  1. 앱에 양식을 추가하고 목록을 데이터 원본으로 설정합니다.

  2. 왼쪽의 트리 뷰에서 폼 표시 컨트롤을 선택합니다. 대신 편집 양식을 사용할 수도 있습니다.

  3. 오른쪽의 옵션 패널에 있는 속성 탭에서 데이터 원본 을 선택한 다음, 연결한 목록을 선택합니다.

  4. 필드 섹션에서 필드 편집을 선택하고 필드 추가를 선택합니다.

  5. 첨부 파일 필드를 선택하고 추가를 선택합니다.

    목록과 연결된 첨부 파일 필드가 양식에 표시됩니다.

컨트롤을 추가하고 구성하는 방법 알아보기

내게 필요한 옵션 지침

색 대비

다음 사이에 적절한 색 대비가 있어야 합니다.

  • ItemColorItemFill
  • ItemHoverColorItemHoverFill
  • ItemPressedColorItemPressedFill
  • AddedItemColorAddedItemFill
  • RemovedItemColorRemovedItemFill
  • ItemErrorColorItemErrorFill
  • AddAttachmentColor채우기
  • MaxAttachmentsColor채우기
  • NoAttachmentsColorFill

이 요구 사항은 표준 색 대비 요구 사항에 추가됩니다.

화면 읽기 프로그램 지원

다음 속성이 있어야 합니다.

키보드 지원

  • TabIndex 는 키보드 사용자가 탐색할 수 있도록 0 이상이어야 합니다.
  • 포커스 표시기를 명확하게 표시해야 합니다. 이 명확성을 달성하려면 FocusedBorderColorFocusedBorderThickness 를 사용합니다.