포털에서 파일 열 구성

아티클
03/16/2023

참고

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

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

제품 번호, 제품 이름 및 제품 카탈로그에 대한 필드가 있는 테이블의 애니메이션. 제품 카탈로그 필드를 채우기 위해 사용자는 파일 선택을 선택한 다음 업로드하고 제품 카탈로그에 사용할 PDF 파일을 찾습니다.

중요

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

유동 코드

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 [ ]

다음을 통해 공유