이 문서가 해결하는 문제#
전송 작업을 만들 때 가장 먼저 막히는 자리는 "무엇을 보낼지" 입니다. 원본 폴더에는 보낼 파일만 있는 것이 아닙니다. 작업 중인 임시 파일, 디자인 원본, 지난 달 로그, 압축 전 원본이 같은 폴더에 섞여 있습니다. 파일 하나씩 고를 수 없는 규모이고, 폴더째 보내면 보낼 필요가 없는 것까지 나갑니다.
이 문서는 그 자리에서 할 수 있는 네 가지를 다룹니다.
- 폴더째 고르기 — 파일을 하나씩 고르지 않습니다.
Item filters— 확장자, 정규식, 크기로 걸러냅니다.- 바뀐 것만 보내기 — 매번 전부 보내지 않습니다.
- Dataset — 여러 장비의 같은 경로를 하나의 묶음으로 만들어 재사용합니다.
이 문서는 고르는 쪽만 다룹니다. 목적지에 어떻게 저장할지(
Save path,File conflict)는 전송을 만드는 다른 단계이고, 결과를 읽는 방법은 아래 함께 보기의 문서에 있습니다.
누가, 어떤 상황에서#
| 상황 | 이 문서에서 쓸 것 |
|---|---|
| 검사 장비가 하루에 수만 개 이미지를 쌓는데 보낼 것은 결과 파일뿐 | Item filters 의 Types |
| 로그 폴더에 몇 달치가 쌓여 있고 새로 생긴 것만 모으고 싶다 | Regular exp. 로 날짜를 거른다(왜) |
| 영상 원본 폴더에서 큰 것만 아카이브로 보내야 한다 | Item filters 의 Minimum size |
| 공장 100곳의 같은 경로를 매번 다시 고르고 있다 | Dataset |
| 파일명 규칙으로만 구분되는 파일이 섞여 있다 | Regular exp. |
시작하기 전에#
- 보내는 쪽 장비가 연결되어 있어야 합니다. 연결되지 않은 장비는 고를 수 없습니다.
- 경로를 탐색할 권한이 있어야 합니다. 권한이 없으면 폴더를 열 때 막힙니다.
- Dataset 을 만들려면 장비가 하나 이상 연결되어 있어야 합니다 — 없으면 화면이 "Connect a device first to add a data set." 라고 적습니다.
고르는 자리#
- Flows → Flow 선택 → Edit flow.
- 캔버스에서 보내는 쪽 끝점을 고릅니다. 오른쪽 패널에 그 끝점의 줄이 섭니다.
- 아직 아무것도 고르지 않았으면 화면이 그대로 알려 줍니다 — "Nothing is sent until you choose the folders or files to send." 이 상태로 저장해도 나가는 것은 없습니다.
- 경로 칸을 눌러 탐색기를 엽니다. 이미 골라 둔 것이 있으면 안내가 "Click to browse or change selected files" 로 바뀝니다.
- 폴더를 고릅니다. 파일을 하나씩 고르지 않아도 됩니다. 고른 뒤 패널에 경로와 크기가 함께 적힙니다.
파일 하나씩 고르는 것과 폴더째 고르는 것의 차이. 파일을 지정하면 그 파일만 나갑니다. 폴더를 지정하면 실행할 때 그 폴더에 있는 것이 대상이 됩니다. 매일 새 파일이 생기는 폴더라면 폴더째 골라야 합니다.
Item filters 세 가지#
끝점 줄의 필터 칩을 누르면 Item filters 창이 열립니다. 칩의 글자가 상태를 알려 줍니다.
| 칩에 적힌 글자 | 뜻 |
|---|---|
Add filters |
이 끝점에 조건이 아직 없습니다 |
Item filters |
이 끝점에 조건이 걸려 있습니다 |
Use default |
보내는 쪽이 여럿일 때, 이 끝점은 공통 조건을 따릅니다 |
Override |
보내는 쪽이 여럿일 때, 이 끝점만 따로 걸었습니다 |
창 안은 탭 셋입니다 — Types, Name, Size. 다 정하고 Apply 를 누릅니다(Cancel 로 버립니다).
Types — 확장자로#
Allow 와 Deny 중 하나를 고르고 확장자를 넣습니다.
Allow— 적은 것만 보냅니다. 보낼 종류가 분명할 때(mp4,json) 이쪽이 안전합니다.Deny— 적은 것만 뺍니다. 빼야 할 것이 분명할 때(tmp,bak) 씁니다.
넣은 확장자는 하나씩 지울 수 있습니다(Remove {{type}}).
Allow를 기본으로 보세요.Deny는 "이것만 아니면 다 보낸다" 이므로, 나중에 새 확장자가 폴더에 생기면 말없이 함께 나갑니다.
Name — 파일명으로#
이 탭에 셋이 있습니다.
| 선택지 | 무엇을 하나 |
|---|---|
Include |
적은 글자가 들어 있는 파일만 |
Exclude |
적은 글자가 들어 있는 파일을 뺀다 |
Regular exp. |
정규식으로 맞춘다 |
Include 와 Exclude 로 되는 일에 정규식을 쓰지 마세요 — _OK 가 들어간 것만 보내려면 Include 로 끝납니다. Regular exp. 는 확장자나 글자 하나로 가를 수 없을 때 씁니다. LINE3_20261115_OK.csv 처럼 파일명 안에 자리별로 뜻이 있는 경우입니다.
Size — 크기로#
Minimum size 와 Maximum size 가 있고 단위는 MB 입니다. 둘 중 하나만 걸 수 있습니다 — 화면이 그렇게 적습니다.
Use either a minimum or a maximum size – one limit per flow.Minimum size— 작은 것을 뺍니다. 빈 파일, 헤더만 있는 파일, 잘린 파일이 섞이는 경우.Maximum size— 큰 것을 뺍니다. 야간 시간창에 끝내야 하는데 원본 하나가 그 창을 다 쓰는 경우.
0 이하나 숫자가 아닌 값을 넣으면 "Enter a size above 0, e.g. 10 or 1.5." 로 막힙니다. 소수점을 쓸 수 있습니다(1.5).
걸어 둔 조건은 칩으로 보입니다#
Apply 를 누르면 끝점 줄에 요약이 붙습니다 — 이름 조건은 Name <operator> '<value>', 크기 조건은 Size <symbol> <value> <unit> 꼴입니다. 창을 열지 않고도 무엇이 걸려 있는지 읽을 수 있습니다.
"새로 생긴 것만" 은 아직 고를 수 없습니다#
같은 폴더를 반복해서 보낼 때 "새로 생긴 것만" 보내고 싶은 것이 자연스럽습니다. 그 선택지는 지금 화면에서 고를 수 없습니다. 확인한 그대로 적습니다.
| 무엇 | 지금 상태 |
|---|---|
Flow 의 Start when |
Date/time, After transfer, URL request 셋뿐입니다. 폴더를 감시하는 선택지가 없습니다. 첫 단계에는 둘만 보입니다 — After transfer 는 앞에 끝날 것이 없어 아예 나오지 않습니다(흐려지는 것이 아니라 사라집니다) |
Sync on 의 New items / Modified items |
폴더 감시 트리거를 고른 Flow 에만 나오는 칸입니다. 그 트리거를 새로 고를 수 없으니 이 칸도 열리지 않습니다 |
그래서 대상을 줄이는 길은 Item filters 입니다. 확장자, 정규식, 크기로 좁히면 보낼 필요가 없는 파일은 나가지 않습니다. 날짜가 파일명에 들어 있는 환경이라면 Regular exp. 로 그날 분만 고르는 것이 "새로 생긴 것만" 에 가장 가깝습니다.
매번 전부 다시 보내는 것이 걱정이라면 목적지 쪽 처리로 받으세요. 같은 이름이 이미 있으면
File conflict에서Skip을 고르면 그 파일은 건너뜁니다. 보내기는 하지만 덮어쓰지 않습니다.
여러 장비를 한 묶음으로 — Dataset#
공장 100곳의 /var/log/inspection 을 매번 100번 고르는 것은 유지되지 않습니다. 그 묶음에 이름을 붙여 두는 것이 Dataset 입니다.
만들기#
- Datasets → Create dataset.
Dataset name에 이름을 넣습니다.Connection settings에서Add resource로 자원을 더합니다. 자원 하나가Device와Path의 짝입니다.Browse path로 경로를 고르고, 장비에서 다시 읽으려면Refresh path를 누릅니다.- 자원이 쌓이면 표에
Device,Paths,Files,Size,Status,Action이 보입니다. 잘못 넣은 것은Remove resource로 뺍니다. - 아직 자원이 없으면 "No resources yet. Add a resource to get started." 가 뜹니다.
Save draft로 두거나Save & publish로 올립니다. 초안을 버릴 때는 "Discard this draft?" 를 확인합니다 — 버려지는 것은 초안뿐이고 장비의 파일과 폴더는 그대로입니다.
읽기#
묶음을 열면 Sources(몇 군데에서), Contents(무엇이), Files & paths 가 보입니다. 목록 쪽 표에는 Dataset, Devices, Path, Files, Size, Last updated, Last run, Action 칸이 있습니다.
Last updated 를 먼저 보세요 — 장비에서 파일이 바뀌었는데 묶음이 아직 다시 읽히지 않았다면 이 묶음이 실제와 다릅니다.
Flow 에서 쓰기#
Dataset 을 단계에 끌어다 놓습니다. 다음 세 경우에는 화면이 막고 이유를 적습니다.
| 화면이 적는 것 | 뜻 |
|---|---|
This dataset is already in the flow. |
같은 묶음을 두 번 넣었습니다 |
Add a device to this dataset before using it in a flow. |
자원이 비어 있는 묶음입니다 |
Every device in this dataset must be connected before using it in a flow. |
묶음 안에 연결되지 않은 장비가 있습니다 |
마지막 경우가 운영에서 가장 자주 걸립니다. 100곳 묶음에서 한 곳이 꺼져 있어도 묶음째로는 쓸 수 없으니, 꺼진 장비를 빼고 작은 묶음을 따로 두는 쪽이 현실적입니다.
제대로 걸렸는지 확인하기#
조건은 실행해 보면 바로 드러납니다.
- 실행한 뒤 Runs 에서 그 실행을 엽니다.
Transferred files탭에서 실제로 나간 파일을 봅니다. 넣지 않으려던 확장자가 보이면Types가Deny로 걸려 있을 가능성이 큽니다.- 장비별로는
Devices N of M completed가 몇 대 중 몇 대인지 적습니다. - 아무것도 나가지 않았다면 순서대로 봅니다 — (1) 경로를 고르긴 했는가, (2)
Item filters의Allow목록이 지나치게 좁은가, (3)Regular exp.의 날짜 조건이 오늘과 맞는가.
오류와 예외#
| 증상 | 원인 | 할 일 |
|---|---|---|
| 저장했는데 나가는 것이 없다 | 원본을 고르지 않았다 | 끝점의 안내 "Nothing is sent until you choose the folders or files to send." 를 확인 |
| 크기 조건을 둘 다 넣을 수 없다 | 한 플로우에 한 한도만 걸 수 있다 | 둘이 필요하면 플로우를 나눈다 |
| 크기 입력이 막힌다 | 0 이하 또는 숫자가 아니다 | "Enter a size above 0, e.g. 10 or 1.5." |
| 끝점마다 조건이 달라져 있다 | Override 가 걸려 있다 |
칩이 Use default 인지 Override 인지 확인 |
| Dataset 을 놓을 수 없다 | 자원이 없거나 장비가 꺼져 있다 | 위 Flow 에서 쓰기 의 세 안내문 |
| Dataset 목록이 비어 보인다 | 불러오지 못했다 | "Could not load datasets." — 다시 시도하고 연결을 확인 |
운영할 때#
- 조건은 끝점마다 걸립니다. 보내는 쪽이 여럿인 플로우에서 한 곳만 고쳤다면 나머지는 그대로입니다. 칩의
Use default/Override로 확인하세요. Deny목록은 시간이 지나면 새는 쪽입니다. 폴더에 새 확장자가 생기면 함께 나갑니다. 장기 운영에는Allow가 안전합니다.- 크기 한도는 "왜 안 왔지" 의 숨은 원인입니다.
Maximum size를 걸어 둔 플로우에서 큰 원본은 조용히 빠집니다. 걸어 둔 한도는 문서로 남기세요. - Dataset 의
Last updated를 운영 점검 항목에 넣으세요. 묶음이 실제 장비와 어긋나면 "보냈는데 그 파일이 없다" 가 됩니다. - 조건을 좁혀 대상을 줄이는 것이 가장 값싼 성능 개선입니다. 보내지 않는 파일은 시간도 회선도 쓰지 않습니다.
업종별 예시#
| 업종 | 어떻게 거는가 |
|---|---|
| 반도체, 제조 | 검사 장비 폴더를 폴더째 고르고 Types 를 Allow 로 두어 csv 와 json 만. 이미지 원본은 자동으로 빠진다 |
| 방송, 미디어 | 원본 폴더에 Minimum size 를 걸어 썸네일과 프록시 파일을 뺀다 |
| 금융, 공공 | 파일명에 날짜와 지점 코드가 들어가므로 Regular exp. 로 그날 분만 |
| 유통, 리테일 | 매장 콘텐츠 폴더를 Dataset 으로 묶고, 목적지의 File conflict 를 Skip 으로 두어 이미 있는 콘텐츠는 건너뛴다 |
| 의료, 연구 | 검사 결과 파일명에 날짜가 있으므로 Regular exp. 로 그날 분만. 지난 검사를 다시 보내지 않는다 |
| 에너지, 인프라 | 원격 설비 묶음을 Dataset 으로 두고, 꺼진 설비는 작은 묶음으로 분리해 전체가 막히지 않게 한다 |