カスタムインポート
外部ソースから YouTrack にデータをインポートするには、YouTrack に組み込まれているインポートスクリプトの 1 つをカスタマイズしたり、新しいインポートスクリプトを最初から作成したりできます。
カスタムインポートスクリプトは、中間データスキームとして JSON を使用して JavaScript で記述されています。YouTrack にインポートされたすべてのデータは、JSON に変換されてから、YouTrack エンティティに変換されます。
新しいカスタムインポートを設定する
外部ソースから YouTrack にデータをインポートするには、新しいカスタムインポートスクリプトパッケージを作成する必要があります。
新しいインポートスクリプトを作成するには:
管理メニューから、を選択します。新規インポートボタンをクリックして、セットアップダイアログを開きます。
カスタムインポートを選択します。
スクリプトパッケージをインポートするドロップダウンメニューを展開します。
新しいインポートスクリプトパッケージを選択します。
新しいインポートスクリプトパッケージダイアログが開きます。
名前とタイトルを入力します。
作成ボタンをクリックしてください。
新しいインポートスクリプトがバックグラウンドで作成されます。この新しいスクリプトは、スクリプトパッケージをインポートするドロップダウンメニューで選択されます。
これで新しいインポートスクリプトパッケージができましたが、必要なすべてのデータを外部ソースから YouTrack エンティティに変換するように構成する必要があります。
作成したスクリプトを Web ベースのスクリプトエディターで開くには、ダイアログの下部にあるインポートスクリプトのカスタマイズリンクをクリックします。インポートスクリプトを作成およびカスタマイズする方法については、デモインポートスクリプトを調べて、カスタムインポート API リファレンスを参照してください。スクリプトの編集が終了したら、インポート構成に進みます。
Web ベースのスクリプトエディターでの作業については、Web ベースのワークフローエディターを参照してください。
カスタムインポートを構成するには:
- 管理メニューから、を選択します。
新規インポートボタンをクリックして、セットアップダイアログを開きます。
カスタムインポートを選択します。
新しいカスタムインポートダイアログが開きます。
以下の設定に値を入力します。
設定
説明
URL
インポートソースの URL を入力します。
ユーザー名またはメール
インポートする必要のあるデータにアクセスできるインポートソースに、ユーザーアカウントのユーザー名またはメールを入力します。
パスワードまたはトークン
インポートソースでユーザーの認証に使用されるパスワードまたはトークンを入力します。
スクリプトパッケージをインポートする
作成したインポートスクリプトを選択します。
次へボタンをクリックして、構成ダイアログの次の部分を開きます。
ドロップダウンで、データのインポート元のプロジェクトを選択します。インポートソース内のすべてのプロジェクトからデータをインポートするには、デフォルトのすべてのプロジェクト設定のままにします。
カスタムインポートソースが連続インポートモードをサポートしている場合は、継続的なインポートスイッチをアクティブにします。
インポートを開始しますボタンをクリックしてください。
カスタムインポートスクリプトロジックの対象となるエンティティは、YouTrack にインポートされます。
継続的なインポートオプションが有効になっている場合、YouTrack はインポートソースの更新を定期的にチェックします。
インポートリンクのダウンロードオプションを使用すると、インポートログをダウンロードできます。このオプションを使用して、インポート中に発生したエラーを表示および調査します。
デモインポートスクリプトを調べる
カスタムインポートスクリプトがどのように機能するかを理解するには、YouTrack に組み込まれている事前定義されたデモインポートスクリプトを確認してください。
デモインポートスクリプトパッケージを開くには:
- 管理メニューから、を選択します。
新規インポートボタンをクリックして、セットアップダイアログを開きます。
カスタムインポートを選択します。
新しいカスタムインポートダイアログが開きます。
スクリプトパッケージをインポートするドロップダウンメニューで、デフォルトの
@jetbrains/youtrack-demo-clientスクリプトが選択されていることを確認してください。
ページの下部にあるインポートスクリプトのカスタマイズリンクをクリックします。
Web ベースのスクリプトエディターが開き、デモスクリプトパッケージが展開されます。Web ベースのスクリプトエディターでの作業については、Web ベースのワークフローエディターを参照してください。
デモスクリプトパッケージは 5 つのファイルで構成されています。メインスクリプトファイルの名前は client.js です。インポートロジックと API リファレンスが含まれています。スクリプトの例としてこのファイルを参照してください。
他の 4 つのファイルには、JSON 形式でハードコードされたデモデータが含まれています。このデータは、デモインポートスクリプトの実行時に YouTrack エンティティに変換されます。
これらの 4 つのファイルは、課題、記事、プロジェクト、ユーザーに対してインポートできる属性を示しています。これらのファイルを参照して、インポートソースから予想されるデータ形式を確認してください。
事前定義されたインポートスクリプトをカスタマイズする
GitHub、Jira、MantisBT、Redmine、Bugzilla、GitLab、Zendesk、monday.com、YouTrack、合流からの事前定義されたインポートのロジックでカバーされていないエンティティをインポートするには、対応するスクリプトを編集できます。
Web ベースのエディターで事前定義されたスクリプトパッケージを開くには:
- 管理メニューから、を選択します。
新規インポートボタンをクリックして、セットアップダイアログを開きます。
インポートソースに対応するオプションを選択します。
ページの下部にあるインポートスクリプトのカスタマイズリンクをクリックします。
Web ベースのスクリプトエディターが開き、関連するスクリプトパッケージが展開されます。Web ベースのスクリプトエディターでの作業については、Web ベースのワークフローエディターを参照してください。
これで、事前定義されたインポートスクリプトに変更を加えることができます。詳細については、API リファレンスを参照してください。
インポートされたエンティティ
インポート用の API は、外部ソースから YouTrack にインポートできる多くのタイプのエンティティをサポートしています。ただし、対象外であり、この方法を使用してインポートできないエンティティがあります。YouTrack REST API および Hub REST API を使用して、これらのエンティティの一部をインポートすることができます。
次のエンティティは、インポートスクリプトを使用して YouTrack にインポートできます。
プロジェクト
課題
カスタムフィールドとその値
コメント
添付
作業項目
リンク
タグ
記事
ユーザー
グループ
次のエンティティは、インポートスクリプトを使用して YouTrack にインポートできません。
アジャイルボード。これらのエンティティをインポートするには、YouTrack REST API を使用します。
レポート
ダッシュボード。これらのエンティティをインポートするには、Hub REST API を使用します。
関連ページ：
Web ベースのワークフローエディター
YouTrack には、JavaScript でワークフローを作成するために使用できる Web ベースのワークフローエディターが組み込まれています。統合開発環境でコードを書くことを好む場合でも、JavaScript をサポートする外部エディターを使用してワークフローを YouTrack にインポートすることができます。ワークフローコンストラクターにアクセスするには: アプリケーションヘッダーの管理メニューから、ワークフローを選択します。JavaScript で記述されたワークフローを見つけて、リス...
GitHub からインポート
GitHub からのインポートにより、課題、コメント、ユーザー、その他のデータを GitHub リポジトリから YouTrack に移行できます。セットアップウィザードは、インポート構成プロセスを移動します。接続設定を入力するように求められ、YouTrack のプロジェクトを GitHub のリポジトリにマップできます。リポジトリに課題用のカスタムフィールドセットがある場合は、YouTrack でインポートスクリプトを直接編集できます。前提条件：GitHub から YouTrack に課題をイン...
JIRA からインポート
YouTrack を使用すると、Jira インスタンスに接続できます。この統合により、次のタスクを実行できます。Jira から既存のプロジェクト、ユーザー、グループ、グループメンバーシップをインポートします。以前にインポートしたプロジェクトを更新して、Jira で行われた課題に変更を適用します。最後のインポート以降に Jira プロジェクトの課題に適用される新しい課題と変更が YouTrack に追加されます。セキュリティレベルが設定された Jira からインポートされた課題の表示設定は、プロジェ...
Mantis バグトラッカーからのインポート
Mantis バグトラッカー (MantisBT) からのインポートでは、プロジェクト、ユーザー、課題、その他のエンティティを MantisBT から YouTrack にインポートできます。セットアップウィザードは、インポート構成プロセスを移動します。接続設定を入力するように求められ、YouTrack のプロジェクトを MantisBT のプロジェクトにマップできます。MantisBT に課題用のカスタムフィールドセットがある場合は、YouTrack でインポートスクリプトを直接編集できます。前...
Bugzilla からインポート
Bugzilla からのインポートでは、プロジェクト、課題、課題履歴、コメント、アタッチファイル、ユーザー、カスタムフィールド、タグ、リンク、作業項目を Bugzilla サービスから YouTrack にインポートできます。セットアップウィザードは、インポート構成プロセスを移動します。接続設定を入力するように求められ、YouTrack のプロジェクトを Bugzilla のプロジェクトにマップできます。Bugzilla プロジェクトに課題用のカスタムフィールドセットがある場合は、YouTrack...
Zendesk からインポート
Zendesk からのインポートにより、チケット、添付ファイル、ユーザー、その他のデータを Zendesk から YouTrack に移行できます。セットアップウィザードは、インポート構成プロセスを移動します。接続設定を入力するように求められ、YouTrack のプロジェクトを Zendesk のブランドにマップできます。Zendesk インスタンスにチケット用のカスタムフィールドセットがある場合は、YouTrack でインポートスクリプトを直接編集できます。前提条件：Zendesk から Yo...