What You'll Learn
  1. Download Android Studio
  2. Install Flutter SDK

If on Mac:

  1. Install xCode

another_quickbase is a Flutter package for the Quickbase REST APIs.

Supports all Flutter supported platforms:

Install another_quickbase

flutter pub add another_quickbase

Quickbase - another_quickbase]

With your developer account information at hand we can now move on to configuring the Quickbase client and be able to make requests to the Quickbase APIs.

    String realm = "builderprogram-fhernandez2292";
    String appToken = "b6uehv_p3pr_0_4ce4fxdqtbrrfcba7rr6b989j25";
    String appId = "br68wk99f";

    QuickBaseClient client = QuickBaseClient(qBRealmHostname: realm, appToken: appToken);
    await client.initialize();

In order to print we'll first need to define what printer we are going to print on, what label (or paper) the printer has and what channel of communication we'll use to send the print request to the printer.

The another_brother plugin allows for a large level of detail when specifing your print. In this section however we'll just present the most basic setup to get you printing.

The snippet below shows how to print to a 1110NWB printer with a W103 label (103mm wide) talking over Bluetooth Classic.

    var printer = new Printer();
    var printInfo = PrinterInfo();
    printInfo.printerModel = Model.QL_1110NWB;
    printInfo.printMode = PrintMode.FIT_TO_PAGE;
    printInfo.isAutoCut = true;
    printInfo.port = Port.BLUETOOTH;
    // Set the label type.
    printInfo.labelNameIndex = QL1100.ordinalFromID(QL1100.W103.getId());

    // Set the printer info so we can use the SDK to get the printers.
    await printer.setPrinterInfo(printInfo);

With the printer configured we then need to find a specific printer to connect to by looking for a list of printers bonded to the device. In this example we are connecting over Bluetooth but similar methods exist WiFi.

    List<BluetoothPrinter> printers = await printer.getBluetoothPrinters([Model.QL_1110NWB.getName()]);

Since at this point we are not interested in any specific printer we'll just grab the first one and print to it.

    printInfo.macAddress = printers.single.macAddress;
    printer.setPrinterInfo(printInfo);

With the Quickbase client configured we can proceed to make requests to Quickbase. In this specific example we'll query a customer's table.

    var contactTable = await client.getTable(tableId:"br68wmaaw" ,appId: appId);

    var contacts = await client.runQuery(request: RecordsQueryRequest(
        from: contactTable.id!
    ));

In Quickbase every record is represented as a 2D array of columns index and the word "value". Although our customer table has a lot of information we currently only want the information that will allows us to print mailing labels for those customers.

    // Print each contact in a label.
    for (int i =0; i < contacts.data!.length; i++) {

      // TODO Create contact label image.
      var contact = contacts.data![i];
      String nameLine = "${contact["6"]["value"]} ${contact["7"]["value"]}";
      String streetLine = "${contact["9"]["value"]}";
      String stateLine = "${contact["11"]["value"]},${contact["12"]["value"]}";

      print ("$nameLine, $streetLine, $stateLine");
      ui.Image imageToPrint = await _generateContactLabel([nameLine, streetLine, stateLine]);
      // Print Invoice
      PrinterStatus status = await printer.printImage(imageToPrint);

      /*
      if (status.errorCode != ErrorCode.ERROR_NONE) {
        // Show toast with error.
        ScaffoldMessenger.of(context).showSnackBar( SnackBar(
          content: Padding(
            padding: EdgeInsets.all(8.0),
            child: Text("Print failed with error code: ${status.errorCode.getName()}"),
          ),
        ));
       */
    }