[skip ci] Updates

html/latest/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 38aaf4f404f26900dd1b6b9e34df995e
+config: e82df07de89216024288178d9caab6cd
 tags: 645f666f9bcd5a90fca523b33c5a78b7

html/latest/_modules/parsons/action_builder/action_builder.html

@@ -427,6 +427,87 @@ <h1>Source code for parsons.action_builder.action_builder</h1><div class="highli
             <span class="n">identifier</span><span class="o">=</span><span class="n">identifier</span><span class="p">,</span> <span class="n">data</span><span class="o">=</span><span class="n">data</span><span class="p">,</span> <span class="n">campaign</span><span class="o">=</span><span class="n">campaign</span>
         <span class="p">)</span></div>
 
+<div class="viewcode-block" id="ActionBuilder.remove_tagging"><a class="viewcode-back" href="../../../action_builder.html#parsons.ActionBuilder.remove_tagging">[docs]</a>    <span class="k">def</span> <span class="nf">remove_tagging</span><span class="p">(</span>
+        <span class="bp">self</span><span class="p">,</span>
+        <span class="n">identifier</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+        <span class="n">tag_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+        <span class="n">tag_name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+        <span class="n">tagging_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+        <span class="n">campaign</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+    <span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">        Remove one or more tags (i.e. custom field value) from an existing entity or connection</span>
+<span class="sd">        record in Action Builder. The basis for this end point is the combination of the tag&#39;s</span>
+<span class="sd">        interact ID and that of the specific tagging. The tag ID can usually be determined from</span>
+<span class="sd">        the tag&#39;s name, and the tagging ID can be derived if the identifier of the entity or</span>
+<span class="sd">        connection record is supplied instead.</span>
+<span class="sd">        `Args:`</span>
+<span class="sd">            identifier: str</span>
+<span class="sd">                Optional. The unique identifier for an entity or connection record being updated.</span>
+<span class="sd">                If omitted, `tagging_id` must be provided.</span>
+<span class="sd">            tag_id: str</span>
+<span class="sd">                Optional. The unique identifier for the tag being removed. If omitted, `tag_name`</span>
+<span class="sd">                must be provided.</span>
+<span class="sd">            tag_name: str</span>
+<span class="sd">                Optional. The exact name of the tag being removed. May result in an error if</span>
+<span class="sd">                multiple tags (in different fields/sections) have the same name. If omitted,</span>
+<span class="sd">                `tag_id` must be provided.</span>
+<span class="sd">            tagging_id: str</span>
+<span class="sd">                Optional. The unique identifier for the specific application of the tag to an</span>
+<span class="sd">                individual entity or connection record. If omitted, `identifier` must be provided.</span>
+<span class="sd">            campaign: str</span>
+<span class="sd">                Optional. The 36-character &quot;interact ID&quot; of the campaign whose data is to be</span>
+<span class="sd">                retrieved or edited. Not necessary if supplied when instantiating the class.</span>
+<span class="sd">        `Returns:`</span>
+<span class="sd">            API response JSON which contains `{&#39;message&#39;: &#39;Tag has been removed from Taggable</span>
+<span class="sd">            Logbook&#39;}` if successful.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+
+        <span class="k">if</span> <span class="p">{</span><span class="n">tag_name</span><span class="p">,</span> <span class="n">tag_id</span><span class="p">}</span> <span class="o">==</span> <span class="p">{</span><span class="kc">None</span><span class="p">}:</span>
+            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Please supply a tag_name or tag_id!&quot;</span><span class="p">)</span>
+
+        <span class="k">if</span> <span class="p">{</span><span class="n">identifier</span><span class="p">,</span> <span class="n">tagging_id</span><span class="p">}</span> <span class="o">==</span> <span class="p">{</span><span class="kc">None</span><span class="p">}:</span>
+            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+                <span class="s2">&quot;Please supply an entity or connection identifier, or a tagging id!&quot;</span>
+            <span class="p">)</span>
+
+        <span class="n">campaign</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_campaign_check</span><span class="p">(</span><span class="n">campaign</span><span class="p">)</span>
+        <span class="n">endpoint</span> <span class="o">=</span> <span class="s2">&quot;tags/</span><span class="si">{}</span><span class="s2">/taggings&quot;</span>
+
+        <span class="k">if</span> <span class="n">tag_name</span> <span class="ow">and</span> <span class="p">{</span><span class="n">tag_id</span><span class="p">,</span> <span class="n">tagging_id</span><span class="p">}</span> <span class="o">==</span> <span class="p">{</span><span class="kc">None</span><span class="p">}:</span>
+            <span class="n">tag_data</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_tag_by_name</span><span class="p">(</span><span class="n">tag_name</span><span class="p">,</span> <span class="n">campaign</span><span class="o">=</span><span class="n">campaign</span><span class="p">)</span>
+            <span class="n">tag_count</span> <span class="o">=</span> <span class="n">tag_data</span><span class="o">.</span><span class="n">num_rows</span>
+
+            <span class="k">if</span> <span class="n">tag_count</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
+                <span class="n">error_msg</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;Found </span><span class="si">{</span><span class="n">tag_count</span><span class="si">}</span><span class="s2"> tags with this name. &quot;</span>
+                <span class="n">error_msg</span> <span class="o">+=</span> <span class="s2">&quot;Try with using the unique interact ID&quot;</span>
+                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="n">error_msg</span><span class="p">)</span>
+
+            <span class="n">tag_id</span> <span class="o">=</span> <span class="n">tag_data</span><span class="p">[</span><span class="s2">&quot;identifiers&quot;</span><span class="p">][</span><span class="mi">0</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">&quot;:&quot;</span><span class="p">)[</span><span class="mi">1</span><span class="p">]</span>
+            <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Tag </span><span class="si">{</span><span class="n">tag_name</span><span class="si">}</span><span class="s2"> has ID </span><span class="si">{</span><span class="n">tag_id</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+
+        <span class="k">if</span> <span class="n">tagging_id</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">tag_id</span><span class="p">:</span>
+            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Cannot search based on tagging ID alone.&quot;</span><span class="p">)</span>
+
+        <span class="k">if</span> <span class="n">tag_id</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">tagging_id</span><span class="p">:</span>
+            <span class="n">taggings</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_all_records</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">campaign</span><span class="p">,</span> <span class="n">endpoint</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">tag_id</span><span class="p">))</span>
+            <span class="n">taggings_filtered</span> <span class="o">=</span> <span class="n">taggings</span><span class="o">.</span><span class="n">select_rows</span><span class="p">(</span>
+                <span class="k">lambda</span> <span class="n">row</span><span class="p">:</span> <span class="n">identifier</span>
+                <span class="ow">in</span> <span class="n">row</span><span class="p">[</span><span class="s2">&quot;_links&quot;</span><span class="p">][</span><span class="s2">&quot;action_builder:connection&quot;</span><span class="p">][</span><span class="s2">&quot;href&quot;</span><span class="p">]</span>
+                <span class="k">if</span> <span class="n">row</span><span class="p">[</span><span class="s2">&quot;item_type&quot;</span><span class="p">]</span> <span class="o">==</span> <span class="s2">&quot;connection&quot;</span>
+                <span class="k">else</span> <span class="n">identifier</span> <span class="ow">in</span> <span class="n">row</span><span class="p">[</span><span class="s2">&quot;osdi:person&quot;</span><span class="p">][</span><span class="s2">&quot;href&quot;</span><span class="p">]</span>
+            <span class="p">)</span>
+            <span class="n">tagging_id</span> <span class="o">=</span> <span class="p">[</span>
+                <span class="n">x</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">&quot;:&quot;</span><span class="p">)[</span><span class="mi">1</span><span class="p">]</span>
+                <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">taggings_filtered</span><span class="p">[</span><span class="s2">&quot;identifiers&quot;</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span>
+                <span class="k">if</span> <span class="s2">&quot;action_builder&quot;</span> <span class="ow">in</span> <span class="n">x</span>
+            <span class="p">][</span><span class="mi">0</span><span class="p">]</span>
+
+        <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Removing tag </span><span class="si">{</span><span class="n">tag_id</span><span class="si">}</span><span class="s2"> from </span><span class="si">{</span><span class="n">identifier</span><span class="w"> </span><span class="ow">or</span><span class="w"> </span><span class="n">tagging_id</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">api</span><span class="o">.</span><span class="n">delete_request</span><span class="p">(</span>
+            <span class="sa">f</span><span class="s2">&quot;campaigns/</span><span class="si">{</span><span class="n">campaign</span><span class="si">}</span><span class="s2">/</span><span class="si">{</span><span class="n">endpoint</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">tag_id</span><span class="p">)</span><span class="si">}</span><span class="s2">/</span><span class="si">{</span><span class="n">tagging_id</span><span class="si">}</span><span class="s2">&quot;</span>
+        <span class="p">)</span></div>
+
 <div class="viewcode-block" id="ActionBuilder.upsert_connection"><a class="viewcode-back" href="../../../action_builder.html#parsons.ActionBuilder.upsert_connection">[docs]</a>    <span class="k">def</span> <span class="nf">upsert_connection</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">identifiers</span><span class="p">,</span> <span class="n">tag_data</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">campaign</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 <span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">        Load or update a connection record in Action Builder between two existing entity records.</span>

html/latest/action_builder.html

@@ -362,6 +362,42 @@ <h2>API<a class="headerlink" href="#api" title="Permalink to this headline"><
 </dl>
 </dd></dl>
 
+<dl class="py method">
+<dt class="sig sig-object py" id="parsons.ActionBuilder.remove_tagging">
+<span class="sig-name descname"><span class="pre">remove_tagging</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">identifier</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">tag_id</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">tag_name</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">tagging_id</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">campaign</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/parsons/action_builder/action_builder.html#ActionBuilder.remove_tagging"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#parsons.ActionBuilder.remove_tagging" title="Permalink to this definition"></a></dt>
+<dd><p>Remove one or more tags (i.e. custom field value) from an existing entity or connection
+record in Action Builder. The basis for this end point is the combination of the tag’s
+interact ID and that of the specific tagging. The tag ID can usually be determined from
+the tag’s name, and the tagging ID can be derived if the identifier of the entity or
+connection record is supplied instead.
+<cite>Args:</cite></p>
+<blockquote>
+<div><dl class="simple">
+<dt>identifier: str</dt><dd><p>Optional. The unique identifier for an entity or connection record being updated.
+If omitted, <cite>tagging_id</cite> must be provided.</p>
+</dd>
+<dt>tag_id: str</dt><dd><p>Optional. The unique identifier for the tag being removed. If omitted, <cite>tag_name</cite>
+must be provided.</p>
+</dd>
+<dt>tag_name: str</dt><dd><p>Optional. The exact name of the tag being removed. May result in an error if
+multiple tags (in different fields/sections) have the same name. If omitted,
+<cite>tag_id</cite> must be provided.</p>
+</dd>
+<dt>tagging_id: str</dt><dd><p>Optional. The unique identifier for the specific application of the tag to an
+individual entity or connection record. If omitted, <cite>identifier</cite> must be provided.</p>
+</dd>
+<dt>campaign: str</dt><dd><p>Optional. The 36-character “interact ID” of the campaign whose data is to be
+retrieved or edited. Not necessary if supplied when instantiating the class.</p>
+</dd>
+</dl>
+</div></blockquote>
+<dl class="simple">
+<dt><cite>Returns:</cite></dt><dd><p>API response JSON which contains <cite>{‘message’: ‘Tag has been removed from Taggable
+Logbook’}</cite> if successful.</p>
+</dd>
+</dl>
+</dd></dl>
+
 <dl class="py method">
 <dt class="sig sig-object py" id="parsons.ActionBuilder.upsert_connection">
 <span class="sig-name descname"><span class="pre">upsert_connection</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">identifiers</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">tag_data</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">campaign</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/parsons/action_builder/action_builder.html#ActionBuilder.upsert_connection"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#parsons.ActionBuilder.upsert_connection" title="Permalink to this definition"></a></dt>

html/latest/genindex.html

@@ -1557,6 +1557,8 @@ <h2 id="R">R</h2>
 </li>
       </ul></li>
       <li><a href="table.html#parsons.etl.etl.ETL.remove_null_rows">remove_null_rows() (parsons.etl.etl.ETL method)</a>
+</li>
+      <li><a href="action_builder.html#parsons.ActionBuilder.remove_tagging">remove_tagging() (parsons.ActionBuilder method)</a>
 </li>
       <li><a href="table.html#parsons.etl.etl.ETL.rename_column">rename_column() (parsons.etl.etl.ETL method)</a>
 </li>

html/stable/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 0c4cc394cd9243a931e0904c5f637320
+config: 0abef3855052e5266028694a19391721
 tags: 645f666f9bcd5a90fca523b33c5a78b7

html/v0.14.0/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 19f0221e01ec6535b22a62141b1bc47b
+config: 5038948aa606612dc1acb03ceaa34c61
 tags: 645f666f9bcd5a90fca523b33c5a78b7

html/v0.15.0/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: c50d216676019247c8b0069a46f072c4
+config: 7ad26256677a2707a4843fbd42426496
 tags: 645f666f9bcd5a90fca523b33c5a78b7

html/v0.16.0/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: a715e2bc23982a1facb5a22644e97733
+config: 0e505e741f0840a90779f066a2d3ddd4
 tags: 645f666f9bcd5a90fca523b33c5a78b7

html/v0.17.0/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 04272bd8ae3fa439e0f2ac12bf4028bc
+config: b317dd687d16d3732c3af4d20dcfdf69
 tags: 645f666f9bcd5a90fca523b33c5a78b7

html/v0.18.0/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: fd266ca116fe5b06634c3ec99ff1ceed
+config: 75f478036dd606f5122de2318f9329da
 tags: 645f666f9bcd5a90fca523b33c5a78b7