파일 변수를 활용한 파일 스트리밍
- 최종 업데이트2025/10/23
파일 스트림 기능은 자동화(API 태스크 및 Task Bot)가 데이터 소스에서 파일을 직접 처리할 수 있도록 합니다. 데이터 소스에서 파일을 직접 스트리밍하면 로컬 데스크톱이나 Control Room 저장소에서 파일을 다운로드한 후 다시 업로드할 필요가 없습니다.
개요
파일 스트림 기능은 파일 변수를 활용하여 파일을 스트리밍합니다. 파일 변수를 생성한 다음, 지원되는 작업 내의 변수에 파일 할당 옵션에서 이 변수를 스트리밍해야 하는 파일에 할당합니다. 파일을 스트리밍하기 위해 할당된 파일 변수는 후속 작업에서 사용할 수 있습니다. 런타임 시 자동화는 파일을 다운로드하고 업로드할 필요 없이 소스에서 직접 스트리밍합니다. 이 기능을 사용하면 파일 기반 API 태스크를 생성할 수 있습니다.
파일 스트림은 글로벌 값이 파일 스트림 기능을 지원하지 않기 때문에 세션 내에서만 사용할 수 있습니다. 세션이 종료되면 스트리밍도 중단됩니다. 또한, 스트림을 사용하는 작업은 소스 파일에 따라 다릅니다. 파일 스트림 기능은 할당 작업을 사용하여 파일을 다운로드한 다음, 후속 자동화에 입력으로 사용하기 위해 다른 작업으로 업로드해야 하는 상황에서 소요 시간을 줄여줍니다.
- 소스 파일이 수정되면, 해당 작업도 그에 따라 변경됩니다.
- 소스 파일을 삭제하는 경우, 자동화가 실패합니다.
예를 들어, Microsoft 365 OneDrive 패키지의 파일 할당 작업을 사용하여 Microsoft 365 OneDrive 위치에 있는 파일에 파일 변수를 할당할 수 있습니다. 파일 변수를 후속 자동화 워크플로의 데이터 소스로 사용할 수 있습니다. 파일 변수를 데이터 소스로 선택하면 다른 옵션(Control Room 파일 및 Desktop 파일)은 선택할 수 없습니다.
지원되는 패키지
클라우드 저장소 위치에서 파일을 스트리밍하기 위한 파일 변수를 할당할 수 있는 작업은 다음과 같습니다.
| 패키지 | 작업 |
|---|---|
| 데이터베이스 | 파일 스트림으로 내보내기 작업을 사용하여 SELECT 문 또는 저장 프로시저로 데이터베이스에서 데이터를 가져옵니다. 데이터를 .csv 파일로 내보내고, 결과를 파일 스트림 변수에 저장합니다. 이는 데이터를 효율적으로 처리하고 다양한 자동화 작업 간에 공유할 수 있게 해줍니다. |
| Google Drive | 파일 할당 작업을 사용하면 Google Drive 위치에 있는 파일에 파일 변수를 할당할 수 있습니다. 이 변수는 세션 내의 후속 작업에서 사용할 수 있습니다. |
| Microsoft 365 OneDrive | 파일 할당 작업을 사용하면 Microsoft 365 OneDrive 위치에 있는 파일에 파일 변수를 할당할 수 있습니다. 이 변수는 세션 내의 후속 작업에서 사용할 수 있습니다. |
| Microsoft 365 Outlook | 첨부 파일 할당 작업을 사용하면 파일 변수를 이메일 첨부 파일에 할당하고, 해당 변수를 세션 내의 후속 작업에서 사용할 수 있습니다. |
| REST 웹 서비스 | 파일 스트림 가져오기 작업을 사용하면 파일 변수를 URI에서 사용 가능한 파일에 할당하고 세션의 이후 작업에서 사용할 수 있습니다. |
| Salesforce | 파일 할당 작업을 사용하면 모든 Salesforce 인스턴스에서 사용 가능한 첨부 파일에 파일 변수를 할당할 수 있습니다. |
| ServiceNow | 파일 할당 작업을 사용하면 모든 ServiceNow 인스턴스에서 사용 가능한 첨부 파일에 파일 변수를 할당할 수 있습니다. |
| SharePoint | 파일 할당 작업을 사용하면 SharePoint 위치에 있는 파일에 파일 변수를 할당하고, 해당 변수를 세션의 이후 작업에서 사용할 수 있습니다. |
다음 작업은 데이터 소스로 파일 스트림을 사용하는 것을 지원합니다.
| 패키지 | 작업 |
|---|---|
| CSV/TXT | 열기 작업은 파일 변수를 지원하여 세션의 이후 동작에서 데이터 소스로 파일을 스트리밍할 수 있습니다. |
| Google Drive | 파일 업로드 작업을 사용하면 파일 변수를 이용해 파일을 Google Drive 위치로 업로드할 수 있습니다. 위에서 언급한 작업 중 하나를 사용하여 파일을 파일 변수에 할당하고, 해당 변수를 사용해 파일을 업로드할 수 있습니다. 자동화 워크플로는 파일을 로컬에 다운로드하지 않고 스트리밍 및 Google Drive 위치에 업로드합니다. |
| JSON | 세션 시작 작업은 파일 변수를 지원하므로, 세션 내 후속 작업에서 해당 파일을 데이터 소스로 스트리밍하여 사용할 수 있습니다. |
| 목록 | 항목 추가 작업을 사용하면 클라우드 저장소에서 파일을 직접 스트리밍하는 파일 변수를 목록 변수에 추가할 수 있습니다. |
| Microsoft 365 OneDrive | 파일 업로드 작업을 사용하면 파일 변수를 이용해 파일을 Microsoft 365 OneDrive 위치로 업로드할 수 있습니다. 위에서 언급한 작업 중 하나를 사용하여 파일을 파일 변수에 할당하고, 해당 변수를 사용해 파일을 업로드할 수 있습니다. 자동화 워크플로는 파일을 로컬에 다운로드하지 않고 스트리밍 및 Microsoft 365 OneDrive 위치에 업로드합니다. |
| Microsoft 365 Outlook |
전달, 회신, 모두 회신, 보내기 작업은 첨부 파일의 파일 스트림을 지원합니다. 파일 스트림을 보유하는 파일 변수를 목록 변수에 추가한 다음, 해당 목록 변수를 작업의 첨부 파일 설정에서 사용하여 파일을 이메일의 첨부 파일로 추가할 수 있습니다. 이메일에 여러 파일을 첨부하려면, 목록 패키지의 추가 작업을 사용하여 여러 파일 변수를 목록 변수에 추가할 수 있습니다. |
| Pipeline Accelerator | 첨부파일 업로드 작업을 사용하면 파일 스트림을 보유하는 파일 변수를 이용해 비즈니스 관련 문서를 기회에 첨부할 수 있습니다. 자동화 워크플로는 파일을 로컬에 다운로드하지 않고 스트리밍 및 기회 위치에 업로드합니다. |
| Salesforce | 첨부 파일 업로드 작업을 사용하면 파일 스트림을 보유하는 파일 변수를 이용해 Salesforce 기록에 파일을 업로드할 수 있습니다. 커넥터 빌더로 만든 기본 제공 패키지 또는 사용자 정의 패키지의 파일 스트림 호환 작업을 사용하여 파일 스트림을 저장할 파일 변수를 생성할 수 있습니다. |
| ServiceNow | 첨부 파일 추가 작업을 사용하면 파일 스트림을 보유하는 파일 변수를 이용해 ServiceNow 테이블 애플리케이션의 기록에 파일을 업로드할 수 있습니다. 커넥터 빌더로 만든 기본 제공 패키지 또는 사용자 정의 패키지의 파일 스트림 호환 작업을 사용하여 파일 스트림을 저장할 파일 변수를 생성할 수 있습니다. |
커넥터 빌더의 파일 스트림
커넥터 빌더가 이제 패키지 작업 내에서 파일 스트림을 지원하므로 파일 스트림을 생성하고 사용하는 작업을 만들 수 있습니다. 바이너리 파일을 파일 변수에 저장하기 위한 작업을 생성할 수 있습니다. 파일 스트림 호환 작업은 기본 패키지와 커넥터 빌더를 사용하여 생성된 패키지에서 사용할 수 있으며, 동일한 세션 내에서 이 파일 변수를 사용할 수 있습니다.
작업을 생성할 때 파일 스트림 표기법 확인란 다운로드 중에 파일 스트림을 확인하십시오.