앱 프로필 탭 제출하기
앱이 소유한 프로필 화면과 표시 권한을 선언합니다.
앱 프로필 탭 제출하기
앱은 ProfileTabDescriptor 하나로 내 프로필에 탭과 화면을 제출할 수 있습니다. 대응하는 PHP SDK, Core와 앱 런타임을 적용한 후 앱을 제출하세요. Core는 개요를 소유하고 앱은 업무 탭을 명시적으로 선언합니다. 이 호스트 변경에서는 기존 슬롯 선언만으로 탭을 만들지 않으므로 적용 전에 설치된 앱을 이관하세요.
use Nexia\AppDescriptors\AppDescriptorSet;
use Nexia\AppDescriptors\Contracts\AppDescriptorContribution;
use Nexia\AppDescriptors\ProfileTabDescriptor;
final class WorkshopProfileTabs implements AppDescriptorContribution
{
public static function appDescriptors(): AppDescriptorSet
{
return AppDescriptorSet::of(new ProfileTabDescriptor(
key: 'workshop.records',
labelKey: 'workshop.profile.records',
component: 'WorkshopProfileRecords',
permission: 'workshop.record.read',
));
}
}key와 permission은 앱 소유여야 하며, 권한은 앱 카탈로그에도 선언해야 합니다. labelKey의 번역을 제공하고 프런트엔드 컴포넌트를 기존 등록의 overrides에 추가하세요.
overrides: {
WorkshopProfileRecords: () => import('./profile/WorkshopProfileRecords'),
},컴포넌트는 @nexia/sdk의 ProfileSlotPropsV2를 받아 선택된 업무 문맥을 사용할 수 있습니다. workContext가 null이면 임의의 직원을 선택하지 마세요. 앱이 화면과 버튼을 소유하며, 데이터 조회와 변경은 앱 API에서 각각 인가해야 합니다. 탭 표시 권한은 데이터 접근 권한을 대체하지 않습니다.
호스트는 앱의 설치·운영 상태와 현재 사용자의 Self 권한을 확인합니다. 탭 주소는 /me/workshop.records입니다. 대시보드 위젯 선언이나 사용자의 배치 편집은 필요하지 않습니다. 다른 표면에 위젯을 배치하려면 호스트 슬롯 안내를 참고하세요.
선언 형식은 PHP SDK descriptor 소스에서도 확인할 수 있습니다. 권한 없는 사용자와 앱 비활성화 상태에서 탭이 숨겨지는지, 업무 문맥 변경과 권한 회수 시 데이터가 다시 인가되는지 확인하세요.
기존 위젯을 하나의 탭으로 구성하기
PHP SDK 0.10.28부터 그룹 탭과 이전 주소 별칭을 제공합니다. 대상 Core와 호환되는 공개 패키지와 lock을 사용하세요. 소스 조합 검사만으로 실행 런타임의 채택을 확인할 수는 없습니다.
new ProfileTabDescriptor(
key: 'workshop.records',
labelKey: 'workshop.profile.records',
sort: 20,
widgetKeys: ['workshop.self.summary', 'workshop.self.requests'],
legacyTabIds: ['records'],
);component와 permission 조합 또는 widgetKeys 중 하나만 사용합니다.
같은 앱이 지원되는 개인 프로필 슬롯에 선언한 위젯을 묶을 수 있습니다.
위젯별 권한·순서·고용 관계를 유지하며 표시 가능한 위젯이 없으면 탭을 숨깁니다.
Core 개요는 현재 사용자의 신원·연락처·유효한 역할만 보여 줍니다. 앱 요약과 업무
액션 카드는 모으지 않으며 프로필의 대시보드 배치 버튼도 제공하지 않습니다.
기존 Core 업무 탭과 내 조직 배치는 제거됩니다. profile.team.overview는 이
화면에서 조합하지 않으므로 앱의 별도 조직 업무 화면을 사용하세요. 기존 대시보드
진입점은 독립적으로 유지됩니다. legacyTabIds는 이전 주소를 앱 탭에 연결하며
쿼리를 보존합니다. overview는 별칭으로 사용할 수 없고 알 수 없거나 충돌하는
별칭은 개요로 돌아갑니다.
이 호환성 변경을 적용하기 전에 설치된 슬롯 전용 앱을 명시적 탭 선언으로 이관하고, 권한·앱 비활성화·고용 관계 전환·기존 링크·액션 복귀를 검증하세요. 호스트 릴리스는 1.0 이전 호환성 변경 버전 정책에 따라 조율해야 합니다. 이 소스 변경만으로 운영 환경의 이관 완료를 선언하지 않습니다.