변환된 Alteryx 앱 사용

PlaidCloud는 Alteryx 분석 앱의 질문을 제어되는 워크플로 변수로 변환합니다. 사용자는 실행하기 전에 이 변수를 설정할 수 있으며, PlaidCloud는 그 값을 수식, 필터, 파일 경로, 조건, 매크로 매개변수, 하위 단계 설정에 적용합니다.

App Runner 프런트엔드

Alteryx 분석 앱(.yxwz)을 변환하면 해당 앱의 인터페이스도 게시된 Panel “App Runner”로 구현됩니다. App Runner는 Alteryx 질문이 수집하던 값과 같은 값을 수집하여 그 값으로 변환된 워크플로를 실행하는 실제 작동하는 입력 양식입니다. 이 프런트엔드는 변환의 일부로 자동으로 생성되며, 입력 위젯이 없는 앱은 건너뜁니다.

앱의 질문은 텍스트, 숫자, 날짜, 체크박스, 라디오 버튼, 드롭다운, 목록 상자, 트리, 파일 찾아보기, 폴더 찾아보기 등의 App Runner 컨트롤이 됩니다. 각 컨트롤은 변환된 단계가 읽는 워크플로 변수에 값을 기록하므로, App Runner에서 실행하면 변수를 직접 설정할 때와 같은 로직이 실행됩니다. 실제 워크플로 변수에 바인딩되지 않은 컨트롤은 값을 조용히 수집하고 어디에도 전달하지 않는 대신 눈에 띄는 참고 사항과 함께 표시되므로, 이를 검토하여 의도한 변수에 연결하십시오.

양식은 앱 작성자의 그룹 구성, 즉 작성자가 앱을 만들 때 사용한 탭과 이름이 붙은 상자를 그대로 따라 배치되며, 작성자의 설명 텍스트(Alteryx Label 도구)는 설명 대상 질문과 함께 양식에 표시됩니다. 앱이 설계 시점에 고정한 질문, 예를 들어 이를 구동하는 인터페이스 질문이 없는 Detour는 질문으로 전혀 표시되지 않습니다.

양식은 워크플로의 변수에 저장된 값으로 열립니다. 다른 값을 저장하지 않은 경우에는 작성자의 기본값입니다. 저장된 값이 없는 질문은 비어 있습니다. 저장된 값이 더 이상 질문의 선택 항목 중 어느 것과도 일치하지 않으면, 오래된 선택으로 표시되지 않고 무시됩니다. 숫자 질문은 작성자가 설정한 최솟값, 최댓값, 증분을 적용하므로 작은 범위로 제한된 질문은 범위 밖의 값으로 답할 수 없습니다.

변환된 워크플로가 분기하는 곳에서는 App Runner가 분기를 이름이 붙은 선택 항목으로 표시하므로, Alteryx 앱에서 선택하던 것처럼 실행이 거치는 경로를 실행 시점에 고를 수 있습니다.

파일 및 폴더 질문

각 파일 또는 폴더 질문에는 문서 브라우저를 여는 찾아보기 버튼이 있으므로, 경로를 기억에 의존해 입력하는 대신 선택할 수 있습니다.

찾아보기는 접근할 수 있는 Document 계정을 제공하며, 기본값은 앱 자체 계정이고 계정 간에 전환할 수 있습니다.
질문의 현재 답변이 가리키는 폴더에서 열리며, 아직 답변이 없으면 계정의 최상위에서 열립니다.
위쪽의 경로 표시줄로 상위 폴더로 돌아갈 수 있습니다. 목록에서 폴더를 선택하면 그 폴더가 열리고, 파일을 선택하면 해당 파일이 선택됩니다.
선택을 누르기 전에 채워질 경로가 표시됩니다. 아무것도 강조 표시되지 않은 상태에서는 선택이 현재 보고 있는 폴더를 가져오며, 계정의 최상위를 선택하려면 이렇게 합니다.
폴더를 나열할 수 없으면 목록에 그 사실과 이유가 표시되며, 선택은 보이지 않은 경로를 채우지 않습니다. 20초 이내에 응답이 없는 목록은 계정이 응답하지 않았다고 표시합니다.

앱 실행

양식을 작성하고 실행을 누릅니다.

답변은 실행과 함께 전달되며 해당 실행에만 적용됩니다. 워크플로에 저장되지 않으므로 한 사람의 답변이 다른 사람의 실행에 영향을 주지 않으며, 앱을 실행하는 데 워크플로를 변경할 권한이 필요하지 않습니다. 이는 행을 제한하는 프로젝트에서 중요한데, 이러한 프로젝트는 아키텍트만 변경할 수 있기 때문입니다. 양식이 열릴 때 표시되는 값을 바꾸려면 아래와 같이 워크플로에 값을 저장하십시오.

답변은 실행이 시작되기 전에 확인됩니다. 답변하지 않은 선택형 질문이 있으면 실행이 시작되기 전에 중지되고 해당 질문이 지정되므로, 한 시간 가까이 걸릴 수 있는 실행이 진행되는 도중에 발견되는 일이 없습니다.

실행이 진행되는 동안 양식에는 진행률 표시줄, 워크플로의 전체 단계 수에 대해 계산된 N of M steps, 경과 시간, 현재 실행 중인 단계가 표시됩니다. 일시 중지와 중지는 실행 중일 때만 실행 옆에 나타나며, 실행이 일시 중지되면 일시 중지가 재개로 바뀝니다.

