{"id":31452,"date":"2018-04-21T15:47:46","date_gmt":"2018-04-21T15:47:46","guid":{"rendered":"https:\/\/ampscript.guide\/executefilterorderedrows\/"},"modified":"2021-04-06T01:18:28","modified_gmt":"2021-04-06T01:18:28","slug":"executefilterorderedrows","status":"publish","type":"post","link":"https:\/\/ampscript.guide\/executefilterorderedrows\/","title":{"rendered":"ExecuteFilterOrderedRows"},"content":{"rendered":"<h2>ExecuteFilterOrderedRows<\/h2>\n<p>This function executes the specified Data Extension Data Filter and returns a row set with the specified number of rows.  Rows are returned sorted by the columns specified in the third parameter.<\/p>\n<h3>Arguments<\/h3>\n<p><code>ExecuteFilterOrderedRows(1,2,3)<\/code><\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: center\">Ordinal<\/th>\n<th style=\"text-align: left\">Type<\/th>\n<th style=\"text-align: left\">Required<\/th>\n<th style=\"text-align: left\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: center\">1<\/td>\n<td style=\"text-align: left\">String<\/td>\n<td style=\"text-align: left\">True<\/td>\n<td style=\"text-align: left\">Customer\/External Key of the Data Filter to execute<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: center\">2<\/td>\n<td style=\"text-align: left\">Number<\/td>\n<td style=\"text-align: left\">True<\/td>\n<td style=\"text-align: left\">Number of rows to return.  A value of 0 returns all rows.  No maximum limit on rows returned.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: center\">3<\/td>\n<td style=\"text-align: left\">String<\/td>\n<td style=\"text-align: left\">True<\/td>\n<td style=\"text-align: left\">Name of column used to sort resulting row set. Add a <code>ASC<\/code> or <code>DESC<\/code> suffix to specify the sort order. <code>ASC<\/code> is the default.  Specify multiple sort columns by separating them with a comma.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<blockquote>\n<p>NOTE: This function only works in a landing page, microsite page or CloudPage, or in an SMS message in MobileConnect.<\/p>\n<p>NOTE: This function will not work on Profile Attribute Data Filters.<\/p>\n<\/blockquote>\n<h3>Example<\/h3>\n<pre><code>%%[\n\nvar @rows, @row, @rowCount, @numRowsToReturn, @i\n\nset @numRowsToReturn = 2 \/* 0 means return all rows, no limit *\/\nset @rows = ExecuteFilterOrderedRows(\"DataExtension_Test_Example_Emails\",@numRowsToReturn,\"emailAddress desc\")\nset @rowCount = rowcount(@rows)\n\nif @rowCount &gt; 0 then\n\n  output(concat(\"rowCount: \", @rowCount))\n\n  for @i = 1 to @rowCount do\n\n    var @emailAddress\n    set @row = row(@rows, @i) \/* get row based on counter *\/\n    set @emailAddress = field(@row,\"emailAddress\")\n\n    ]%%\n\n    &lt;br&gt;Row %%=v(@i)=%%, emailAddress is %%=v(@emailAddress)=%%\n\n    %%[\n\n  next @i ]%%\n\n%%[ else ]%%\n\nNo rows found\n\n%%[ endif ]%%<\/code><\/pre>\n<h4>Output<\/h4>\n<pre><code>rowCount: 2\nRow 1, emailAddress is dale@limedash.com\nRow 2, emailAddress is suzy@limedash.com<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"<p>ExecuteFilterOrderedRows This function executes the specified Data Extension Data Filter and returns a row set with the specified number of rows. Rows are returned sorted by the columns specified in the third parameter. Arguments ExecuteFilterOrderedRows(1,2,3) Ordinal Type Required Description 1 String True Customer\/External Key of the Data Filter to execute 2 Number True Number of [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v14.7 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>The AMPscript Guide - ExecuteFilterOrderedRows<\/title>\n<meta name=\"robots\" content=\"index, follow\" \/>\n<meta name=\"googlebot\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<meta name=\"bingbot\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/ampscript.guide\/executefilterorderedrows\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"The AMPscript Guide - ExecuteFilterOrderedRows\" \/>\n<meta property=\"og:description\" content=\"ExecuteFilterOrderedRows This function executes the specified Data Extension Data Filter and returns a row set with the specified number of rows. Rows are returned sorted by the columns specified in the third parameter. Arguments ExecuteFilterOrderedRows(1,2,3) Ordinal Type Required Description 1 String True Customer\/External Key of the Data Filter to execute 2 Number True Number of [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ampscript.guide\/executefilterorderedrows\/\" \/>\n<meta property=\"og:site_name\" content=\"The AMPscript Guide\" \/>\n<meta property=\"article:published_time\" content=\"2018-04-21T15:47:46+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2021-04-06T01:18:28+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebSite\",\"@id\":\"https:\/\/ampscript.guide\/#website\",\"url\":\"https:\/\/ampscript.guide\/\",\"name\":\"The AMPscript Guide\",\"description\":\"The Definitive Scripting Manual for Salesforce Marketing Cloud\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":\"https:\/\/ampscript.guide\/?s={search_term_string}\",\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ampscript.guide\/executefilterorderedrows\/#webpage\",\"url\":\"https:\/\/ampscript.guide\/executefilterorderedrows\/\",\"name\":\"The AMPscript Guide - ExecuteFilterOrderedRows\",\"isPartOf\":{\"@id\":\"https:\/\/ampscript.guide\/#website\"},\"datePublished\":\"2018-04-21T15:47:46+00:00\",\"dateModified\":\"2021-04-06T01:18:28+00:00\",\"author\":{\"@id\":\"https:\/\/ampscript.guide\/#\/schema\/person\/5335042f77731e84f9808aecef25daec\"},\"breadcrumb\":{\"@id\":\"https:\/\/ampscript.guide\/executefilterorderedrows\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ampscript.guide\/executefilterorderedrows\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/ampscript.guide\/executefilterorderedrows\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"item\":{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ampscript.guide\/\",\"url\":\"https:\/\/ampscript.guide\/\",\"name\":\"Home\"}},{\"@type\":\"ListItem\",\"position\":2,\"item\":{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ampscript.guide\/executefilterorderedrows\/\",\"url\":\"https:\/\/ampscript.guide\/executefilterorderedrows\/\",\"name\":\"ExecuteFilterOrderedRows\"}}]},{\"@type\":[\"Person\"],\"@id\":\"https:\/\/ampscript.guide\/#\/schema\/person\/5335042f77731e84f9808aecef25daec\",\"name\":\"dev\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","_links":{"self":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/posts\/31452"}],"collection":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/comments?post=31452"}],"version-history":[{"count":0,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/posts\/31452\/revisions"}],"wp:attachment":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/media?parent=31452"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/categories?post=31452"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/tags?post=31452"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}