MENU
    사용자 지정 위젯 예약하기
    • 14 Mar 2025
    • 3 읽을 분
    • 기여자

    사용자 지정 위젯 예약하기


    기사 요약

    To download the app, visit: Library

    목적

    스케줄링 사용자 지정 위젯은 작업 관리를 위한 혁신적인 솔루션입니다. 이 예약 위젯은 데이터베이스에서 작업 또는 작업을 가져오는 데 사용하도록 설계되었으며, 각각 고유한 기간을 가지고 있습니다.

    위젯의 왼쪽에 표시되는 작업은 세로로 정렬된 목록으로 나타납니다. 작업을 예약 위젯의 오른쪽에 있는 리소스 중 하나에 끌어다 놓으면 작업이나 작업을 타임라인에 예약할 수 있습니다. 이 할당은 작업이나 작업을 특정 리소스에 연결하여 해당 리소스가 언제 해당 작업을 처리할지 알려줍니다.

    기본적으로 이 사용자 지정 위젯은 직관적인 드래그 앤 드롭 기능을 통해 작업과 리소스 간의 시각적 연결을 촉진함으로써 작업 할당 프로세스를 간소화하여 Tulip 인터페이스 내에서 효과적인 관리 및 스케줄링을 보장합니다.

    scheduling-printscreen.png

    설정

    위젯을 구성할 때 특정 매개변수는 필수이며, 다른 매개변수는 기본값이 있는 선택 사항입니다.

    클라이언트 시스템과의 연결을 설정하려면 위젯에 다음이 필요합니다:

    • 클라이언트의 인스턴스 URL
    • 로그인 자격증명 대신 액세스할 수 있는 인증 토큰
    • 클라이언트가 기본 워크스페이스를 사용하지 않는 경우에는 워크스페이스 ID도 제공해야 합니다.

    인증에 성공하면 스케줄링 위젯이 목록에서 검색되는 리소스에 액세스해야 합니다. 리소스는 변수 또는 테이블 쿼리에서 가져올 수 있습니다.

    스케줄링 위젯의 작업은 테이블 ID와 해당 필드를 기준으로 튤립 테이블에서 가져옵니다. 이러한 작업은 사용자 지정이 가능하므로 다른 테이블을 사용하는 경우 스케줄링 위젯을 더욱 유연하게 활용할 수 있습니다.

    스케줄링 위젯에는 다음과 같은 매개변수를 설정할 수 있습니다:

    필수 매개변수

    리소스: 텍스트 목록으로, 테이블에서 가져올 수 있지만 이 경우에는 앱 변수로 관리됩니다**.열 이름:** 필드 ID는 작업 테이블 수준에서 찾을 수 있으므로 하나씩 추가하세요.

    작업 테이블은 다음 방법으로 찾을 수 있습니다:scheduling-table.png

    필드 ID는 다음 방법으로 찾을 수 있습니다:tablefield-unique-name.png

    • 작업 ID
    • 작업 이름
    • 상태 열 이름
    • 시작 열 이름
    • 종료 열 이름
    • 기간 열 이름
    • 리소스 열 이름

    기본 인증 토큰: 오른쪽 상단의 프로필을 클릭하고 계정 설정을 선택한 다음 왼쪽 패널에서 API 토큰을 클릭하고 지침에 따라 이 토큰을 받습니다**.계정 URL:** 예: your-account.tulip.coTask테이블 ID: 테이블 ID는 테이블 수준에서 찾을 수 있습니다tableID.png

    예약 날짜: 어느 날짜에 계획을 세우시겠습니까? 날짜/시간 필드입니다.

    선택적 매개변수

    일 시작: 타임라인의 시작입니다. 기본값은 06:00입니다.일종료: 타임라인의 종료입니다. 기본값은 21:00시간 내 시간 단위: 기본값은 10(분 단위)으로, 타임라인에서 작업을 이동할 때 07:10 또는 07:20....., 각 단계는 10분을 선택할 수 있습니다. 30으로 변경하면 07:00, 07:30..... 각 단계는 30분단위너비: 위젯의 너비를 설정할 수 있는 단위로, 이 매개변수를 통해 한 단계 너비(픽셀)를 선택할 수 있습니다. 기본값은 13리소스 이름 너비입니다: 리소스 열의 너비(픽셀)입니다. 기본값은 220오버랩**:** 위젯이 작업 중첩을 지원합니다. 기본값은 false입니다**.인포박스:** 잘린 경우 작업 이름을 볼 수 있는 팝업 창입니다. 기본값은 falseStatuses입니다**(이 옵션은 인포박스가 활성화된 경우에 사용할 수 있습니다):** 스케줄링 위젯은 두 가지 고정된 상태로 작동합니다: "예약됨"과 "예약되지 않음"입니다. 또한 "완료됨" 또는 "취소됨"과 같은 추가 상태를 정의할 수 있는 기능도 제공합니다. 사용자 지정 상태의 경우 색상을 지정할 수 있으며 기본 동작(ShowByDefault)을 설정할 수도 있습니다. 쇼바이디폴트 매개변수에 따라 위젯은 쇼바이디폴트가 "아니오"인 경우 작업을 자동으로 숨기고 "예"인 경우 작업을 표시합니다.

    사용자 지정 상태는 인포박스에서 확인할 수 있습니다.image.png

    현재 시간대를 강조 표시합니다: 실시간 진행률을 나타내는 수직선을 표시하여 타임라인에서 현재 위치를 표시합니다. 기본값은 false입니다.

    트리거

    스케줄링 위젯에서 사용할 수 있는 이벤트는 다음과 같습니다:

    작업 예약됨: 타임라인에 놓인 작업예약취소됨: 타임라인에서 제거된 작업작업 이동됨: 방금 다시 예약된 작업작업상태 업데이트: 사용자 지정 상태를 사용하는 경우작업선택됨: 예약된 작업을 클릭한 경우

    image.png

    작업 선택됨 및 작업 상태 업데이트를 제외한 모든 트리거에는 다음과 같은 결과가 있습니다:

    scheduling-widget-results.png

    "작업 선택됨"의 결과는 작업의 ID입니다. 예를 들어 레코드 로딩에 사용할 수 있습니다.

    작동 방식

    데이터베이스의 작업 테이블에서 API 호출을 통해 작업을 검색하고, 리소스는 위젯의 매개변수에서 가져오며, 작업은 왼쪽에 표시되고 리소스는 스케줄링 위젯의 오른쪽에 세로로 나열되며, 각 리소스에는 작업을 배치할 수 있는 일일 타임라인이 있습니다. 이전에 할당된 작업은 위젯을 다시 로드하면 타임라인에 자동으로 다시 나타나며, 작업이 리소스에 연결되면 계획된 날짜의 시작 및 종료 시간을 수신하고 해당 날짜에만 스케줄링 위젯의 타임라인에 표시됩니다.스케줄링 위젯은 데이터베이스의 CDM 작업 테이블과 상호작용하여 새 일정, 시간 또는 리소스 간의 작업 이동, 더블 클릭을 통한 리소스 타임라인에서의 작업 제거(예약되지 않은 상태로 배치)를 기록합니다. 이러한 백그라운드 프로세스는 내장된 fireEvent 함수를 사용하여 작동합니다. fireEvent 함수에 대한 자세한 내용은 여기{target=_blank}.추가 기능에서 확인할 수 있습니다:

    • 동일한 리소스에서 동시 작업을 처리할 때 유용한 "Overlap" 매개변수를 true로 설정하여 작업 중첩을 지원합니다.
    • "정보 상자" 매개변수를 true로 설정하여 정보 상자 활성화, 간혹 이름이 타임라인에 맞지 않을 수 있으므로 클릭 시 전체 작업 이름이 표시된 작은 창을 표시합니다.

    API 토큰을 만드는 방법

    여기{target=_blank}에서 API 토큰 생성에 대한 자세한 정보를 확인할 수 있습니다.

    추가 자료

    사용자 지정 위젯에 대해 자세히 알고 싶으시다면 아래 사이트를 방문하세요: 사용자 지정 위젯 개요{target=_blank}


    이 문서가 도움이 되었습니까?