نام (NAME)

gh-project-item-edit - ویرایش یک آیتم در یک پروژه

خلاصه دستور (SYNOPSIS)

gh project item-edit [<number>] [flags]

توضیحات (DESCRIPTION)

ویرایش یک پیش‌نویس ایشو (draft issue) یا یک آیتم پروژه.

روش معمول برای انتخاب آیتم و فیلد بر اساس نام است: ارسال شماره پروژه number به‌همراه --owner، اشاره به آیتم با نشانی --url ایشو یا پول ریکوئست مربوطه، و مشخص کردن نام فیلد با --field. برای فیلدهای تک‌انتخابی (single-select)، --value نام گزینه مورد نظر است.

برای اسکریپت‌ها و استفاده ماشینی، می‌توانید شناسه‌های نود (node IDs) در GraphQL را نیز مستقیماً با گزینه‌های --id، --field-id و --project-id (و برای فیلدهای تک‌انتخابی با --single-select-option-id) ارسال کنید.

توجه داشته باشید که --url نشانی اینترنتی ایشو یا پول ریکوئست است، نه نشانی پروژه؛ بنابراین ممکن است مالک آن با مالک پروژه متفاوت باشد؛ گزینه --owner پروژه را انتخاب می‌کند.

برای ایشوهای غیر پیش‌نویس، در هر بار فراخوانی تنها مقدار یک فیلد قابل به‌روزرسانی است.

حذف مقدار یک فیلد از آیتم پروژه با گزینه --clear.

گزینه‌ها (OPTIONS)

--body <string>: متن بدنه آیتم پیش‌نویس ایشو
--clear: حذف مقدار فیلد
--date <string>: مقدار تاریخ برای فیلد (YYYY-MM-DD)
--field <string>: نام فیلد برای به‌روزرسانی
--field-id <string>: شناسه (ID) فیلد برای به‌روزرسانی
--format <string>: قالب خروجی: {json}
--id <string>: شناسه (ID) آیتم برای ویرایش
--iteration-id <string>: شناسه مقدار تکرار (iteration) برای تنظیم روی فیلد
-q, --jq <expression>: فیلتر کردن خروجی JSON با استفاده از عبارت jq
--number <float> (پیش‌فرض 0): مقدار عددی برای فیلد
--owner <string>: نام کاربری مالک. از "@me" برای کاربر جاری استفاده کنید.
--project-id <string>: شناسه پروژه‌ای که فیلد متعلق به آن است
--single-select-option-id <string>: شناسه گزینه تک‌انتخابی برای تنظیم روی فیلد
-t, --template <string>: قالب‌بندی خروجی JSON با استفاده از الگوی Go؛ به "gh help formatting" مراجعه کنید
--text <string>: مقدار متنی برای فیلد
--title <string>: عنوان آیتم پیش‌نویس ایشو
--url <string>: نشانی اینترنتی (URL) ایشو یا پول ریکوئستی که آیتم پروژه آن باید ویرایش شود
--value <--field>: مقداری که باید روی فیلد مشخص‌شده با --field تنظیم شود

کدهای خروج (EXIT CODES)

0: اجرای موفقیت‌آمیز

1: خطا

2: دستور لغو شد

4: نیاز به احراز هویت است

نکته: دستورات خاص ممکن است کدهای خروج دیگری نیز داشته باشند. برای اطلاعات بیشتر به راهنمای همان دستور مراجعه کنید.

مثال‌ها (EXAMPLES)

# تنظیم فیلد "Status" به "In Progress" برای یک ایشو در پروژه 1 متعلق به monalisa
$ gh project item-edit 1 --owner monalisa --url https://github.com/monalisa/myproject/issues/23 --field "Status" --value "In Progress"
# ویرایش مقدار فیلد متنی یک آیتم با شناسه نود (استفاده ماشینی / اسکریپتی)
$ gh project item-edit --id <item-id> --field-id <field-id> --project-id <project-id> --text "new text"
# پاک کردن مقدار فیلد یک آیتم با شناسه نود
$ gh project item-edit --id <item-id> --field-id <field-id> --project-id <project-id> --clear

همچنین ببینید (SEE ALSO)

gh-project(1)