1. スクリプト タイプ

スクリプト タイプ

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

警告

Sitecore Content Hub™ では、すべてのスクリプトは制限されています。無制限のスクリプトは廃止されました。

Sitecore Content Hub™ には、次のスクリプト タイプが用意されています。

  • ユーザー サインイン スクリプト:

    ユーザー サインイン スクリプトは、ユーザーがアプリケーションにログインするたびに実行されます。

    ユーザー サインインス クリプト タイプ

    警告
    • スクリプトのユーザー検証に一貫性がない場合、またはその他のランタイム エラーがある場合、ユーザー サインイン スクリプトによってユーザーがロックアウトされる可能性があります。これにはスーパーユーザー管理者も含まれます。
    • このロックアウトを解決するには、REST API または SDK を使用してスクリプトを無効にします。
  • ユーザー登録前スクリプト:

    ユーザー登録前スクリプトは、新しいユーザーが作成されるたびに実行されます。

    ユーザー登録スクリプト タイプ

    注意

    ユーザー登録前スクリプトは、新しいユーザーが作成される前に実行されます。

  • ユーザー登録後スクリプト:

    ユーザー登録後スクリプトは、新しいユーザーが作成されるたびに実行されます。

    ユーザー登録スクリプト タイプ

    注意

    ユーザー登録後スクリプトは、新しいユーザーが作成された後で実行されます。

  • メタデータ処理スクリプト:

    メタデータ処理スクリプトは、アセットが処理ワーカーによって処理されるたびに実行されます。

    メタデータ処理スクリプト タイプ

  • アクション スクリプト:

    アクション スクリプトは、アクションとトリガーで使用できる唯一のスクリプト タイプです。これらは、複数のユース ケースをカバーできるため、最も一般的に使用されるスクリプトです。

    トリガーと組み合わせて使用する場合、アクションは、処理中 (即座) またはバックグラウンド処理中のいずれかのアクション スクリプトを実行できます。

    アクション スクリプト タイプ

    警告

    イン プロセス アクション スクリプトは、UI 関連のインタラクションや時間のかかる操作には使用しないでください。

    処理中アクション スクリプトは、以下の複数のフェーズで実行できます。

    • コミット前:

      このフェーズでは、アクション スクリプトはトリガー イベントの実行前に実行されます。たとえば、トリガー イベントが 'エンティティの変更' の場合、アクション スクリプトはエンティティが変更される前に実行されます。

      ヒント

      コミット前アクション スクリプトを使用して、既定値を入力できます。

      重要

      コミット前フェーズは、スクリプトによってイベントのデータを変更できる唯一のフェーズです。

    • セキュリティ:

      このフェーズでは、トリガーするユーザーのアクセス許可をアプリケーションがアサートすると、アクション スクリプトが実行されます。たとえば、トリガー イベントが 'エンティティの変更' の場合、トリガーするユーザーがエンティティの変更を許可されているとアプリケーションがアサートすると、アクション スクリプトが実行されます。

      ヒント

      セキュリティ アクション スクリプトを使用すると、追加のセキュリティ チェックを実行して、SecurityException をスローできます。

    • 検証:

      このフェーズでは、アクション スクリプトは、トリガーするイベントのデータをアプリケーションが検証すると実行されます。たとえば、トリガーするイベントが 'エンティティの変更' の場合、エンティティの変更後の値をアプリケーションが検証すると、アクション スクリプトが実行されます。

      ヒント

      検証アクション スクリプトを使用すると、追加の検証を実行して、ValidationException をスローできます。

    • 監査:

      このフェーズでは、トリガーするイベントのデータが確定した後で、アクション スクリプトが実行されます。

      ヒント

      監査アクション スクリプトを使用すると、監査メッセージを内部または外部のログ システムに記録できます。

    • 投稿:

      このフェーズでは、トリガーするイベントが確定した後に、アクション スクリプトが実行されます。

  • 共有スクリプト:

    共有スクリプトを使用すると、よく使用されるコードを個別のスクリプトに維持して再利用でき、任意のタイプの 1 つ以上のスクリプトから参照できます。

    注意

    共有スクリプトを構築すると、依存関係チェーン全体の整合性を維持するために、すべての依存スクリプト (共有スクリプトを参照するスクリプト) も再構築されます。共有スクリプトは、すべてのスクリプトが正常にコンパイルされた場合にのみ公開できます。

ベスト プラクティス

スクリプトのベスト プラクティスに関するガイダンスについては、「スクリプト実行タイプ」を参照してください。

この記事を改善するための提案がある場合は、 お知らせください!