<?xml version="1.0" encoding="UTF-8"?>
<!--
  修学カルテ カルテXML RELAX NG スキーマ

  対象: 修学カルテのカルテテンプレートXML（ルート要素 <doc>）
  
  検証例 (Python + lxml):
    from lxml import etree
    schema = etree.RelaxNG(etree.parse("shugaku.rng"))
    doc = etree.parse("carte.xml")
    if not schema.validate(doc):
        for error in schema.error_log:
            print(error.line, error.message)

  方針:
    - 要素の親子関係と属性名は厳密に検査します。未知の属性や綴り誤りはエラーになります。
      ただし <iframe> は data-* 属性を任意に付けられるため、定義済み以外の属性も許容します。
    - <field_template> は type 属性の値ごとに、使用できる form_type・子要素を切り替えて検査します。
    - <field> は <field_template> の属性を上書きできるため、type 以外の属性を広く許容します。
    - ID の重複、<field ref> の参照先の存在など、要素をまたぐ整合性は検査しません。
-->
<grammar xmlns="http://relaxng.org/ns/structure/1.0"
         datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes">

  <start>
    <ref name="doc"/>
  </start>

  <!-- ============================================================
       共通の値の型
       ============================================================ -->

  <!-- "true" / "false" -->
  <define name="boolean.value">
    <choice>
      <value>true</value>
      <value>false</value>
    </choice>
  </define>

  <!--
    カード・field・field_template などの ID。英字で始まり、英数字と "-" "_" のみ。2文字以上とする。
  -->
  <define name="identifier.value">
    <data type="token">
      <param name="pattern">[A-Za-z][A-Za-z0-9_\-]+</param>
    </data>
  </define>
  <!--
    権限のカンマ区切りリスト。"self" "adviser" "external" のみ指定できる。
    仕様としてはaddon のカスタム権限を許容するが、ほとんど使われないので外す方が便利だろう。
    空文字は「誰も操作できない」の意味で使われるため許容する。
  -->
  <define name="authority-list.value">
    <data type="string">
      <param name="pattern">\s*((self|adviser|external)(\s*,\s*(self|adviser|external))*)?\s*</param>
    </data>
  </define>

  <define name="integer.value">
    <data type="integer"/>
  </define>

  <define name="number.value">
    <data type="decimal"/>
  </define>

  <!-- グラフ・iframe の大きさ。数値または "px" 付きの数値 -->
  <define name="length.value">
    <data type="token">
      <param name="pattern">[0-9]+(\.[0-9]+)?(px)?</param>
    </data>
  </define>

  <!-- アップロードファイルの上限サイズ(MB)。システム上限は 300MB -->
  <define name="max-file-size-mb.value">
    <data type="positiveInteger">
      <param name="maxInclusive">300</param>
    </data>
  </define>

  <!-- CSS の色・スタイル・クラス名など、任意の文字列 -->
  <define name="text.value">
    <text/>
  </define>

  <!-- ============================================================
       <doc> ルート
       ============================================================ -->

  <define name="doc">
    <element name="doc">
      <optional><attribute name="id"><ref name="identifier.value"/></attribute></optional>
      <attribute name="title"><ref name="text.value"/></attribute>
      <optional><attribute name="order"><ref name="integer.value"/></attribute></optional>
      <optional><attribute name="print"><ref name="boolean.value"/></attribute></optional>
      <optional><attribute name="export"><ref name="boolean.value"/></attribute></optional>
      <optional><attribute name="allow-external-login"><ref name="boolean.value"/></attribute></optional>
      <optional><attribute name="link-top-page-to-my-page"><ref name="boolean.value"/></attribute></optional>
      <optional><attribute name="my-page-menu"><ref name="boolean.value"/></attribute></optional>

      <!-- 記述順は問わない -->
      <choice>
        <group>
          <ref name="field_templates"/>
          <ref name="doc_template"/>
        </group>
        <group>
          <ref name="doc_template"/>
          <ref name="field_templates"/>
        </group>
      </choice>
    </element>
  </define>

  <!--
    子要素は順不同。
    各要素は仕様上1つのみだが、libxml2 の interleave はエラー箇所を特定できないメッセージになるため、
    個数は検査せず zeroOrMore/choice で定義する。
  -->
  <define name="doc_template">
    <element name="doc_template">
      <zeroOrMore>
        <choice>
          <ref name="profile"/>
          <ref name="cards"/>
          <ref name="summary"/>
          <ref name="before_cards"/>
          <element name="notification"><ref name="boolean.value"/></element>
          <ref name="custom-export"/>
        </choice>
      </zeroOrMore>
    </element>
  </define>

  <define name="cards">
    <element name="cards">
      <zeroOrMore>
        <choice>
          <ref name="static_card"/>
          <ref name="appendable_card"/>
        </choice>
      </zeroOrMore>
    </element>
  </define>

  <define name="before_cards">
    <element name="before_cards">
      <zeroOrMore>
        <choice>
          <ref name="markdown"/>
          <ref name="p"/>
          <ref name="iframe"/>
        </choice>
      </zeroOrMore>
    </element>
  </define>

  <!-- 拡張: PDF などのカスタムエクスポート -->
  <define name="custom-export">
    <element name="custom-export">
      <attribute name="name"><ref name="text.value"/></attribute>
      <attribute name="addon"><ref name="text.value"/></attribute>
      <attribute name="label"><ref name="text.value"/></attribute>
      <optional><attribute name="visible-auth"><ref name="authority-list.value"/></attribute></optional>
      <!-- addon 側のクラスに渡す任意の属性 -->
      <zeroOrMore>
        <attribute>
          <anyName>
            <except>
              <name>name</name>
              <name>addon</name>
              <name>label</name>
              <name>visible-auth</name>
            </except>
          </anyName>
          <text/>
        </attribute>
      </zeroOrMore>
      <empty/>
    </element>
  </define>

  <!-- ============================================================
       <field_templates> 入力項目の定義
       ============================================================ -->

  <define name="field_templates">
    <element name="field_templates">
      <zeroOrMore><ref name="field_template"/></zeroOrMore>
    </element>
  </define>

  <!--
    type の値ごとに form_type・子要素・固有の属性を切り替える。
    title と edit-auth は <field> 側で上書きできるため省略可とする。
  -->
  <define name="field_template">
    <element name="field_template">
      <attribute name="id"><ref name="identifier.value"/></attribute>
      <ref name="field-template.common.attributes"/>
      <choice>
        <ref name="field-template.type-text"/>
        <ref name="field-template.type-number"/>
        <ref name="field-template.type-date"/>
        <ref name="field-template.type-file"/>
        <ref name="field-template.type-select"/>
        <ref name="field-template.type-multi-select"/>
        <ref name="field-template.type-rubric"/>
        <ref name="field-template.type-title"/>
        <ref name="field-template.type-expression"/>
        <ref name="field-template.type-hidden"/>
      </choice>
    </element>
  </define>

  <!-- type に関わらず指定できる属性 -->
  <define name="field-template.common.attributes">
    <optional><attribute name="title"><ref name="text.value"/></attribute></optional>
    <optional><attribute name="edit-auth"><ref name="authority-list.value"/></attribute></optional>
    <optional><attribute name="tips"><ref name="text.value"/></attribute></optional>
    <optional><attribute name="require"><ref name="boolean.value"/></attribute></optional>
    <optional><attribute name="show-modified-info"><ref name="boolean.value"/></attribute></optional>
    <optional><attribute name="show-title"><ref name="boolean.value"/></attribute></optional>
    <optional><attribute name="protect-from-other"><ref name="boolean.value"/></attribute></optional>
    <optional><attribute name="notification"><ref name="boolean.value"/></attribute></optional>
    <optional><attribute name="title-font-color"><ref name="text.value"/></attribute></optional>
    <optional><attribute name="title-background-color"><ref name="text.value"/></attribute></optional>
    <optional><attribute name="hide-empty-state-label"><ref name="boolean.value"/></attribute></optional>
    <optional><attribute name="placeholder"><ref name="text.value"/></attribute></optional>
    <optional><attribute name="list-column"><ref name="boolean.value"/></attribute></optional>
  </define>

  <define name="character-counter.attribute">
    <attribute name="character-counter">
      <choice>
        <value>always</value>
        <value>edit</value>
        <!-- 空文字は表示しない -->
        <value></value>
      </choice>
    </attribute>
  </define>

  <!-- 記述式 -->
  <define name="field-template.type-text">
    <attribute name="type"><value>text</value></attribute>
    <optional>
      <attribute name="form_type">
        <choice>
          <value>text</value>
          <value>textarea</value>
        </choice>
      </attribute>
    </optional>
    <optional><attribute name="rows"><data type="positiveInteger"/></attribute></optional>
    <optional><attribute name="default"><ref name="text.value"/></attribute></optional>
    <optional><ref name="character-counter.attribute"/></optional>
    <!-- 入力候補（form_type="text" のときのみ有効） -->
    <zeroOrMore><ref name="select.option"/></zeroOrMore>
  </define>

  <!-- 数値 -->
  <define name="field-template.type-number">
    <attribute name="type"><value>number</value></attribute>
    <attribute name="max"><ref name="number.value"/></attribute>
    <attribute name="min"><ref name="number.value"/></attribute>
    <optional><attribute name="float"><ref name="boolean.value"/></attribute></optional>
    <empty/>
  </define>

  <!-- 年月日 -->
  <define name="field-template.type-date">
    <attribute name="type"><value>date</value></attribute>
    <empty/>
  </define>

  <!-- ファイル -->
  <define name="field-template.type-file">
    <attribute name="type"><value>file</value></attribute>
    <optional><attribute name="preview"><ref name="boolean.value"/></attribute></optional>
    <optional><attribute name="preview-height"><ref name="text.value"/></attribute></optional>
    <optional><attribute name="max-file-size-mb"><ref name="max-file-size-mb.value"/></attribute></optional>
    <empty/>
  </define>

  <define name="select.form_type.attribute">
    <attribute name="form_type">
      <choice>
        <value>selectbox</value>
        <value>checkbox</value>
        <value>checklist</value>
      </choice>
    </attribute>
  </define>

  <!-- 単数選択 -->
  <define name="field-template.type-select">
    <attribute name="type"><value>select</value></attribute>
    <optional><ref name="select.form_type.attribute"/></optional>
    <optional><attribute name="parent-field-id"><ref name="identifier.value"/></attribute></optional>
    <!-- 拡張: プラグインによる選択肢の絞り込み "{プラグインID}:{キー}" -->
    <optional>
      <attribute name="options-filter">
        <data type="token">
          <param name="pattern">[^:\s]+:[^:\s]+</param>
        </data>
      </attribute>
    </optional>
    <optional><attribute name="default"><ref name="text.value"/></attribute></optional>
    <zeroOrMore>
      <choice>
        <ref name="select.option"/>
        <ref name="option-range"/>
      </choice>
    </zeroOrMore>
  </define>

  <!-- 複数選択 -->
  <define name="field-template.type-multi-select">
    <attribute name="type"><value>multi-select</value></attribute>
    <optional><ref name="select.form_type.attribute"/></optional>
    <zeroOrMore>
      <choice>
        <ref name="select.option"/>
        <ref name="option-range"/>
      </choice>
    </zeroOrMore>
  </define>

  <!-- ルーブリック -->
  <define name="field-template.type-rubric">
    <attribute name="type"><value>rubric</value></attribute>
    <optional>
      <attribute name="form_type">
        <choice>
          <value>rubric</value>
          <value>dropdown</value>
        </choice>
      </attribute>
    </optional>
    <ref name="rubric"/>
  </define>

  <!-- タイトル（入力欄なし） -->
  <define name="field-template.type-title">
    <attribute name="type"><value>title</value></attribute>
    <empty/>
  </define>

  <!-- 拡張: JavaScript の式で自動計算する項目 -->
  <define name="field-template.type-expression">
    <attribute name="type"><value>expression</value></attribute>
    <optional>
      <attribute name="form_type">
        <choice>
          <value>text</value>
          <value>textarea</value>
        </choice>
      </attribute>
    </optional>
    <choice>
      <!-- 推奨: <expression> 要素で式を記述 CDATAを使ってください。 -->
      <ref name="expression"/>
      <!-- 非推奨: expression 属性で式を記述 -->
      <attribute name="expression"><ref name="text.value"/></attribute>
    </choice>
  </define>

  <!-- 画面に表示しない項目（CSVインポートや連携で値を保持する用途） -->
  <define name="field-template.type-hidden">
    <attribute name="type"><value>hidden</value></attribute>
    <empty/>
  </define>

  <define name="expression">
    <element name="expression"><text/></element>
  </define>

  <!-- 選択肢・入力候補 -->
  <define name="select.option">
    <element name="option">
      <attribute name="value"><ref name="text.value"/></attribute>
      <optional><attribute name="parent-value"><ref name="text.value"/></attribute></optional>
      <text/>
    </element>
  </define>

  <!-- 拡張: 連続する整数の選択肢を生成する -->
  <define name="option-range">
    <element name="option-range">
      <attribute name="from"><ref name="integer.value"/></attribute>
      <attribute name="to"><ref name="integer.value"/></attribute>
      <optional>
        <attribute name="base">
          <choice>
            <value>current-academic-year</value>
            <value>admitted-year</value>
          </choice>
        </attribute>
      </optional>
      <optional>
        <attribute name="order">
          <choice>
            <value>asc</value>
            <value>desc</value>
          </choice>
        </attribute>
      </optional>
      <optional><attribute name="label"><ref name="text.value"/></attribute></optional>
      <empty/>
    </element>
  </define>

  <!--
    ルーブリックのレベル値。数値のみ許容する。
    "0-a" のような「数字-英小文字」の値は過去に許容していたが、deprecated 予定のため許容しない。
  -->
  <define name="rubric-level.value">
    <data type="token">
      <param name="pattern">0|-?[1-9][0-9]*</param>
    </data>
  </define>


  <define name="rubric">
    <element name="rubric">
      <optional>
        <element name="rubric_header">
          <oneOrMore>
            <element name="level">
              <attribute name="value"><ref name="number.value"/></attribute>
              <text/>
            </element>
          </oneOrMore>
        </element>
      </optional>
      <oneOrMore>
        <element name="dimension">
          <attribute name="id"><ref name="identifier.value"/></attribute>
          <attribute name="title"><ref name="text.value"/></attribute>
          <optional><attribute name="description"><ref name="text.value"/></attribute></optional>
          <!-- 空文字は「初期値なし」として扱われる -->
          <optional>
            <attribute name="default">
              <choice>
                <value></value>
                <ref name="number.value"/>
              </choice>
            </attribute>
          </optional>
          <optional><attribute name="show-title"><ref name="boolean.value"/></attribute></optional>
          <oneOrMore>
            <element name="option">
              <attribute name="level"><ref name="number.value"/></attribute>
              <text/>
            </element>
          </oneOrMore>
        </element>
      </oneOrMore>
    </element>
  </define>

  <!-- ============================================================
       <profile> プロフィール
       ============================================================ -->

  <define name="profile">
    <element name="profile">
      <!-- 拡張: "false" でプロフィール欄を非表示 -->
      <optional><attribute name="show"><ref name="boolean.value"/></attribute></optional>
      <zeroOrMore><ref name="profile.param"/></zeroOrMore>
    </element>
  </define>

  <define name="profile.param">
    <element name="param">
      <!--
        email / profile.(システム共通の項目) / custom_profile.xxx / custom.xxx / attendance.(出席率の項目)
        profile. と attendance. に続く値は IP_ShugakuCarte_ProtoCarteProfileParameter のホワイトリストと同じ。
      -->
      <attribute name="name">
        <choice>
          <value>email</value>
          <data type="token">
            <param name="pattern">profile\.(student_id|student_name|photo|sex|nationality|admitted_year|univ|faclt|dept|classname|class_order_no|furigana_name|grade|furigana_roma|occupation|remarks)</param>
          </data>
          <data type="token">
            <param name="pattern">(custom_profile|custom)\.[A-Za-z][A-Za-z0-9_\-]+</param>
          </data>
          <data type="token">
            <param name="pattern">attendance\.(total_syusseki_percentage|prev_total_syusseki_percentage|current_year_syusseki_percentage|prev_year_syusseki_percentage|current_academic_year)</param>
          </data>
        </choice>
      </attribute>
      <attribute name="label"><ref name="text.value"/></attribute>
      <optional>
        <attribute name="type">
          <choice>
            <value>text</value>
            <value>file</value>
          </choice>
        </attribute>
      </optional>
      <optional><attribute name="list-column"><ref name="boolean.value"/></attribute></optional>
      <optional><attribute name="edit-auth"><ref name="authority-list.value"/></attribute></optional>
      <optional><attribute name="placeholder"><ref name="text.value"/></attribute></optional>
      <optional>
        <attribute name="form_type">
          <choice>
            <value>text</value>
            <value>textarea</value>
          </choice>
        </attribute>
      </optional>
      <optional>
        <attribute name="search">
          <choice>
            <value>wildcard</value>
            <value>range</value>
            <!-- 拡張: 行ごとのワイルドカード検索 / 部分一致検索 -->
            <value>wildcard-each-line</value>
            <value>partial-match</value>
          </choice>
        </attribute>
      </optional>
      <!-- 拡張: ユーザID・氏名の隣に並べる -->
      <optional><attribute name="is-next-to-username"><ref name="boolean.value"/></attribute></optional>
      <!-- 拡張: 一覧のソート方法 -->
      <optional>
        <attribute name="sort">
          <choice>
            <value>text</value>
            <value>number</value>
          </choice>
        </attribute>
      </optional>
      <!-- 拡張: プロフィール欄に表示しない -->
      <optional><attribute name="hidden"><ref name="boolean.value"/></attribute></optional>
      <empty/>
    </element>
  </define>

  <!-- ============================================================
       カード
       ============================================================ -->

  <!-- static_card / appendable_card で共通の属性 -->
  <define name="card.common.attributes">
    <attribute name="id"><ref name="identifier.value"/></attribute>
    <attribute name="title"><ref name="text.value"/></attribute>
    <optional><attribute name="order"><ref name="integer.value"/></attribute></optional>
    <optional><attribute name="default-viewable"><ref name="boolean.value"/></attribute></optional>
    <optional><attribute name="default-adviser-viewable"><ref name="boolean.value"/></attribute></optional>
    <optional><attribute name="edit-protect-setting"><ref name="boolean.value"/></attribute></optional>
    <optional><attribute name="edit-protect-target"><ref name="authority-list.value"/></attribute></optional>
    <optional><attribute name="allow-external-login"><ref name="boolean.value"/></attribute></optional>
    <optional><attribute name="tab-font-color"><ref name="text.value"/></attribute></optional>
    <optional><attribute name="tab-background-color"><ref name="text.value"/></attribute></optional>
    <optional><attribute name="index-font-color"><ref name="text.value"/></attribute></optional>
    <optional><attribute name="index-background-color"><ref name="text.value"/></attribute></optional>
    <!-- 拡張: 学生が入力済みでアドバイザーが未入力のときに通知 -->
    <optional><attribute name="cron-notification"><ref name="boolean.value"/></attribute></optional>
    <!-- 拡張: カード更新時に呼び出すカスタマイズ機能のキー  -->
    <optional><attribute name="trigger-on-update"><ref name="text.value"/></attribute></optional>
    <!--
      拡張: 入学年度から計算した年度でタイトルを置換（3属性セットで有効）。
      grade はタイトル置換では整数を指定するが、addon で学年の識別子（"L1" など）として使う例があるため文字列とする。
    -->
    <optional><attribute name="grade"><data type="token"/></attribute></optional>
    <optional><attribute name="replace-title-needle"><ref name="text.value"/></attribute></optional>
    <optional><attribute name="replace-title-to"><ref name="text.value"/></attribute></optional>
  </define>

  <define name="static_card">
    <element name="static_card">
      <ref name="card.common.attributes"/>
      <optional><attribute name="auto-update-title-from"><ref name="identifier.value"/></attribute></optional>
      <!-- 拡張: 画面上部の保存ボタンを非表示 -->
      <optional><attribute name="hide-top-save-button"><ref name="boolean.value"/></attribute></optional>
      <zeroOrMore>
        <choice>
          <ref name="card-content"/>
          <ref name="style"/>
        </choice>
      </zeroOrMore>
    </element>
  </define>

  <define name="appendable_card">
    <element name="appendable_card">
      <ref name="card.common.attributes"/>
      <attribute name="append-auth"><ref name="authority-list.value"/></attribute>
      <optional><attribute name="category-field-id"><ref name="identifier.value"/></attribute></optional>
      <optional>
        <attribute name="print-layout"><value>table</value></attribute>
      </optional>
      <!-- <copy-field> は layout="categorized" のときのみ使用できる -->
      <choice>
        <group>
          <attribute name="layout"><value>categorized</value></attribute>
          <zeroOrMore>
            <choice>
              <ref name="appendable-card-content"/>
              <ref name="copy-field"/>
            </choice>
          </zeroOrMore>
        </group>
        <group>
          <optional>
            <attribute name="layout">
              <choice>
                <value>default</value>
                <value></value>
              </choice>
            </attribute>
          </optional>
          <zeroOrMore><ref name="appendable-card-content"/></zeroOrMore>
        </group>
      </choice>
    </element>
  </define>

  <!-- appendable_card 内に配置できる要素（copy-field を除く） -->
  <define name="appendable-card-content">
    <choice>
      <ref name="field"/>
      <ref name="p"/>
      <ref name="markdown"/>
      <ref name="mark-complete"/>
      <ref name="table"/>
      <ref name="iframe"/>
      <ref name="handout"/>
    </choice>
  </define>

  <!-- カード内（および summary の before_card_list / after_card_list）に配置できる要素 -->
  <define name="card-content">
    <choice>
      <ref name="field"/>
      <ref name="p"/>
      <ref name="markdown"/>
      <ref name="copy-field"/>
      <ref name="table"/>
      <ref name="message-form"/>
      <ref name="mark-complete"/>
      <ref name="handout"/>
      <ref name="iframe"/>
      <ref name="rubric-chart"/>
      <ref name="number-chart"/>
      <ref name="chart"/>
    </choice>
  </define>

  <!-- ============================================================
       カード内の要素
       ============================================================ -->

  <!--
    <field> は <field_template> の type 以外の属性を上書きできる。
    参照先の type が分からないため、form_type は全候補を許容する。
  -->
  <define name="field">
    <element name="field">
      <attribute name="id"><ref name="identifier.value"/></attribute>
      <attribute name="ref"><ref name="identifier.value"/></attribute>
      <optional><attribute name="chain-id"><ref name="identifier.value"/></attribute></optional>
      <ref name="field-template.common.attributes"/>
      <optional>
        <attribute name="form_type">
          <choice>
            <value>text</value>
            <value>textarea</value>
            <value>rubric</value>
            <value>dropdown</value>
            <value>selectbox</value>
            <value>checkbox</value>
            <value>checklist</value>
          </choice>
        </attribute>
      </optional>
      <optional><attribute name="rows"><data type="positiveInteger"/></attribute></optional>
      <optional><attribute name="default"><ref name="text.value"/></attribute></optional>
      <optional><ref name="character-counter.attribute"/></optional>
      <optional><attribute name="max"><ref name="number.value"/></attribute></optional>
      <optional><attribute name="min"><ref name="number.value"/></attribute></optional>
      <optional><attribute name="float"><ref name="boolean.value"/></attribute></optional>
      <optional><attribute name="preview"><ref name="boolean.value"/></attribute></optional>
      <optional><attribute name="preview-height"><ref name="text.value"/></attribute></optional>
      <optional><attribute name="max-file-size-mb"><ref name="max-file-size-mb.value"/></attribute></optional>
      <optional><attribute name="parent-field-id"><ref name="identifier.value"/></attribute></optional>
      <optional>
        <choice>
          <attribute name="expression"><ref name="text.value"/></attribute>
          <ref name="expression"/>
        </choice>
      </optional>
    </element>
  </define>

  <!-- テキスト。[[br]] [[u]] [[b]] が使用可能 -->
  <define name="p">
    <element name="p">
      <optional><attribute name="class"><ref name="text.value"/></attribute></optional>
      <optional><attribute name="style"><ref name="text.value"/></attribute></optional>
      <text/>
    </element>
  </define>

  <define name="markdown">
    <element name="markdown">
      <optional><attribute name="id"><ref name="identifier.value"/></attribute></optional>
      <optional><attribute name="class"><ref name="text.value"/></attribute></optional>
      <optional><attribute name="display-only-while-editing"><ref name="boolean.value"/></attribute></optional>
      <text/>
    </element>
  </define>

  <!-- カード内の CSS（static_card 直下のみ）※CDATAを使ってください -->
  <define name="style">
    <element name="style"><text/></element>
  </define>

  <define name="copy-field">
    <element name="copy-field">
      <attribute name="card-id"><ref name="identifier.value"/></attribute>
      <attribute name="field-id"><ref name="identifier.value"/></attribute>
      <optional><attribute name="title"><ref name="text.value"/></attribute></optional>
      <optional><attribute name="show-title"><ref name="boolean.value"/></attribute></optional>
      <optional><attribute name="title-font-color"><ref name="text.value"/></attribute></optional>
      <optional><attribute name="title-background-color"><ref name="text.value"/></attribute></optional>
      <optional><attribute name="show-modified-info"><ref name="boolean.value"/></attribute></optional>
      <optional>
        <attribute name="form_type">
          <choice>
            <value>text</value>
            <value>textarea</value>
            <value>rubric</value>
            <value>dropdown</value>
            <value>selectbox</value>
            <value>checkbox</value>
            <value>checklist</value>
            <value>value</value>
          </choice>
        </attribute>
      </optional>
      <empty/>
    </element>
  </define>

  <define name="message-form">
    <element name="message-form">
      <attribute name="visible-auth"><ref name="authority-list.value"/></attribute>
      <attribute name="subject"><ref name="text.value"/></attribute>
      <!-- to-self="true" のときは to を省略できる -->
      <optional><attribute name="to"><ref name="text.value"/></attribute></optional>
      <optional><attribute name="to-self"><ref name="boolean.value"/></attribute></optional>
      <zeroOrMore>
        <choice>
          <ref name="markdown"/>
          <ref name="p"/>
          <element name="message-form-param">
            <attribute name="label"><ref name="text.value"/></attribute>
            <optional><attribute name="type"><value>text</value></attribute></optional>
            <optional>
              <attribute name="form_type">
                <choice>
                  <value>text</value>
                  <value>textarea</value>
                </choice>
              </attribute>
            </optional>
            <optional><attribute name="require"><ref name="boolean.value"/></attribute></optional>
            <optional><attribute name="placeholder"><ref name="text.value"/></attribute></optional>
            <empty/>
          </element>
        </choice>
      </zeroOrMore>
    </element>
  </define>

  <define name="mark-complete">
    <element name="mark-complete">
      <attribute name="id"><ref name="identifier.value"/></attribute>
      <attribute name="title"><ref name="text.value"/></attribute>
      <optional><attribute name="complete-target"><ref name="authority-list.value"/></attribute></optional>
      <optional><attribute name="edit-auth"><ref name="authority-list.value"/></attribute></optional>
      <optional><attribute name="lock-target"><ref name="authority-list.value"/></attribute></optional>
      <zeroOrMore>
        <element name="child">
          <attribute name="card-id"><ref name="identifier.value"/></attribute>
          <attribute name="mark-complete-id"><ref name="identifier.value"/></attribute>
          <empty/>
        </element>
      </zeroOrMore>
    </element>
  </define>

  <!-- 配布ファイル -->
  <define name="handout">
    <element name="handout">
      <attribute name="filename"><ref name="text.value"/></attribute>
      <attribute name="organization-id"><ref name="text.value"/></attribute>
      <attribute name="label"><ref name="text.value"/></attribute>
      <optional><attribute name="class"><ref name="text.value"/></attribute></optional>
      <optional><attribute name="style"><ref name="text.value"/></attribute></optional>
      <zeroOrMore>
        <element name="write-excel-sheet">
          <attribute name="name"><ref name="text.value"/></attribute>
          <zeroOrMore>
            <element name="write-column">
              <attribute name="name">
                <data type="token">
                  <param name="pattern">[A-Za-z]+</param>
                </data>
              </attribute>
              <attribute name="data">
                <data type="token">
                  <param name="pattern">user\.id|user\.name|profile\..+|result\..+</param>
                </data>
              </attribute>
              <optional>
                <attribute name="type">
                  <choice>
                    <value>number</value>
                    <value>text</value>
                  </choice>
                </attribute>
              </optional>
              <empty/>
            </element>
          </zeroOrMore>
        </element>
      </zeroOrMore>
    </element>
  </define>

  <!-- 拡張: iframe の埋め込み。data-param-* などの任意属性を許容 -->
  <define name="iframe">
    <element name="iframe">
      <attribute name="src"><ref name="text.value"/></attribute>
      <optional><attribute name="plugin"><ref name="text.value"/></attribute></optional>
      <optional><attribute name="addon"><ref name="text.value"/></attribute></optional>
      <optional>
        <attribute name="height">
          <choice>
            <value>auto</value>
            <ref name="length.value"/>
          </choice>
        </attribute>
      </optional>
      <optional>
        <attribute name="width">
          <choice>
            <value>auto</value>
            <ref name="length.value"/>
          </choice>
        </attribute>
      </optional>
      <optional><attribute name="display-only-while-editing"><ref name="boolean.value"/></attribute></optional>
      <zeroOrMore>
        <attribute>
          <anyName>
            <except>
              <name>src</name>
              <name>plugin</name>
              <name>addon</name>
              <name>height</name>
              <name>width</name>
              <name>display-only-while-editing</name>
            </except>
          </anyName>
          <text/>
        </attribute>
      </zeroOrMore>
      <empty/>
    </element>
  </define>

  <!-- ============================================================
       表
       ============================================================ -->

  <define name="table-common.attributes">
    <optional><attribute name="class"><ref name="text.value"/></attribute></optional>
    <optional><attribute name="style"><ref name="text.value"/></attribute></optional>
  </define>

  <define name="table">
    <element name="table">
      <ref name="table-common.attributes"/>
      <zeroOrMore>
        <element name="tr">
          <ref name="table-common.attributes"/>
          <zeroOrMore>
            <choice>
              <ref name="th"/>
              <ref name="td"/>
            </choice>
          </zeroOrMore>
        </element>
      </zeroOrMore>
    </element>
  </define>

  <define name="cell-span.attributes">
    <optional><attribute name="colspan"><data type="positiveInteger"/></attribute></optional>
    <optional><attribute name="rowspan"><data type="positiveInteger"/></attribute></optional>
  </define>

  <!-- 見出しセル。テキストのみ -->
  <define name="th">
    <element name="th">
      <ref name="table-common.attributes"/>
      <ref name="cell-span.attributes"/>
      <text/>
    </element>
  </define>

  <!-- データセル。テキストを直接書けないため <p> を使う -->
  <define name="td">
    <element name="td">
      <ref name="table-common.attributes"/>
      <ref name="cell-span.attributes"/>
      <optional><attribute name="show-modified-info"><ref name="boolean.value"/></attribute></optional>
      <zeroOrMore>
        <choice>
          <ref name="p"/>
          <ref name="field"/>
          <ref name="copy-field"/>
          <ref name="table"/>
          <ref name="handout"/>
          <ref name="rubric-chart"/>
          <ref name="number-chart"/>
          <ref name="chart"/>
        </choice>
      </zeroOrMore>
    </element>
  </define>

  <!-- ============================================================
       <summary> サマリー
       ============================================================ -->

  <define name="summary">
    <element name="summary">
      <optional><attribute name="show"><ref name="boolean.value"/></attribute></optional>
      <!-- 非推奨: カスタムsummary　廃止 -->
