@esri/solutions-components 0.3.9 → 0.4.1

package/dist/collection/utils/downloadUtils.ts

@@ -0,0 +1,235 @@
+/** @license
+ * Copyright 2022 Esri
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+//#region Declarations
+
+import { exportCSV } from "./csvUtils";
+import { ILabel, exportPDF } from "./pdfUtils";
+import { loadModules } from "./loadModules";
+import { queryFeaturesByID } from "./queryUtils";
+
+export { ILabel } from "./pdfUtils";
+
+//#endregion
+//#region Public functions
+
+/**
+ * Downloads csv of mailing labels for the provided list of ids
+ *
+ * @param layer Layer providing features and attributes for download
+ * @param ids List of ids to download
+ * @param formatUsingLayerPopup When true, the layer's popup is used to choose attributes for each column; when false,
+ * all attributes are exported
+ * @param removeDuplicates When true a single label is generated when multiple featues have a shared address value
+ * @param addColumnTitle Indicates if column headings should be included in output
+ * @returns Promise resolving when function is done
+ */
+export async function downloadCSV(
+  layer: __esri.FeatureLayer,
+  ids: number[],
+  formatUsingLayerPopup: boolean,
+  removeDuplicates = false,
+  addColumnTitle = false
+): Promise<void> {
+  const labels = await _prepareLabels(layer, ids, removeDuplicates, formatUsingLayerPopup, addColumnTitle);
+
+  exportCSV(labels);
+
+  return Promise.resolve();
+}
+
+/**
+ * Downloads csv of mailing labels for the provided list of ids
+ *
+ * @param layer Layer providing features and attributes for download
+ * @param ids List of ids to download
+ * @param removeDuplicates When true a single label is generated when multiple featues have a shared address value
+ * @param labelPageDescription Provides PDF page layout info
+ * @returns Promise resolving when function is done
+ */
+export async function downloadPDF(
+  layer: __esri.FeatureLayer,
+  ids: number[],
+  removeDuplicates: boolean,
+  labelPageDescription: ILabel
+): Promise<void> {
+  const labels = await _prepareLabels(layer, ids, removeDuplicates);
+
+  exportPDF(labels, labelPageDescription);
+
+  return Promise.resolve();
+}
+
+//#endregion
+//#region Private functions
+
+/**
+ * Converts a set of fieldInfos into template lines.
+ *
+ * @param fieldInfos Layer's fieldInfos structure
+ * @return Label spec
+ */
+function _convertPopupFieldsToLabelSpec(
+  fieldInfos: __esri.FieldInfo[]
+): string[] {
+  const labelSpec: string[] = [];
+
+  // Every visible attribute is used
+  fieldInfos.forEach(
+    fieldInfo => {
+      if (fieldInfo.visible) {
+        labelSpec.push(`{${fieldInfo.fieldName}}`);
+      }
+    }
+  );
+
+  return labelSpec;
+};
+
+/**
+ * Converts the text of a custom popup into a multiline label specification; conversion splits text into
+ * lines on <br>s, and removes HTML tags. It does not handle Arcade and related records.
+ *
+ * @param popupInfo Layer's popupInfo structure containing description, fieldInfos, and expressionInfos, e.g.,
+ * "<div style='text-align: left;'>{NAME}<br />{STREET}<br />{CITY}, {STATE} {ZIP} <br /></div>"
+ * @return Label spec
+ */
+function _convertPopupTextToLabelSpec(
+  popupInfo: string
+): string[] {
+  // Replace <br>, <br/> with |
+  popupInfo = popupInfo.replace(/<br\s*\/?>/gi, "|");
+
+  // Remove remaining HTML tags, replace 0xA0 that popup uses for spaces, replace some char representations,
+  // and split the label back into individual lines
+  let labelSpec = popupInfo
+    .replace(/<[\s.]*[^<>]*\/?>/gi, "")
+    .replace(/\xA0/gi, " ")
+    .replace(/&lt;/gi, "<")
+    .replace(/&gt;/gi, ">")
+    .replace(/&nbsp;/gi, " ")
+    .split("|");
+
+  // Trim lines and remove empties
+  labelSpec = labelSpec.map(line => line.trim()).filter(line => line.length > 0);
+
+  return labelSpec;
+};
+
+/**
+ * Creates labels from items.
+ *
+ * @param layer Layer from which to fetch features
+ * @param ids List of ids to download
+ * @param removeDuplicates When true a single label is generated when multiple featues have a shared address value
+ * @param formatUsingLayerPopup When true, the layer's popup is used to choose attributes for each column; when false,
+ * all attributes are exported
+ * @param includeHeaderNames Add the label format at the front of the list of generated labels
+ * @returns Promise resolving when function is done
+ */
+async function _prepareLabels(
+  layer: __esri.FeatureLayer,
+  ids: number[],
+  removeDuplicates = true,
+  formatUsingLayerPopup = true,
+  includeHeaderNames = false
+): Promise<string[][]> {
+  const [intl] = await loadModules([
+    "esri/intl"
+  ]);
+
+  // Get the attributes of the features to export
+  const featureSet = await queryFeaturesByID(ids, layer);
+  const featuresAttrs = featureSet.features.map(f => f.attributes);
+
+  // Get the label formatting, if any
+  let labelFormat: string[];
+  if (layer.popupEnabled) {
+    // What data fields are used in the labels?
+    // Example labelFormat: ['{NAME}', '{STREET}', '{CITY}, {STATE} {ZIP}']
+    if (formatUsingLayerPopup && layer.popupTemplate?.content[0]?.type === "fields") {
+      labelFormat = _convertPopupFieldsToLabelSpec(layer.popupTemplate.fieldInfos);
+
+    } else if (formatUsingLayerPopup && layer.popupTemplate?.content[0]?.type === "text") {
+      labelFormat = _convertPopupTextToLabelSpec(layer.popupTemplate.content[0].text);
+
+    }
+  }
+
+  // Apply the label format
+  let labels: string[][];
+  // eslint-disable-next-line unicorn/prefer-ternary
+  if (labelFormat) {
+    // Convert attributes into an array of labels
+    labels = featuresAttrs.map(
+      featureAttributes => {
+        const label: string[] = [];
+        labelFormat.forEach(
+          labelLineTemplate => {
+            const labelLine = intl.substitute(labelLineTemplate, featureAttributes).trim();
+            if (labelLine.length > 0) {
+              label.push(labelLine);
+            }
+          }
+        )
+        return label;
+      }
+    )
+    // Remove empty labels
+    .filter(label => label.length > 0);
+
+  } else {
+    // Export all attributes
+    labels = featuresAttrs.map(
+      featureAttributes => {
+        return Object.values(featureAttributes).map(
+          attribute => `${attribute}`
+        );
+      }
+    );
+  }
+
+  // Remove duplicates
+  if (removeDuplicates) {
+    const labelsAsStrings: string[] = labels.map(label => JSON.stringify(label));
+    const uniqueLabels = new Set(labelsAsStrings);
+    labels = Array.from(uniqueLabels,
+      labelString => JSON.parse(labelString)
+    );
+  }
+
+  // Add header names
+  if (includeHeaderNames) {
+    let headerNames = [];
+
+    if (labelFormat) {
+      headerNames = labelFormat.map(labelFormatLine => labelFormatLine.replace(/\{/g, "").replace(/\}/g, ""));
+
+    } else {
+      Object.keys(featuresAttrs[0]).forEach(k => {
+        if (featuresAttrs[0].hasOwnProperty(k)) {
+          headerNames.push(k);
+        }
+      });
+    }
+
+    labels.unshift(headerNames);
+  }
+
+  return Promise.resolve(labels);
+}
+
+//#endregion

