{"id":89755,"date":"2025-06-03T13:16:26","date_gmt":"2025-06-03T12:16:26","guid":{"rendered":"https:\/\/churchtools.academy\/help\/non-knowledgebase\/uncategorized\/how-do-i-define-a-fallback-behavior\/"},"modified":"2026-08-25T12:46:54","modified_gmt":"2026-08-25T11:46:54","password":"","slug":"how-to-define-a-fallback-behavior","status":"publish","type":"docs","link":"https:\/\/staging.churchtools.academy\/en\/help\/churchtools-modules\/configure-connections\/how-to-define-a-fallback-behavior\/","title":{"rendered":"How to define a fallback behavior?"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">To enable data synchronization between two systems, the properties of the data must be linked so that ChurchTools knows which property in ChurchTools corresponds to which property in the external system and can be synchronized. They are linked into what are called <em>property pairs<\/em>. The property pairs always apply to the entire connection.  <\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Some of these properties have <em>values<\/em> that must also be linked to one another; for example, the &#8221; <em>gender<\/em> &#8221; property has the values &#8221; <em>unknown<\/em>,&#8221; &#8221; <em>male<\/em>,&#8221; &#8221; <em>female<\/em>,&#8221; and possibly &#8221; <em>diverse<\/em>.&#8221;  <\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If not all values in a property pair are linked\u2014that is, if the link is incomplete\u2014this will prevent the execution of all sync jobs for which you have selected that property pair.  <\/p>\n\n\n\n<p class=\"wp-block-paragraph\">To prevent this, you can define a <strong>fallback behavior<\/strong> for the relevant values. This allows you, for example, to synchronize the data first and then review the data assigned here in ChurchTools later to ensure it is correctly mapped. In this article, we\u2019ll show you how to define a fallback behavior.  <\/p>\n\n\n\n<aside class=\"wp-block-group ct-box ct-box-blue has-background is-vertical is-layout-flex wp-container-core-group-is-layout-1ccdadb1 wp-block-group-is-layout-flex\" style=\"border-radius:8px;border-left-color:#3e70ce;border-left-width:0.5rem;background-color:#f3f5f7;margin-top:var(--wp--preset--spacing--60);margin-bottom:var(--wp--preset--spacing--60)\">\n<p class=\"wp-block-paragraph\" style=\"margin-top:0.5rem;margin-right:0.5rem;margin-bottom:0rem;margin-left:0.5rem\"><strong>Note<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\" style=\"margin-top:0rem;margin-right:0.5rem;margin-bottom:0.5rem;margin-left:0.5rem\">If you have created a connection that supports writing in both directions, you can define fallback behavior for both directions. If your connection supports writing in only one direction, you can define fallback behavior for only one of the connected systems. <\/p>\n<\/aside>\n\n\n\n<h2 class=\"wp-block-heading\">Call a connection with an incomplete value mapping<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Navigate to a <em>connection<\/em> (1) with an incomplete value mapping for which you need to define a fallback behavior. On the right side, you\u2019ll see <em>a message indicating<\/em> that <em>synchronization<\/em> is <em>being prevented<\/em> (2) because the value mapping is incomplete. Click <em>\u201cEdit Value Mapping\u201d<\/em> (3) here.  <\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><a href=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented.png\"><img fetchpriority=\"high\" decoding=\"async\" width=\"2474\" height=\"868\" src=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented.png\" alt=\"Screenshot Sync Execution prevented\" class=\"wp-image-90225\" srcset=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented.png 2474w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented-300x105.png 300w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented-1024x359.png 1024w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented-768x269.png 768w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented-1536x539.png 1536w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented-2048x719.png 2048w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented-360x126.png 360w\" sizes=\"(max-width: 2474px) 100vw, 2474px\" \/><\/a><\/figure>\n\n\n\n<aside class=\"wp-block-group ct-box ct-box-blue has-background is-vertical is-layout-flex wp-container-core-group-is-layout-1ccdadb1 wp-block-group-is-layout-flex\" style=\"border-radius:8px;border-left-color:#3e70ce;border-left-width:0.5rem;background-color:#f3f5f7;margin-top:var(--wp--preset--spacing--60);margin-bottom:var(--wp--preset--spacing--60)\">\n<p class=\"wp-block-paragraph\" style=\"margin-top:0.5rem;margin-right:0.5rem;margin-bottom:0rem;margin-left:0.5rem\"><strong>Note<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\" style=\"margin-top:0rem;margin-right:0.5rem;margin-bottom:0.5rem;margin-left:0.5rem\">There are property pairs for which you must first assign a parent date before you can actually assign the values. Examples include roles for groups or accounts, and cost centers by fiscal year.   <br><br><img decoding=\"async\" width=\"929\" height=\"335\" class=\"wp-image-38259\" style=\"width: 400px\" src=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/CleanShot-2025-08-14-at-14.02.15-1.png\" alt=\"Screenshot: Assign Values, Assign Parent Date\" srcset=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/CleanShot-2025-08-14-at-14.02.15-1.png 929w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/CleanShot-2025-08-14-at-14.02.15-1-300x108.png 300w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/CleanShot-2025-08-14-at-14.02.15-1-768x277.png 768w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/CleanShot-2025-08-14-at-14.02.15-1-360x130.png 360w\" sizes=\"(max-width: 929px) 100vw, 929px\" \/><br><br>Once you&#8217;ve assigned the parent date, a yellow <em>&#8220;Assign Values<\/em>&#8221; button will appear, which you can use to assign the values as described below.<br><br><img decoding=\"async\" width=\"930\" height=\"400\" class=\"wp-image-38261\" style=\"width: 400px\" src=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/CleanShot-2025-08-14-at-14.02.36.png\" alt=\"\" srcset=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/CleanShot-2025-08-14-at-14.02.36.png 930w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/CleanShot-2025-08-14-at-14.02.36-300x129.png 300w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/CleanShot-2025-08-14-at-14.02.36-768x330.png 768w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/CleanShot-2025-08-14-at-14.02.36-360x155.png 360w\" sizes=\"(max-width: 930px) 100vw, 930px\" \/><\/p>\n<\/aside>\n\n\n\n<h2 class=\"wp-block-heading\">Define fallback behavior<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">In the value mapping, click the <em>red exclamation mark<\/em> (4) that <em>appears <\/em>next to &#8221; <em>Not linked <\/em>.&#8221;  <\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><a href=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented_Edit-gender.png\"><img loading=\"lazy\" decoding=\"async\" width=\"1316\" height=\"1450\" src=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented_Edit-gender.png\" alt=\"Screenshot Sync Execution prevented Edit gender\" class=\"wp-image-90228\" style=\"aspect-ratio:0.9075782702474389;width:716px;height:auto\" srcset=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented_Edit-gender.png 1316w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented_Edit-gender-272x300.png 272w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented_Edit-gender-929x1024.png 929w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented_Edit-gender-768x846.png 768w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented_Edit-gender-360x397.png 360w\" sizes=\"(max-width: 1316px) 100vw, 1316px\" \/><\/a><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">When defining the fallback behavior, you have the option <em>to assign<\/em> a <em>fallback value<\/em> (1), <em>clear<\/em> the <em>property<\/em> (2), or define <em>protected values<\/em> (3) that should not be overwritten by a fallback value even if they are not linked. You can delete an existing fallback behavior by clicking <em>Delete Fallback<\/em> (4). <\/p>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><a href=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented_Edit-gender_Define-fallback.png\"><img loading=\"lazy\" decoding=\"async\" width=\"590\" height=\"1070\" src=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented_Edit-gender_Define-fallback.png\" alt=\"Screenshot Sync Execution prevented Edit gender Define fallback\" class=\"wp-image-90230\" style=\"width:407px;height:auto\" srcset=\"https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented_Edit-gender_Define-fallback.png 590w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented_Edit-gender_Define-fallback-165x300.png 165w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented_Edit-gender_Define-fallback-565x1024.png 565w, https:\/\/staging.churchtools.academy\/wp-content\/uploads\/2025\/06\/Sync_Execution-prevented_Edit-gender_Define-fallback-282x512.png 282w\" sizes=\"(max-width: 590px) 100vw, 590px\" \/><\/a><\/figure>\n\n\n\n<aside class=\"wp-block-group ct-artikel-zum-weiterlesen has-background is-layout-constrained wp-container-core-group-is-layout-79a8db7e wp-block-group-is-layout-constrained\" style=\"border-radius:8px;background-color:#f9fafb;margin-top:24px;margin-bottom:24px;padding-top:32px;padding-right:24px;padding-bottom:32px;padding-left:24px\">\n<h2 class=\"wp-block-heading has-medium-font-size\">Read more<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/staging.churchtools.academy\/en\/help\/churchtools-modules\/basics-sync\/how-to-synchronize-my-data\/\">How to synchronize my data?<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/staging.churchtools.academy\/de\/help\/churchtools-module\/verbindungen-konfigurieren\/wie-bilde-ich-eigenschaften-paare\/\">How to form pairs of properties?<\/a><\/li>\n<\/ul>\n<\/aside>\n","protected":false},"excerpt":{"rendered":"<p>To enable data synchronization between two systems, the properties of the data must be linked so that ChurchTools knows which property in ChurchTools corresponds to which property in the external system and can be synchronized. They are linked into what are called property pairs. The property pairs always apply to the entire connection. Some of [&hellip;]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"doc_category":[500],"doc_tag":[],"knowledge_base":[224],"class_list":["post-89755","docs","type-docs","status-publish","hentry","doc_category-configure-connections","knowledge_base-churchtools-modules"],"pp_statuses_selecting_workflow":false,"pp_workflow_action":"current","pp_status_selection":"publish","pp_force_visibility":null,"pp_subpost_visibility":null,"pp_inherited_force_visibility":null,"pp_inherited_subpost_visibility":null,"acf":[],"year_month":"2026-08","word_count":297,"total_views":"42","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"Hans-Helge B\u00fcrger","author_nicename":"hhbuerger","author_url":"https:\/\/staging.churchtools.academy\/en\/author\/hhbuerger\/"},"doc_category_info":[{"term_name":"Configure Connections","term_url":"https:\/\/staging.churchtools.academy\/en\/help\/churchtools-modules\/configure-connections\/"}],"doc_tag_info":[],"knowledge_base_info":[{"term_name":"Modules","term_url":"https:\/\/staging.churchtools.academy\/en\/help\/churchtools-modules\/","term_slug":"churchtools-modules"}],"knowledge_base_slug":["churchtools-modules"],"_links":{"self":[{"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/docs\/89755","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/comments?post=89755"}],"version-history":[{"count":9,"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/docs\/89755\/revisions"}],"predecessor-version":[{"id":90232,"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/docs\/89755\/revisions\/90232"}],"wp:attachment":[{"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/media?parent=89755"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/doc_category?post=89755"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/doc_tag?post=89755"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/staging.churchtools.academy\/en\/wp-json\/wp\/v2\/knowledge_base?post=89755"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}