ベストプラクティス：アクションカードの名前と説明

アクションカードに名前と説明を割り当てるときは、推奨されるベストプラクティスに従います。

アクションカードの名前

アクションカードの名前は、新しいフローを最初に保存するときにフローの命名（Name your Flow）ダイアログに入力する文字列から派生します。フローの命名（Name your Flow）ダイアログは、2つの方法で表示できます。

  • Workflows Designerキャンバスの上部バナーで名前未設定（Unnamed）という鉛筆アイコンをクリックします。
  • 保存（Save）ボタンをクリックします。

アクションカード名の表記では各単語の最初の文字を大文字にする必要があります。冠詞（定冠詞、不定冠詞）や前置詞などの単語は可能な限り含めません。

たとえば、次のアクションカード名はすべて適切です。

  • Create User
  • Delete File
  • Custom API Action

上記アクションカード名を次のように表記することはお勧めできません。

  • Create a User
  • Delete a File
  • custom api action

直感的な命名のために冠詞や前置詞が必要な場合は、小文字で指定します。

  • Add User to Group
  • List Users with Filter

このような例での大文字のToやWithのフォームは誤りです。

アクションカードの説明

コネクターのアクションカードをレビューや公開カタログへの掲載のために提出するときは、説明を含める必要があります。説明は、フローの命名（Name your Flow）ダイアログで追加できます。

  • カードの説明では、説明に名前や固有名詞が含まれる場合を除き、文章の先頭の文字のみを小文字で表記します。
  • 説明の長さは1、2文に収め、文末はピリオドで終える必要があります。説明には、必要に応じて最大2つの文章を含めることができます。
  • 検索結果を向上させるために、統合されるサービスの名前を説明に含める必要があります。たとえば、OktaやSalesforce、Zoomです。
  • 説明の文体は現在形とします。

たとえば、次の説明は有効です。

  • Update group details in Google Workspace.
  • Unassign a license from an Azure Active Directory（Azure Active Directoryからライセンスを割り当て解除する。） user.

以下の説明は誤った時制、不適切な大文字化、記号で表記されています。

  • Updated group & details
  • Unassigns a License from a Azure Active Directory（Azure Active Directoryからライセンスを割り当て解除する。） User