package/dist/collection/utils/interfaces.ts

@@ -108,7 +108,7 @@ export interface ISearchConfiguration {
   sources: Array<ILocatorSourceConfigItem | ILayerSourceConfigItem>;
 }
 
-interface ISearchSourceConfigItem {
+export interface ISearchSourceConfigItem {
   maxResults: number;
   maxSuggestions: number;
   minSuggestCharacters: number;
@@ -387,6 +387,13 @@ export interface ISelectionSet {
   refineIds: IRefineIds;
   redoStack?: IRefineOperation[];
   undoStack?: IRefineOperation[];
+  //skipGeomQuery?: boolean;
+  skipGeomOIDs?: number[];
+}
+
+export interface IRefineSelectionEvent {
+  graphics: __esri.Graphic[];
+  useOIDs: boolean;
 }
 
 export interface IRefineIds {

package/dist/collection/utils/pdfUtils.js

@@ -18,9 +18,13 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+//#region Declarations
 import * as PDFCreator_jsPDF from "../assets/arcgis-pdf-creator/PDFCreator_jsPDF";
 import * as PDFLabels from "../assets/arcgis-pdf-creator/PDFLabels";
 import { getAssetPath } from "@stencil/core";
+export { ILabel } from "../assets/arcgis-pdf-creator/PDFLabels";
+//#endregion
+//#region Public functions
 /**
  * Exports a PDF of labels.
  *
@@ -30,6 +34,8 @@ import { getAssetPath } from "@stencil/core";
 export function exportPDF(labels, labelPageDescription) {
   _downloadPDFFile(labels, labelPageDescription, `notify-${Date.now().toString()}`);
 }
+//#endregion
+//#region Private functions
 /**
  * Downloads the PDF file.
  *
@@ -51,3 +57,4 @@ function _downloadPDFFile(labels, labelPageDescription, fileTitle) {
     });
   });
 }
+//#endregion

package/dist/collection/utils/pdfUtils.ts

@@ -14,9 +14,15 @@
  * limitations under the License.
  */
 
+//#region Declarations
+
 import * as PDFCreator_jsPDF from "../assets/arcgis-pdf-creator/PDFCreator_jsPDF";
 import * as PDFLabels from "../assets/arcgis-pdf-creator/PDFLabels";
 import { getAssetPath } from "@stencil/core";
+export { ILabel } from "../assets/arcgis-pdf-creator/PDFLabels";
+
+//#endregion
+//#region Public functions
 
 /**
  * Exports a PDF of labels.
@@ -26,11 +32,14 @@ import { getAssetPath } from "@stencil/core";
  */
 export function exportPDF(
   labels: string[][],
-  labelPageDescription: any
+  labelPageDescription: PDFLabels.ILabel
 ): void {
   _downloadPDFFile(labels, labelPageDescription, `notify-${Date.now().toString()}`);
 }
 
+//#endregion
+//#region Private functions
+
 /**
  * Downloads the PDF file.
  *
@@ -40,7 +49,7 @@ export function exportPDF(
  */
 function _downloadPDFFile(
   labels: string[][],
-  labelPageDescription: any,
+  labelPageDescription: PDFLabels.ILabel,
   fileTitle: string
 ): void {
   const pdfLib = new PDFCreator_jsPDF.PDFCreator_jsPDF();
@@ -69,3 +78,5 @@ function _downloadPDFFile(
   );
 
 }
+
+//#endregion