Difference between revisions of "Manuals/calci/DGET"

From ZCubes Wiki
Jump to navigation Jump to search
(Created page with "<div id="6SpaceContent" class="zcontent" align="left">  <font color="#484848"><font face="Arial, sans-serif"><font size="2">'''DGET'''</font></font></font><font color="#48...")
 
Line 1: Line 1:
−
<div id="6SpaceContent" class="zcontent" align="left"> 
+
=DGET(database, field, criteria)=
  
−
<font color="#484848"><font face="Arial, sans-serif"><font size="2">'''DGET'''</font></font></font><font color="#484848"><font face="Arial, sans-serif"><font size="2">(</font></font></font><font color="#484848"><font face="Arial, sans-serif"><font size="2">'''db'''</font></font></font><font color="#484848"><font face="Arial, sans-serif"><font size="2">,</font></font></font><font color="#484848"><font face="Arial, sans-serif"><font size="2">'''fld'''</font></font></font><font color="#484848"><font face="Arial, sans-serif"><font size="2">,</font></font></font><font color="#484848"><font face="Arial, sans-serif"><font size="2">'''cri'''</font></font></font><font color="#484848"><font face="Arial, sans-serif"><font size="2">)</font></font></font>
+
*Where 'database' is the range of cells that makes up the list or database
  
−
<font color="#484848"><font face="Arial, sans-serif"><font size="2">'''where db'''</font></font></font><font color="#484848"><font face="Arial, sans-serif"><font size="2"> is the range of cells that makes up the list or database,</font></font></font>
+
*'field' shows which column is used in the function and
  
−
<font color="#484848"><font face="Arial, sans-serif"><font size="2">fld shows which column is used in the function and </font></font></font>
+
*'criteria' is the range of cells that contains the specified criteria.
  
−
<font color="#484848"><font face="Arial, sans-serif"><font size="2">cri   is the range of cells that contains the conditions that we specify. </font></font></font>
+
DGET() obtains a single value from the database that matches the specified criteria.
  
−
</div>
+
== Description ==
−
----
 
−
<div id="1SpaceContent" class="zcontent" align="left"> 
 
  
−
<font color="#484848"><font face="Arial, sans-serif"><font size="2">It obtain a single value from a column of a list or database that matches conditions that we specify.</font></font></font>
+
DGET(database, field, criteria)
  
−
</div>
+
*The function obtains a single value from the list or database that matches the specified condition.
−
----
+
*If no matching records are found, Calci returns an #ERROR message.
−
<div id="12SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="left">
+
*If more than one records are matching with the given criteria, Calci returns an #ERROR message.
 +
*Criteria can be any range on the Calci with minimum of one column and at least one row indicating the condition.
 +
*The Criteria columns should not overlap the list of data.
  
−
DGET
 
  
−
</div></div>
+
== Examples ==
−
----
 
−
<div id="8SpaceContent" class="zcontent" align="left"> 
 
−
 
 
−
[javascript:ToggleDiv('divExpCollAsst_4') <font color="#666666"><font face="Arial, sans-serif"><font size="2">Let's see an example</font></font></font>]
 
−
 
 
−
[javascript:ToggleDiv('divExpCollAsst_4') <font color="#0000ff">Let's see an example</font>]
 
−
 
 
−
<font color="#0000ff"><br /></font>
 
−
 
 
−
[javascript:ToggleDiv('divExpCollAsst_4') <font color="#0000ff">C1 C2 C3 </font>]
 
−
 
 
−
<font color="#0000ff"><br /></font>
 
−
 
 
−
[javascript:ToggleDiv('divExpCollAsst_4') <font color="#0000ff">R1 Name Age Salary </font>]
 
−
 
 
−
<font color="#0000ff"><br /></font>
 
−
 
 
−
[javascript:ToggleDiv('divExpCollAsst_4') <font color="#0000ff">R2 &lt;30 </font>]
 
−
 
 
−
<font color="#0000ff"><br /></font>
 
−
 
 
−
[javascript:ToggleDiv('divExpCollAsst_4') <font color="#0000ff">R3 &gt;40 &gt;5000</font>]
 
−
 
 
−
<font color="#0000ff"><br /></font>
 
−
 
 
−
[javascript:ToggleDiv('divExpCollAsst_4') <font color="#0000ff">R4 Name Age Salary</font>]
 
−
 
 
−
<font color="#0000ff"><br /></font>
 
−
 
 
−
[javascript:ToggleDiv('divExpCollAsst_4') <font color="#0000ff">R5 John 34 5500 </font>]
 
−
 
 
−
<font color="#0000ff"><br /></font>
 
−
 
 
−
[javascript:ToggleDiv('divExpCollAsst_4') <font color="#0000ff">R6 Bill 35 6500 </font>]
 
−
 
 
−
<font color="#0000ff"><br /></font>
 
−
 
 
−
[javascript:ToggleDiv('divExpCollAsst_4') <font color="#0000ff">R7 Clark 29 7000 </font>]
 
−
 
 
−
<font color="#0000ff"><br /></font>
 
−
 
 
−
[javascript:ToggleDiv('divExpCollAsst_4') <font color="#0000ff">R8 Bob 45 9000</font>]
 
−
 
 
−
<font color="#0000ff"><br /></font>
 
−
 
 
−
[javascript:ToggleDiv('divExpCollAsst_4') <font color="#0000ff">R9 Susan 37 4000</font>]
 
−
 
 
−
<font color="#0000ff"><br /></font>
 
−
 
 
−
[javascript:ToggleDiv('divExpCollAsst_4') <font color="#0000ff">R10 Jill 45 8000 </font>]
 
−
 
 
−
<font color="#0000ff"><br /></font>
 
−
 
 
−
[javascript:ToggleDiv('divExpCollAsst_4') <font color="#0000ff">I.e =DGET(C1R4:C3R10,”Salary”,C1R1:C2R2) is 7000</font>]
 
−
 
 
−
</div>
 
−
----
 
−
<div id="10SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Syntax </div><div class="ZEditBox"><center></center></div></div>
 
−
----
 
−
<div id="3SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Examples </div></div>
 
−
----
 
−
<div id="11SpaceContent" class="zcontent" align="left"><div class="ZEditBox" align="justify">Description </div></div>
 
−
----
 
 
<div id="2SpaceContent" class="zcontent" align="left">
 
<div id="2SpaceContent" class="zcontent" align="left">
  
 
{| id="TABLE3" class="SpreadSheet blue"
 
{| id="TABLE3" class="SpreadSheet blue"
 
|- class="even"
 
|- class="even"
−
| class="   " |
+
| class="sshl_f " | '''Name'''
−
<div id="2Space_Copy" title="Click and Drag over to AutoFill other cells."></div>
+
| class="sshl_f" | '''Age'''
−
| class="    " | Column1
+
| class="sshl_f" | '''Salary'''
−
| class="   " | Column2
+
| class="sshl_f" | '''Age'''
−
| class=" " | Column3
 
−
| class=" " | Column4
 
 
|- class="odd"
 
|- class="odd"
−
| class=" " | Row1
+
| class="sshl_f" |
−
| class="sshl_f   " | Name
+
| class="sshl_f" | &lt;40
−
| class="sshl_f" | Age
+
| class="sshl_f" | &gt;5000
−
| class="sshl_f" | Salary
+
| class="sshl_fSelectTD SelectTD " | &gt;32
−
| class="sshl_f" | 7000
+
<div id="2Space_Handle" title="Click and Drag to resize CALCI Column/Row/Cell. It is EZ!"></div><div id="2Space_Copy" title="Click and Drag over to AutoFill other cells."></div>
 
|- class="even"
 
|- class="even"
−
| class="  " | Row2
 
 
| class="sshl_f" |
 
| class="sshl_f" |
−
| class="sshl_f " | &lt;30
+
| class="sshl_f " | &gt;30
 +
| class="sshl_f" |
 
| class="sshl_f" |
 
| class="sshl_f" |
−
| class="sshl_f      SelectTD SelectTD" |
 
−
<div id="2Space_Handle" title="Click and Drag to resize CALCI Column/Row/Cell. It is EZ!"></div><div id="2Space_Copy" title="Click and Drag over to AutoFill other cells."></div>
 
 
|- class="odd"
 
|- class="odd"
−
| Row3
+
| class="sshl_f   " | '''Name'''
−
| class="sshl_f" |
+
| class="sshl_f" | '''Age'''
−
| class="sshl_f " | &gt;40
+
| class="sshl_f" | '''Salary'''
−
| class="sshl_f" | &gt;5000
 
 
| class="sshl_f" |
 
| class="sshl_f" |
 
|- class="even"
 
|- class="even"
−
| Row4
 
−
| class="sshl_f    " | Name
 
−
| class="sshl_f" | Age
 
−
| class="sshl_f" | Salary
 
−
| class="sshl_f" |
 
−
|- class="odd"
 
−
| class=" " | Row5
 
 
| class="sshl_f" | John
 
| class="sshl_f" | John
 
| class="sshl_f" | 34
 
| class="sshl_f" | 34
 
| class="sshl_f" | 5500
 
| class="sshl_f" | 5500
 
| class="sshl_f" |
 
| class="sshl_f" |
−
|- class="even"
+
|- class="odd"
−
| class="sshl_f" | Row6
 
 
| class="sshl_f" | Bill
 
| class="sshl_f" | Bill
 
| class="sshl_f" | 35
 
| class="sshl_f" | 35
 
| class="sshl_f" | 6500
 
| class="sshl_f" | 6500
 
| class="sshl_f  " |
 
| class="sshl_f  " |
−
|- class="odd"
+
|- class="even"
−
| class="sshl_f" | Row7
 
 
| class="sshl_f" | Clark
 
| class="sshl_f" | Clark
 
| class="sshl_f" | 29
 
| class="sshl_f" | 29
 
| class="sshl_f" | 7000
 
| class="sshl_f" | 7000
 
| class="sshl_f" |
 
| class="sshl_f" |
−
|- class="even"
+
|- class="odd"
−
| class="sshl_f" | Row8
 
 
| class="sshl_f" | Bob
 
| class="sshl_f" | Bob
 
| class="sshl_f" | 45
 
| class="sshl_f" | 45
 
| class="sshl_f" | 9000
 
| class="sshl_f" | 9000
 
| class="sshl_f" |
 
| class="sshl_f" |
−
|- class="odd"
+
|- class="even"
−
| class="sshl_f" | Row9
 
 
| class="sshl_f" | Susan
 
| class="sshl_f" | Susan
 
| class="sshl_f" | 37
 
| class="sshl_f" | 37
 
| class="sshl_f" | 4000
 
| class="sshl_f" | 4000
 
| class="sshl_f" |
 
| class="sshl_f" |
−
|- class="even"
+
|- class="odd"
−
| class="sshl_f" | Row10
 
 
| class="sshl_f" | Jill
 
| class="sshl_f" | Jill
 
| class="sshl_f" | 45
 
| class="sshl_f" | 45
Line 158: Line 77:
 
|}
 
|}
  
−
<div align="left">[[Image:calci1.gif]]</div></div>
+
 
−
----
+
=DGET()  :
 +
=DGET()  :
 +
=DGET()  :
 +
 
 +
== See Also ==
 +
 
 +
*[[Manuals/calci/DCOUNTA| DCOUNTA]]
 +
 
 +
==References==
 +
 
 +
*[http://en.wikipedia.org/wiki/Aggregate_function List of Aggregate Functions]
 +
*[http://en.wikipedia.org/wiki/Aggregate_function DGET]

Revision as of 11:46, 21 November 2013

DGET(database, field, criteria)

  • Where 'database' is the range of cells that makes up the list or database
  • 'field' shows which column is used in the function and
  • 'criteria' is the range of cells that contains the specified criteria.

DGET() obtains a single value from the database that matches the specified criteria.

Description

DGET(database, field, criteria)

  • The function obtains a single value from the list or database that matches the specified condition.
  • If no matching records are found, Calci returns an #ERROR message.
  • If more than one records are matching with the given criteria, Calci returns an #ERROR message.
  • Criteria can be any range on the Calci with minimum of one column and at least one row indicating the condition.
  • The Criteria columns should not overlap the list of data.


Examples

Name Age Salary Age
<40 >5000 >32
>30
Name Age Salary
John 34 5500
Bill 35 6500
Clark 29 7000
Bob 45 9000
Susan 37 4000
Jill 45 8000


=DGET() : =DGET() : =DGET() :

See Also

References

Retrieved from "http://wiki.zcubes.com/index.php?title=Manuals/calci/DGET&oldid=195534"