نام (NAME)

timew-import - وارد کردن داده‌های ردیابی زمان از فایل‌ها

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

timew import [<file>...]

توضیحات (DESCRIPTION)

وارد کردن زمان‌های ردیابی‌شده از file. اگر فایلی مشخص نشود، دستور از ورودی استاندارد خواهد خواند.

داده‌های واردشونده باید در قالب JSON باشند، همان‌طور که توسط timew-export(1) صادر می‌شوند؛ یعنی یک آرایهٔ تکی حاوی شیءهای بازه زمانی (interval objects).

هنگام واردسازی، بازه‌ها از نظر هم‌پوشانی با بازه‌های موجود بررسی می‌شوند. اگر هم‌پوشانی یافت شود، فرایند واردسازی در اولین تداخل متوقف شده و هیچ بازهٔ دیگری وارد نخواهد شد، مگر اینکه هینت :adjust مشخص شده باشد.

به‌طور کلی، توصیه می‌شود پیش از واردسازی، از داده‌های خود یک نسخهٔ پشتیبان تهیه کنید.

نکات (HINTS)

:adjust

در صورت مشخص شدن، بازهٔ واردشده روی هر بازهٔ موجودی که با آن تداخل و هم‌پوشانی داشته باشد بازنویسی خواهد شد.

مثال‌ها (EXAMPLES)

وارد کردن بازه‌ها از یک فایل

وارد کردن بازه‌ها از یک فایل منفرد:

timew import intervals.json

هر مسیر فایلی که با / آغاز نشود، به‌صورت نسبی نسبت به دایرکتوری کاری فعلی تفسیر می‌شود.

وارد کردن بازه‌ها از چندین فایل

همچنین می‌توان از نویسه‌های عمومی شل (wildcards) و مسیرهای مطلق استفاده کرد:

timew import /path/to/intervals/*.json

وارد کردن بازه‌ها از ورودی استاندارد

وارد کردن بازه‌ها از stdin:

timew export | ssh <server> 'timew import'

این روش به‌ویژه برای همگام‌سازی بازه‌ها بین ماشین‌های مختلف مفید است.