# WriteData

WriteData 함수를 사용하여 로컬 장치 또는 FTP 서버에서 파일에 데이터를 쓰거나 파일에 데이터 문자열을 추가할 수 있습니다. 이 함수를 사용하여 데이터 결과를 기록하고 파일에서 볼 수 있습니다.

참고 : 온라인이거나 오프라인 상태이거나 선택한 저장 위치에 파일을 저장할 수 있습니다.

## WriteData 입력

매개 변수 | 설명
데이터 | 파일에 쓰거나 파일에 추가하려는 텍스트 문자열 또는 텍스트 문자열을 포함하는 셀에 대한 참조를 지정합니다.
이벤트 | 업데이트를 강제하는 이벤트를 지정합니다. 이 매개 변수는 타임스탬프가 있는 이벤트에 대한 참조여야 합니다. 예를 들어 다음 중 하나여야 합니다. Event 함수가 포함된 셀. Button 함수가 포함된 셀.
스토리지 | 데이터 파일을 로컬 장치에 저장할지 FTP 서버에 저장할지 지정합니다. 저장 위치는 연결된 장치 및 함수의 스토리지 설정에 따라 다릅니다.
스토리지 설정 | 연결 장치 | 저장 위치
--- | --- | ---
로컬 장치 | In-Sight 장치 | In-Sight 장치 In-Sight 장치에 설치된 SD 카드 참고 : 파일을 보려면 FileZilla 클라이언트 등의 FTP 소프트웨어를 사용해야 합니다. 자세한 내용은 In-Sight 장치에 저장된 파일을 보는 방법 항목을 참조하십시오. SD 카드 스토리지를 사용하는 경우 작업을 실행하기 전에 SD 카드를 연결했는지 확인하십시오. SD 카드를 연결하지 않고 SD 카드 스토리지를 구성하면 파일이 내부 플래시 드라이브의 /sdcard 디렉터리에 저장됩니다.
PC | PC 참고 : PC 저장은 FTP 서버를 통해서만 지원됩니다.
FTP 서버 | 모든 장치 | 지정된 FTP 서버
서버 | 네트워크 상에서 데이터 파일이 쓰여질 FTP 서버의 서버 이름(또는 IP 주소)을 지정합니다. FTP 서버는 In-Sight 에뮬레이터일 수도 있고 네트워크에서 FTP 서버로 인식되는 기타 장치가 될 수 도 있습니다. 참고 : FTP 서버를 스토리지 유형으로 지정한 경우에만 이 옵션이 활성화됩니다. 특정 포트가 필요한 경우 서버 이름에 추가할 수 있습니다. 예를 들어, FTP 서버가 포트 50021을 사용하는 경우 "127.0.0.1:50021"을 입력합니다.
사용자 이름 | FTP 서버의 사용자 이름을 지정합니다. 이 필드를 비워두면 "admin"이 사용됩니다. 참고 : FTP 서버를 스토리지 유형으로 지정한 경우에만 이 옵션이 활성화됩니다.
암호 | FTP 서버의 암호를 지정합니다. 암호는 대소문자를 구별합니다. FTP/SFTP 서버에 암호가 없는 경우 이 필드를 비워도 됩니다. 참고 : FTP 서버를 스토리지 유형으로 지정한 경우에만 이 옵션이 활성화됩니다. 보안상의 이유로, 입력된 암호는 WriteData 속성 시트와 수식 바에서 "*"로 표시됩니다. 암호는 암호화된 형식으로 작업 파일에 저장됩니다.
파일 경로 | 파일을 저장할 위치를 지정합니다. PC에 저장하는 경우 운영 체제 쓰기 권한이 있는 모든 위치에 파일을 쓸 수 있습니다. 이 필드에는 하드 코딩된 경로(예: X:/, X:/Subdir), UNC 경로(예: //Cognex/shared/), 매핑된 드라이브(예: M:/Subdir), 상대 경로(../../Subdir)를 입력할 수 있습니다. In-Sight 장치 또는 PC에 경로가 없는 경우 이 함수는 #ERR을 반환합니다. FTP 서버에서 경로 또는 FTP 자격 증명이 유효하지 않은 경우에는 #ERR이 반환되지 않습니다. 이 필드를 비워두면 파일이 다음 기본 위치 중 하나로 전송됩니다. In-Sight 장치: 장치의 루트 디렉토리. FTP 서버: 지정된 FTP 서버의 기본 디렉토리.
파일 이름 | 데이터 파일 이름을 지정합니다. 참고 : 사용 가능한 문자는 운영 체제의 제한을 따릅니다.
데이터 형식 | 파일 유형을 지정합니다. 파일 이름에 확장자가 자동으로 추가됩니다.
0 = TXT(기본값) | 표준 ASCII 텍스트 파일 형식(.TXT).
1 = HTML | 표준 HTML 파일 형식(.HTML).
2 = XML | 표준 XML 파일 형식(.XML).
3 = CSV | 표준 CSV 파일 형식(.CSV).
추가 | 데이터를 파일에 쓰는 방법을 지정합니다.
0 = 꺼짐 | 파일의 기존 데이터를 덮어씁니다.
1 = 켜짐(기본값) | 데이터 문자열을 파일 끝에 추가합니다.

## WriteData 출력

반환 | 참조된 이벤트가 트리거될 때마다 데이터 매개 변수에 포함된 데이터 문자열을 로컬 장치 또는 FTP 서버에 쓰는 WriteData 구조체. 입력 매개 변수가 유효하지 않거나 파일 대기열이 가득 찬 경우 #ERR을 반환합니다. 참고 : 유효하지 않은 FTP 서버, 경로, 파일 이름의 경우에는 #ERR을 반환하지 않습니다.