<!--      <optional><attribute name="mode"><ref name="text.value"/></attribute></optional>-->
      <zeroOrMore>
        <choice>
          <ref name="rubric-chart"/>
          <ref name="number-chart"/>
          <element name="extract-static-field">
            <attribute name="target-id-list"><ref name="text.value"/></attribute>
            <optional><attribute name="title"><ref name="text.value"/></attribute></optional>
            <empty/>
          </element>
          <!-- 拡張: カード一覧の前後に差し込む要素 -->
          <element name="before_card_list">
            <zeroOrMore><ref name="card-content"/></zeroOrMore>
          </element>
          <element name="after_card_list">
            <zeroOrMore><ref name="card-content"/></zeroOrMore>
          </element>
        </choice>
      </zeroOrMore>
    </element>
  </define>

  <!-- ============================================================
       グラフ
       ============================================================ -->

  <define name="rubric-chart">
    <element name="rubric-chart">
      <optional><attribute name="show"><ref name="boolean.value"/></attribute></optional>
      <optional><attribute name="hide-if-empty"><ref name="boolean.value"/></attribute></optional>
      <zeroOrMore>
        <choice>
          <ref name="radar"/>
          <ref name="line-graph"/>
          <element name="axis-type">
            <choice>
              <value>each-dimension</value>
              <value>each-field</value>
            </choice>
          </element>
        </choice>
      </zeroOrMore>
    </element>
  </define>

  <define name="number-chart">
    <element name="number-chart">
      <zeroOrMore>
        <choice>
          <ref name="radar"/>
          <ref name="line-graph"/>
          <ref name="stacked-bar-graph"/>
        </choice>
      </zeroOrMore>
    </element>
  </define>

  <!-- グラフ要素で共通の属性 -->
  <define name="graph-common.attributes">
    <optional><attribute name="title"><ref name="text.value"/></attribute></optional>
    <optional><attribute name="width"><ref name="length.value"/></attribute></optional>
    <optional><attribute name="ticks"><ref name="number.value"/></attribute></optional>
    <optional><attribute name="max"><ref name="number.value"/></attribute></optional>
    <optional><attribute name="legend-max-column-count"><data type="positiveInteger"/></attribute></optional>
    <optional><attribute name="hide-if-empty"><ref name="boolean.value"/></attribute></optional>
  </define>

  <!-- 折れ線グラフ・積み上げ棒グラフで共通の属性 -->
  <define name="axis-graph.attributes">
    <optional><attribute name="height"><ref name="length.value"/></attribute></optional>
    <optional><attribute name="grid"><ref name="number.value"/></attribute></optional>
    <optional><attribute name="min"><ref name="number.value"/></attribute></optional>
  </define>

  <define name="radar">
    <element name="radar">
      <ref name="graph-common.attributes"/>
      <ref name="graph-header"/>
      <ref name="graph-data"/>
    </element>
  </define>

  <define name="line-graph">
    <element name="line-graph">
      <ref name="graph-common.attributes"/>
      <ref name="axis-graph.attributes"/>
      <ref name="graph-header"/>
      <ref name="graph-data"/>
    </element>
  </define>

  <define name="stacked-bar-graph">
    <element name="stacked-bar-graph">
      <ref name="graph-common.attributes"/>
      <ref name="axis-graph.attributes"/>
      <ref name="graph-header"/>
      <ref name="graph-data"/>
    </element>
  </define>

  <!-- style 属性でグラフ種別を指定する汎用グラフ -->
  <define name="chart">
    <element name="chart">
      <attribute name="style">
        <choice>
          <value>radar</value>
          <value>line-graph</value>
          <value>stacked-bar-graph</value>
        </choice>
      </attribute>
      <ref name="graph-common.attributes"/>
      <ref name="axis-graph.attributes"/>
      <optional><attribute name="use-field-source"><ref name="boolean.value"/></attribute></optional>
      <optional><attribute name="source-card-id"><ref name="identifier.value"/></attribute></optional>
      <optional><attribute name="source-field-id"><ref name="identifier.value"/></attribute></optional>
      <!-- use-field-source="true" のときは header/data を JSON から読み込むため省略可 -->
      <optional><ref name="graph-header"/></optional>
      <optional><ref name="graph-data"/></optional>
    </element>
  </define>

  <define name="graph-header">
    <element name="header">
      <oneOrMore>
        <element name="axis">
          <optional><attribute name="label"><ref name="text.value"/></attribute></optional>
          <empty/>
        </element>
      </oneOrMore>
    </element>
  </define>

  <define name="graph-data">
    <element name="data">
      <zeroOrMore>
        <choice>
          <ref name="series"/>
          <ref name="custom-series"/>
        </choice>
      </zeroOrMore>
    </element>
  </define>

  <define name="series">
    <element name="series">
      <optional><attribute name="label"><ref name="text.value"/></attribute></optional>
      <optional><attribute name="color"><ref name="text.value"/></attribute></optional>
      <optional><attribute name="dashed"><ref name="boolean.value"/></attribute></optional>
      <optional><attribute name="hide-if-empty"><ref name="boolean.value"/></attribute></optional>
      <zeroOrMore><ref name="value"/></zeroOrMore>
    </element>
  </define>

  <!-- 拡張: カルテ外のデータを系列として表示  　※廃止予定 -->
  <define name="custom-series">
    <element name="custom-series">
      <attribute name="name"><ref name="text.value"/></attribute>
      <attribute name="addon"><ref name="text.value"/></attribute>
      <attribute name="label"><ref name="text.value"/></attribute>
      <optional><attribute name="color"><ref name="text.value"/></attribute></optional>
      <optional><attribute name="dashed"><ref name="boolean.value"/></attribute></optional>
      <zeroOrMore>
        <attribute>
          <anyName>
            <except>
              <name>name</name>
              <name>addon</name>
              <name>label</name>
              <name>color</name>
              <name>dashed</name>
            </except>
          </anyName>
          <text/>
        </attribute>
      </zeroOrMore>
      <empty/>
    </element>
  </define>

  <!-- field の値を参照する属性 -->
  <define name="field-reference.attributes">
    <attribute name="card-id"><ref name="identifier.value"/></attribute>
    <attribute name="field-id"><ref name="identifier.value"/></attribute>
    <optional><attribute name="dimension-id"><ref name="identifier.value"/></attribute></optional>
  </define>

  <!-- 単一 field の参照 / 固定値 / 複数 field の集計 のいずれか -->
  <define name="value">
    <element name="value">
      <choice>
        <group>
          <ref name="field-reference.attributes"/>
          <empty/>
        </group>
        <group>
          <attribute name="value"><ref name="number.value"/></attribute>
          <empty/>
        </group>
        <group>
          <attribute name="aggregate">
            <choice>
              <value>sum</value>
              <value>average</value>
              <value>max</value>
              <value>min</value>
              <value>count_empty</value>
              <value>count_filled</value>
              <value>filled_rate</value>
            </choice>
          </attribute>
          <oneOrMore><ref name="operand"/></oneOrMore>
        </group>
      </choice>
    </element>
  </define>

  <define name="operand">
    <element name="operand">
      <choice>
        <ref name="field-reference.attributes"/>
        <attribute name="value"><ref name="number.value"/></attribute>
      </choice>
      <optional><attribute name="required"><ref name="boolean.value"/></attribute></optional>
      <empty/>
    </element>
  </define>

</grammar>
