UIIN-3116: Add call number browse settings.

CHANGELOG.md

@@ -8,6 +8,7 @@
 * React v19: refactor away from default props for functional components. Refs UIIN-2890.
 * User can edit Source consortium "Holdings sources" in member tenant but not in Consortia manager. Refs UIIN-3147.
 * React 19: refactor away from react-dom/test-utils. Refs UIIN-2888.
+* Add call number browse settings. Refs UIIN-3116.
 
 ## [12.0.6](https://github.com/folio-org/ui-inventory/tree/v12.0.6) (2024-12-06)
 [Full Changelog](https://github.com/folio-org/ui-inventory/compare/v12.0.5...v12.0.6)

package.json

@@ -265,6 +265,18 @@
         ],
         "visible": true
       },
+      {
+        "permissionName": "ui-inventory.settings.call-number-browse",
+        "displayName": "Settings (Inventory): Configure call number browse",
+        "subPermissions": [
+          "settings.inventory.enabled",
+          "inventory-storage.call-number-types.collection.get",
+          "browse.config.collection.get",
+          "browse.config.item.put",
+          "perms.users.get"
+        ],
+        "visible": true
+      },
       {
         "permissionName": "ui-inventory.settings.classification-browse",
         "displayName": "Settings (Inventory): Configure classification browse",

src/hooks/index.js

@@ -16,3 +16,4 @@ export { default as useUpdateOwnership } from './useUpdateOwnership';
 export { default as useLocalStorageItems } from './useLocalStorageItems';
 export * from './useQuickExport';
 export * from '@folio/stripes-inventory-components/lib/queries/useInstanceDateTypes';
+export * from './useCallNumberTypesQuery';

src/hooks/useCallNumberTypesQuery/index.js

@@ -0,0 +1 @@
+export * from './useCallNumberTypesQuery';

src/hooks/useCallNumberTypesQuery/useCallNumberTypesQuery.js

@@ -0,0 +1,22 @@
+import { useQuery } from 'react-query';
+
+import {
+  useNamespace,
+  useOkapiKy,
+} from '@folio/stripes/core';
+import { CQL_FIND_ALL } from '@folio/stripes-inventory-components';
+
+export const useCallNumberTypesQuery = ({ tenantId } = {}) => {
+  const ky = useOkapiKy({ tenant: tenantId });
+  const [namespace] = useNamespace({ key: 'call-number-types' });
+
+  const { data, isFetching } = useQuery(
+    [namespace, tenantId],
+    () => ky.get(`call-number-types?limit=2000&query=${CQL_FIND_ALL} sortby name`).json(),
+  );
+
+  return {
+    callNumberTypes: data?.callNumberTypes || [],
+    isCallNumberTypesLoading: isFetching,
+  };
+};

src/hooks/useCallNumberTypesQuery/useCallNumberTypesQuery.test.js

@@ -0,0 +1,44 @@
+import {
+  QueryClient,
+  QueryClientProvider,
+} from 'react-query';
+
+import {
+  renderHook,
+  act,
+} from '@folio/jest-config-stripes/testing-library/react';
+import { useOkapiKy } from '@folio/stripes/core';
+
+import { useCallNumberTypesQuery } from './useCallNumberTypesQuery';
+
+const queryClient = new QueryClient();
+
+const wrapper = ({ children }) => (
+  <QueryClientProvider client={queryClient}>
+    {children}
+  </QueryClientProvider>
+);
+
+describe('useCallNumberTypesQuery', () => {
+  beforeEach(() => {
+    useOkapiKy.mockClear().mockReturnValue({
+      get: () => ({
+        json: () => Promise.resolve({
+          callNumberTypes: [{ id: 'call-number-type-id' }],
+        }),
+      }),
+    });
+  });
+
+  afterEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('should fetch call number types', async () => {
+    const { result } = renderHook(() => useCallNumberTypesQuery(), { wrapper });
+
+    await act(() => !result.current.isLoading);
+
+    expect(result.current.callNumberTypes).toEqual([{ id: 'call-number-type-id' }]);
+  });
+});

src/settings/CallNumberBrowseSettings/CallNumberBrowseSettings.js

@@ -0,0 +1,143 @@
+import {
+  useCallback,
+  useMemo,
+} from 'react';
+import {
+  FormattedMessage,
+  useIntl,
+} from 'react-intl';
+
+import { ControlledVocab } from '@folio/stripes/smart-components';
+import {
+  InfoPopover,
+  List,
+  LoadingPane,
+} from '@folio/stripes/components';
+import {
+  TitleManager,
+  useStripes,
+  useUserTenantPermissions,
+} from '@folio/stripes/core';
+
+import { useCallNumberTypesQuery } from '../../hooks';
+import { CALL_NUMBER_BROWSE_COLUMNS } from './constants';
+import getFieldComponents from './getFieldComponents';
+
+const CallNumberBrowseSettings = () => {
+  const stripes = useStripes();
+  const intl = useIntl();
+  const centralTenantId = stripes.user.user?.consortium?.centralTenantId;
+  const { callNumberTypes, isCallNumberTypesLoading } = useCallNumberTypesQuery({ tenantId: centralTenantId });
+  const ConnectedControlledVocab = useMemo(() => stripes.connect(ControlledVocab), [stripes]);
+
+  const {
+    userPermissions: centralTenantPermissions,
+    isFetching: isCentralTenantPermissionsLoading,
+  } = useUserTenantPermissions({
+    tenantId: centralTenantId,
+  });
+
+  const permission = 'ui-inventory.settings.call-number-browse';
+  const hasCentralTenantPerm = centralTenantPermissions.some(({ permissionName }) => permissionName === permission);
+  const hasRequiredPermissions = stripes.hasInterface('consortia')
+    ? (hasCentralTenantPerm && stripes.hasPerm(permission))
+    : stripes.hasPerm(permission);
+
+  const fieldLabels = {
+    [CALL_NUMBER_BROWSE_COLUMNS.ID]: intl.formatMessage({ id: 'ui-inventory.name' }),
+    [CALL_NUMBER_BROWSE_COLUMNS.TYPE_IDS]: intl.formatMessage({ id: 'ui-inventory.callNumberTypes' }),
+  };
+
+  const columnMapping = useMemo(() => ({
+    [CALL_NUMBER_BROWSE_COLUMNS.ID]: fieldLabels[CALL_NUMBER_BROWSE_COLUMNS.ID],
+    [CALL_NUMBER_BROWSE_COLUMNS.TYPE_IDS]: (
+      <>
+        {fieldLabels[CALL_NUMBER_BROWSE_COLUMNS.TYPE_IDS]}
+        <InfoPopover
+          content={intl.formatMessage({ id: 'ui-inventory.settings.instanceCallNumber.identifierTypesPopover' })}
+        />
+      </>
+    ),
+  }));
+
+  const callNumberTypeOptions = useMemo(() => callNumberTypes.map(type => ({
+    id: type.id,
+    label: type.name,
+  })), [callNumberTypes]);
+
+  const formatRowData = useCallback(rowData => {
+    const callNumberType = rowData[CALL_NUMBER_BROWSE_COLUMNS.TYPE_IDS]
+      ?.map(id => callNumberTypeOptions.find(type => type.id === id));
+
+    return {
+      ...rowData,
+      name: intl.formatMessage({ id: `ui-inventory.settings.instanceCallNumber.${rowData.id}` }),
+      [CALL_NUMBER_BROWSE_COLUMNS.TYPE_IDS]: callNumberType,
+    };
+  }, [callNumberTypeOptions]);
+
+  const formatItemForSaving = useCallback((item) => ({
+    [CALL_NUMBER_BROWSE_COLUMNS.ID]: item[CALL_NUMBER_BROWSE_COLUMNS.ID],
+    [CALL_NUMBER_BROWSE_COLUMNS.SHELVING_ALGORITHM]: item[CALL_NUMBER_BROWSE_COLUMNS.SHELVING_ALGORITHM],
+    [CALL_NUMBER_BROWSE_COLUMNS.TYPE_IDS]: item[CALL_NUMBER_BROWSE_COLUMNS.TYPE_IDS].map(type => type.id),
+  }), []);
+
+  const renderCallNumberTypes = (types = []) => (
+    <List
+      items={types}
+      itemFormatter={type => <li>{type?.label}</li>}
+      listStyle="bullets"
+      marginBottom0
+    />
+  );
+
+  if (!hasRequiredPermissions) {
+    return null;
+  }
+
+  if (isCentralTenantPermissionsLoading || isCallNumberTypesLoading) {
+    return <LoadingPane />;
+  }
+
+  return (
+    <TitleManager
+      page={intl.formatMessage({ id: 'ui-inventory.settings.inventory.title' })}
+      record={intl.formatMessage({ id: 'ui-inventory.callNumberTypes' })}
+    >
+      <ConnectedControlledVocab
+        stripes={stripes}
+        baseUrl="browse/config/instance-call-number"
+        records="configs"
+        objectLabel={null}
+        label={<FormattedMessage id="ui-inventory.callNumberBrowse" />}
+        labelSingular={intl.formatMessage({ id: 'ui-inventory.name' })}
+        visibleFields={[CALL_NUMBER_BROWSE_COLUMNS.NAME, CALL_NUMBER_BROWSE_COLUMNS.TYPE_IDS]}
+        columnMapping={columnMapping}
+        hiddenFields={[CALL_NUMBER_BROWSE_COLUMNS.SHELVING_ALGORITHM, 'lastUpdated', 'numberOfObjects']}
+        formatter={{
+          [CALL_NUMBER_BROWSE_COLUMNS.TYPE_IDS]: ({ typeIds }) => renderCallNumberTypes(typeIds),
+        }}
+        readOnlyFields={[CALL_NUMBER_BROWSE_COLUMNS.NAME]}
+        nameKey="name"
+        formType="final-form"
+        id="call-number-browse"
+        preUpdateHook={formatItemForSaving}
+        editable
+        fieldComponents={getFieldComponents(fieldLabels, callNumberTypeOptions)}
+        canCreate={false}
+        parseRow={formatRowData}
+        actionSuppressor={{
+          delete: () => true,
+          edit: () => false,
+        }}
+        translations={{
+          termUpdated: 'ui-inventory.settings.instanceCallNumber.termUpdated'
+        }}
+        hideCreateButton
+        tenant={centralTenantId}
+      />
+    </TitleManager>
+  );
+};
+
+export default CallNumberBrowseSettings;