포털에서 파일 열 구성

참고

2022년 10월 12일부터 Power Apps 포털이 Power Pages가 됩니다. 추가 정보: Microsoft Power Pages는 이제 일반적으로 사용할 수 있습니다(블로그)
곧 Power Apps 포털 설명서를 마이그레이션하고 Power Pages 설명서와 병합할 예정입니다.

파일 열은 이진 데이터를 저장하는 데 사용됩니다. 이 열은 주로 단일 파일, 메모 또는 첨부 파일을 저장하는 데 사용되지만 다른 형식의 이진 데이터를 저장할 수 있습니다. 기본 및 다단계 양식에서 파일 열을 구성하여 파일을 업로드, 보기, 수정 또는 삭제할 수 있는 기능을 제공할 수 있습니다. 파일 열은 Microsoft Dataverse 테이블 열의 지정된 최대 크기까지 파일을 저장할 수 있습니다.

중요

• 기본 양식 또는 다단계 양식 단계에서 삽입 모드를 사용하여 파일을 업로드할 수 없습니다.

유동 코드

Liquid는 Microsoft Power Apps 포털에 기본적으로 통합된 오픈 소스 템플릿 언어입니다. 개발자는 fetchXML 및 엔터티 보기를 사용하여 데이터를 쿼리할 때 파일 열 값을 검색할 수 있습니다.

{% for item in tables.results.entities %}
    {{ item.columnname.Name }}
    {{ item.columnname.Size }}
    {{ item.columnname.Url }}
{% endfor %}

특성	Description
입력	열과 연결된 파일의 이름
Size	파일 크기(바이트)
URL	파일 다운로드 URL

예: 연락처 테이블에서 파일 열 데이터 검색

이름이 myfileattribute인 연락처 테이블용으로 Dataverse에 새 파일 데이터 유형 열을 만듭니다.

참고

레코드를 읽을 수 있도록 연락처 테이블에 대한 적절한 테이블 권한을 구성했는지 확인하십시오.

{% fetchxml contacts %}
<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false">
  <entity name="contact">
    <attribute name="fullname" />
    <attribute name="myfileattribute" />    
  </entity>
</fetch>
{% endfetchxml %}

{% for item in contacts.results.entities %}
        "Full Name":"{{ item.fullname }}"
        "Entity File Url":"{{ item.myfileattribute.Name }}",      
        "Entity File Size":"{{ item.myfileattribute.Size }}",
        "Entity File Type":"{{ item.myfileattribute.Url }}" 
{% endfor %}

웹 API

포털 웹 API를 사용하여 Dataverse 테이블에서 파일 열에 대한 생성, 읽기, 업데이트 및 삭제 작업을 수행할 수 있습니다.

참고

액세스하려는 테이블 및 파일 열에 대해 적절한 Web API 사이트 설정을 구성했는지 확인합니다.

파일 데이터 검색

파일 데이터를 검색하려면 다음 예제에 설명된 API 요청을 사용하십시오.

GET /_api/<entity-type>(id)/<file-attribute-name>/$value

웹 서비스 끝점에서 파일 데이터 전송은 단일 서비스 호출에서 최대 16MB 데이터로 제한됩니다. 16MB를 초과하는 파일 데이터는 4MB 이하의 데이터 블록(청크)으로 분할해야 합니다. 모든 파일 데이터가 수신될 때까지 각 블록은 별도의 API 호출로 수신됩니다. 블록이 수신된 것과 동일한 순서로 데이터 블록을 결합하여 전체 데이터 파일에서 다운로드한 데이터 블록을 결합하는 것은 사용자의 책임입니다.

예: 파일 다운로드 < 16MB

요청

HTTP
GET [Portal Url]/_api/accounts(62d53214-9dfa-eb11-94ee-0022482230a8)/myfileattribute/$value
Headers:
Content-Type: application/octet-stream

응답

204 No Content
Body:
Byte[ ]

예: 파일 다운로드 > 16MB

요청

HTTP
GET [Portal Url]/_api/accounts(62d53214-9dfa-eb11-94ee-0022482230a8)/myfileattribute/$value
Headers:
Content-Type: application/octet-stream
Range: bytes=0-1023

응답

HTTP
204 No Content
Body:
Byte[ ]

파일 데이터 업로드

파일을 업로드하려면 파일 열의 값을 파일 내용이 포함된 바이트 배열로 설정하십시오.

PUT or PATCH /_api/<entity-type>(id)/<file-attribute-name>

예: 파일 업로드

Request

HTTP
PUT [Portal Url]/_api/accounts(62d53214-9dfa-eb11-94ee-0022482230a8)/myfileattribute
Headers:
Content-Type: application/octet-stream
Body :
Byte [ ]