Zendesk からインポート
Zendesk(英語) からのインポートにより、チケット、添付ファイル、ユーザー、その他のデータを Zendesk から YouTrack に移行できます。
セットアップウィザードは、インポート構成プロセスを移動します。接続設定を入力するように求められ、YouTrack のプロジェクトを Zendesk のブランドにマップできます。Zendesk インスタンスにチケット用のカスタムフィールドセットがある場合は、YouTrack でインポートスクリプトを直接編集できます。
前提条件
Zendesk から YouTrack にプロジェクトをインポートする前に、次の要件を確認してください。
YouTrack および Zendesk インストールには受信接続からアクセスできます。具体的には、ネットワークが Zendesk と YouTrack 間の接続をブロックしていないことを確認する必要があります。
Zendesk のユーザーアカウントには管理権限があります。
パスワードまたはトークンを使用して、ソースアプリケーションに直接ログインしてアクセスできます。
YouTrack のインポートエンジンは、外部認証モジュールによる認証をサポートしていません。
詳細のインポート
Zendesk データベースにまだ YouTrack に存在しないエンティティへの参照が含まれている場合は、エンティティが作成されます。インポートの実行に使用する YouTrack ユーザーアカウントには、インポートされたすべてのエンティティを作成するための十分な権限が必要です。インポートを実行するには、システム管理者ロールまたは低レベルの管理者書き込み権限を持つアカウントを使用することをお勧めします。
インポートされたエンティティ
以下は、Zendesk からインポートされたエンティティのリストと、それらの YouTrack エンティティへのマッピングです。
Zendesk のエンティティ | YouTrack のエンティティ |
---|---|
ブランド | プロジェクト |
チケット | 課題 |
チケットフィールド | カスタムフィールド |
ユーザー | ユーザー |
エージェント | ユーザー |
グループ | グループ |
チケットの添付ファイル | 添付ファイルを発行する |
コメント | コメント |
チケットの最初のコメントとその件名 | 課題の説明と要約 |
タグ | タグ |
リンクされたチケット | リンクされた課題 |
インポートの制限
YouTrack は、一部のエンティティを部分的にインポートするか、まったくインポートしません。Zendesk で設定された制限の一部は、インポート時に無視されます。
次のインポート制限があります。
Zendesk のエンティティ | 詳細 |
---|---|
チケット履歴 | YouTrack は、コメントのみをチケットにインポートします。YouTrack は、ステータス、タグ、フィールド、その他の変更の変更などの履歴イベントをインポートしません。 |
ナレッジベース | YouTrack は、Zendesk のナレッジベースから記事をインポートしません。 |
内部コメント | YouTrack は、可視性の制限なしに、公開コメントとともに内部コメントをインポートします。 |
ユーザータイプ | YouTrack は、すべてのタイプのユーザーを等しくインポートします。YouTrack 管理者は、インポート後にユーザー権限を個別に構成する必要があります。詳細については、ユーザーアクセスの管理を参照してください。 |
Zendesk からのインポートを設定する
新しいインポート設定を追加する前に、Zendesk へのアクセスを許可する API トークンを作成する必要があります。次に、YouTrack でインポートを設定するときに、認証にトークンを使用できます。
Zendesk で API トークンを作成する
Zendesk からのチケットのインポートを設定するには、まず、Zendesk サービスの API トークンを作成する必要があります。
Zendesk で API トークンを作成するには:
Zendesk の管理センターで、アプリと統合をクリックします。
Zendesk API を選択します。
設定タブをクリックし、トークンアクセスオプションが有効になっていることを確認します。
API トークンを追加ボタンをクリックしてください。
API トークンをコピーして、インポートセットアップウィザードに入力します。
API トークンの作成の詳細については、Zendesk のドキュメント(英語)を参照してください。
YouTrack で Zendesk からのインポートを設定する
セットアップウィザードは、セットアッププロセスをガイドします。
Zendesk からのインポートを設定するには:
管理メニューから、 を選択します。
新規インポートボタンをクリックして、セットアップダイアログを開きます。
Zendesk を選択します。
Zendesk からの新規インポートの設定が表示されます。
以下の設定に値を入力します。
設定
説明
Zendesk の URL
Zendesk の URL。
トークン
ターゲットチケットにアクセスするために Zendesk で生成した API トークン。
Zendesk サービスで必要な場合は、クライアント認証に SSL キーを使用するオプションを有効にします。
次へボタンをクリックしてください。
インポート設定の 2 番目のセットが表示されます。
オプションのデータセットのインポートを管理するセクションを展開します。ここでは、インポート中にソースデータベースの特定の部分を無視するようにインポートエンジンを構成できます。
設定
説明
課題履歴
このトグルを無効にして、インポート中に課題の変更履歴を無視します。
課題リンク
インポート中に課題間のリンクを無視するには、このトグルを無効にします。
デフォルトでは、これらのトグルは有効になっています。これは、インポートスクリプトがサポートしている場合、YouTrack が過去の変更をプルし、インポートソースからリンクを発行することを意味します。
Zendesk ブランドとインポート対象の Youtrack プロジェクトを選択します。プロジェクトマッピング構成の詳細については、プロジェクトマッピングを参照してください。
必要に応じて、継続的なインポートを有効にします。有効にすると、YouTrack は選択した Zendesk ブランドのチケットを定期的にポーリングし、最後の同期以降に行われた更新をインポートします。
インポートを開始しますボタンをクリックしてください。
YouTrack は、構成されたプロジェクトマッピングに従って、新しいプロジェクトを作成し、既存のプロジェクトにデータをインポートします。
YouTrack は、選択した Zendesk ブランドからターゲット YouTrack プロジェクトにチケット、コメント、ユーザーをインポートします。
継続的なインポートオプションが有効になっている場合、YouTrack はターゲットの Zendesk ブランドで更新されたチケットと新しいチケットを定期的にチェックします。
インポートを設定すると、インポートリストに表示されます。構成とインポートの詳細を表示するには、リストからインポート構成を選択します。
詳細サイドバーの YouTrack には、インポートステータス、最後にインポートされた日時、インポートされたデータの詳細が表示されます。インポート中に課題が発生した場合は、エラーメッセージがここに表示されます。
ツールバーの 再開ボタンをクリックして、変更のポーリングとソース Zendesk ブランドからの更新のインポートを明示的に開始します。
インポートログファイルをダウンロードして、必要に応じて調査および調査することもできます。
プロジェクトマッピング
インポート設定の最後のステップで、YouTrack にインポートするブランドを選択できます。YouTrack の既存のプロジェクトにデータをインポートするか、インポートするために新しいプロジェクトを作成するかを選択することもできます。
YouTrack は、Web アドレスが以前のインポートによってソースプロジェクトをすでにマップしているかどうかを認識します。YouTrack ですでにマップされているインポートされたソースプロジェクトは選択できません。重複データをインポートせずに、同じソースから複数のインポートジョブを作成できます。
プロジェクトマッピングを構成するには:
インポートする Zendesk ブランドを見つけます。
右側のフィルターバーを使用して、Zendesk ブランドを名前でフィルター処理します。
インポートするブランドを選択します。リストの上部にあるオプションを選択して、利用可能なすべての Zendesk ブランドをインポートします。
Zendesk ブランドごとにターゲットの YouTrack プロジェクトを選択します。
マッピングのために Zendesk ブランドのリストをロードするとき、YouTrack は対応する名前を持つ既存の YouTrack プロジェクトをチェックします。Zendesk ブランドと同じ名前の YouTrack プロジェクトが見つかった場合、YouTrack はそれをターゲットプロジェクトとして提案します。
対応する名前の既存の YouTrack プロジェクトがない場合、YouTrack は新しいプロジェクトを作成することを提案します。
ターゲットプロジェクトを変更する場合は、リストの対応するドロップダウンから別のオプションを選択します。
次へをクリックして、インポートの設定を完了し、インポートを開始します。
インポートが開始されます。
インポートオプション
最初のインポート後、サイドバーで次のコントロールを使用できます。
コントロール | 説明 |
---|---|
再開 | 前回のインポート後に選択した Zendesk ブランドに加えられた変更をすぐにインポートします。 |
編集 | 統合設定ページを編集モードで開きます。このオプションを使用して、別の Zendesk インスタンスに接続したり、ログインクレデンシャルを更新したり、プロジェクトマッピングを更新したりします。 |
削除 | 現在のインポート設定を削除します。インポートされた課題にアタッチされている Zendesk チケット番号も削除されます。接続された Zendesk インスタンスからインポートされたプロジェクト、課題、コメント、ユーザー、グループは影響を受けません。インポート設定を削除して同じ Zendesk インスタンスに接続すると、チケットは新しい課題 ID を使用して既存のプロジェクトに再インポートされます。 |
関連ページ:
ユーザーアクセスの管理
ロールタブでは、単一のユーザーアカウントで使用できる権限を表示および管理できます。ユーザーには、1 つ以上のプロジェクトで割り当てられているロールに基づいて権限が付与されます。ユーザーをプロジェクトチームに直接追加して、プロジェクトへのアクセスをユーザーに許可することもできます。詳細については、プロジェクトチームを管理するを参照してください。アクセス許可の表示:ユーザーアカウントのアクセス許可は、アカウントプロファイルのロールタブに表示されます。ここで、アカウントに割り当てられているロールと権...
YouTrack からインポート
YouTrack からのインポートでは、別の YouTrack サービスからプロジェクト、課題、ユーザー、グループ、その他のデータを移行できます。セットアップウィザードは、インポート構成プロセスを移動します。接続設定を入力するように求められ、ターゲット YouTrack のプロジェクトをソース YouTrack のプロジェクトにマップできます。ソース YouTrack に課題用のカスタムフィールドセットがある場合、ターゲット YouTrack でインポートスクリプトを直接編集できます。前提条件...