실패한 단계는 실패하는 즉시 양식에 표시되며, 실행이 끝나면 양식에 실패한 각 단계가 보고한 내용이 인용됩니다. 워크플로를 열어 중지된 이유를 확인할 필요가 없습니다. 앞선 단계가 실패하여 실행할 수 없었던 단계는 실패가 아니라 실행되지 않음으로 별도로 표시되며, 진행률 표시줄에는 계속 포함되므로 진행률 표시줄이 끝까지 도달합니다.

페이지를 닫거나 연결이 끊겨도 실행은 계속됩니다. 실행이 아직 진행 중일 때 앱을 다시 열면 유휴 양식 대신 일시 중지와 중지가 있는 진행 중인 실행이 표시됩니다.

실행 옆의 워크플로 열기 링크는 새 탭에서 PlaidCloud의 기본 워크플로를 엽니다. DAG 워크플로이면 캔버스에서 열립니다. 양식 자체의 실행 보기가 업데이트를 멈춘 경우에도 작동합니다.

아래와 같이 변수를 설정하여 워크플로를 직접 실행할 수도 있습니다. App Runner는 앱 방식의 추가 진입 경로입니다.

앱을 최신 상태로 유지

App Runner 앱은 PlaidCloud가 app.py, widget_map.py, requirements.txt를 생성하는 Panel 서버 앱입니다. PlaidCloud가 App Runner를 업데이트하면 기존 앱이 새 버전을 자동으로 적용합니다. 각 앱은 PlaidCloud가 다음에 업데이트될 때 현재 파일로 갱신되어 다시 빌드되며, 내 Panel 앱 화면에서 앱을 다시 빌드하거나 편집할 때도 마찬가지입니다. 앱의 설정과 워크플로는 변경되지 않습니다.

잠긴 앱은 그대로 유지됩니다. 최신 상태로 만들려면 잠금을 해제하고 다시 빌드를 클릭하십시오.
생성된 파일을 직접 수정한 내용은 대체됩니다. 갱신하면 현재 app.py, widget_map.py, requirements.txt가 변경 내용 위에 기록됩니다. 앱의 Git 이력에는 이전 버전이 보관됩니다.

변환된 입력 유형

PlaidCloud는 일반적인 Alteryx 앱 컨트롤을 유형이 지정된 워크플로 입력으로 변환합니다.

텍스트 상자는 텍스트 변수가 됩니다.
숫자 컨트롤은 숫자 변수가 됩니다.
날짜 컨트롤은 ISO 날짜 변수가 됩니다.
체크박스, 라디오 버튼, 드롭다운, 목록 상자, 트리는 제어되는 선택 변수가 됩니다.
파일 찾아보기 컨트롤은 Document 파일 변수가 됩니다.
폴더 찾아보기 컨트롤은 Document 폴더 변수가 됩니다.

변환된 워크플로는 Alteryx 앱이 원래 질문 값을 사용하던 모든 곳에서 이 변수를 사용합니다.

실행 전 값 설정

변환된 앱 워크플로를 실행하기 전에 다음을 수행합니다.

변환된 워크플로를 엽니다.
워크플로 변수를 검토합니다.
필수 텍스트, 숫자, 날짜, 선택, 파일, 폴더 값을 설정합니다.
Document 파일 및 폴더 경로가 가져온 종속성 위치 또는 승인된 다른 Document 경로를 가리키는지 확인합니다.
워크플로를 실행합니다.

예약된 실행의 경우, 일정이 실행될 때마다 사용해야 할 변수 값을 저장하십시오.

조건, 경고 및 오류

Alteryx 앱 조건과 오류 검사는 PlaidCloud 단계 조건으로 변환됩니다. 조건은 다음을 수행할 수 있습니다.

워크플로가 계속되도록 허용합니다.
경고 메시지를 표시합니다.
앱 규칙에 따라 필요한 경우 명확한 오류와 함께 워크플로를 중지합니다.
실행을 다른 분기로 라우팅합니다.

이 동작을 사용하여 PlaidCloud에서 워크플로를 실행하면서 앱 수준의 검증을 유지하십시오.

파일 및 폴더 입력

파일 및 폴더 질문은 Document 경로를 사용합니다.

파일 입력은 Document에서 파일을 선택합니다.
폴더 입력은 Document 폴더를 선택합니다.
가져온 데스크톱 종속성은 가져오기 중에 선택한 Document 경로에 저장됩니다.
동적 입력 단계는 변수를 사용하여 실행 시점에 최종 Document 경로를 결정할 수 있습니다.

이렇게 하면 변환된 앱을 사용자와 예약된 실행 간에 이식할 수 있습니다.

매크로 매개변수

변환된 앱이 매크로를 호출하면 앱 변수가 매크로 매개변수에 값을 전달할 수 있습니다. PlaidCloud는 매크로 입력과 제어 매개변수 처리를 통해 이 값을 생성된 매크로 워크플로에 전달합니다.

동시 매크로 실행은 격리되므로, 여러 워크플로 실행이 중간 상태를 공유하지 않고 같은 변환된 매크로를 사용할 수 있습니다.

검증 체크리스트

변환된 각 앱에 대해 다음을 확인합니다.

예상되는 모든 질문이 워크플로 변수로 나타납니다.
기본값이 구성되어 있던 경우 원래 앱과 일치합니다.
제어되는 목록에 예상한 선택 항목이 포함되어 있습니다.
파일 및 폴더 변수가 Document 경로를 가리킵니다.
조건이 예상한 메시지, 경고 또는 중지 동작을 생성합니다.
선택한 변수 값에 대해 출력 동등성 검증이 통과합니다.