시나리오의 변수와 데이터

시나리오에는 데이터를 흐르게 하는 장치가 세 가지 있습니다. 서로를 보완하는 것들이며, 어느 것을 고를지 알고 있으면 불필요한 배선을 크게 줄일 수 있습니다.

1. 링크를 타고 흐르는 토큰

주된 장치입니다. 박스가 값을 만들면 그 값이 링크를 따라 이동하고, 필요에 따라 셀렉터로 모양이 바뀐 뒤 다음 박스의 입력에 도착합니다.

명시적이고 읽기 쉬운 방식입니다. 데이터의 흐름이 곧 그림 그 자체입니다.

국소적인 것에는 이것을 사용하십시오. 어떤 호출의 결과를 다음 호출이 소비하는 경우가 그렇습니다.

2. 실행 변수

실행에 고유한, 이름이 붙은 공간입니다.

• 변수 설정이 값을 씁니다.
• 변수 가져오기가 그것을 다시 읽습니다.
• variable 타입의 값은 어떤 필드에서든 그 자리에서 값을 읽습니다.
• {{name}} 은 템플릿(Transform template, Map) 안에서 읽습니다.
• vars 객체는 코드 액션 안에서 읽습니다.
• 목록에 추가와 목록에서 제거는 소스가 되는 변수에 직접 쓸 수 있습니다.

실행 변수는 실행되는 동안 환경을 덮어 가립니다. {{token}} 을 사용하는 요청은 환경의 토큰이 아니라 시나리오가 설정한 토큰을 가져갑니다.

실행 전체에 걸치는 것에는 이쪽을 사용하십시오. 토큰, 상관관계 식별자, 카운터 같은 것을 그래프 전체에 링크를 끌고 다니지 않고도 다룰 수 있습니다.

3. 파라미터와 출력

• Input / Param 박스는 이름이 붙은 파라미터를 하나 이상, 각각의 타입과 함께 선언합니다. 내보내는 것은 단 하나의 객체 { name: value, … } 입니다.

  값은 다음 순서로 제공됩니다. 실행 시점(인터페이스 또는 MCP), 명령줄 (--param name=value), 또는 시나리오가 값 없이 그 박스에 도달한 경우의 대화형 질의입니다.

• Output / Return 박스는 이름이 붙은 결과를 호출자에게 공개합니다. 시나리오 실행 액션이 호출한 시나리오는 그 출력을 호출자의 output:<name> 포트에 드러냅니다.

이것이 조립을 가능하게 합니다. 토큰을 돌려주는 “로그인” 시나리오를 다른 시나리오들이 재사용하는 식입니다.

환경

요청 액션에는 env 포트가 있습니다. 여기에 환경(environment 타입의 값 또는 환경 이름)을 배선하면 그 환경에서 호출이 실행됩니다.

같은 시나리오를 staging 에 대해, 이어서 production 에 대해 돌리기 위한 방법입니다. 무엇도 복제할 필요가 없습니다. 환경은 시나리오의 파라미터로 넘기십시오.

헤드리스 모드에서의 해석

타입이 지정된 모든 값은 인터페이스에서든 창 없이든 똑같이 해석됩니다. 사용자 지정 목록, 열거형, 환경 미리보기도 마찬가지입니다. 인터페이스에서 동작하는 시나리오는 CI에서도 동작합니다.

환경 이름이 모호한 경우(동명의 환경이 두 개 있는 경우)에는 명시적인 오류가 발생합니다. 그때는 식별자를 넘기십시오.

명령줄 파라미터의 변환

--param 은 텍스트를 받고, Restorm이 파라미터의 선언된 타입에 따라 이를 변환합니다.

선언된 타입	넘기는 값
숫자	--param Seuil=42
Boolean	--param Actif=true (1, yes, on 도 가능)
Date math	날짜 또는 epoch 타임스탬프
목록	JSON: --param Ids='[1,2,3]'
열거형	값. 허용된 집합에 대해 검증됩니다
사용자 지정 값 목록	레이블. 값으로 변환됩니다 (Rouge → FF0000)
환경	환경의 이름 또는 식별자
그 밖의 것	원본 문자열

변환이 불가능하면 잘못된 값으로 실행하는 대신 명확한 메시지와 함께 실행이 실패합니다.