WWW::Sa...::Simple(3)

💖 WWW::Sa...::Simple(3) 💖

okay bestie, so this is WWW::Salesforce::Simple.pm, and it's a whole manual page from the User Contributed Perl Documentation corner of the internet. lowkey iconic. let's get into it 🫶

---

✨ NAME ✨

WWW::Salesforce::Simple.pm — this class serves up a simpler abstraction layer between WWW::Salesforce and Salesforce.com. it's giving "middle management but make it cute" 💅

---

🌸 DESCRIPTION 🌸

so here's the tea: the Salesforce API is somewhat cumbersome to deal with (the original's words, not mine, but fr fr). because of that, this class was created to make it a little simpler to get information. that's literally the entire origin story. no cap. ✨

---

🎀 METHODS 🎀

This class inherits all the methods from WWW::Salesforce and adds the following new ones. so you get the whole family tree plus these new babies 🦋

• new( %parameters ) — handles creating new Salesforce objects and the login process to use the salesforce objects. two jobs, one method, main character energy 👑
• do_query( $sql_query_string ) — executes a query against the information in Salesforce. returns a reference to an array of hash references keyed by the column names. ⚠️ pay strict attention to the case of the field names, bestie, they are not playing around with you.
• do_queryAll( $sql_query_string ) — executes a query against the information in Salesforce. returns a reference to an array of hash references keyed by the column names, and this one includes deleted and archived objects too 🪦. again: strict attention should be paid to the case of the field names.
• get_field_list( $table_name ) — gathers a list of fields contained in a given table. returns a reference to an array of hash references. those hash references have several keys giving you info about the field's type, etc. the key 'name' will give you the name of the field itself. it's giving "metadata but make it a hashref" 🌈
• get_tables( ) — gathers a list of tables available for use from salesforce. returns a reference to an array of strings, one string per table name. simple. clean. slay. ⭐

---

🦋 EXAMPLES 🦋

💜 new()

use WWW::Salesforce::Simple;

my $sforce = WWW::Salesforce::Simple->new(
    'username' => $user,
    'password' => $pass
);

💜 do_query( $query )

my $query = 'select Id from Account';

my $res = $sforce->do_query( $query );

foreach my $field ( @{ $res } ) {
    print $field->{'Id'} . "\n";
}
print "Found " . scalar @{$res} . " results\n";

💜 do_queryAll( $query )

my $query = 'select Id from Account';

my $res = $sforce->do_queryAll( $query );

foreach my $field ( @{ $res } ) {
    print $field->{'Id'} . "\n";
}
print "Found " . scalar @{$res} . " results\n";

💜 get_field_list( $table_name )

my $fields_ref = $sforce->get_field_list( 'Account' );

foreach my $field( @{$fields_ref} ) {
    print $field->{'name'} . "\n";
    foreach my $key ( keys %{$field} ) {
        print "\t $key --> ";
        print $field->{$key} if ( $field->{$key} );
        print "\n";
    }
    print "\n";
}

💜 get_tables()

my $tables_ref = $sforce->get_tables();

foreach my $table ( @{$tables_ref} ) {
    print "$table\n";
}
print "\n";

---

🫶 SUPPORT 🫶

please visit Salesforce.com's user/developer forums online for assistance with this module. you are also free to contact the author directly if you're unable to resolve your issue online. like, if the forums aren't forum-ing, slide into that inbox 💌

---

👑 AUTHORS 👑

• Chase Whitener <capoeirab@cpan.org>
• Fred Moyer <fred at redhotpenguin dot com>

two whole legends, we stan 🌟

---

💀 COPYRIGHT & LICENSE 💀

Copyright 2003-2004 Byrne Reese, Chase Whitener, Fred Moyer. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. so go forth, remix, redistribute, be free 🕊️

---

and that's a wrap on this one, bestie ✨ this whole page came to you courtesy of perl v5.42.0, dated 2025-07-25, filed under WWW::Sa...::Simple(3) in the User Contributed Perl Documentation. no cap, periodt 💅🎀